/krunner-spotify

Allows you to easily control Spotify via KRunner.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

KRunner-Spotify

This plugin allows you to easily control Spotify using KRunner. The plugin uses Spotipy to interact with the Spotify Web API. Using only a handful of words the user can control Spotify in a straightforward manner, even if Spotify does not run on the same device as KRunner is running on. Whether you are playing Spotify on your phone, Chromecast(Audio), Smart TV or anyother device, you are able to control it using this plugin!

Dependencies

In order to run the project the following software needs to be installed:


Install

After installing all dependencies listed above, the following steps are needed to finish the installation:

  1. Clone the repo
git clone https://github.com/MartijnVogelaar/krunner-spotify
  1. Install
sh install.sh



Uninstall

In order to uninstall the plugin the following has to be done:

  1. Navigate to the repo
cd /path/to/repo
  1. Install
sh uninstall.sh

Functionalities

The KRunner-Spotify plugin has a wide range of functionalities including:

  • Adding songs to the queue
  • Increasing/Decreasing the volume
  • Pause/Resume a track
  • Play next/previous track
  • Play a song/playlist
  • Search for songs, artists, playlists and your playlists
  • View the info of the current track

Usage

See USAGE.md for an extensive guide.

Future implementations:

  • Support for Podcasts
  • Control progress of a track
    • Fast forward
    • Rewind
    • Move to a certain point in the track
  • Control your own playlists
    • Create
    • Delete
    • Rename
    • Add (current) song to playlist
  • Search and play album by name
  • Search and play album by artists name
  • Play an artist besides just searching for songs by artist.
  • Change playback style
    • Shuffle
    • Normal
    • Repeat

License

Distributed under the GPL-3.0 License. See LICENSE for more information.

Contact

Martijn Vogelaar - Martijn.j.Vogelaar@outlook.com

Project Link: GitHub