aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: 4148790dcb02e5653ad560dc102c610d7f3dbd14 (plain) (blame)
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
76
77
78
79
80
81
82
83
84
85
Overview
------------------------------------------------------------------------------
ncmpc is a curses client for the Music Player Daemon (MPD). ncmpc connects to 
a MPD running on a machine on the local network, and controls this with an 
interface inspired by cplay. 

Music Player Daemon (MPD) allows remote access for playing music (MP3, 
Ogg Vorbis, FLAC, AAC, and wave files) and managing playlists. MPD is 
designed for integrating a computer into a stereo system that provides 
control for music playback over a local network. Read more at musicpd.org



How to compile and install ncmpc
-------------------------------------------------------------------------------

Requirements:
	* ncurses 
	* glib-2.2 (2.4 for NLS support)

Download the ncmpc source code, then:
	$ tar zxvf ncmpc-x.y.z.tar.gz
	$ cd ncmpc-x.y.z
	$ ./configure
	$ make
	$ make install

or if you are starting from the subversion checkout:
	$ svn co https://svn.musicpd.org/ncmpc/trunk ncmpc
	$ cd ncmpc
	$ ./autogen.sh
	$ make
	$ make install


Upgrading to ncmpc-0.11.0 
------------------------------------------------------------------------------
The syntax for the configuration file (~/.ncmpc/config) has changed, view the
manual page or the sample configuration file for details.

The old key binding to the select command (space,a) will result in a 
conflict as the a key is used for the new add command in 0.11.0. The easy 
solution is to delete your old key bindings (~/.ncmpc/keys), but you can use 
the built in key editor to solve any key conflicts.



Usage
-------------------------------------------------------------------------------
ncmpc connects to a MPD running on a machine on the local network. 
By default, ncmpc  connects  to  localhost:6600.   This  can  be
changed  either  at  compile-time,  or  by  exporting  the MPD_HOST and
MPD_PORT environment variables, or by the command line  options  --host
and --port.

	$ ncmpc --host=musicserver --port=44000

For more information please view ncmpc's manual page.




Web Page, Forums and Bug Reports
-------------------------------------------------------------------------------
	* Read more about ncmpc & MPD on http://www.musicpd.org
	* a ncmpc forum exists at musicpd.org - http://www.musicpd.org/forum
	* report bugs at musicpd.org - http://www.musicpd.org/mantis/




-------------------------------------------------------------------------------
$Id$