SONGBIRD TUI

> Terminal Music Player | Rust | High Performance

Recursive music discovery • Metadata parsing • Full playback control

VIEW SOURCE INSTALL

[FEATURES]

Performance

Built in Rust for speed. Full-screen TUI with responsive performance across large music libraries.

Playback

Play, pause, next, previous, shuffle, repeat, volume controls via keyboard.

Scanning

Discovers MP3, FLAC, WAV, OGG, M4A, AAC files recursively in your music folder.

Metadata

Extracts title, artist, album, year, codec, bitrate, duration, lossless info via lofty.

Persistence

Saves folder preference to ~/.songbird/config.json. No re-entry on restart.

Terminal UI

Full-screen ratatui-based interface with rounded panels and keyboard navigation.

[SCREENSHOTS]

> MAIN_LIBRARY_VIEW
Main Library View
> PLAYBACK_STATUS
Playback Status

[INSTALLATION]

REQUIREMENTS

> Rust stable toolchain (rustup.rs)

> mpv installed and in your PATH

$ rustup --version && mpv --version

FROM CRATES.IO

Install from crates.io registry:

$ cargo install songbird-tui
$ songbird
FROM SOURCE

Clone and build from repository:

$ git clone https://github.com/kaizoku010/Songbird-TUI.git
$ cd Songbird-TUI
$ cargo build --release
$ ./target/release/songbird

[CONTROLS]

SPLASH SCREEN

Confirm folder Enter
Cancel Esc
Navigate ↑ ↓
Edit path Backspace
Paste path Ctrl+V

LIBRARY SCREEN

Move selection ↑ ↓
Play track Enter
Pause/Resume Space
Next/Previous N / P
Shuffle S
Repeat (cycle) R
Volume up/down + / -
Change folder F
Quit Q

[TECHNICAL]

PROJECT DETAILS

Songbird is a TUI music player written in Rust. It combines terminal rendering with concurrent file scanning and metadata extraction for performant command-line music playback.

Tech Stack:

  • > Ratatui - Terminal UI rendering
  • > Crossterm - Terminal I/O and event handling
  • > Lofty - Audio metadata extraction
  • > Rayon - Parallel file scanning
  • > Walkdir - Recursive directory traversal
  • > Interprocess - MPV communication

License: ISC