xaizek / pms (License: GPLv3+) (since 2018-12-07)
Older version of Practical Music Search written in C++.
Clone URLs: https://code.reversed.top/user/xaizek/pms ssh://rocketgit@code.reversed.top/user/xaizek/pms
0.42 c experimental gh-pages legacy libmpdclient master
<root> / README.md (59f81d4e70c3bb3edf02503a82548ef3bcf4faaf) (2,429B) (mode 100644) [raw]
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 
# PMS
## Practical Music Search
Practical Music Search is an ncurses-based client for
[MPD](http://mpd.wikia.com/wiki/Music_Player_Daemon_Wiki). It has a command
line interface much like [Vim](http://www.vim.org), and supports custom colors,
layouts, and key bindings. [PMS](https://github.com/ambientsound/pms) aims to
be accessible and highly configurable.

### Compiling
If you are building from Git, you need GNU autoconf and automake.

    $ autoreconf --install
    $ ./configure
    $ make

### Dependencies
You need to have [MPD](http://mpd.wikia.com/wiki/Music_Player_Daemon_Wiki)
installed and working before using [PMS](https://github.com/ambientsound/pms),
but not neccessarily on the same machine. This client requires
[MPD](http://mpd.wikia.com/wiki/Music_Player_Daemon_Wiki) >= 0.15.0.

[PMS](https://github.com/ambientsound/pms) depends on the wide version of
ncurses. On Debian systems this package is called
<code>libncurses5w-dev</code>.

### Configuration
Your configuration file is <code>~/.config/pms/pms.conf</code>. A system-wide
config file can be put in <code>/etc/xdg/pms/pms.conf</code>.

Start PMS and type <code>:set</code> for a list of options available, or type
<code>:set color</code> for a list of color options.

#### Setting options
Options can be set with

    set option=value
    set option+=value
    set option-=value

Boolean options can be set, inverted or unset with

    set option
    set nooption
    set invoption
    set option!

Option values can be queried with

    set option?

#### Changing colors
Background colors are <code>black, red, green, brown, blue, magenta,
cyan</code> and <code>gray</code>.  Foreground colors are as background colors,
in addition to <code>brightred, brightgreen, yellow, brightblue, brightmagenta,
brightcyan, white</code>.

Set colors with

    set color.name=foreground [background]

### Copying
This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

See the COPYING file for more information.

### Authors
Written by [Kim Tore Jensen](http://www.incendio.no). Copyright (c) 2006-2011.

A big thanks to contributors [Bart Nagel](https://github.com/tremby) and
[Murilo Pereira](https://github.com/mpereira).

<!--- vi: se ft=markdown et ts=4 sts=4 sw=4: -->
Hints
Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"

Clone this repository using HTTP(S):
git clone https://code.reversed.top/user/xaizek/pms

Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@code.reversed.top/user/xaizek/pms

You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a pull request:
... clone the repository ...
... make some changes and some commits ...
git push origin master