Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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  sup-
     ported: -C /text.

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

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.

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.

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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=cmus-remote&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help