How skensmaster/spotui works
SpoTUI is a keyboard-driven, terminal-style interface layered inside Spotify via Spicetify. Users enter commands or use keybindings, which dispatch playback, search, playlist, lyrics, theme, and appearance actions; panels present interactive results. The runtime also supports onboarding, custom playback visuals, synchronized listening (“Jam”), and a SpoSync companion. The graph follows documented capabilities and indexed module references; unsampled implementation details are represented only where the README or source index supports them.
Main entry points: commands.js Command dispatcher · main.js Runtime bootstrap · panels.js Panel navigation · jam.js Jam playback sync
Components 25
Interface and dispatch
- Runtime bootstrap
src/main.js - Command terminal
src/terminal.js - Command dispatcher
src/commands.js - Panel navigation
src/panels.js - Keyboard bindings
src/keybinds.js - Listener actions
src/actions.js - First-run onboarding
src/onboarding.js
Spotify experiences
- Playlist browser
src/playlists.js - Spotify search
src/search.js - Lyrics panel
src/lyrics.js - Audio visualizer
src/visualizer.js - DJ playback
src/dj.js
Customization
- Appearance controls
src/appearance.js - Theme browser
src/themes.js - Wallpaper
src/wallpaper.js - ASCII display
src/ascii.js
Runtime and integrations
- Jam playback sync
src/jam.js - SpoSync integration
src/sync.js - Shared runtime state
src/state.js - Preference storage
src/storage.js
Other components
- Spotify user
- Spotify / Spicetify
- LRCLIB lyrics service
- Jam relay server
- SpoSync companion
sposync/app.py
Connections 29
- Spotify user → Command terminal: enters commands
README.md - Runtime bootstrap → Command terminal: initializes
src/main.js - Runtime bootstrap → First-run onboarding: initializes
src/main.js - Runtime bootstrap → Appearance controls: initializes
src/main.js - Runtime bootstrap → Jam playback sync: initializes
src/main.js - Runtime bootstrap → Keyboard bindings: initializes
src/main.js - Command terminal → Command dispatcher: dispatches
src/terminal.js - Command dispatcher → Panel navigation: opens panels
src/commands.js - Command dispatcher → Playlist browser: loads playlists
src/commands.js - Command dispatcher → Listener actions: dispatches action commands
src/commands.js - Command dispatcher → Keyboard bindings: configures bindings
src/commands.js - Keyboard bindings → Command dispatcher: executes commands
src/keybinds.js - Panel navigation → Spotify search: opens and closes
src/panels.js - Panel navigation → Playlist browser: renders browser
src/panels.js - Panel navigation → Theme browser: loads theme feed
src/panels.js - First-run onboarding → Theme browser: loads theme feed
src/onboarding.js - Listener actions → Command dispatcher: executes listeners
src/actions.js - Spotify search → Spotify / Spicetify: requests search
src/search.js - Lyrics panel → Spotify / Spicetify: fetches lyrics
src/lyrics.js - Lyrics panel → LRCLIB lyrics service: fetches lyrics
src/lyrics.js - Playlist browser → Spotify / Spicetify: plays selections
src/playlists.js - Appearance controls → Lyrics panel: syncs lyrics settings
src/appearance.js - Jam playback sync → Jam relay server: sends sync requests
src/jam.js - Jam playback sync → Spotify / Spicetify: controls playback
src/jam.js - Appearance controls → Preference storage: reads preferences
src/appearance.js - Listener actions → Preference storage: loads and saves actions
src/actions.js - Jam playback sync → Preference storage: persists session
src/jam.js - Command terminal → ASCII display: renders logo
src/terminal.js - SpoSync integration → SpoSync companion: companion relationship