Repolode
Submit
Jaxx497

Jaxx497/NoctaVox

A lightweight Rust terminal music player for local libraries, with gapless playback, queues, playlists and vim-style keys.

Open-source alternative to:foobar2000MusicBee

View on GitHub
Stars
381
Forks
25
Open issues
3
Last commit
8 days ago

What is it?

NoctaVox is a terminal user interface (TUI) music player built in Rust for playing audio from local folders. You point it at one or more root directories, and it scans and indexes the library so you can browse, search by title, album or artist, and queue tracks without leaving the terminal.

Playback features include gapless playback, ReplayGain support, a single-track loop mode, and live library reloading that picks up new, changed or removed files. Visualizations include waveform, oscilloscope and spectrum views, and the player integrates with system media controls. Themes are defined in files that reload while the app runs, and the key bindings follow vim-style conventions.

The player relies on accurate file tags and does not edit them. It is read-only apart from its own SQLite database, and it has no online capabilities. Playlist import and export are provided through an addon, and the audio engine is built on a separate project called Voxio.

Key features

  • 01Gapless playback with queue and playlist management
  • 02Supports mp3, m4a, wav, flac, ogg, opus, aiff, alac and webm
  • 03Live library reloading without restarting
  • 04Waveform, oscilloscope and spectrum visualizations
  • 05Custom themes with hot reload and Vim-style key bindings
  • 06Smart search across title, album and artist

Use cases

  • Listening to a local FLAC or MP3 collection from an SSH session or terminal-centric workflow
  • Browsing and queuing a large tagged music library entirely from the keyboard
  • Customizing the look of a terminal music player with your own themes

Quick start

  1. 1

    Install from crates.io with Cargo

    cargo install noctavox --locked
  2. 2

    Launch the player with the vox command

    vox

Things to know

  • On Linux, ALSA development packages must be installed before building.
  • Relies on accurate file tags; it has no tag editing feature.
  • Config format is in progress and may break between versions.
  • Playlist import/export requires a separate addon that is being deprecated.

Topics

#music-player#tui#rust#terminal#audio#local-music#ratatui

FAQ

What is NoctaVox?
A lightweight Rust terminal music player for local libraries, with gapless playback, queues, playlists and vim-style keys. NoctaVox is a terminal user interface (TUI) music player built in Rust for playing audio from local folders. You point it at one or more root directories, and it scans and indexes the library so you can browse, search by title, album or artist, and queue tracks without leaving the terminal.
Is NoctaVox free to use? What license does it have?
NoctaVox is open source under the MIT license. Check the license terms before using it in commercial products.
Is NoctaVox still maintained?
Actively maintained. The last commit to NoctaVox was on Oct 12, 2026.
What can I use NoctaVox for?
Listening to a local FLAC or MP3 collection from an SSH session or terminal-centric workflow Browsing and queuing a large tagged music library entirely from the keyboard Customizing the look of a terminal music player with your own themes
How do I install NoctaVox?
Install from crates.io with Cargo: cargo install noctavox --locked Launch the player with the vox command: vox
Where can I get NoctaVox?
The source code and installation instructions are on GitHub: https://github.com/Jaxx497/NoctaVox

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects