Practical Music Search
C++ C Shell
Failed to load latest commit information.
doc Add pending action mechanism for use in main loop, and make the start… Jan 13, 2016
m4 Removed dependency to boost, use c++11 std::regex (if desired). Nov 1, 2015
po Clean up build system Apr 11, 2015
src Fix some non void functions returning random data. Jan 30, 2016
.gdbinit Clean up .gdbinit and fix typo Jan 4, 2016
ABOUT-NLS Clean up build system Apr 11, 2015
AUTHORS Reverting all changes since commit 3667fe5. Aug 25, 2015
COPYING Remove glib2 dependency, it's not needed yet. Clean up README and wri… Oct 25, 2011
ChangeLog Clean up build system Apr 11, 2015
INSTALL Clean up build system Apr 11, 2015 Make sure m4 macro directory is included when running automake, fixes #… Jan 31, 2016
NEWS Switch build system to GNU Autotools. Aug 16, 2012
README Replace old README file Aug 30, 2015 Modified - dependencies for regex changed Nov 1, 2015
config.rpath Clean up build system Apr 11, 2015 Fix pandoc conditional check Jan 10, 2016 Clean up build system Apr 11, 2015
testpms Reverting all changes since commit 3667fe5. Aug 25, 2015

Practical Music Search

Practical Music Search is a ncurses-based client for MPD. It has a command line interface much like Vim, and supports custom colors, layouts, and key bindings. PMS aims to be accessible and highly configurable.


PMS is a client for the Music Player Daemon. You need to have MPD installed and working before using PMS, but not neccessarily on the same machine.

The client only works with MPD versions >= 0.15.0.

You'll need glib >= 2.0, ncurses >= 5.0, and libmpdclient >= 2.5 to build PMS. If your c++ compiler supports c++11's regex (like gcc-c++ >= 4.9), it will enable regular expression searches. In addition, if building from Git, you'll need the intltool package. On Debian-based systems, you can install them by running:

sudo apt-get install build-essential intltool libncursesw5-dev libglib2.0-dev libmpdclient-dev

To build from a release tarball, run:

./configure && make

From the Git tree, run:


Then, you may install PMS by running sudo make install.


Consult the man page for configuration options.

There are example configuration files in the examples directory.

Hint: type :help from within PMS to show a list of all current keyboard bindings.

Bugs, feature requests, etc.

There are many bugs. Please report them if you discover them.

Please use the issue tracker to report bugs, or send them to the author's e-mail address.


Copyright (c) 2006-2015 Kim Tore Jensen

The source code and latest version can be found at Github: