Skip to main content

whisper-memo

Record a voice memo in your terminal, get the transcript on your clipboard. Transcription runs entirely on your machine with faster-whisper. No account, no API key, no audio leaves your computer.

whisper-memo recording and transcribing a memo

Why

I built this project as a simple way to capture changes I wanted to make during quality review checks on my Claude development. While reviewing changes, I activate whisper-memo and just talk, then paste that into Claude. There are many solutions to this problem, but I had some specific needs, so I built this small tool.

Install

With uv (recommended) or pipx:

uv tool install whisper-memo          # CPU, works everywhere
uv tool install 'whisper-memo[cuda]'  # NVIDIA GPU on Linux or Windows

Replace uv tool install with pipx install if you use pipx.

The first run downloads the Whisper model from Hugging Face (about 1.6 GB for the default large-v3-turbo). After that, everything works offline.

Platform notes

  • Linux: install PortAudio for the microphone (sudo apt install libportaudio2) and a clipboard tool (xclip, xsel or wl-clipboard).
  • macOS: the terminal asks for microphone permission the first time. Transcription runs on the CPU; pick a smaller model (-m small) if it feels slow.
  • Windows: works out of the box. Add [cuda] for an NVIDIA GPU.
  • WSL: microphone access depends on WSLg audio support and may not work.

Usage

whisper-memo                  # default model, English
whisper-memo -m small         # smaller, faster model
whisper-memo -l auto          # detect the spoken language
whisper-memo -d cpu           # force CPU even if a GPU is present
whisper-memo --no-clipboard   # print only

Press Enter to start recording and Enter again to stop. Ctrl+C quits.

Say "new line" while recording to split the transcript into bullet points:

"Rename the fetch helper to load user, new line, add a test for the empty list case, new line, drop the unused import in the CLI module"

- Rename the fetch helper to load user
- Add a test for the empty list case
- Drop the unused import in the CLI module
Option Default
-m, --model large-v3-turbo Any faster-whisper model name or a local path. Also read from WHISPER_MODEL.
-d, --device auto auto, cuda or cpu. auto uses the GPU when one is available.
-l, --language en Language code (de, ja, ...) or auto.
--no-clipboard off Don't copy transcripts to the clipboard.

Development

git clone https://github.com/adamhp/whisper-memo
cd whisper-memo
uv run whisper-memo                    # run from source
uv run --group dev pytest              # tests
uv run --group dev ruff check          # lint
uv run --group dev ruff format         # format

Releasing

  1. Bump version in pyproject.toml and move the Unreleased notes in CHANGELOG.md under the new version.
  2. Commit, then tag and push: git tag v0.2.0 && git push origin v0.2.0.
  3. The release workflow builds the package, publishes it to PyPI and creates a GitHub release.

License

MIT

Metadata

Release files for whisper-memo 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for whisper-memo 0.1.0
File Size Uploaded Provenance Actions
whisper_memo-0.1.0.tar.gz 106.2 kB Without provenance Details for whisper_memo-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for whisper-memo 0.1.0
File Interpreter ABI Platform Actions
whisper_memo-0.1.0-py3-none-any.whl Python 3 none any Details for whisper_memo-0.1.0-py3-none-any.whl

Total release size: 114.4 kB

Release files / whisper_memo-0.1.0.tar.gz

Download URL whisper_memo-0.1.0.tar.gz
Size 106.2 kB
Tags Source
SHA-256 checksum
How to use checksums
abff332c9ba41aa1dc898eaf6480975526bab55bf896b8e902404995c9f7f48b
BLAKE2b-256 checksum
How to use checksums
194ce7c87e002f3ebb6c1c02ff48177e4497b7ca30b197f2e803b1c0100b4497
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / whisper_memo-0.1.0-py3-none-any.whl

Download URL whisper_memo-0.1.0-py3-none-any.whl
Size 8.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dadc8e75a2ea0b23201822aaa6e517b8acbf0f0c5f78a800cd213d973711d118
BLAKE2b-256 checksum
How to use checksums
a427c605c27a1881847f31969fdc106ae36b9e3ec1bad340c85b251f11b010fb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for whisper-memo 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page