CMUS-REMOTE(1)						      General Commands Manual						    CMUS-REMOTE(1)

NAME

       cmus-remote - control cmus

SYNOPSIS

       cmus-remote [OPTION]... [FILE|DIR|PLAYLIST]...
       cmus-remote -C COMMAND...
       cmus-remote

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.

       When -C is given all command line arguments are treated as raw commands.

OPTIONS

       --server SOCKET
	      Connect using socket SOCKET instead of ~/.cmus/socket.

       --help
	      Display usage information and exit.

       --version
	      Display version information and exit.

       -p, --play
	      Start playing.

       -u, --pause
	      Toggle pause.

       -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).

       -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.

EXAMPLES

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

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

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

	      $ cmus-remote -c music.m3u

       Three different ways to toggle repeat:

	      $ cmus-remote -R
	      $ cmus-remote -C "toggle repeat"
	      $ cmus-remote
	      toggle repeat
	      ^D

       Query settings or key bindings:

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

       Dump the playlist to stdout:

	      $ cmus-remote -C "save -p -"
	      [...]

       Search works too:

	      $ cmus-remote -C /beatles

SEE ALSO

       cmus(1)

AUTHOR

       Written by Timo Hirvonen <tihirvon@gmail.com>

cmus								    05/11/2006							    CMUS-REMOTE(1)