Provided by: mpc_0.12.1-1_i386 bug


       mpc - Program for controlling Music Player Daemon (MPD)


       mpc [<command> <arguments>]


       mpc  is  a  client for MPD, the Music Player Daemon.  mpc connects to a
       MPD and controls it according to commands and arguments passed  to  it.
       If no arguments are passed, current status is given.


              Configure  the  format  of  song  display  for  status  and  the
              playlist.  The metadata  delimeters  are  "%name%",  "%artist%",
              "%album%", "%title%", "%track%", "%time%", and "%file%".  The []
              operator is used to  group  output  such  that  if  no  metadata
              delimeters  are  found or matched between ’[’ and ’]’, then none
              of the characters between ’[’ and ’]’ are output.  ’&’  and  ’|’
              are  logical  operators  for  and and or.  ’#’ is used to escape
              characters.  Some useful examples for format are:  "%file%"  and
              "[[%artist%  - ]%title%]|[%file%]".  This command also takes the
              following defined escape sequences:
              \\ - backslash
              \a - alert
              \b - backspace
              \t - tab
              \n - newline
              \v - vertical tab
              \f - form-feed
              \r - carriage return

              Prevents  the  current  song  status  from  being   printed   on
              completion of some of the commands.


       add <file>
              Adds  a  song  from the music database to the playlist. Can also
              read input from pipes. Use "mpc ls | mpc add" to add  all  files
              to the playlist.

       clear  Empties playlist.

       crop   Remove all songs except for the currently playing song.

       crossfade [<seconds>]
              Gets and sets the current amount of crossfading between songs (0
              disables crossfading).

       del <songpos>
              Removes a playlist number from the playlist. Can also read input
              from pipes (0 deletes the current playing song).

       disable <output #>
              Disables the output, number is required.

       enable <output #>
              Enables the output, number is required.

       listall [<file>]
              Lists <file> from playlist. If no <file> is specified, lists all

       load <file>
              Loads <file> as playlist.

       ls [<directory>]
              Lists all files/folders in <directory>.  If  no  <directory>  is
              specified, lists all files in music directory.

              Lists available playlists.

       move <from> <to>
              Moves  song  at  position  <from>  to  the  postion  <to> in the

       next   Starts playing next song on playlist.

              Lists all available outputs

       pause  Pauses playing.

       play <position>
              Starts playing the song-number specified. If none is  specified,
              plays number 1.

              Prints entire playlist.

       prev   Starts playing previous song.

       random <on|off>
              Toggle random mode if state ("on" or "off") is not specified.

       repeat <on|off>
              Toggle repeat mode if state ("on" or "off") is not specified.

       rm <file>
              Deletes a specific playlist.

       save <file>
              Saves playlist as <file>.

       search <type> <query> [<type> <query>]...
              Searches  for songs where all of the given tag <type>s match the
              given <query>s.  Any number of tag type and  query  combinations
              can be specified.  Possible tag types are: artist, album, title,
              track, name, genre, date, composer,  performer,  comment,  disc,
              filename, or any (to match any tag).

       seek [+-][<HH:MM:SS>] or <[+-]<0-100>%>
              Seeks  by  hour,  minute  or  seconds,  hours  or minutes can be
              omitted.  If seeking by percentage,  seeks  within  the  current
              song in the specified manner.  If a "+" or "-" is used, the seek
              is done relative to the current song position. Absolute  seeking
              by default.

              Shuffles all songs on the playlist.

       stats  Displays statistics about MPD

       stop   Stops playing.

       toggle Toggles  between play and pause. If stopped starts playing. Does
              not support start playing at song number (use play).

       update [<path>]
              Scans music directory for updates if no <path> is specified.  If
              one  or more <path>’s are specified, scans only those path’s for
              updates.  Can take input from a pipe.

              Reports the version of MPD.

       volume [+-]<num>
              Sets the volume to <num> (0-100).  If "+" or "-" is  used,  then
              it adjusts the volume relative to the current volume.


       This  section  describes some environment variables that affect how mpc
                        By  default,  mpc connects to localhost:6600. This can
              be changed either at compile-time, or by exporting the  MPD_HOST
              and MPD_PORT environment variables.
                        To   use   a   password  with  mpd,  set  MPD_HOST  to


       Here is a script to load and play m3u playlists (useful for mozilla):

              mpc clear
              cat $1 | mpc add
              mpc play

       This script can be used to load and play pls playlists  (again,  useful
       for mozilla):

              mpc clear
              grep ’^File[0-9]*’ $1 | sed -e ’s/^File[0-9]*=//’ | mpc add
              mpc play


       Report bugs on


       Since MPD uses UTF-8, mpc needs to convert characters  to  the  charset
       used  by  the local system. If you get character conversion errors when
       you’re running mpc you probably need to set up  your  locale.  This  is
       done  by  setting  any  of  the  LC_CTYPE,  LANG  or  LC_ALL enviroment
       vatiables (LC_CTYPE only affects character handling).




            See <>, for  contributors
       to mpc

                                                       Music Player Command(1)