Repository files navigation

Spotify in the terminal.

Install withpip install spotui

Please Note: SpoTUI will not work with free Spotify accounts.

Register a developer application at:https://developer.spotify.com/dashboard/login. Once you create the application you'll need to edit it to add a Redirect URI. Use something like 'http://localhost:8888/callback' (it doesn't matter what you use really as long as it matches what's in your config file).

Runspotui to generate a sample config file at ~/.config/spotui/.spotuirc or create one manually with the following:

[spotify_api]user_name = *Your spotify username*client_id = *Your application client ID*client_secret = *Your application secret*redirect_uri = http://localhost:8888/callback[other]use_nerd_fonts = yesconfig_version = 1

Once you're done start the app withspotui, log in via your browser and copy the URL of the broken web page you're taken to.(This ugly authentication process is part of the underlying Spotipy library I use so don't blame me 😜)

This app acts like a kind of remote control for Spotify. The best way to use it is in conjunction withSpotifyd which means you won't need to actually have Spotify open. Alternatively, you can just open Spotify on your computer, phone etc. (pressd to pick the device to play on).

Navigation

tab Switch section

k/↑ Up

j/↓ Down

g Scroll to top

G Scroll to bottom

Enter Select

/ Search

d Open device menu

Esc/q Quit/Back

Playback

space Play/Pause

n Next track

p Previous track

→ Seek 10s forwards

← Seek 10s backwards

s Toggle shuffle

r Toggle repeat

• What do I do if something breaks?Raise an issue or submit a PR to fix my crappy code 🙏
• Why can't I play anything? Check you have a device selected (d) and make sure you're using a paid Spotify account
• I get an error page when I log into Spotify This is correct - just copy the URL and paste it back into the terminal
• Podcasts aren't playing See: #13

• Spotipy

MIT