Flow.Launcher.Plugin.SpotifyPremium

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 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":"yourClientSecret","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 https://developer.spotify.com/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
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

fow5040 / Flow.Launcher.Plugin.SpotifyPremium

readme