Skip to main content

SpoTUI

Version Badge License Badge Code size Badge

Spotify in the terminal.

screenshot

Getting Started

Install with pip 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).

Run spotui 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 = yes
config_version = 1 

Once you're done start the app with spotui, 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 :stuck_out_tongue_winking_eye:)

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

Controls

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

FAQ

  • What do I do if something breaks? Raise an issue or submit a PR to fix my crappy code :pray:
  • 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

Dependencies

LICENSE

MIT

Metadata

Release files for spotui 0.1.20

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for spotui 0.1.20
File Size Uploaded
spotui-0.1.20.tar.gz 15.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for spotui 0.1.20
File Interpreter ABI Platform
spotui-0.1.20-py3-none-any.whl Python 3 none any Details

Total release size: 34.3 kB

Release files / spotui-0.1.20.tar.gz

Download URL spotui-0.1.20.tar.gz
Size 15.1 kB
Tags Source
SHA-256 checksum
How to use checksums
340aa83187d91d14b0bae82b24954e630eb6b36418988b4115a224809a980e39
BLAKE2b-256 checksum
How to use checksums
2e198636e8974cdc3a4723038c5d89b1251ef1ccb328bfd5441ad91ad6f69df3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.8

Release files / spotui-0.1.20-py3-none-any.whl

Download URL spotui-0.1.20-py3-none-any.whl
Size 19.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b39318cc38a7f11d63a0ceda67ac52df7b9038e989d54deadc7c727619eadf3c
BLAKE2b-256 checksum
How to use checksums
cedbf9dcd0c6f28076d7c6c934333bad32067cb6001fb9ee921f58368ffd338c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.8

Release history Release notifications | RSS feed

This release

0.1.20 This release

2 release files

0.1.19

2 release files

0.1.18

2 release files

0.1.17

2 release files

0.1.13

2 release files

0.1.12

2 release files

0.1.11

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page