golang spotify client
Go to file
abs3nt 6bbcd97b1e
ci/woodpecker/push/woodpecker Pipeline was successful Details
Merge pull request 'this should be println' (#20) from println into main
Reviewed-on: #20
2023-11-06 07:02:48 +00:00
assets gif 2023-01-16 22:50:43 -08:00
cmd this should be print 2023-11-05 20:42:20 -06:00
src update, checks in format, rename alias for dl 2023-10-20 10:52:55 -07:00
.gitignore CI: add completions 2023-02-28 09:02:16 -08:00
.golangci.yml make code less bad 2023-04-06 18:11:06 -07:00
.goreleaser.yaml version 2023-03-11 21:39:46 -08:00
.woodpecker.yml pipeline -> steps 2023-10-20 10:55:20 -07:00
LICENSE license 2023-01-15 13:19:26 -08:00
Makefile Makefile 2023-01-18 21:37:32 -08:00
README.md updates 2023-03-10 09:51:07 -08:00
go.mod update, checks in format, rename alias for dl 2023-10-20 10:52:55 -07:00
go.sum update, checks in format, rename alias for dl 2023-10-20 10:52:55 -07:00
main.go queue tracks, view queue, queue updates when open, hotkey clean up 2023-04-16 10:47:26 -07:00


IF YOU ARE ON GITHUB.COM GO HERE INSTEAD: https://git.asdf.cafe/abs3nt/gospt :)

If you open an issue or PR on github I won't see it please use git. Register on asdf and open your PRs there

This project is still under heavy development and some things might not work or not work as intended. Don't hesitate to open an issue to let me know.

status-badge video

To install (with a package manager):

Archlinux (AUR)

yay -S gospt


yay -S gospt-git

NetBSD (Official repositories)

pkgin install gospt

To build from source by pulling and building the binary

git clone https://git.asdf.cafe/abs3nt/gospt

cd gospt

make build && sudo make install


go here https://developer.spotify.com/dashboard/applications to make a spotify application. you will need a client ID and a client secret. Set your redirect uri like this:


add your information to ~/.config/gospt/client.yml like this

client_id: "idgoeshere"
client_secret: "secretgoeshere"
port: "8888"

if you dont want to store your secret in the file in plaintext you can use a command to retreive it:

client_secret_cmd: "secret spotify_secret"

you should have either client_secret or client_secret_cmd

then run


you will be asked to login, you will only have to do this the first time. After login you will be asked to select your default device, this will also only happen once. To reset your device run gospot setdevice

helpful keybinds are shown in the bottom of the screen, hit ? to see all of them

To use the custom radio feature:

gospt radio

or hit ctrl+r on any track in the TUI. This will start an extended radio. To replenish the current radio run gospt refillradio and all the songs already listened will be removed and that number of new recomendations will be added.

This radio uses slightly different logic than the standard spotify radio to give a longer playlist and more recomendation. With a cronjob you can schedule refill to run to have an infinite and morphing radio station.

To view help:

gospt --help

Very open to contributations feel free to open a PR

tmux plugin