namp

Linux	Mac

namp is a terminal-based MP3 player for Linux and macOS, implemented in C++ / Qt. For systems which do not have Qt available, a lite version of namp namp-lite (Linux only) is available.

Features

• Play local audio files and entire directories
• Search playlist and enqueue tracks to play next
• CD+G karaoke playback using .cdg sidecar files
• Lyrics from .lrc files, embedded tags or LRCLIB
• Real-time spectrum analyzer visualization
• Mouse control and Winamp-style key bindings
• Edit track tags using external tool idntag
• Last.fm scrobbling with status indicator
• Shuffle and sequential playback modes

Usage

Usage:

namp OPTION
namp PATH...

Command-line Options:

--clear-cache     clear lyrics cache and exit
-h, --help        display this help and exit
-s, --setup       setup last.fm scrobbling account
-v, --version     output version information and exit
PATH              file or directory to add to playlist

Command-line Examples:

namp ~/Music      play all files in ~/Music
namp hello.mp3    play hello.mp3

Interactive Commands:

z                 previous track
x                 play
c                 pause
v                 stop
b                 next track
q,ESC             quit
/,j               find
up,+              volume up
down,-            volume down
left              skip/fast backward
right             skip/fast forward
home              playlist top
end               playlist end
pgup              playlist previous page
pgdn              playlist next page
ENTER             play selected track
TAB               toggle main window / playlist focus
a                 toggle spectrum analyzer
d                 toggle show folder names
e                 enqueue selected track
E                 unenqueue selected track
f                 toggle fullscreen (lyrics/cdg)
k                 toggle CDG karaoke window
l                 toggle lyrics view
L                 refetch lyrics (bypass cache)
s                 toggle shuffle on/off
t                 external tag editor
w                 toggle lyrics window / terminal lyrics
,                 lyrics font smaller
.                 lyrics font larger
;                 lyrics font reset

Scrobble Indicators:

_                 now playing sent to last.fm
^                 scrobbled to last.fm
~                 not scrobbled (missing artist/title tags)
!                 scrobbling failed

Supported Platforms

namp is primarily developed and tested on macOS, but basic functionality should work on Linux as well. Current version has been tested on:

• macOS Sequoia 15.4
• Ubuntu 24.04 LTS

Linux

Dependencies Ubuntu 20.04

sudo apt install libncursesw5-dev libtag1-dev cmake qtmultimedia5-dev libqt5multimedia5-plugins ubuntu-restricted-extras

Dependencies Ubuntu 22.04 onwards

sudo apt install cmake libncursesw5-dev libtag1-dev qt6-base-dev qt6-multimedia-dev gstreamer1.0-pulseaudio ubuntu-restricted-extras

Source

git clone https://github.com/d99kris/namp && cd namp

Build

mkdir -p build && cd build && cmake .. && make -s

Install

sudo make -s install

macOS

Dependencies

brew install cmake ncurses taglib gnu-sed
brew install qt

Source

git clone https://github.com/d99kris/namp && cd namp

Build

mkdir -p build && cd build && cmake .. && make -s

Install

make -s install

External Tools

Using external tag editor requires idntag to be installed on the system.

License

namp is distributed under GPLv2 license. See LICENSE file.

Keywords

command line, console-based, linux, macos, mp3 player, music player, ncurses, terminal-based.