Wirenote

Private meeting notes for Linux: detects calls, records, transcribes and summarizes locally.

When an app starts using your microphone for a call, Wirenote asks whether to record. After the call it writes a Markdown note with a transcript, who said what, a summary, decisions and action items. By default nothing leaves your computer: transcription runs with faster-whisper, speakers are told apart with sherpa-onnx, and summaries come from a local model through Ollama.

• Notices calls by itself. It watches PipeWire for apps that open the mic: Jitsi or any web call in Chrome, Brave or Firefox, Discord, Rocket.Chat, and whatever you add to apps.toml. No bot joins your call.
• Two clean tracks. Your mic and the system audio are recorded separately, so "Me" and the others are never mixed up.
• Notes you own. Plain Markdown files in ~/Meetings, plus a local web app to search calls, play back moments, name speakers, tick off action items and ask questions about past meetings.
• Private by default. Files are readable only by you, the web app only by your user, and the cloud is opt-in. See PRIVACY.md.

Requirements

• Linux on x86_64 or ARM64 with PipeWire (most current distributions), and a desktop with notifications. Tested on KDE Plasma 6 (Wayland); GNOME and others should work but are not tested yet. macOS and Windows are not supported.
• Python 3.11 to 3.14, and uv. uv downloads a matching Python if yours is newer or older.
• ffmpeg (for playback in the web app).
• About 2 GB of disk for the speech models, downloaded once on the first note.
• Optional: Ollama for local summaries, or an Anthropic API key for summaries by Claude.

Install

uv tool install wirenote
wirenote setup install     # systemd user services and an app-menu entry; no root needed
wirenote doctor            # checks PipeWire, notifications, models, summaries

To install from source instead: uv tool install git+https://github.com/knowhrishi/wirenote.

For local summaries, install Ollama and pull the default model:

ollama pull qwen3:4b

Your first note

1. Join a call. After a few seconds a notification asks Record or Ignore.
2. Click Record and tell the others. If you set a consent line in Settings, it is now on your clipboard, ready to paste into the call chat.
3. Leave the call. The call opens in the meetings app in your browser, and the note fills in a few minutes later, when "Meeting note ready" appears.
4. To come back to it later, click Open note, or open Wirenote from the app menu.

Everything else, from calendars to commands to files, is in docs/usage.md.

Recording law

You are responsible for getting consent; in many countries (for example Germany, §201 StGB) recording without it is a crime. Wirenote never records without your click, shows a notification for as long as it records, and can copy a consent line for the call chat. Set it in the app's Settings.

Privacy in brief

• Audio, transcripts, notes, voice prints and settings stay on your computer, readable only by your user.
• The meetings app listens on 127.0.0.1 and only lets your own user in.
• Speech models are downloaded once from Hugging Face. There is no telemetry.
• Claude is opt-in. If you choose it, transcripts and notes are sent to Anthropic; the app shows exactly what before you switch, and marks each call "Local" or "Sent to Claude".

Details: PRIVACY.md. Security reports: SECURITY.md.

Update

wirenote update            # newest version from PyPI; restarts Wirenote, never during a call

After an update, the meetings app shows what is new. To hear about new versions, turn on update checks in Settings (off by default; see PRIVACY.md).

Uninstall

wirenote setup uninstall           # services and app-menu entry; your data stays
wirenote setup uninstall --purge   # also recordings, transcripts and settings (asks first); notes stay
uv tool uninstall wirenote

Contributing

Bug reports and pull requests are welcome; see CONTRIBUTING.md. Pull requests need a one-time Contributor License Agreement, so that the project can later offer a supported edition for companies; your contributions stay available as open source. Please follow the code of conduct.

License

Wirenote is free software under the GNU Affero General Public License v3.0 or later. Third-party components and models are listed in THIRD_PARTY.md.