# README
Baton
Baton is a CLI tool to manage Spotify playback and includes a TUI for searches
NOTE: You can't change songs, volume, etc without Spotify premium due to a limit on their web API
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 |
| me | Commands related to your profile (saved tracks, albums, playlists) |
| 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 |
| s | save or unsave the currently selected track or album |
Building
To build the program, simply run make or make build, this will build for all 3 platforms (note: to do this on windows you'll need Make for windows). To build for one specific platform run make <platform> where platform is either "windows", "darwin" (for MacOS) or "linux". You can also run from source by running make run.
License
MIT
Credits
Baton is built using: