58 lines
1.6 KiB
Markdown
58 lines
1.6 KiB
Markdown
# Call Recorder
|
||
|
||
Records microphone and system audio (everything playing on your speakers/headphones) into a single MP3 file — ideal for transcription with Whisper, Gemini, or similar services.
|
||
|
||
## Requirements
|
||
|
||
- Linux with PipeWire / PulseAudio
|
||
- `ffmpeg`
|
||
|
||
## Usage
|
||
|
||
```bash
|
||
# Start recording before your call
|
||
./record.sh
|
||
|
||
# Join your call normally, then press Ctrl+C when done.
|
||
# Recording is saved to recordings/call_YYYYMMDD_HHMMSS.mp3
|
||
```
|
||
|
||
### Check which inputs are active
|
||
|
||
```bash
|
||
./record.sh --show-inputs
|
||
```
|
||
|
||
Displays a live bar chart of both inputs in the terminal:
|
||
|
||
```
|
||
Mikrofon : [████████████░░░░░░░░░░░░░░░░░░] -18 dB
|
||
System Audio : [░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░] -60 dB
|
||
```
|
||
|
||
Colour coding: green (normal) → yellow (−12 dB) → red (−3 dB). Press Ctrl+C to exit.
|
||
|
||
### List available audio sources
|
||
|
||
```bash
|
||
./list-sources.sh
|
||
```
|
||
|
||
## How it works
|
||
|
||
`record.sh` detects the default PipeWire/PulseAudio sink, then runs `ffmpeg` to simultaneously capture:
|
||
|
||
- **Microphone** — PulseAudio default source
|
||
- **System audio** — monitor of the default sink (everything you hear)
|
||
|
||
Both streams are mixed and encoded as MP3 at 128 kbps (~11 MB / 15 min).
|
||
|
||
## Troubleshooting
|
||
|
||
**Missing system audio or microphone?**
|
||
Run `./list-sources.sh` to inspect available devices. The script auto-detects the default sink at startup — if you switched audio output after launching (e.g. plugged in headphones), restart the script.
|
||
|
||
## License
|
||
|
||
This project is licensed under the [GNU General Public License v3.0](LICENSE).
|