majjoha / voxctl

Command-line tool for controlling the VOX music player.

🎧 voxctl

voxctl is a command-line tool for controlling the VOX music player from the terminal.

Under the hood, it works by proxying calls to VOX using JavaScript for Automation which was introduced in Mac OS X Yosemite. voxctl currently supports all commands from the VOX scripting suite.

Requirements

• macOS 10.10 or newer.

Installation

brew tap majjoha/tap
brew install voxctl

Usage

Usage:
  $ voxctl [command]

Commands:
  start               # Starts VOX
  quit                # Quits VOX
  play                # Begins playback
  pause               # Pauses playback
  togglePlay          # Toggles playback between playing and paused 
  next                # Skips to the next track in the playlist
  previous            # Skips to the previous track in the playlist
  shuffle             # Toggles shuffle on or off
  playUrl URL         # Plays the specified URL
  addUrl URL          # Adds the specified URL to the playlist
  rewindForward       # Rewinds the current track forward
  rewindForwardFast   # Rewinds the current track forward fast
  rewindBackward      # Rewinds the current track backward
  rewindBackwardFast  # Rewinds the current track backward fast
  increaseVolume      # Increases the volume
  decreaseVolume      # Decreases the volume
  togglePlaylist      # Shows/hides the playlist
  info                # Displays information about the current track in JSON
  isRunning           # Prints true if VOX is open, otherwise false
  help                # Prints this information
  version             # Prints the version of voxctl

License

See LICENSE.

voxctl's Issues

Feature request: Is it possible to play a song providing file path?

Thanks for building this convenient tool, love it!

I wonder if it's possible to support playing a song with command like

voxctl playSong path/to/the/song.mp3

Thanks!