Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

CMUS-REMOTE(1)							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
	      $XDG_RUNTIME_DIR/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)

Vote for polarhome