MixMatch is a modern web application that automatically masters your audio tracks to match professional reference tracks. Built with React, FastAPI, and the powerful Matchering library. https://scripty2k.github.io/MixMatch/
- Drag & Drop Upload: Intuitive file upload for target and reference tracks
- Automated Mastering: Uses the Matchering library for professional audio processing
- Real-time Progress: Visual feedback during processing
- Before/After Comparison: Toggle between original and mastered versions
- Waveform Visualization: See the audio waveform of your processed track
- One-Click Download: Export your mastered track instantly
- Dark Mode UI: Clean, modern interface with Deep Grey (#1a1a1b) and Vibrant Purple (#8b5cf6)
- React.js - Modern UI library
- Tailwind CSS - Utility-first styling
- Vite - Fast build tool
- react-dropzone - Drag & drop file upload
- Axios - HTTP client
- FastAPI - High-performance Python web framework
- Matchering - Audio mastering library
- librosa - Audio analysis and visualization
- Uvicorn - ASGI server
- Node.js (v16 or higher)
- Python (3.8 or higher)
- pip (Python package manager)
- FFmpeg (required by Matchering for audio processing)
macOS:
brew install ffmpegUbuntu/Debian:
sudo apt-get update
sudo apt-get install ffmpegWindows: Download from ffmpeg.org and add to PATH.
cd /Users/scripty/LocalDocuments/MixMatch/MixMatch# Navigate to backend directory
cd backend
# Create a virtual environment
python3 -m venv venv
# Activate virtual environment
# macOS/Linux:
source venv/bin/activate
# Windows:
# venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Create necessary directories
mkdir -p uploads processed# Navigate to frontend directory (from project root)
cd frontend
# Install dependencies
npm installcd backend
source venv/bin/activate # Activate virtual environment if not already active
python main.pyThe backend will start on http://localhost:8000
API Endpoints:
POST /mix- Upload and process audio filesGET /status/{job_id}- Check processing statusGET /download/{filename}- Download processed fileGET /health- Health check
cd frontend
npm run devThe frontend will start on http://localhost:5173
Open your browser and navigate to http://localhost:5173
-
Upload Files
- Drag & drop or click to select your Target Track (unmixed audio)
- Drag & drop or click to select your Reference Track (professional track to mimic)
-
Start Mastering
- Click the "Start Mastering" button
- Watch the progress bar as your audio is processed
-
Review Results
- Use the Before/After toggle to compare versions
- View the waveform visualization
- Play both versions using the built-in audio player
-
Download
- Click the "Download" button to save your mastered track
- The file will be saved as a WAV file
-
Master Another Track
- Click "Master Another Track" to start over
- MP3 (.mp3)
- WAV (.wav)
- FLAC (.flac)
- OGG (.ogg)
- M4A (.m4a)
Edit backend/main.py to modify:
- Port: Change
uvicorn.run(app, host="0.0.0.0", port=8000) - CORS origins: Update
allow_originslist - Upload directories: Modify
UPLOAD_DIRandPROCESSED_DIR
Edit frontend/src/App.jsx to modify:
- API URL: Change
API_BASE_URLconstant
The application uses a custom color scheme defined in tailwind.config.js:
colors: {
'deep-grey': '#1a1a1b', // Background color
'vibrant-purple': '#8b5cf6', // Accent color
}Modify these values to customize the theme.
Once the backend is running, visit:
- Swagger UI:
http://localhost:8000/docs - ReDoc:
http://localhost:8000/redoc
Error: matchering module not found
pip install matcheringError: FFmpeg not found
- Install FFmpeg following the instructions in Prerequisites
Error: Port 8000 already in use
- Change the port in
main.pyor kill the process using port 8000
Error: Dependencies not installed
cd frontend
npm installError: Cannot connect to backend
- Ensure backend is running on
http://localhost:8000 - Check CORS configuration in
backend/main.py
Error: Port 5173 already in use
- Vite will automatically try the next available port
- Or manually kill the process using port 5173
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
- Matchering - Audio mastering library
- FastAPI - Modern Python web framework
- React - UI library
- Tailwind CSS - CSS framework
- librosa - Audio analysis library
For issues and questions, please open an issue on the GitHub repository.
Built with ❤️ and 🎵