1Music Player Command(1) General Commands Manual Music Player Command(1)
2
6 mpc - Program for controlling Music Player Daemon (MPD)
7
9 mpc [<command> <arguments>]
10
12 mpc is a client for MPD, the Music Player Daemon. mpc connects to a MPD
13 running on a machine on the local network and controls MPD according to
14 commands and arguments passed to it. If no arguments are passed, cur‐
15 rent status is given.
16
19 --format
20 Configure the format of song display for status and the
21 playlist. The metadata delimeters are "%name%", "%artist%",
22 "%album%", "%title%", "%track%", "%time%", and "%file%". The []
23 operator is used to group output such that if no metadata
24 delimeters are found or matched between '[' and ']', then none
25 of the characters between '[' and ']' are output. '&' and '|'
26 are logical operators for and and or. '#' is used to escape
27 characters. Some useful examples for format are: "%file%" and
28 "[[%artist% - ]%title%]|[%file%]"
29 --no-status
31 Prevents the current song status from being printed on comple‐
32 tion of some of the commands.
33
35 add <file>
36 Adds a song from the music database to the playlist. Can also
37 read input from pipes. Use "mpc ls | mpc add" to add all files
38 to the playlist.
39 clear Empties playlist.
41 crop Remove all songs except for the currently playing song.
43 crossfade [<seconds>]
45 Gets and sets the current amount of crossfading between songs (0
46 disables crossfading).
47 del <file>
49 Removes a song from the playlist. Can also read input from
50 pipes.
51 disable <output #>
53 Disables the output, number is required.
54 enable <output #>
56 Enables the output, number is required.
57 listall [<file>]
59 Lists <file> from playlist. If no <file> is specified, lists all
60 songs.
61 load <file>
63 Loads <file> as playlist.
64 ls [<directory>]
66 Lists all files/folders in <directory>. If no <directory> is
67 specified, lists all files in music directory.
68 lsplaylists
70 Lists available playlists.
71 move <from> <to>
73 Moves song at position <from> to the postion <to> in the
74 playlist.
75 next Starts playing next song on playlist.
77 outputs
79 Lists all available outputs
80 pause Pauses playing.
82 play <position>
84 Starts playing the song-number specified. If none is specified,
85 plays number 1.
86 playlist
88 Prints entire playlist.
89 prev Starts playing previous song.
91 random <on|off>
93 Toggle random mode if state ("on" or "off") is not specified.
94 repeat <on|off>
96 Toggle repeat mode if state ("on" or "off") is not specified.
97 rm <file>
99 Deletes a specific playlist.
100 save <file>
102 Saves playlist as <file>.
103 search <type> <queries>
105 Searches for songs that match the queries, where type is
106 "artist", "album", "title", or "filename".
107 seek [+-][<HH:MM:SS>] or <[+-]<0-100>%>
109 Seeks by hour, minute or seconds, hours or minutes can be omit‐
110 ted. If seeking by percentage, seeks within the current song in
111 the specified manner. If a "+" or "-" is used, the seek is done
112 relative to the current song position. Absolute seeking by
113 default.
114 shuffle
116 Shuffles all songs on the playlist.
117 stats Displays statistics about MPD
119 stop Stops playing.
121 toggle Toggles between play and pause. If stopped starts playing. Does
123 not support start playing at song number (use play).
124 update [<path>]
126 Scans music directory for updates if no <path> is specified. If
127 one or more <path>'s are specified, scans only those path's for
128 updates. Can take input from a pipe.
129 version
131 Reports the version of MPD.
132 volume [+-]<num>
134 Sets the volume to <num> (0-100). If "+" or "-" is used, then
135 it adjusts the volume relative to the current volume.
136
138 This section describes some environment variables that affect how mpc
139 operates.
140 MPD_HOST
141 MPD_PORT
142 By default, mpc connects to localhost:6600. This can
143 be changed either at compile-time, or by exporting the MPD_HOST
144 and MPD_PORT environment variables.
145 To use a password with mpd, set MPD_HOST to pass‐
146 word@host.
147
149 Here is a script to load and play m3u playlists (useful for mozilla):
150 #!/bin/bash
152 mpc clear
153 cat $1 | mpc add
154 mpc play
155 This script can be used to load and play pls playlists (again, useful
157 for mozilla):
158 #!/bin/bash
160 mpc clear
161 grep '^File[0-9]*' $1 | sed -e 's/^File[0-9]*=//' | mpc add
162 mpc play
163
165 Report bugs on http://www.musicpd.org/mantis/
166
168 Since MPD uses UTF-8, mpc needs to convert characters to the charset
169 used by the local system. If you get character conversion errors when
170 your running mpc you probably need to set up your locale. This is done
171 by setting any of the LC_CTYPE, LANG or LC_ALL enviroment vatiables
172 (LC_CTYPE only affects character handling).
173
175 mpd(1)
176
178 See <http://svn.musicpd.org/mpc/trunk/AUTHORS>, for contributors
179 to mpc
180 Music Player Command(1)