Metadata-Version: 2.4
Name: meetscribe-record
Version: 0.1.0
Summary: Lightweight capture-only subset of meetscribe: record dual-channel meeting audio (mic + system) with no transcription/diarization/summarization deps.
Author: pretyflaco
License: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/pretyflaco/meetscribe-record
Project-URL: Repository, https://github.com/pretyflaco/meetscribe-record
Project-URL: Issues, https://github.com/pretyflaco/meetscribe-record/issues
Keywords: meeting,recording,audio,ffmpeg,pipewire,pulseaudio,scribe,thin-client
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Capture/Recording
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0
Requires-Dist: numpy>=1.20
Provides-Extra: dev
Requires-Dist: ruff; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Dynamic: license-file

# meetscribe-record

Lightweight capture-only subset of [meetscribe](https://github.com/pretyflaco/meetscribe).

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 meetscribe's transcription,
diarization, summarization, or PDF dependencies; install footprint is
~30 MB instead of ~3 GB.

## When to use which

| Need | Install |
|---|---|
| Just record audio (e.g., for [vezir](https://github.com/pretyflaco/vezir) thin clients, or local archival) | `pip install meetscribe-record` |
| Record + transcribe + diarize + summarize + PDF (full meetscribe) | `pip install meetscribe-offline` (depends on meetscribe-record) |

## Install

```bash
pip install meetscribe-record
```

System deps (apt example):

```bash
sudo apt install ffmpeg pulseaudio-utils
```

## CLI

```bash
meet check          # verify prerequisites
meet devices        # list audio sources
meet record         # record dual-channel WAV; Ctrl+C to stop
meet archive        # compress past WAV recordings to OGG/Opus
```

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

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

## Architecture

`meetscribe-record` exposes a stable package `meet_record` containing:

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

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

## License

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