ncmpcpp

Connect to a music player daemon on a given host and port

$ ncmpcpp --host [ip] --port [port]

$ ncmpcpp --current-song

$ ncmpcpp --config [file]

$ ncmpcpp --bindings [file]

ncmpcpp [options]

-v, --version
    Display version information and exit.

-h, --help
    Display help message and exit.

-c , --config
    Specify an alternative configuration file path. Default: ~/.ncmpcpp/config

-s , --screen
    Specify an alternative screen configuration directory path. Default: ~/.ncmpcpp/screens

-d, --debug
    Enable debug mode. Outputs detailed logs to the console.

ncmpcpp is a feature-rich ncurses-based MPD (Music Player Daemon) client that strives to provide a similar user experience to mpdclient but with more advanced features and a customizable interface.

It allows users to browse and manage their music library, create and modify playlists, control playback, and view song information directly from the terminal.

ncmpcpp is highly configurable, enabling users to tailor the layout, colors, keybindings, and various other settings to suit their preferences.

Its modular design allows for easy extension with scripts and plugins, providing further customization and functionality. This makes it a powerful and versatile tool for anyone who prefers a command-line interface for managing their music library and listening to music.

ncmpcpp requires MPD (Music Player Daemon) to be installed and configured separately. It acts as a client to MPD, so MPD must be running for ncmpcpp to function.

The main configuration file (~/.ncmpcpp/config) allows customization of nearly all aspects of ncmpcpp, including colors, keybindings, visualizer settings, and more. The documentation provides detailed explanations of all available configuration options.

Screens allow for creating different layouts within ncmpcpp, so you can switch between different views of your music library and player information.
It also allows for creating custom screen using configuration files.

ncmpcpp was developed as an alternative to other MPD clients, aiming to provide a more visually appealing and feature-rich experience within the terminal. It has gained popularity among command-line enthusiasts and music lovers who appreciate its flexibility and customization options. The project is actively maintained, with regular updates and improvements.

mpd(1)