Skip to main content
miniti for linux is a native desktop app. it shares miniti’s backend and core meeting features. linux ships on its own version line; apple releases do not automatically add features to linux. version 0.7.2 adds newer own-key AI models, current Granola export support, steadier live Questions updates and clearer handling when an account is busy. download the tarball or Debian package from the latest release. Omarchy package availability follows its own update schedule.

requirements

  • x86_64. prebuilt releases are built on ubuntu 22.04 (glibc 2.35), so they run on ubuntu 22.04+, debian 12+, fedora, arch, and other rolling distributions
  • pipewire with the pulse shim (pipewire-pulse) for system audio. without it miniti transcribes the microphone only
  • runtime libraries (arch names): webkit2gtk-4.1 gtk3 libsoup3 librsvg libayatana-appindicator alsa-lib pipewire pipewire-pulse libpulse libsecret libnotify. the tarball’s own readme lists the debian names
  • optional on wayland: gtk-layer-shell lets the floating recording surface pin itself to the corner on compositors that support it (hyprland, sway, kde). without it, or on gnome, the compositor decides where the surface appears. the omarchy package depends on it
  • no keyring is needed. account credentials live in owner-only files under ~/.local/share/miniti/ and are mirrored into gnome keyring or kwallet when one exists

install

miniti is packaged for the omarchy package repository, which every omarchy machine has enabled. once the package is listed:
pacman keeps it updated with the rest of the system. for bar integrations, use the command-line examples below. the separate omarchy widget repository was not publicly available at the documentation check on 2026-11-03.

first launch

choose how miniti should run:
  • managed uses the miniti backend. your account is an anonymous recovery key created in the app, with no email or password. 500 free minutes every month; pro is a polar subscription. keep the key somewhere safe; the released linux app uses recovery-key restore. apple apps also support verified-email sign-in. see account and recovery key
  • byok uses your own deepgram and openai api keys for provider requests. version checks and configured calendar or crm integrations can still contact miniti. see byok

what is in the linux app

  • live transcription - deepgram nova-3 in 11 languages, microphone plus system audio through pipewire, with remote callers and people in the room kept apart as separate speakers and echo of your own voice removed
  • live insights - summary, questions, coaching, plus the sales (meddpicc), templates, and playbook specialist views, with live and saved-meeting updates
  • catch me up, investigate (web and a local codebase folder), and automatic speaker naming
  • history - search, pin, rename speakers, mark as you (or mark all mic speakers as you in one click), trim, delete, notes
  • corrections (0.6.1) - select a misheard word in the transcript and choose correct: the fix applies to the rest of the meeting as it arrives, to earlier mentions if you want, and to future meetings through deepgram. corrections live in settings → language and never touch insights
  • join links (0.6.1) - calendar prompts, the reminder notification, the upcoming list, and the prepare sheet offer “join and take notes” when the event has a meet, zoom, teams, or webex link; the live meeting keeps a “join call” button. starting a meeting on its own never opens a browser
  • export - markdown, copy transcript, webhooks, and granola csv import
  • integrations - google calendar, attio, and twenty. oauth completes in the browser and returns through a miniti-* url scheme
  • smart meetings - quiet prompts, calendar handoff, and call detection based on pipewire clients. browsers are a weaker signal than native apps
  • one person, one speaker (0.6.1) - a new mic voice needs real evidence before it counts, more so on an online call, so one person on a headset stays one speaker. on a 1:1 calendar call the other person is named from the invitation
  • desktop shell - tray icon with a timer, floating recording surface that never takes focus, desktop notifications
  • plans - pro via polar with license-key restore, byok, usage banner, and limit view
  • appearance - compact, standard, or large interface scale
  • debug log - view, copy, save, or clear from settings → about. review raw messages for personal information before sharing

command line, bars, and keybinds

the app is also its own command line. miniti status, miniti start, miniti stop, miniti toggle, miniti questions, miniti meetings, miniti export last, miniti decide primary, and miniti watch talk to the running app; --json makes any of them machine-readable and man miniti has the rest. the same state is in $XDG_RUNTIME_DIR/miniti/state.json, on a control socket next to it, and on the session bus as com.miniti.linux.
the desktop entry offers start, stop, and toggle actions from the app menu. launch at login (settings → general, or miniti autostart on) starts miniti hidden in the tray. while recording, miniti requests sleep and idle inhibition; desktop support varies. it attempts to save on logout, but an abrupt shutdown can interrupt it. everything is documented in the repository’s desktop-integration.md.

if the backend says it already knows this computer

the enrollment screen can say that the backend already knows this computer but its credentials are not on this machine (a wiped data directory does that). choose restore with the recovery key to keep your plan and minutes, or start over as a new device if the key is gone. from a terminal, miniti reset-device --yes does the same reset offline.

not on linux

  • silent in-app updates. updates come through your package manager or the releases page. the app checks the minimum supported version on launch but does not update itself
  • apple watch import and apple subscriptions
  • cloud sync and the apple apps’ api settings
  • on-device transcription, on-device speaker separation, remembered voices and private mode
  • custom template editing and ai template drafting; built-in templates are available

known limits

  • a system audio route change (bluetooth, output device) is recovered by restarting capture after about four seconds of silence, so a switch mid-sentence can lose a few seconds of remote audio
  • a disconnected usb or bluetooth microphone surfaces as a stream error rather than recovering
  • on wayland the floating surface is pinned and focus-free only through layer-shell (hyprland, sway, kde, with gtk-layer-shell installed). on gnome, or without the library, the compositor decides placement. x11 gets the full behaviour
  • very long meetings (thousands of turns) render slower than on the mac

source and license

the source is available under the elastic license 2.0 at github.com/12ian34/miniti-linux. managed mode works in any build, including builds from source, because there is no secret to compile in. the linux app has its own changelog alongside the changelog for every platform.

see also