Skip to content

maliavko/spotifar

Repository files navigation

spotifar

Alternative Spotify client implementation via Far Manager plugin. The plugin itself is just a UI facade for the Spotify Web API, using Far Manager API to draw panels and dialogs for a user to perform some basic manipulations with the current playback and his spotify collection.

Alt Text

Rationale

  • simple minimalistic way to control your music
  • possibility to customize what you see in the app, on a contrary to the overloaded Spotify client
  • global hotkeys support
  • control and customize featuring releases and artists

Prerequisites

Spotify

For plugin to work as expected the user should have a Spotify account with active Premium subscription. Without one a playback functions will be forbidden, throwing 403 response. Beside the premium account, the user should obtain an authorisations token from Spotify developers dashboard.

Far Manager

For now, only Far Manager of version 3.0 and higher is supported.

Limitations

Starting from November 27, 2024 Spotify blocked some of their web endpoints, mainly related to their internal algorythms. In practise for the third parties it means no accees to:

  • all kind of recommendations and featurings: similar artists, freshly released albums, playlists created for you and etc.
  • audio analysis features

Quick start

Installing plugin

  1. Download plugin's binaries
  2. Unpack the archive into your %FARHOME%\Plugins\ folder
  3. If everything was right, you'll see a dedicated plugin's menu in the "Plugin Commands" dialogs in Far Manager (F11)

Obtaining Spotify API tokens

  1. Open a Spotify developers dashboard
  2. Click "Create App" button, input your information
    • "App name" and "App description" are up to you
    • "Redirect URIs" - http://127.0.0.1:5000/auth/callback
    • "Which API/SDKs are you planning to use?" - pick "Web API" and "Web Playback SDK"
    • Consent an agreement with Spotify's terms and save your data

Plugin configuration

  1. Open up plugin's configuration dialog in Far Manager (Shift+Alt+F9) and select corresponded Spotifar option
  2. In the dialog menu proceed with "General" option
  3. In the "Spotify API" settings block input your freshly obtained "Client ID" and "Client Secret"
  4. Leave "Port" data unchanged, or put the one you like, not forgetting to edit accordingly your callback url, used in the Spotify dashboard

Compiling

A detailed instruction

Dependencies

Plugin uses the following great 3rd-parties, without which it wouldn't be even possible to think of this implementation:

Thanks guys

About

An alternative Spotify client implementation via Far Manager plugin

Topics

Resources

License

Stars

Watchers

Forks