Doc/cmus-remote.txt

   1 @title CMUS-REMOTE 1 05/11/2006 cmus
   2
   3 @h1 NAME
   4
   5 cmus-remote - control cmus
   6
   7
   8 @h1 SYNOPSIS
   9
  10 cmus-remote [*OPTION*]... [`FILE`|`DIR`|`PLAYLIST`]...@br
  11 cmus-remote *-C* `COMMAND`...@br
  12 cmus-remote
  13
  14
  15 @h1 DESCRIPTION
  16
  17 Add `FILE/DIR/PLAYLIST` to playlist, library (*-l*) or play queue (*-q*).
  18
  19 If no arguments are given cmus-remote reads raw commands from stdin (one
  20 command per line).  Raw commands are cmus' command mode commands.  These same
  21 commands are used in configuration files and key bindings.  *cmus*(1) contains
  22 full list of commands.
  23
  24 When *-C* is given all command line arguments are treated as raw commands.
  25
  26
  27 @h1 OPTIONS
  28
  29 --server SOCKET
  30         Connect using socket *SOCKET* instead of `/tmp/cmus-$USER`.
  31
  32 --help
  33         Display usage information and exit.
  34
  35 --version
  36         Display version information and exit.
  37
  38 -p, --play
  39         Start playing.
  40
  41 -u, --pause
  42         Toggle pause.
  43
  44 -s, --stop
  45         Stop playing.
  46
  47 -n, --next
  48         Skip forward in playlist.
  49
  50 -r, --prev
  51         Skip backward in playlist.
  52
  53 -R, --repeat
  54         Toggle repeat.
  55
  56 -S, --shuffle
  57         Toggle shuffle.
  58
  59 -v, --volume VOL
  60         Change volume. See *vol* command in *cmus*(1).
  61
  62 -k, --seek SEEK
  63         Seek. See *seek* command in *cmus*(1).
  64
  65 -l, --library
  66         Modify library instead of playlist.
  67
  68 -P, --playlist
  69         Modify playlist (default).
  70
  71 -q, --queue
  72         Modify play queue instead of playlist.
  73
  74 -c, --clear
  75         Clear playlist, library (*-l*) or play queue (*-q*).
  76
  77 -C, --raw
  78         Treat arguments (instead of stdin) as raw commands.
  79
  80 @h1 EXAMPLES
  81
  82 Add playlists/files/directories/URLs to library view (1 & 2):
  83
  84         @pre
  85         $ cmus-remote -l music.m3u \\
  86         http://live.urn1350.net:8080/urn_high.ogg
  87         @endpre
  88
  89 Load (clear and add) playlist to playlist view (3):
  90
  91         @pre
  92         $ cmus-remote -c music.m3u
  93         @endpre
  94
  95 Three different ways to toggle repeat:
  96
  97         @pre
  98         $ cmus-remote -R
  99         $ cmus-remote -C "toggle repeat"
 100         $ cmus-remote
 101         toggle repeat
 102         ^D
 103         @endpre
 104
 105 @h1 SEE ALSO
 106
 107 *cmus*(1)
 108
 109 @h1 AUTHOR
 110
 111 Written by Timo Hirvonen <tihirvon\@gmail.com>