First Upload

All Files

README.md

@@ -0,0 +1,103 @@
+![Python](https://img.shields.io/badge/python-3.10%2B-blue)
+![FFmpeg](https://img.shields.io/badge/ffmpeg-required-red)
+![Local Only](https://img.shields.io/badge/local--only-no--cloud-success)
+![DJ Tools](https://img.shields.io/badge/DJ-tools-purple)
+
+# 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.
+
+---
+
+## 📁 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.