NXTCue for macOS
=================

AI-powered next track recommendations for DJs.

NXTCue detects the track currently playing in your DJ software and asks a
selected AI model for ranked, transition-oriented next-track suggestions.
It does not import your music library.


Requirements
------------
- macOS 12 or newer (Apple Silicon or Intel)
- Internet access for activation, license validation, and AI recommendations
- A Gumroad license key from your purchase
- A Tinker or OpenAI API key for recommendations (configured inside the app)


Getting started
---------------
1. Open NXTCue from Applications.
2. Enter the license key from your purchase receipt and click Activate NXTCue.
3. Open Configuration (gear icon or Command+,).
4. Select an AI model and enter the matching API key:
   - Thinking Machines models: Tinker API key
   - OpenAI models: OpenAI API key
5. Start playback in your DJ software.
6. Click Suggest tracks, or enable Auto suggest tracks in Configuration.

For rekordbox deck detection, grant Accessibility access:
System Settings → Privacy & Security → Accessibility → enable NXTCue.


Supported DJ software
-----------------------
- Apple Music / Music app (via macOS Now Playing)
- Spotify (via macOS Now Playing)
- Serato DJ Pro / Lite
- rekordbox (Accessibility deck metadata)
- VirtualDJ
- djay Pro
- Mixxx

Track detection uses macOS media sessions and, where available, direct
read-only metadata from the supported applications listed above.


Optional audio analysis
-----------------------
If essentia_streaming_extractor_music is installed and available on PATH
(or set through ESSENTIA_EXTRACTOR), NXTCue can analyze a short audio
sample locally to improve BPM and key information. Essentia is optional
and typically also needs ffmpeg plus a loopback device such as BlackHole.


License management
------------------
One license seat can be active on one Mac at a time.

To move your license to another computer:
Configuration → License → Deactivate this device

Activation data is stored in:
~/Library/Application Support/NXTCue/activation.json

Application settings are stored in:
~/Library/Application Support/NXTCue/config.json


Help and support
----------------
Website:         https://www.nxtcuedj.com
Troubleshooting: https://nxtcuedj.com/help

For usage examples and troubleshooting tips, see the help page above.


Privacy note
------------
NXTCue sends current-track metadata and recommendation settings to the
AI provider you choose. Activation requests are sent to the NXTCue
activation server over HTTPS. Your license key is not stored locally
after activation; only the returned activation token is saved.

See DISCLAIMER.txt for additional terms and limitations.
