Skip to content

Command Line Arguments

Elijah Lopez edited this page Mar 3, 2022 · 30 revisions

Usage

When command-line arguments are used, Music Caster does not check for updates and thus will not auto-update. This ensures that using command-line arguments does what you want immediately without delays or restarts. There is an option to auto update from the command line if you value updates over responsiveness.

By the way, since this app is Windowed, there won't be any terminal feedback. If you want feedback, use the REST API.

usage: "Music Caster[.exe]" [-h] [--debug] [--start-playing] [--queue] [--playnext] [--urlprotocol]
                            [--update] [--nupdate] [--exit] [--minimized] [--version] [--position POSITION]   
                            [--shell] [--device DEVICE]
                            [uris ...]

Music Caster

positional arguments:
  uris                 list of files/dirs/playlists/urls to play/queue

options:
  -h, --help           show this help message and exit
  --debug, -d          allows > 1 instance + no info sent
  --start-playing      resume or shuffle play all
  --queue, -q          uris are queued not played
  --playnext, -n       paths are added to next up
  --urlprotocol, -p    launched using uri protocol
  --update, -u         update MC even if --args provided
  --nupdate            start without auto-update
  --exit, -x           exits any existing instance (including self)
  --minimized, -m      start minimized to tray
  --version, -v        returns the version
  --position POSITION  position to start at if resume_playing
  --shell              if from shell/explorer
  --device DEVICE      device to use

Example

"Music Caster" -q "C:\Users\maste\Music" "E:\Music\Adam K & Soha - Twilight.mp3" "favourite playlist" -m
Clone this wiki locally