Add comprehensive README

README.md

@@ -1,12 +1,109 @@
 ---
-title: SoundForge Studio
-emoji: 🐢
-colorFrom: yellow
-colorTo: pink
+title: 🎛️ SoundForge Studio
+emoji: 🎛️
+colorFrom: blue
+colorTo: purple
 sdk: gradio
-sdk_version: 6.13.0
+sdk_version: "4.44.1"
 app_file: app.py
-pinned: false
+pinned: true
+license: mit
+short_description: "Copyright-Free Audio • Remix • Mashup"
+tags:
+  - audio
+  - music
+  - remix
+  - mashup
+  - copyright-free
+  - stem-separation
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🎛️ SoundForge Studio
+
+**Professional Copyright-Free Audio Processing Suite**
+
+Make any song copyright-free for YouTube, create custom remixes, build multi-track mashups, and separate audio stems — all in one powerful web application.
+
+---
+
+## 🚀 Features
+
+### 🔓 Copyright-Free Processing
+Transform any song into a copyright-free version using an 8-step fingerprint modification pipeline:
+1. **Stem Separation** — Splits audio into vocals, drums, bass, and melody
+2. **Per-Stem Micro-Pitch Shifting** — Different subtle shifts per element
+3. **Micro-Tempo Adjustment** — Barely perceptible speed changes
+4. **EQ Profile Shift** — Subtle frequency balance changes per stem
+5. **Spatial Modification** — Reverb and stereo field changes
+6. **Texture Addition** — Envelope-shaped micro-noise layer
+7. **Micro-Timing Offsets** — Sample-level timing shifts between stems
+8. **Professional Mastering** — Normalize, limit, and stereo-widen
+
+### 🎚️ Remix Engine
+Full control over every element:
+- Individual stem volume control (Vocals, Drums, Bass, Melody)
+- Vocal pitch shifting (±12 semitones)
+- BPM/tempo adjustment
+- Professional effects: Reverb, Chorus, Delay
+- 3-band parametric EQ
+
+### 🔀 Mashup Creator
+Combine up to **6 songs** simultaneously:
+- **Layered** — Vocals from Track A + Instrumental from Track B
+- **Sequential** — Tracks with smooth crossfades
+- **Blend** — All tracks mixed at custom volumes
+- **Alternating** — Switches between tracks every 8 seconds
+- Auto BPM & key matching
+
+### 🎤 Stem Separator
+Split any song into 5 components:
+- 🎤 Vocals
+- 🥁 Drums (Percussive)
+- 🎸 Bass
+- 🎹 Other/Melody
+- 🎸 Full Instrumental
+
+### 📊 Audio Analyzer
+Professional audio analysis:
+- BPM detection
+- Musical key detection (Krumhansl-Schmuckler algorithm)
+- Spectral analysis (centroid, bandwidth, rolloff)
+- Duration and sample rate
+
+### 📦 Batch Processor
+Process multiple files at once with identical settings.
+
+---
+
+## 🛠️ Tech Stack
+
+| Component | Library |
+|-----------|---------|
+| UI Framework | Gradio 4.x |
+| Audio Analysis | librosa |
+| Effects Processing | Spotify Pedalboard |
+| Audio I/O | soundfile, pydub |
+| Signal Processing | scipy |
+| Stem Separation | HPSS (Harmonic-Percussive) |
+
+---
+
+## 📋 How to Use
+
+1. **Copyright-Free**: Upload → Click "One-Click Copyright-Free" → Download
+2. **Remix**: Upload → Adjust sliders → Click "Create Remix" → Download
+3. **Mashup**: Upload 2-6 tracks → Choose mode → Click "Create Mashup" → Download
+4. **Stems**: Upload → Click "Separate Stems" → Download individual stems
+5. **Analyze**: Upload → Click "Analyze Track" → View results
+
+---
+
+## ⚠️ Disclaimer
+
+This tool modifies audio fingerprints for creative and fair use purposes. Always ensure you have the right to use and modify the audio content. Results may vary depending on platform-specific content detection systems.
+
+---
+
+## 📄 License
+
+MIT License