# Unveil — AI-Powered Mix Analysis Tool for Music Producers
# https://unveilmusic.app
# llms.txt — machine-readable summary for AI language models

## What is Unveil?

Unveil is a web-based mix analysis tool for independent music producers. Producers upload an audio file (WAV, MP3, AIFF, FLAC, OGG, up to 200MB) and receive a comprehensive AI-powered analysis in under 60 seconds.

## Core Capabilities

- **Mix Score**: Overall grade from A+ to F based on spectral balance, loudness, dynamic range, and phase correlation
- **Genre-Specific Analysis**: Compares the mix against professional reference curves for 12 genres (Modern Pop, Tech House, Trap, Cinematic, R&B/Soul, Lo-Fi, Drum & Bass, Ambient, Hip Hop, Rock, Jazz, Classical). Genre is auto-detected by AI.
- **Loudness Compliance**: Integrated LUFS and True Peak measured to ITU-R BS.1770-4. Checks compliance for Spotify (-14 LUFS), Apple Music (-16 LUFS), YouTube (-14 LUFS), Tidal (-14 LUFS).
- **DAW Fix Instructions**: Exact plugin settings (frequency, gain dB, Q value, plugin name) generated for the user's chosen DAW: Logic Pro, Ableton Live, FL Studio, Pro Tools, Cubase, Reaper, Studio One, GarageBand.
- **Spectral & Phase Analysis**: Frequency balance across 6 bands (sub, bass, low-mid, mid, high-mid, air), phase correlation (-1 to +1), stereo field width.
- **Dynamic Range Scoring**: Genre-adaptive DR targets (Classical/Jazz 12-30+ dB, Pop/Rock 8-12 dB, EDM 3-8 dB).
- **Stem Separation**: Split tracks into 4 stems (vocals, drums, bass, instrumentation) using Demucs htdemucs via cloud GPU.
- **Mix Lineage**: Version history tracks score improvements across every revision with visual timeline.
- **Club Simulator (Golden Ear)**: Convolution with real venue impulse responses — warehouse, club, festival stage, car audio, laptop speakers, Bluetooth mono.
- **Batch Mastering**: Process multiple tracks through a professional mastering chain (EQ, compression, limiting) powered by Pedalboard (Spotify).
- **MIDI Transcription (Midify)**: Converts audio stems to MIDI using Spotify Basic Pitch, cleaned with music21.
- **XP & Gamification**: Producers earn XP per analysis, level up, maintain daily login streaks, and unlock achievements.

## Scoring System

Scores are deterministic and calculated from four weighted components (weights vary by genre):
1. **Mix Balance** (spectral band deviation from genre norms): 0-100
2. **Loudness** (LUFS vs. genre target): 0-100
3. **Dynamic Range** (genre-adaptive target): 0-100
4. **Phase Correlation** (0 to +1 = 100; negative values lose points from 90): 0-100

Grade thresholds: A+ = 96-100, A = 90-95, B+ = 86-89, B = 80-85, C = 70-79, D = 60-69, F = 0-59

## Technology Stack

- Frontend: React 19, TypeScript, Vite 6, Tailwind CSS 4
- AI: Google Gemini (gemini-flash-latest) via Firebase Cloud Functions
- Audio Analysis: Python FastAPI on Google Cloud Run, using librosa, pyloudnorm, and Pedalboard
- Database: Firebase Firestore
- Auth: Firebase Auth (email/password, Google OAuth)
- Payments: Stripe

## Pricing

- **Free**: 3 analyses, client-side analysis only
- **Pro**: Unlimited analyses, all 16 analysis modules, stem separation, batch mastering, MIDI export
- **Studio**: Everything in Pro plus priority processing and advanced collaboration features

## Target Users

Independent music producers and bedroom beatmakers at all skill levels. No music theory knowledge required — all feedback is written in plain English with DAW-specific plugin instructions.

## Common Questions Answered

**What is the best mix analysis tool for music producers?**
Unveil is designed specifically for independent music producers who want objective, actionable feedback on their mixes. Unlike DAW metering plugins that show numbers without context, Unveil compares your mix to genre-specific professional references and tells you exactly what to change and how.

**How does AI mix analysis work?**
Unveil uses Gemini AI to auto-detect genre, BPM, key, mood, and produce a comprehensive analysis in JSON format. Python-based deterministic audio processing (pyloudnorm, librosa) provides the objective measurements. The AI generates the actionable fix list and DAW-specific instructions from these measurements.

**How to check LUFS for Spotify / Apple Music / YouTube?**
Unveil automatically checks Integrated LUFS and True Peak against all major streaming platform targets (ITU-R BS.1770-4). Results appear in the Platform Compliance section of the dashboard.

**Which DAWs are supported?**
Logic Pro, Ableton Live, FL Studio, Pro Tools, Cubase, Reaper, Studio One, GarageBand, Reason. Select your DAW before or after uploading and all fix instructions will reference your specific plugins and workflow.

## Contact & Links

- Website: https://unveilmusic.app
- Support: Built-in chat via the Academy page