• Stars
    star
    175
  • Rank 218,059 (Top 5 %)
  • Language
    Go
  • License
    MIT License
  • Created almost 7 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Terminal client for Spotify

Spotify CLI

Build Status codecov Go Report Card

Spotify Client which runs in the terminal.

How does it look like?

screenshot

How does it work?

What are the components of spotify-cli?

screenshot

How components talk with each other?

screenshot

How to run it?

Prerequisites

  1. Linux/MacOS operating system
  2. Google Chrome browser installed
  3. Premium Spotify Account
  4. Created Spotify Application under https://beta.developer.spotify.com/dashboard/applications (set redirect URI to http://localhost:8888/spotify-cli)

Go to https://beta.developer.spotify.com/dashboard/applications, find created earlier Spotify Application, find Client ID and Client Secret, and put them in environment variables

export SPOTIFY_CLIENT_ID=xxxxxxxxxxxxx
export SPOTIFY_SECRET=yyyyyyyyyyyyyyyy

Running from release

  1. Download release for your OS/architecture under https://github.com/jedruniu/spotify-cli/releases
  2. Unpack it (i.e. with tar -xvf spotify-cli_1.0.1_Darwin_x86_64.tar spotify)
  3. Run it (./spotify-cli)

Building from sources

Additional prerequisities

  1. Go language installed (version 1.12 or higher)

Steps

  1. Clone this repository outside your GOPATH, and cd into it.
  2. Build application
make build
  1. Run application
./bin/spotify-cli

Running tests

make test

Releasing

Before releasing set GITHUB_TOKEN environment variable and run:

make release

Unfortunately for releases to work files generated by packr are added to repo.

Built With

  • tui - Terminal User Interface framework
  • Spotify - Spotify Web API Wrapper
  • packr - Embeding static files in binaries