DragonFly On-Line Manual Pages

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