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: 3 months 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 (over 10 years ago)
• Default Branch: master
• Last Pushed: 2024-09-28T05:26:49.000Z (over 1 year ago)
• Last Synced: 2025-05-08T23:35:25.669Z (11 months ago)
• Topics: audio-player, console, linux, macos, mp3-player, ncurses, terminal-based, tui
• Language: C++
• Homepage:
• Size: 954 KB
• Stars: 63
• Watchers: 6
• Forks: 5
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
namp

====

| **Linux** | **Mac** |

|-----------|---------|

| [![Linux](https://github.com/d99kris/namp/workflows/Linux/badge.svg)](https://github.com/d99kris/namp/actions?query=workflow%3ALinux) | [![macOS](https://github.com/d99kris/namp/workflows/macOS/badge.svg)](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.

![screenshot](/res/namp-screenshot.png)

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

    e                 external tag editor

    s                 toggle shuffle on/off

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 qt5-default qt5-qmake qtmultimedia5-dev libqt5multimedia5-plugins ubuntu-restricted-extras

**Dependencies Ubuntu 22.04 onwards**

    sudo apt install 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 && qmake .. && make -s

**Install**

    sudo make -s install

macOS

=====

**Dependencies**

    brew install ncurses taglib gnu-sed

    brew install qt

**Source**

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

**Build**

    mkdir -p build && cd build && qmake .. && 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.