Ghira
Docs menu

Get started

Record your first meeting

Set up Ghira, then record and review your first meeting

Set up Ghira once, then record a call or a meeting in the room. Everything in this guide happens on your Mac.

Before you start

Set up Ghira

The first launch walks you through these steps. You can change most of them later in Settings.

  1. Choose your languages. Pick English, Tiếng Việt, or Both, often mixed. With both, Ghira understands mixed sentences like “chốt scope cho bản beta”.
  2. Download speech models. Ghira picks a preset for your Mac's memory: Light, Balanced or Max. The download starts by itself, and you can continue while it runs. See Speech models.
  3. Allow the microphone and system audio. The microphone hears you and the room. Screen & System Audio Recording hears the other people on Zoom, Meet or Teams. Ghira records sound only, never your screen. Notifications and Calendar are optional.
  4. Add your voice. Optional. Read a short passage, about 20 seconds, so Ghira can label you as Me. This step shows up once the voice model is downloaded or downloading. You agree to store the profile, and it stays encrypted on your Mac.
  5. Make a test recording. Ten seconds is enough to check that both sources are heard and a line of transcript appears. Play a video or speak.
  6. Keep a recovery key. Optional. Your meetings are encrypted with a key kept in your Mac's keychain. A 24-word recovery key brings them back if the keychain is lost. Write it on paper and keep it away from your Mac.

No internet? Skip ahead and record. Ghira keeps the audio and processes it once the models are installed.

Record a call

Choose Record call or press ⌘⇧R. When Ghira notices a meeting app using the microphone, it asks “Record this call?”. It never starts on its own. The transcript appears as people talk, and each new voice gets a color and an initial.

Pick Room instead of Call to record a meeting around you with the microphone alone.

While you record:

All the keys are listed in Keyboard shortcuts.

After the call

When you stop recording, Ghira refines the speakers, improves the transcript and writes the notes. You can leave the meeting open or close it. A notification tells you when the notes are ready.

Open the meeting to read the Notes or the Transcript. Every sentence in the notes links to the moment it was said.

From the command line

The ghi command does the same work without the app, which is handy for files you already have. Build it with the speech engines, then point it at a file:

Terminal
cargo build --release -p ghi-cli --features nemo
target/release/ghi transcribe standup.wav --lang vi

It needs the models in ./models (see Install from source). The Command line page lists every command.

Limits

Edit this page on GitHubLast updated