https://github.com/d99kris/namp
Terminal-based audio player for Linux and macOS
https://github.com/d99kris/namp
audio-player console linux macos mp3-player ncurses terminal-based tui
Last synced: 19 days ago
JSON representation
Terminal-based audio player for Linux and macOS
- Host: GitHub
- URL: https://github.com/d99kris/namp
- Owner: d99kris
- License: gpl-2.0
- Created: 2015-09-29T14:26:42.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2026-05-17T12:18:09.000Z (about 2 months ago)
- Last Synced: 2026-05-17T14:28:24.003Z (about 2 months ago)
- Topics: audio-player, console, linux, macos, mp3-player, ncurses, terminal-based, tui
- Language: C++
- Homepage:
- Size: 1.75 MB
- Stars: 65
- Watchers: 5
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
namp
====
| **Linux** | **Mac** |
|-----------|---------|
| [](https://github.com/d99kris/namp/actions?query=workflow%3ALinux) | [](https://github.com/d99kris/namp/actions?query=workflow%3AmacOS) |
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](https://github.com/d99kris/namp-lite) (Linux only) is available.
Usage
=====
Usage:
namp OPTION
namp PATH...
Command-line Options:
-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
d toggle show folder names
e enqueue selected track
E unenqueue selected track
f toggle fullscreen (lyrics/cdg)
g toggle CDG graphics window
l toggle lyrics window
s toggle shuffle on/off
t external tag editor
, lyrics font smaller
. lyrics font larger
; lyrics font reset
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](https://github.com/d99kris/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.