@title CMUS-REMOTE 1 05/11/2006 cmus

@h1 NAME

cmus-remote - control cmus


@h1 SYNOPSIS

cmus-remote [*OPTION*]... [`FILE`|`DIR`|`PLAYLIST`]...@br
cmus-remote *-C* `COMMAND`...@br
cmus-remote


@h1 DESCRIPTION

Add `FILE/DIR/PLAYLIST` to playlist, library (*-l*) or play queue (*-q*).

If no arguments are given cmus-remote reads raw commands from stdin (one
command per line).  Raw commands are cmus' command mode commands.  These same
commands are used in configuration files and key bindings.  *cmus*(1) contains
full list of commands.  For consistency also searching is supported:
*-C /text*.

If *-C* is given, all command line arguments are treated as raw commands.

@h1 OPTIONS

--server SOCKET
	Connect using socket *SOCKET* instead of `$XDG_RUNTIME_DIR/cmus-socket`.

--passwd PASSWD
	password to use for TCP/IP connection

--help
	Display usage information and exit.

--version
	Display version information and exit.

-p, --play
	Start playing.

-u, --pause
	Toggle pause.

-U, --pause-playback
	Pause if currently playing.

-s, --stop
	Stop playing.

-n, --next
	Skip forward in playlist.

-r, --prev
	Skip backward in playlist.

-R, --repeat
	Toggle repeat.

-S, --shuffle
	Toggle shuffle.

-v, --volume VOL
	Change volume. See *vol* command in *cmus*(1).

-k, --seek SEEK
	Seek. See *seek* command in *cmus*(1).

-f, --file FILE
	Play from file.

-Q
	Get player status information.  Same as *-C status*.  Note that
	*status* is a special command only available to cmus-remote.

-l, --library
	Modify library instead of playlist.

-P, --playlist
	Modify playlist (default).

-q, --queue
	Modify play queue instead of playlist.

-c, --clear
	Clear playlist, library (*-l*) or play queue (*-q*).

-C, --raw
	Treat arguments (instead of stdin) as raw commands.

@h1 REMOTE COMMANDS

Special commands only available to cmus-remote.

status
	Print information about currently playing track.

format_print
	Print arguments as `Format Strings`. Each argument starts a new line.

@h1 EXAMPLES

Add playlists/files/directories/URLs to library view (1 & 2):

	@pre
	$ cmus-remote -l music.m3u \\
	http://live.urn1350.net:8080/urn_high.ogg
	@endpre

Load (clear and add) playlist to playlist view (3):

	@pre
	$ cmus-remote -c music.m3u
	@endpre

Three different ways to toggle repeat:

	@pre
	$ cmus-remote -R
	$ cmus-remote -C "toggle repeat"
	$ cmus-remote
	toggle repeat
	^D
	@endpre

Query settings or key bindings:

	@pre
	$ cmus-remote -C "set repeat?"
	setting: 'repeat=false'
	$ cmus-remote -C "showbind common a"
	bind common a win-add-l
	@endpre

Dump the playlist to stdout:

	@pre
	$ cmus-remote -C "save -p -"
	[...]
	@endpre

Search works too:

	@pre
	$ cmus-remote -C /beatles
	@endpre

@h1 SEE ALSO

*cmus*(1)

@h1 AUTHOR

Written by Timo Hirvonen <tihirvon\@gmail.com>
