README

   1
   2 Overview
   3 ------------------------------------------------------------------------------
   4 ncmpc is a curses client for the Music Player Daemon (MPD). ncmpc connects to
   5 a MPD running on a machine on the local network, and controls this with an
   6 interface inspired by cplay.
   7
   8 Music Player Daemon (MPD) allows remote access for playing music (MP3,
   9 Ogg Vorbis, FLAC, AAC, and wave files) and managing playlists. MPD is
  10 designed for integrating a computer into a stereo system that provides
  11 control for music playback over a local network. Read more at musicpd.org
  12
  13
  14
  15 How to compile and install ncmpc
  16 -------------------------------------------------------------------------------
  17
  18 Requirements:
  19         * ncurses
  20         * glib-2.2 (2.4 for NLS support)
  21
  22 Download the ncmpc source code, then:
  23         $ tar zxvf ncmpc-x.y.z.tar.gz
  24         $ cd ncmpc-x.y.z
  25         $ ./configure
  26         $ make
  27         $ make install
  28
  29 or if you are starting from the subversion checkout:
  30         $ svn co https://svn.musicpd.org/ncmpc/trunk ncmpc
  31         $ cd ncmpc
  32         $ ./autogen.sh
  33         $ make
  34         $ make install
  35
  36
  37 Upgrading to ncmpc-0.11.0
  38 ------------------------------------------------------------------------------
  39 The syntax for the configuration file (~/.ncmpc/config) has changed, view the
  40 manual page or the sample configuration file for details.
  41
  42 The old key binding to the select command (space,a) will result in a
  43 conflict as the a key is used for the new add command in 0.11.0. The easy
  44 solution is to delete your old key bindings (~/.ncmpc/keys), but you can use
  45 the built in key editor to solve any key conflicts.
  46
  47
  48
  49 Usage
  50 -------------------------------------------------------------------------------
  51 ncmpc connects to a MPD running on a machine on the local network.
  52 By default, ncmpc  connects  to  localhost:6600.   This  can  be
  53 changed  either  at  compile-time,  or  by  exporting  the MPD_HOST and
  54 MPD_PORT environment variables, or by the command line  options  --host
  55 and --port.
  56
  57         $ ncmpc --host=musicserver --port=44000
  58
  59 For more information please view ncmpc's manual page.
  60
  61
  62
  63
  64 Web Page, Forums and Bug Reports
  65 -------------------------------------------------------------------------------
  66         * Read more about ncmpc & MPD on http://www.musicpd.org
  67         * a ncmpc forum exists at musicpd.org - http://www.musicpd.org/forum
  68         * report bugs at musicpd.org - http://www.musicpd.org/mantis/
  69
  70
  71
  72
  73 -------------------------------------------------------------------------------
  74 $Id$
  75
  76
  77
  78
  79
  80
  81
  82
  83
  84
  85