111 lines
2.5 KiB
Markdown
111 lines
2.5 KiB
Markdown
|
|
|
|
|
|
|
|
|
|
# Auto Clip 🎧✂️
|
|
|
|
Local, offline-friendly **DJ-style album teaser builder** using Python + FFmpeg.
|
|
|
|
This repository contains multiple versions of the Auto Clip workflow, each adding more intelligence and DJ-oriented features.
|
|
|
|
---
|
|
|
|
## 🚦 Roadmap
|
|
|
|
See the planned future development here:
|
|
- [V4 Roadmap](V4_ROADMAP.md)
|
|
|
|
---
|
|
|
|
## 📁 Repository structure
|
|
|
|
```
|
|
Auto Clip/
|
|
├── V_1/
|
|
├── V_2/
|
|
├── V_3/
|
|
├── README.md ← this file
|
|
├── README_EN.md
|
|
└── README_DA.md
|
|
```
|
|
|
|
- **V_1** — Minimal MVP / proof-of-concept
|
|
- **V_2** — Track selection, best-of mode, DJ ordering
|
|
- **V_3** — Harmonic mixing (Camelot), downbeat-ish snap, 2-pass loudness
|
|
|
|
---
|
|
|
|
## 📖 Documentation
|
|
|
|
Choose your preferred language:
|
|
|
|
- 🇬🇧 **English documentation** → [README_EN.md](README_EN.md)
|
|
- 🇩🇰 **Dansk dokumentation** → [README_DA.md](README_DA.md)
|
|
|
|
Each language README contains:
|
|
- Full explanation of V_1 / V_2 / V_3
|
|
- Install instructions
|
|
- Usage examples
|
|
- DJ / trance tuning tips
|
|
- Limitations and troubleshooting
|
|
|
|
---
|
|
|
|
## 🎶 What is Auto Clip?
|
|
|
|
Auto Clip scans a folder of audio tracks and automatically creates a **short DJ-style teaser** by:
|
|
|
|
- Finding musical highlights
|
|
- Snapping cuts to bar/phrase boundaries
|
|
- Optionally applying harmonic (Camelot) ordering
|
|
- Rendering a smooth teaser with crossfades
|
|
- Exporting WAV + MP3 plus a detailed JSON report
|
|
|
|
It is designed for:
|
|
- DJs
|
|
- Producers
|
|
- Album / EP promo teasers
|
|
- Old school trance & electronic music
|
|
|
|
Everything runs **locally** — no cloud, no uploads.
|
|
|
|
---
|
|
|
|
## 🤖 Optional: Ollama integration
|
|
|
|
If you run Ollama locally, Auto Clip can optionally generate:
|
|
- README content
|
|
- Promo text (SoMe / YouTube)
|
|
- Tracklists with timestamps
|
|
|
|
Recommended model:
|
|
- `llama3.1:8b-instruct-q4_0`
|
|
|
|
Ollama is **optional** and not required for audio processing.
|
|
|
|
---
|
|
|
|
## 🚀 Quick start (example)
|
|
|
|
```bash
|
|
cd V_3
|
|
python dj_teaser_v3.py --tracks-dir ./tracks --select all --teaser 60 --bars 2 --preroll-bars 1 --avoid-intro 30 --harmonic
|
|
```
|
|
|
|
---
|
|
|
|
## 📜 License
|
|
|
|
Choose the license that fits your project (MIT is commonly used).
|
|
|
|
---
|
|
|
|
## ❤️ Credits
|
|
|
|
- FFmpeg
|
|
- librosa
|
|
- numpy
|
|
|
|
Built for DJs who like automation, control, and clean signal paths.
|