Skip to content

README.md

Latest commit

 

History

History
71 lines (46 loc) · 1.45 KB

README.md

File metadata and controls

71 lines (46 loc) · 1.45 KB

AI-powered sample management for FL Studio
Scan → Analyze → Tag → Export. Stay in your flow.

🎨 UI Mockup

sample-brain UI

🚀 Features (MVP)

  • Scan: build a database from your sample library
  • Analyze: extract audio features (BPM, key, loudness, brightness, MFCCs, chroma …)
  • Autotype: automatic categorization (Kick, Snare, Pad, Drone, Impact …)
  • Export: write smart tags into the FL Studio Browser

🛠️ Setup

# Create virtual environment
python -m venv .venv
.venv\Scripts\activate   # Windows
source .venv/bin/activate # macOS/Linux

# Install dependencies
pip install -r requirements.txt

🏃 Quickstart

# Initialize DB
python -m src.cli init

# Scan sample folder (default in config.py)
python -m src.cli scan

# Analyze audio features
python -m src.cli analyze

# Autotype samples (rules only)
python -m src.cli autotype --no-knn

# Export tags to FL Studio
python -m src.cli export_fl "C:\Users\<username>\Documents\Image-Line"   # Windows
python -m src.cli export_fl "~/Documents/Image-Line"               # macOS/Linux

📚 Documentation

⚖️ License

MIT License – free to use, hack and share.
Dependencies: see THIRD_PARTY_LICENSES.md.

🎧 Your sound. Your flow.