xaizek / pms (License: GPLv3+) (since 2018-12-07)
Older version of Practical Music Search written in C++.
<root> / README (b05ed59b1f05883b834a08ca2553b2ab7a609573) (2,165B) (mode 100644) [raw]
# 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
    $ cmake . && 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 ncurses >= 5.0 to build.

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

Start PMS and type
    :set
for a list of options available, or type
    :set color
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 black, red, green, brown, blue, magenta, cyan and gray.
Foreground colors are as background colors, in addition to 
brightred, brightgreen, yellow, brightblue, brightmagenta, brightcyan, white.

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