mattboardman / baton

CLI / TUI to remotely manage Spotify playback

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Baton

Baton is a CLI tool to manage Spotify playback and includes a TUI for searches

alt text

Install

Fetch the release for your platform from the following page. Use chmod to set permissions on your binary and move it to /usr/local/bin or equivalent.

Setup

Use the baton auth command to perform an initial setup. The command will take you through the process but you will need to login to the Spotify API dashboard, create an app, and set it up with a redirect URL of http://localhost:15298/callback.

This process will generate a long-lasting refresh token and ideally will never have to be repeated.

Usage

CLI Commands

Command Description
auth authorize Baton to access the Spotify Web API on your behalf
devices list all available playback devices
help help about any command
next skip to next track
pause toggle Spotify pause state
play play top result for specified artist, album, playlist, track, or uri
prev skip to previous track
repeat get/set repeat mode
replay replay current track from the beginning
search search for specified artist, album, playlist, or track and select via interactive TUI
seek skip to a specific time (seconds) of the current track
share get uri and url for current track
shuffle toggle shuffle on/off
status show information about the current track
transfer transfer playback to another device by id
vol get/set volume

TUI Keybinds

Keybind Description
h go back one screen
j move the cursor down a line
k move the cursor up a line
l go into playlist, album, or artist
p play selected item
Enter play selected item and quit
m load additional pages from search query
q quit

License

MIT

Credits

Baton is built using:

About

CLI / TUI to remotely manage Spotify playback

License:MIT License


Languages

Language:Go 100.0%