How swadesh-c0de/vibe-fi-go works
vibe-fi is a terminal music player for local files and YouTube streams. The main workflow starts in the Bubble Tea app: the user selects or searches for music, playback is controlled through the audio player, and lyrics and visualizer features enrich the playback view. Playlists, library browsing, session persistence, themes, and media integrations are distinct capabilities. The graph follows the excerpts and README; several subsystem-to-app connections are documented capabilities rather than inspected call sites.
Main entry points: app.go Terminal app · main.go CLI startup · playback_controller.go Playback controller · navigation_controller.go Navigation controller
Components 24
Startup and UI
- CLI startup
cmd/vibe/main.go - Terminal app
internal/tui/app.go - Navigation controller
internal/tui/navigation_controller.go - Playback controller
internal/tui/playback_controller.go - Terminal views
internal/tui/views
Music and playback
- MPV audio engine
internal/player/mpv.go - YouTube search
internal/service/search/search.go - Local library
internal/service/library/library.go - Playlist manager
internal/service/playlist/playlist.go
Listening features
- Synced lyrics
internal/service/lyrics/lyrics.go - Audio visualizer
internal/tui/visualizer/visualizer.go - Color themes
internal/tui/theme/theme.go
State and events
- Session state
internal/config/state.go - Playback events
internal/eventbus/eventbus.go - Update checker
internal/service/updater/updater.go - yt-dlp provisioning
internal/utils/bottle/bottle.go
System integrations
- Discord presence
internal/integration/discord/discord.go - MPRIS server
internal/integration/mpris/mpris.go
Other components
- Listener
- YouTube / yt-dlp
- Local music files
- lrclib.net
- Desktop media controls
- Discord client
Connections 34
- Listener → Terminal app: operates
README.md - CLI startup → MPV audio engine: creates
cmd/vibe/main.go - CLI startup → Terminal app: creates
cmd/vibe/main.go - CLI startup → Discord presence: creates
cmd/vibe/main.go - CLI startup → MPRIS server: starts
cmd/vibe/main.go - CLI startup → Update checker: checks updates
cmd/vibe/main.go - CLI startup → yt-dlp provisioning: provisions
cmd/vibe/main.go - Terminal app → Navigation controller: routes keys
internal/tui/navigation_controller.go - Terminal app → Playback controller: dispatches playback
internal/tui/playback_controller.go - Terminal app → Terminal views: renders
internal/tui/app.go - Terminal app → Local library: initializes
internal/tui/app.go - Terminal app → Playlist manager: initializes
internal/tui/app.go - Terminal app → Synced lyrics: initializes
internal/tui/app.go - Terminal app → Audio visualizer: initializes
internal/tui/app.go - Terminal app → Playback events: initializes
internal/tui/app.go - Navigation controller → Playlist manager: manages playlists
internal/tui/navigation_controller.go - Navigation controller → Playback controller: starts tracks
internal/tui/navigation_controller.go - Playback controller → MPV audio engine: controls playback
internal/tui/playback_controller.go - Playback controller → Synced lyrics: fetches lyrics
internal/tui/playback_controller.go - Playback controller → Playback events: publishes events
internal/tui/playback_controller.go - Navigation controller → YouTube search: uses search
- YouTube search → YouTube / yt-dlp: resolves streams
README.md - YouTube / yt-dlp → MPV audio engine: streams audio
README.md - Local library → Local music files: browses files
README.md - Synced lyrics → lrclib.net: fetches lyrics
README.md - Synced lyrics → Session state: caches offline
- Terminal app → Session state: saves session
internal/tui/app.go - CLI startup → Playback events: publishes track
cmd/vibe/main.go - CLI startup → Color themes: selects theme
- MPRIS server → MPV audio engine: reads player state
internal/integration/mpris/mpris.go - MPRIS server → Terminal app: sends actions
internal/integration/mpris/mpris.go - Desktop media controls → MPRIS server: controls player
README.md - Terminal app → Discord presence: updates presence
- Discord presence → Discord client: uses IPC
README.md