Skip to main content

USB Audio Transcriber

Plug in a voice recorder. Walk away. Come back to timestamped, searchable notes and a summary of the whole session.

A free, open-source Linux utility that turns a cheap USB voice recorder (or any synced folder of voice memos) into a hands-off note-taking system. Plug the recorder in and, within seconds, it finds the new recordings, copies them to a checksum-verified archive, transcribes them locally with faster-whisper, and writes timestamped Markdown notes straight into your Obsidian vault or any notes folder. Recordings that a voice-activated recorder split into a dozen files are stitched back into one session note in the right order, with an optional AI summary from a tool you already pay for (Codex, Claude Code), a local Ollama model, or OpenRouter.

Nothing is uploaded: transcription runs on your own CPU, no GPU required.

Install

sudo apt install pipx ffmpeg zenity libnotify-bin      # Debian/Ubuntu names
pipx install usb-audio-transcriber
usb-audio-transcriber install

install creates ~/.local/share/usb-audio-transcriber/config.env, asks where your notes should go (it finds your Obsidian vaults), enables the background service and the plug-in trigger, and adds USB Audio Transcriber to your app menu: a control panel with the pipeline's state, sessions with a Summarize button, search, and every setting as a form. Everything in the panel is also a command:

usb-audio-transcriber doctor            # check the installation
usb-audio-transcriber sessions list     # session notes
usb-audio-transcriber search roof leak  # every matching moment, newest first
usb-audio-transcriber panel open        # the control panel
usb-audio-transcriber update            # pipx upgrade, then install again

Speaker labels need the optional extra: pipx install "usb-audio-transcriber[diarization]".

Full documentation, the recorder that was tested, and the summary workflow: https://github.com/aaacharlie/usb-audio-transcriber.

Metadata

Release files for usb-audio-transcriber 1.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 usb-audio-transcriber 1.1.0
File Size Uploaded
usb_audio_transcriber-1.1.0.tar.gz 153.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for usb-audio-transcriber 1.1.0
File Interpreter ABI Platform
usb_audio_transcriber-1.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 249.3 kB

Release files / usb_audio_transcriber-1.1.0.tar.gz

Download URL usb_audio_transcriber-1.1.0.tar.gz
Size 153.5 kB
Tags Source
SHA-256 checksum
How to use checksums
5dccbaa69926a82e73393efe6026ae32fb6c2ddf0769a912d82862c64b8f1be7
BLAKE2b-256 checksum
How to use checksums
232056db85042cd39b124533f662faf4e847781cc62bf94c41cfb23c6f0a266d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 6, 2026.

Transparency log

Release files / usb_audio_transcriber-1.1.0-py3-none-any.whl

Download URL usb_audio_transcriber-1.1.0-py3-none-any.whl
Size 95.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
50ca211ee16c907b3539e7d9f9e38d233b9d4bff2b8bf9d19334591236c1e1e3
BLAKE2b-256 checksum
How to use checksums
c6253749790171a6ab63ddf082cb8e1458b52099259d44e17bb4044597b79b96
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 6, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files

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