How OpenKeyScan finds the key

OpenKeyScan turns a track into a spectrogram, a picture of which notes sound when, and a convolutional neural network reads that picture to score all 24 major and minor keys. Everything runs offline on your computer.

Derezzed (Remixed by The Glitch Mob)

Daft Punk · TRON: Legacy Reconfigured · MP3

2A 7m · E♭ minor

Constant-Q spectrogram

What the network sees

Constant-Q spectrogram of Daft Punk, Derezzed (Remixed by The Glitch Mob), as computed by the OpenKeyScan analyzer

Network output

Score for each of the 24 keys

  1. 1A
  2. 95.3%2A
  3. 3A
  4. 4A
  5. 5A
  6. 6A
  7. 7A
  8. 8A
  9. 9A
  10. 10A
  11. 11A
  12. 12A
  13. 1B
  14. 3.4%2B
  15. 3B
  16. 4B
  17. 5B
  18. 6B
  19. 7B
  20. 8B
  21. 9B
  22. 10B
  23. 11B
  24. 12B

Camelot wheel

Compatible keys outlined

1B1A2B2A3B3A4B4A5B5A6B6A7B7A8B8A9B9A10B10A11B11A12B12A
Real output from the OpenKeyScan analyzer, not an illustration. The network scored 2A at 95.3%.

From audio file to key tag in four steps

  1. 1Decode

    The file is decoded and mixed down to mono at 44.1 kHz. MP3, FLAC, WAV, AIFF and the rest all take the same path from here.

  2. 2Constant-Q spectrogram

    The audio becomes 105 frequency rows, two per semitone, starting at C2 and spanning over four octaves. Each column covers 0.2 seconds.

  3. 3Convolutional network

    A network based on Korzeniowski & Widmer (ISMIR 2018) reads the whole spectrogram and scores every key. It learns harmonic patterns, so drums and noise carry little weight.

  4. 4Key and tag

    The top-scoring key is written into the file's key tag in Camelot, Open Key or musical notation, ready for your DJ software.

Specs

Formats

Reads and tags all common audio formats.

  • MP3
  • FLAC
  • WAV
  • AIFF
  • M4A
  • AAC
  • OGG
  • MP4

Speed

Measured in the 2025 r/DJs community test.

414 files per minute

Private by design

No account and no uploads. The model ships inside the app and runs on your own CPU or GPU.

Network
Not used
Runs on
macOS, Windows

Local REST API

Send a file path, get the key back as JSON. API docs →

POST /analyze/single
{ "file": "/music/derezzed.mp3" }
→ { "key": "7m", "success": true }