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

# Record a meeting

> Turn meeting notes on, grant what the app needs, and control the recording bar.

Recording happens in the Jinn desktop app, and it starts switched off. Nothing on your machine
listens until you turn it on, and on macOS the system asks for the microphone and for screen
and system-audio recording separately before Jinn can hear anything.

Recorded the meeting somewhere else already? You don't need the app for that —
[upload the file](https://docs.jinn.so/meetings/upload-a-recording.md) from the browser instead.

Once it's on, recording is one small bar that floats over whatever you're doing.

## Set up recording once

Three things, and none of them come back: the app, the toggle, and what Jinn should do when a
meeting starts.

### Get the desktop app

The desktop app is what captures audio — a browser can't.
[Download it](https://app.jinn.so/download), or use the link in the sidebar under **Desktop**. The download page
offers the build for your computer, and says so if this release doesn't have one yet.

The app records on macOS and Linux, using the system's own audio capture: your microphone, and
whatever plays through your speakers — the other people on the call. Everything else — reading
[transcripts and write-ups](https://docs.jinn.so/meetings/review-a-meeting.md), setting up [agents](https://docs.jinn.so/agents/add-an-agent.md) — works
in a browser on any machine.

### Turn meeting notes on

You do this once. Open **Settings** → **Meetings** and turn on **Enable meeting notes** —
until you do, Jinn has no recording bar and no meeting features at all. Afterwards it stays
on, and every meeting from then on is a click.

On macOS, grant the two permissions the system asks for. Both live under
**Privacy & Security** in the settings, and both show whether they've been granted yet:

* **Microphone** — so Jinn can hear you.
* **Screen & System audio recording** — so Jinn can hear everyone else. This is how a meeting
  gets recorded without a bot joining the call: the audio comes from your machine, not from
  the meeting service.

Click **Open System Settings** when Jinn offers, and it takes you to the right place. If
you've granted a permission and Jinn still shows it as missing, restart the app — there's a
**Restart App** button next to **Permission issues** for exactly this.

On Linux there's nothing to grant. Recording is there whenever your desktop's sound system,
PulseAudio or PipeWire, is running — every mainstream Linux desktop ships one of them.

### Choose what happens when a meeting starts

Under **Meeting recording**, **When meeting starts** decides how much Jinn does on its own:

* **Do nothing** — you start every recording by hand.
* **Show a recording prompt** — Jinn notices a meeting and asks.
* **Auto start recording** — Jinn starts recording without asking.

Auto-start is convenient and worth thinking about before you choose it, because it applies to
every meeting, including the ones you'd rather not have a transcript of. The prompt is the
middle ground and the one most teams settle on.

## Run a recording

Start, say where the recording belongs, stop. This is every meeting from then on.

### Record

Click **Start**. The bar shrinks to a timer and two level meters, one for your microphone and
one for system audio, so a glance tells you both sides of the call are being heard. Click the
bar to open the full panel, and **Collapse** to put it away again.

The panel is where you set the recording up, and you can do it at any point before you stop:

* **Select project** — pick the [project](https://docs.jinn.so/projects/manage-projects.md) this recording belongs to;
  start typing to search. Clear it and the recording goes to your inbox for you to file
  afterwards; see [filing it later](https://docs.jinn.so/meetings/check-a-recording.md)
* **Meeting name** — becomes the recording's title. Leave it empty and Jinn names the
  recording after the app and the time
* **Note** and **Action items** — write down what you don't want to wait for the transcript
  to find. Press Enter to add an action item, and tick it when it's done. Both are on the
  recording's **Notes** tab afterwards, exactly as you typed them
* **Microphone** and **System audio** — each with its own mute and its own choice of device, so
  you can record the room without recording yourself or the other way round

**Pause** and **Resume** hold the recording without ending it.

### Stop

**Stop & Generate** ends the recording and hands it over: Jinn saves the audio, creates the
recording and opens it. The bar shows **Processing…** while it does.

If the meeting wasn't worth keeping, open the arrow next to it and choose
**Stop without saving**. The audio, the note and the action items are discarded, and this
can't be undone.

Jinn sends the audio to the server in pieces while you talk, so most of the meeting is already
saved by the time you click **Stop & Generate**. If the app or your computer shuts down
mid-meeting, what you recorded up to then isn't lost: the next time the app starts, it finishes
saving the meeting by itself, with **(continued)** after its title.

### Quit the app mid-meeting

Jinn won't let a meeting end by accident. Quit the app while it's recording — or, on Linux,
close its window — and it asks first: **A meeting is recording**.

* **Stop and save** — ends the recording, saves it, and quits.
* **Keep recording** — closes every window and goes on recording from the menu bar on macOS, or
  the tray on Linux. Click **Stop** there when the meeting ends, and the app quits once the
  recording is saved. **Open Jinn** brings the window back.
* **Cancel** — changes nothing. The recording carries on and the app stays open.

On macOS, closing the window doesn't quit the app, so it doesn't ask.

### Keep the bar out of your screen share

If you share your screen during meetings, two settings under **Screen sharing** stop Jinn
appearing in what everyone else sees:

* **Hide recording bar when sharing** — the bar stays out of screen shares and recordings. It
  turns grey while hidden, so you can still tell it's recording.
* **Hide main window when sharing** — the same for the main Jinn window.

Both are off unless you turn them on. The panel has the same switch for the bar,
**Hide from screen sharing**, for when you decide mid-meeting.

### Where the recording goes

Straight to the project you picked, or to your inbox if you didn't. Either way Jinn starts
transcribing immediately — you don't have to wait around, and the recording's page fills in by
itself as each part finishes.

### When the recording bar reports a problem

The bar tells you when a recording can't go on, and what to do about it:

* **Recording didn't start** — nothing was captured. Click **Start** again.
* **Recording stopped — the server didn't accept it** — Jinn couldn't keep recording this
  meeting. Click **Start** for a new recording to carry on.
* **This meeting was deleted** — someone deleted the meeting in Jinn while you were recording
  it, so the recording stopped.
* **You can't file this meeting in that project** — you don't have the access to put a meeting
  there. Pick another project under **Select project**.

## Where to go next

> [card] [Manage projects](https://docs.jinn.so/projects/manage-projects.md)
>
> The container a recording needs before any agent reads it.

> [card] [Upload a recording](https://docs.jinn.so/meetings/upload-a-recording.md)
>
> Turn an audio or video file you already have into a meeting.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.