https://github.com/iskoldt-x/dr-lrc
A Python script to download DR LYD audio, generate subtitles using Whisper, convert the subtitles to LRC lyrics format, and embed these lyrics into the MP3 file.
https://github.com/iskoldt-x/dr-lrc
danish danish-language gemma2 language-learning whisper
Last synced: about 1 month ago
JSON representation
A Python script to download DR LYD audio, generate subtitles using Whisper, convert the subtitles to LRC lyrics format, and embed these lyrics into the MP3 file.
- Host: GitHub
- URL: https://github.com/iskoldt-x/dr-lrc
- Owner: iskoldt-X
- License: mit
- Created: 2025-02-27T20:56:36.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2025-03-09T19:32:46.000Z (about 1 month ago)
- Last Synced: 2025-03-09T20:25:39.869Z (about 1 month ago)
- Topics: danish, danish-language, gemma2, language-learning, whisper
- Language: Python
- Homepage:
- Size: 10.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DR-LRC
A Python script to download **DR LYD** audio, generate subtitles using **Whisper**, convert the subtitles to LRC lyrics format, optionally translate them into any language via **Ollama** + **Gemma 2**, and embed these lyrics into the MP3 file.
> **Disclaimer:** This project is intended for educational and research purposes only. The author does not endorse or promote the unauthorized distribution of copyrighted content. Please respect the rights of content creators and only use this tool to download content that is freely available on the internet and use it for study Danish and only for personal use. The code was written by the help of ChatGPT.
## Features
- **Download DR LYD audio:** Scrapes a DR LYD program page to extract the m3u8 URL and downloads the audio as an MP3 file using ffmpeg.
- **Convert audio for Whisper:** Converts the downloaded MP3 file to WAV (mono, 16 kHz) for compatibility with Whisper.
- **Generate subtitles:** Uses Whisper CLI to generate an SRT subtitle file from the WAV file.
- **Convert SRT to LRC:** Converts the generated SRT file into LRC (lyric) format.
- **Embed lyrics:** Embeds the LRC lyrics into the MP3 file using ID3 tags.
- **(Optional) Generate a translated copy:** If you pass a second argument (either `translate` or a specific language name), a second MP3 is created containing Danish + translation.
- **Cleanup:** Removes intermediate files (WAV, SRT, LRC) so that only the final MP3 remains.
## Requirements
- Python 3.11+
- [ffmpeg](https://ffmpeg.org/) must be installed and in your system PATH.
- [whisper-cli](https://github.com/ggerganov/whisper.cpp) must be installed. You can see the installation instructions for each platform in the repository.
- `./build/bin/whisper-cli` must be in your system PATH.
- Environment variable `WHISPER_MODEL_PATH` must be set to the path of your Whisper model file (e.g., `ggml-medium.bin`).
- (Optional) Translation: If you plan to use the translate feature, you need Ollama and the Python ollama client installed, as well as an available model (e.g. `gemma2`).
## Installation
1. **Clone the repository:**
```bash
git clone https://github.com/iskoldt-X/DR-LRC.git
cd DR-LRC
```
2. **Install the required Python packages:**
```bash
pip install -r requirements.txt
```
3. **Set up the Whisper model path in your shell.**
For example, if you are using zsh on macOS, add the following line to your `~/.zshrc` file:
```bash
export WHISPER_MODEL_PATH=/path/to/your/ggml-medium.bin
```
Replace `/path/to/your/ggml-medium.bin` with the path to your Whisper model file.
Then, reload your shell configuration:
```bash
source ~/.zshrc
```
## Usage
Run the script from the command line by providing a DR LYD URL:
```bash
python3 dr_lrc.py https://www.dr.dk/lyd/special-radio/tiden/tiden-2025/tiden-300-000-soldater-i-underskud-telefonfri-skole-og-et-ulvemoede-11802551038
```
The script will:
1. Download the audio and convert it to MP3.
2. Convert the MP3 to WAV for transcription.
3. Run whisper-cli to generate an SRT subtitle file.
4. Convert the SRT file to LRC lyrics.
5. Embed the LRC lyrics into the MP3.
6. Delete intermediate files, leaving only the final MP3 file.
### Translation
You can optionally add a second argument to request translation into a specific language. For example, if you run:
```bash
python3 dr_lrc.py French
```
It will create a second MP3 containing Danish + French lyrics embedded. The main MP3 remains Danish-only.
If you include the word translate as the second argument, the script will default to English. For instance:
```bash
python3 dr_lrc.py translate
```
You will end up with two MP3s:
The original MP3 (with Danish-only lyrics).
A second MP3 named something like dr_output_translated.mp3, containing “Danish / English” lines.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Acknowledgements
- [DR LYD](https://www.dr.dk/lyd)
- [Whisper](https://github.com/openai/whisper)
- [whisper.cpp](https://github.com/ggerganov/whisper.cpp)
- [ffmpeg](https://ffmpeg.org/)
- [mutagen](https://github.com/quodlibet/mutagen)
- [Ollama](https://ollama.com)
- [Gemma 2](https://ollama.com/library/gemma2:9b)