Flow.Launcher.Plugin.SpotifyPremium

Spotify plugin for Flow Launcher

About

Control your Spotify client from the Flow Launcher. Search for tracks, artists, or albums and launch the results directly to your client.
This plugin requires the use of the Spotify Web API, which is only accessible through Spotify Premium.

Usage

| Keyword | Description | | ---------------------------------- | ------------------------------------------------ | | sp | Show currently playing track | | sp {spotify search query} | Search all of Spotify | | sp track {track name} | Search for a track | | sp artist {artist name} | Search for an artist | | sp album {album name} | Search for an album | | sp playlist {playlist name} | Search personal playlists | | sp queue {track name} | Search for track and queue it | | sp next | Play next track | | sp last | Play previous track | | sp play | Resume currently playing track | | sp pause | Pause currently playing track | | sp mute | Toggle Mute | | sp volume {level} | Set Volume (absolute 1-100 or relative +/- 20) | | sp device | Set Active Device | | sp shuffle | Toggle Shuffle Mode | | sp repeat | Cycle Through Repeat Modes | | sp reconnect | Force a full reconnection | | sp like | Add the playing track to liked songs | | sp like {track name} | Search for a track to add to liked songs | | sp unlike | Remove the playing track from liked songs |

Notice

• Spotify relies on Web Authentication Calls to Connect to the API remotely - you will need to authorize it to use this plugin.
• You NEED a client secret and client ID to use this plugin! This app currently hardcodes my personal Client ID and Client Secret to interact with Spotify. If current app usage hits any API limits, naturally you will need to switch out the current Client ID and Secret.
• To use a custom ID/Secret, create a file called security.store in yourFlowUserDataDirectory\Plugins\SpotifyPremium-ver\security.store with the following format:

{"ClientId":"yourClientID", "ClientSecret":"yourClientSecret"}

• If using roaming, your Flow Userdata Directory is: %APPDATA%\FlowLauncher
• If using portable, your Flow Userdata Directory is: %localappdata%\FlowLauncher\app-<VersionOfYourFlowLauncher>\UserData
• To generate a Client ID and Secret, navigate to your Spotify developer dashboard, login, and generate your own ID & Key.
• After generating a key pair, under "edit settings", add http://localhost:4002/callback as a Redirect URI.

Info

• This plugin cannot currently search for Podcasts - this is due to a restructure of the Spotify API which enabled support for "FullEpisode", among other things. See the SpotifyAPI-NET Documentation for more information.
• The Spotify queue API currently only supports adding single tracks to queues, not albums, even though the player can add albums, etc.
• Set Flow Launcher Maximum Results Shown to 12 or higher for best results.

Development

• To get started developing:
  • Restore all NuGet dependencies (dotnet restore)
  • Build with dotnet build
  • Copy the Output/Debug/<Plugin> folder to your FlowLauncher Userdata\Plugins folder

Third-Party Libraries

• SpotifyAPI-NET : Spotify API wrapper
• Json.Net : High performance json library

To Do - Ideas

• Search user content (saved music)
• Configurable default search type
• Add configuration menu
  • Would really like a config menu for people to put their own app ID/Secrets