~obscurity/shy

cli remote controller for musicbee
✨ feature: add info command
🔨 chore: bump version
🔨 chore: cleanup justfile

refs

master
browse  log 

clone

read-only
https://git.sr.ht/~obscurity/shy
read/write
git@git.sr.ht:~obscurity/shy

You can also use your local clone with git send-email.

#shy🍂

A command line remote controller for MusicBee!

⚠️ Requires the MusicBee web server plugin mb_WWWserver to be installed.

#Installation

cargo install --git https://github.com/fawni/shy

#Usage

A command line remote controller for MusicBee

Usage: shy.exe <COMMAND>

Commands:
  play         Play or pause the current track [aliases: pause, p]
  stop         Stop the current playing track [aliases: s]
  next         Skip to the next track in queue [aliases: skip, n]
  previous     Skip to the previous track in queue [aliases: prev, b]
  add          Add track(s) to queue [aliases: a]
  clear        Clear the current queue [aliases: c]
  now-playing  Display the current playing track [aliases: np]
  queue        Display the current queue [aliases: q, list, ls, l]
  volume       Display or modify the player's volume [aliases: vol, v]
  seek         Set the position of the track
  shuffle      Set shuffle mode
  repeat       Set repeat mode [aliases: loop, r]
  help         Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

Most subcommands have aliases which are the recommended way of usage.

#In the following examples, | represents or.
shy np # print now playing
shy add track.mp3 track.flac path/to/album # adds track.mp3 track.flac and valid audio files in album directory to queue
shy v +10 | 80 | -40 # increase volume by 10 points | set volume to 80 | decrease volume by 40
shy seek 5 | 70% | -20 # seek 5 seconds | set position to 70% | go back 20 seconds

#Implemented

  • [x] Play/Pause
  • [x] Stop
  • [x] Next
  • [x] Previous
  • [x] Add to queue
  • [x] Clear queue
  • [x] Seek
  • [x] Volume
  • [x] Shuffle
  • [x] Repeat
  • [ ] Scrobble
  • [x] Now playing
  • [x] List queue
  • [ ] Album art to file (useless)

#License

OSL-3.0