Playpal

Your friendly terminal MP3 and FLAC player with a full-screen TUI.

Screenshot

Features

• Fast file browser for the current folder, with directories listed first
• Plays MP3 and FLAC files, with automatic queueing from the selected track downward
• Smooth progress bar with elapsed and total time
• Keyboard-driven navigation and seek controls
• Windows drive quick-jump support

Quick start

# Run directly
go run .

# Or build a binary
# Windows
go build -o playpal.exe

# macOS/Linux
go build -o playpal

Launch it from any folder that contains music files:

./playpal

Controls

• Esc or Ctrl+C: Quit
• Up/Down or j/k: Move selection
• Enter: Open folder or play selected file
• Space: Pause/resume playback
• Left/Right: Seek backward/forward 10 seconds
• Letter (Windows): Jump to a drive (for example, press C for C:)

Supported formats

• MP3
• FLAC

Notes

• The queue starts at the selected file and continues through the remaining visible audio files.
• Theme colors can be customized in theme.go.

Tech

• Built with Bubble Tea and Lip Gloss
• Audio decoding and playback via faiface/beep