millet-record

Lightweight capture-only subset of millet (formerly meetscribe-record).

Records dual-channel meeting audio — your microphone on the left channel, system/remote audio on the right — into a single stereo WAV via PipeWire or PulseAudio + ffmpeg. Ships none of millet's transcription, diarization, summarization, or PDF dependencies; install footprint is ~30 MB instead of ~3 GB.

Full release history in CHANGELOG.md. Named after the Ottoman millet system. Part of the vezir ecosystem.

When to use which

Need Install
Just record audio (e.g., for vezir thin clients, or local archival) pip install millet-record
Record + transcribe + diarize + summarize + PDF pip install millet-pipeline (depends on millet-record)

Install

pip install millet-record

System deps (apt example):

sudo apt install ffmpeg pulseaudio-utils

CLI

millet check                   # verify prerequisites
millet devices                 # list audio sources
millet record                  # record dual-channel WAV; Ctrl+C to stop
millet archive                 # compress past WAV recordings to OGG/Opus
millet request-permissions     # macOS Sequoia 15+: trigger Microphone /
                               # System Audio Recording TCC prompts
                               # (Apple removed the manual '+' button in
                               # System Settings, so apps must request)

millet record writes to ~/millet-recordings/meeting-YYYYMMDD-HHMMSS/...wav unless -o is passed. See millet record --help for options.

When millet-pipeline is also installed, additional subcommands (transcribe, run, label, sync, gui, ...) become available under the same millet command via Click entry-points.

Legacy meet command

The pre-rename meet console script keeps working for two minor versions (until millet-record 0.6.0). It prints a deprecation warning on each invocation and forwards to the millet group. Set MILLET_SUPPRESS_DEPRECATION=1 to silence the warning during transition.

Architecture

millet-record exposes a stable package millet_record containing:

  • millet_record.capture — ffmpeg-backed dual-channel capture (RecordingSession, watchdog, drain buffer)
  • millet_record.audio — stereo channel reading + ffmpeg-based audio compression
  • millet_record.utils — formatting helpers (HH:MM:SS, file sizes)
  • millet_record.languages — language constants used by capture flow
  • millet_record.cli — millet console-script entry point

The legacy meet_record package name is still importable via a sys.modules alias + a meta-path finder, so existing from meet_record.X import … keeps working unchanged. Removed in millet-record 0.6.0.

millet-pipeline depends on this package and re-uses these modules, plus its own heavy modules (transcribe, label, voiceprint, summarize, sync, pdf, gui).

macOS (Apple Silicon)

pip install millet-record on macOS 14.4+ Apple Silicon ships a bundled meet-record-mac Swift sidecar that captures via Core Audio Process Tap + AVAudioEngine — no PulseAudio, no BlackHole, no extra install. millet record uses it by default.

Note: the Swift binary itself is still named meet-record-mac for now — renaming would require macOS code-signing bundle-path changes that aren't worth doing as part of the package rename. Tracked as a follow-up; doesn't affect end users.

First run prompts for Microphone and System Audio Recording permissions via the standard macOS TCC dialogs; both are required for full dual- channel capture (mic on left, system on right). See mac/README.md for the sidecar's CLI surface, level analysis recipes, and environment variables.

On macOS Sequoia 15+, Apple removed the manual + button from System Settings → Privacy → Microphone, so users can no longer add permissions before running the app. The millet request-permissions subcommand explicitly calls AVCaptureDevice.requestAccess(for: .audio) to trigger the TCC dialog. millet check will tell you which permission is missing and suggest running request-permissions.

Set MEET_RECORD_MAC=0 to force the legacy ffmpeg+PulseAudio path (diagnostic kill switch only — that path will fail on a stock macOS install because there is no PulseAudio device). Intel Macs and macOS < 14.4 are unsupported.

License

GPL-3.0-or-later, same as parent millet.

Project links

Data verified by PyPI on Jul 6, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for pretyflaco from gravatar.com pretyflaco

Credits

Author: pretyflaco

GitHub Statistics

Data verified by PyPI on Jul 6, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

GNU General Public License v3 or later (GPLv3+) (GPL-3.0-or-later)

Requires

Python <3.14, >=3.10

Provides Extra

dev

Tags

meeting recording audio ffmpeg pipewire pulseaudio core-audio scribe thin-client

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

millet_record-0.5.0.tar.gz (45.8 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

millet_record-0.5.0-py3-none-macosx_14_0_arm64.whl (129.1 kB view details)

Uploaded Python 3macOS 14.0+ ARM64

millet_record-0.5.0-py3-none-any.whl (129.1 kB view details)

Uploaded Python 3

File details

Details for the file millet_record-0.5.0.tar.gz.

File metadata

  • Download URL: millet_record-0.5.0.tar.gz
  • Upload date:
  • Size: 45.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for millet_record-0.5.0.tar.gz
Algorithm Hash digest
SHA256 de60d26bfd7cc829e44c3a204ea52386a86bd103f48b796895985e1a99bd1487
MD5 1c58a175156b8ac778859511e490fd09
BLAKE2b-256 aefcc5069f93e9a029f60c19fadcb0cc723c40f8d49c692a97aab85077ced937

See more details on using hashes here.

Provenance

The following attestation bundles were made for millet_record-0.5.0.tar.gz:

Publisher: release.yml on pretyflaco/millet-record

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file millet_record-0.5.0-py3-none-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for millet_record-0.5.0-py3-none-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 93f600539ad83d8849c8eba8a40827fdb1cdf3954c8c92e07ef8391d68f521cf
MD5 d76092ae56a17ef2dd21c1865d4cade7
BLAKE2b-256 925894bbbb3491139dccc02597c4b1f77426874bb2089cdc5ab78ec4305b5d87

See more details on using hashes here.

Provenance

The following attestation bundles were made for millet_record-0.5.0-py3-none-macosx_14_0_arm64.whl:

Publisher: release.yml on pretyflaco/millet-record

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file millet_record-0.5.0-py3-none-any.whl.

File metadata

  • Download URL: millet_record-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 129.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for millet_record-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b12cc252e755138f9b66237ec0ed754440b8cb32038eb046bfa52310edc08e83
MD5 2971347d183d3fd51fc233982f0c5409
BLAKE2b-256 b7e4b38d15ee23a2fa46b2a2120579f2408abdceb39642251d9803eb95015ce3

See more details on using hashes here.

Provenance

The following attestation bundles were made for millet_record-0.5.0-py3-none-any.whl:

Publisher: release.yml on pretyflaco/millet-record

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page