logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

cmus-remote - control cmus

Author

       Written by Timo Hirvonen <tihirvon@gmail.com>

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

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.

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

Name

       cmus-remote - control cmus

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 -Cstatus.  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 FormatStrings. Each argument starts a new line.

See Also

cmus(1)

Synopsis

       cmus-remote [OPTION]... [FILE|DIR|PLAYLIST]...
       cmus-remote -CCOMMAND...
       cmus-remote

See Also