---
title: "Troubleshooting"
description: "Fix common sign-in, permission, calendar, recording, microphone, transcript, notification, and update issues."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.heizen.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

Start with **Settings → Permissions** and **Settings → Microphone Priority**.
Most recording problems come from a missing operating-system permission or an
unexpected input device.

## Recording does not start

1. Open **Settings → Permissions**.
2. Confirm **Microphone** and **Screen & Audio Recording** show **Granted**.
3. Select **Grant access** beside anything missing.
4. If screen recording is enabled, open the meeting window before starting so
   Heizen can identify and capture it automatically.
5. Try **+ Quick Meet** again.

If Home sends you directly to System Settings, screen recording permission is
missing. Enable Heizen Meets, then return and retry.

## My voice is missing or the wrong microphone is used

1. Confirm the intended microphone is connected and available to the operating
   system.
2. In **Settings → Microphone Priority**, drag it above **Auto (system
   default)**.
3. Start recording again.
4. During a live meeting, open **Live transcript** and use the microphone
   selector to switch devices immediately.

Devices below **Auto** are intentionally excluded from automatic selection.

## Other participants are missing from the transcript

System audio permission is likely missing. Return to the permissions flow or
the operating system's privacy settings and allow Heizen Meets to capture system
audio. Microphone permission alone records your voice, not the meeting output.

## The transcript is empty

- Confirm the correct microphone and system audio permissions.
- Make sure the detected meeting window is still open. If Heizen cannot match
  it, the recording falls back to the entire screen.
- Speak and check whether **Waiting for speech…** changes to interim text.
- Wait for **Processing** to complete after stopping.

A completed meeting with no captured speech shows **No transcript available**.

## Calendar events do not appear

1. Open **Settings → Calendar**.
2. If it says **Connect your calendar**, select **Connect** and finish the
   Google Calendar connection in Heizen Studio.
3. Return to Heizen Meets and confirm **Active** and **Connected**.
4. Verify that the event is scheduled for today.

Home shows only today's events. **No events scheduled for today** can therefore
be correct even when the connection is healthy.

## Join opens the call but Heizen does not record

**Join** and **Record** are separate. Return to Home and select **Record** on the
event, or select **Take Notes** when Heizen detects the active call.

## Meeting-detected notifications do not appear

1. Open **Settings → Notifications**.
2. Turn on **Auto-detected meetings**.
3. Check whether the meeting app is selected under **Don't notify me when a
   call is detected in these apps**.
4. Confirm the meeting app is using the microphone.

For a browser call, use a supported meeting URL. A generic browser tab is not
enough for reliable detection.

## Scheduled reminders do not appear

Confirm **Scheduled meetings** is enabled and Google Calendar is connected.
Reminders are designed to appear one minute before the event starts.

## The meeting stays in Processing

Keep Heizen Meets connected and reopen the meeting after a short wait. If it
remains in **Processing**, check your network connection and restart the app.
Your personal notes can still be edited while processing continues.

## The assistant cannot answer

- Wait until the meeting has an active ID and transcript context.
- Stop a stuck streaming response and retry with a shorter question.
- Remove an attachment that exceeds 5 MB or is not an image, PDF, or plain-text
  file.
- Attach no more than three files to one message.

## An update fails

Open **Settings → About**, note the displayed error, and select **Check Now**
again. If a download completed, use **Install & Restart**. Make sure Heizen Meets
can restart before installing.

## Reset skipped permissions

You do not need to rerun onboarding. Open **Settings → Permissions** and grant
the missing access directly. If the operating system still reports access as
denied, enable Heizen Meets in its privacy settings and restart the app.

Source: https://docs.heizen.work/meets/troubleshooting/index.mdx