🎧 Air DJ

Control a DJ interface using hand gestures through your webcam.

• Track Progress Bars: Real-time position with time display (mm:ss)
• Jog Wheel Indicators: Moving position markers
• Stem Status Display: Visual confirmation of vocal/instrumental state
• Independent Visualization: Each deck shows separate progress

• Python 3.9 - 3.12 (MediaPipe compatibility requirement)
• 64-bit Operating System (Windows/macOS/Linux)
• Webcam (built-in or external)
• Audio files with stems (see "Add Your Music" section below)

⚠️ Important: Python 3.13+ and Python 3.8 are not supported due to MediaPipe compatibility.

1. Clone the repository:

   git clone https://github.com/pattssun/air-dj.git
   cd air-dj

2. Create virtual environment:

   python -m venv venv
   source venv/bin/activate

3. Install dependencies:

   pip install -r requirements.txt

1. Clone the repository:

   git clone https://github.com/pattssun/air-dj.git
   cd air-dj

2. Create virtual environment:

   python -m venv venv
   venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

source venv/bin/activate
python air_dj.py

venv\Scripts\activate
python air_dj.py

Air DJ works with stem-separated audio files (vocals + instrumental tracks).

Complete Music Setup Guide →

Quick Start:

1. Try it immediately: Run python air_dj.py - includes 2 copyright-free example songs!
2. Add your music: Get stem-separated songs from fadr.com (free AI separation)
3. Create folders in songs/ directory: Artist - Song Name/
4. Add required files: Vocals - Song.mp3 and Instrumental - Song.mp3

python air_dj.py

Choose your songs from a numbered menu. BPM sync enabled by default.

python air_dj.py --default    # Skip song selection, use preset songs
python air_dj.py --unsync     # Disable BPM synchronization between decks

Air DJ is available under MIT License