8gent Code.Docs
Using 8gent

The DJ

Music in the footer while you work. Search and play a track, tune a radio station, or produce a loop, with title, artist and key on the deck.

The DJ plays music inside 8gent. It lives in the footer as 8GENT FM and opens into a deck that shows what is playing.

Set up

The DJ uses four small tools. Install them once:

brew install mpv yt-dlp ffmpeg sox                 # macOS
sudo apt install mpv yt-dlp ffmpeg sox             # Debian, Ubuntu

On Windows, the same tools come from Scoop: scoop bucket add extras; scoop install mpv yt-dlp ffmpeg sox.

/dj doctor shows which of them it can find.

Play

/dj play boards of canada roygbiv     # search and play a track
/dj radio jazz                         # tune an internet radio station
/dj produce house                      # generate a 60-second loop locally

Radio presets: lofi, chill, jazz, classical, rock, metal, edm, techno, house, dnb, hiphop, ambient, and more. /dj presets lists them all. Anything else is searched as a station name.

The deck

While a track is loaded the deck shows the title, the artist, elapsed and total time, volume, and the track's key:

  • Key: A minor when the source names it
  • Key: A minor (est.) when 8gent estimated it from the audio, locally
  • Key: unknown when the estimate is too weak to trust. It never guesses

Update to get this

The title, artist and key readout needs a current release. Run 8gent update; see Install.

Ctrl+D collapses the deck to one line and back. Your choice is remembered. /dj close and /dj open do the same.

Commands

CommandWhat it does
/dj play <query>Search and play
/dj radio <genre or name>Internet radio
/dj produce <genre>Generate and loop a track
/dj pause, /dj resume, /dj stopTransport
/dj skipNext in the queue
/dj npWhat is playing, as text
/dj vol <0-100>Volume
/dj loopRepeat the current track
/dj queue <query>Add to the queue
/dj dl <url>Download a track
/dj bpm <file>Detect tempo
/dj mix <a> <b> [seconds]Crossfade two tracks
/dj doctorCheck the tools

Keys

KeyWhat it does
Ctrl+Shift+PPlay or pause
Ctrl+Shift+NNext
Ctrl+Shift+BPrevious
Ctrl+Shift+MMute
Ctrl+Shift+Up, Ctrl+Shift+DownVolume
Ctrl+DExpand or collapse the deck

Focus sounds without the DJ: /adhd lofi, /adhd rainsound, /adhd whitenoise, /adhd stop.