internal/

Package audio provides the PCM ingest and FFT analysis that feed the TUI's visualizers.

Package auth handles Spotify OAuth2 with PKCE: interactive login via a local callback server, token persistence on disk, and proactive token refresh to avoid blocking API calls on an expiring token.

Package bootstrap wires together the application's startup sequence: loading or interactively creating config, authenticating against Spotify, starting optional librespot playback, and launching the Bubbletea TUI.

Package config manages the tuify config file.

Package librespot manages the lifecycle of an external librespot subprocess: spawning it with the configured bitrate, backend, and device name; watching stdout for connection/state events; piping PCM audio to the audio package when backend=="pipe"; and invoking user-supplied callbacks on reconnect and inactivity.

Package lyrics fetches song lyrics for the visualizer's lyrics panel.

Package spotify wraps the zmb3/spotify Web API client with the higher-level operations tuify needs: playlist and library fetches, player state polling, playback control, device selection, and transfer-on-reconnect behavior.

Package testutil holds test-only helpers shared across the other internal packages.

Package theme owns the application color palette and the bridge from user config (a Theme struct deserialized from config.json) into the mutable lipgloss colors used by package ui.

Package ui is the Bubble Tea-based terminal UI for tuify.