SortMyMix

Sort your Spotify playlists by BPM and harmonic key using the Camelot Wheel for perfect DJ-style mixing.

Features

• BPM Sorting - Organize tracks by tempo for smooth energy transitions
• Harmonic Mixing - Use the Camelot Wheel for seamless key-matched transitions
• Smart Preview - See before/after comparison with harmonic score analysis
• Direct Spotify Integration - Sort existing playlists without creating duplicates
• Progressive Web App - Install on your device for offline access

How It Works

1. Connect your Spotify account
2. Select a playlist to sort
3. Preview the optimized order with BPM and key info
4. Apply the sort to update your Spotify playlist

BPM & Key Data

BPM and musical key are looked up in order:

1. GetSongBPM (primary) — requires free API key from getsongbpm.com
2. AcousticBrainz (fallback) — free, no key needed

Without a GetSongBPM key, only AcousticBrainz is used (smaller coverage).

Sorting Algorithm

Tracks are sorted using a two-pass algorithm:

1. Primary Sort: Group tracks by BPM ranges (5 BPM buckets)
2. Secondary Sort: Within each BPM group, sort by Camelot wheel position
3. Optimization: Smooth transitions between BPM groups using harmonic compatibility

Setup

Prerequisites

• Node.js 18+
• A Spotify Developer account

Spotify App Configuration

Note (Feb 2026): Spotify updated Development Mode — Premium account, up to 5 users, and one Client ID per developer may be required for Development Mode apps.

1. Go to the Spotify Developer Dashboard
2. Create a new app
3. Add http://localhost:5173/SortMyMix/callback as a Redirect URI (for development)
4. Add https://YOUR_USERNAME.github.io/SortMyMix/callback as a Redirect URI (for production)
5. Copy your Client ID

Environment Variables

Create a .env.local file in the project root:

VITE_SPOTIFY_CLIENT_ID=your_spotify_client_id
VITE_SPOTIFY_REDIRECT_URI=http://localhost:5173/SortMyMix/callback

# Optional: GetSongBPM API key for BPM/key lookup (primary source)
# Register at https://getsongbpm.com/api — backlink to GetSongBPM.com required
VITE_GETSONGBPM_API_KEY=your_getsongbpm_api_key

For production, you can also set the redirect URI:

VITE_SPOTIFY_REDIRECT_URI=https://YOUR_USERNAME.github.io/SortMyMix/callback

Installation

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

PWA Features

SortMyMix is a Progressive Web App with the following capabilities:

• Installable - Add to home screen on mobile or desktop
• Offline Support - Core app works without internet
• Caching - Spotify album artwork is cached for faster loading
• Auto Updates - Service worker updates automatically

Generating PNG Icons (Optional)

For better browser compatibility, you can generate PNG icons:

npm install -D sharp
node scripts/generate-icons.js

Then update vite.config.ts to use PNG icons in the manifest.

Deployment

This project is configured for GitHub Pages deployment:

1. Push to the main branch
2. The GitHub Action will automatically build and deploy
3. Access at https://YOUR_USERNAME.github.io/SortMyMix/

Manual Deployment

npm run build
# Deploy the `dist` folder to your hosting

Tech Stack

• Vue 3 with Composition API
• TypeScript for type safety
• Vuestic UI component library
• Pinia for state management
• Vue Router for navigation
• Vite for blazing fast builds
• vite-plugin-pwa for PWA support

The Camelot Wheel

The Camelot Wheel is a harmonic mixing system used by professional DJs:

• Numbers (1-12): Represent musical keys
• Letters (A/B): A = Minor keys, B = Major keys
• Compatible mixes:
  • Same position (e.g., 8B → 8B)
  • Adjacent numbers (e.g., 8B → 7B or 9B)
  • Same number, different letter (e.g., 8B → 8A)

License

ISC