Skip to content

junkmechanic/spotifz

Repository files navigation

Fuzzy search songs in your Spotify playlists using fzf in the terminal

Features

Home Screen:

  1. Devices
  2. Current Playback
  3. Update Cache
  4. Play/Pause
  5. Search My Library
  6. Current Queue

Selected Track:

  1. Play track in playlist
  2. Play track

TODO

  • current album in playlist
  • play history
  • display models for preview
  • screen models that store passed args and the previous screen
  • current playback to lead to searching by artist, album etc as the input query to fzf
  • using a db (perhaps sqlite) instead of json blobs on disk

Installation

  1. Make sure you have set up a developer account with Spotify.
  2. Create an app on Spotify Dev and obtain the API key.
  3. Copy config.json to ~/.config/spotifz.json and fill in the required json fields.
  4. Change to the root directory of this project and run pip install .
  5. You should be able to call spotifz from your shell.
  6. Select Update Cache the first time you run spotifz.

Dev Setup

  1. Create a virtualenv and activate it.
  2. pip install -r requirements.txt
  3. pip install -e .