spotipy-tui

Text-based UI to control Spotify client


Keywords
spotify, remote, audio, music, tui, curses
License
MIT
Install
pip install spotipy-tui==1.0.5

Documentation

Spotipy-TUI

PyPI version

Spotipy-TUI is a text-based UI program to control the Spotify desktop client on OSX.
Requires OSX, Python 3, and the Spotify desktop client.
Run it within a terminal session.

  • Make sure the terminal window you are running this program in is big enough!
  • If the terminal window is not large enough, the program can't start up.
  • Quick Demo Video

Installation

Pip

$ pip install spotipy-tui

If you have both Python 2 and 3 installed, make sure the pip command is pointing to the Python 3 version. (or replace 'pip' with whichever command you use to invoke pip for Python 3)

Clone Repo

$ git clone https://github.com/JonShepChen/SpotipyTUI.git
$ cd SpotipyTUI
$ python setup.py install

If you have both Python 2 and 3 installed, make sure the python command is pointing to the Python 3 version. (or replace 'python' with whichever command you use to invoke Python 3)

Usage

# Start the program
$ spotipy-tui

Command List

  • S: Search for music
  • I: Jump to song at index within search results
  • A: Go to album of current selection
  • T: Get current selection's artist's top tracks
  • C: Show command list
  • F: Bring Up Spotify desktop client
  • Y: Change Country ISO Code
  • B: Go back one listing in track listing history
  • N: Go forward one listing in track listing history
  • [Space]: Toggle Play/Pause
  • [Enter]: Play track at current cursor position
  • [Up]/K: Go Up
  • [Down]/J: Go Down
  • [Left]/H: Play previous track (based on cursor position)
  • [Right]/L: Play next track (based on cursor position)
  • O: Lower volume
  • P: Increase volume
  • V: Set volume level
  • Q: Quit

Dependencies

$ pip install requests