How gvayoy-web/poor-dj works
POOR DJ is a local Spotify DJ extension for Spicetify. Users choose known tracks or search for music, optionally set a reference or artist mode, then guide a session through local text commands and feedback. The engine proposes tracks, manages playback and the queue, and can narrate with local Spanish speech. The README documents broader capabilities such as library sync, profile import/export, and native transitions; those subsystems are represented, though their internal wiring is not fully shown in the sampled source.
Main entry points: core.js DJ engine · runtime.js Playback runtime · ui.js DJ interface · intent.js Command parsing
Components 17
User experience
- Extension entry
poor-mans-dj.js - DJ interface
src/ui.js
Music selection
- Command parsing
src/intent.js - Known-track choices
src/profile.js - Library sync
src/library.js - Artist mixes
src/artists.js - Candidate discovery
src/candidates.js
Session control
- DJ engine
src/core.js - Playback runtime
src/runtime.js - Playback guard
src/playback-guard.js - Voice and captions
src/narrator.js - Native transitions
src/transitions.js
Local data and integrations
- Acoustic analysis
src/music.js - Request cache
src/requests.js - Spotify and Spicetify
- Local profile
src/profile.js
Other components
- Listener
Connections 21
- Listener → DJ interface: directs session
README.md - Extension entry → Playback runtime: starts extension
src/runtime.js - Playback runtime → DJ interface: mounts interface
src/ui.js - DJ interface → Command parsing: submits instructions
README.md - DJ interface → DJ engine: controls session
src/ui.js - Command parsing → DJ engine: sets intent
README.md - DJ engine → Known-track choices: builds choices
src/core.js - DJ engine → Candidate discovery: requests candidates
src/core.js - DJ engine → Artist mixes: supports artist mode
README.md - DJ engine → Library sync: syncs sources
src/core.js - Library sync → Spotify and Spicetify: reads playlists and likes
src/library.js - Playback runtime → Spotify and Spicetify: controls playback and queue
src/runtime.js - Playback runtime → DJ engine: observes player events
src/runtime.js - DJ engine → Local profile: persists learning
src/core.js - Playback runtime → Acoustic analysis: enriches candidates
src/runtime.js - Acoustic analysis → Request cache: caches acoustic data
- Playback runtime → Playback guard: guards manual playback
- DJ engine → Voice and captions: requests commentary
- Voice and captions → Listener: speaks or captions
README.md - Playback runtime → Native transitions: applies transition settings
README.md - DJ interface → Local profile: exports and imports
README.md