Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mtrnord/matrixliveprocessor
https://github.com/mtrnord/matrixliveprocessor
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/mtrnord/matrixliveprocessor
- Owner: MTRNord
- License: apache-2.0
- Created: 2024-12-14T00:10:39.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2024-12-14T01:05:03.000Z (about 1 month ago)
- Last Synced: 2024-12-22T16:55:39.617Z (about 1 month ago)
- Language: Python
- Size: 11.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Matrix Live Processor
Small script which ensures a somewhat consistent matrix live experience.
## Features
- Audio normalization to -16 LUFS
- Optional Whisper subtitle generation
- Whisper subtitle based show notes
## Requirements
- Python 3.12+
- ffmpeg
- ffmpeg-normalize
- whisper
## Installation
```bash
pip install -r requirements.txt
```
## Usage
```bash
python matrix_live_processor.py ./input.mp4 ./output.mp4 --use-whisper --model-name medium --language en
```
### Arguments
- `input_file`: The input file to process
- `output_file`: The output file to write to (video filename)
- `--use-whisper`: Enable whisper subtitle generation
- `--burn-subtitles`: Burn the generated subtitles into the video
- `--show-notes`: Generate show notes based on the generated subtitles. Requires ollama to be running.
- `--model-name`: The whisper model to use (default: `medium`). Check whispercpp for available models.
- `--language`: The language to use for whisper subtitle generation (default: `en`). Check whispercpp for available
languages.
- `--force`: Force overwrite of the output file if it already exists.
## Note
For best performance you should build the whisper lib manually. See https://github.com/abdeladim-s/pywhispercpp for
details.
## License
Apache 2.0