Skip to content

sxoxgxi/gspotify

Repository files navigation

Logo

GSpotify - GNOME Shell Extension

GSpotify is a GNOME Shell extension that integrates with the Spotify MPRIS interface to display current track information, album art, and playback controls directly in your top panel.

It is designed to be theme-aware, and customizable*


✨ Features

  • Now Playing info: Show track title and artist in the top bar.
  • Album Art: Displays album art in the dropdown menu.
  • Playback Controls: Play, pause, skip, seek, previous and volume control.
  • Progress Bar: Live track progress indicator with dynamic accent color.
  • Theme-Aware Colors: Colors adapt based on the dominant album art color.
  • Local Statistics: Keep track of your listening habits.
  • Track Downloading: Download and save tracks to your computer.
  • Spotify Connection: Connects to your Spotify account for managing liked library.
  • Ad mute: Mutes Spotify's volume when an advertisement is playing.

📸 Media

Examples


🚧 Todo

  • Shuffle and repeat buttons if available.
  • Add support for track downloading.
  • Local Statistics.
  • Synced and Plain Lyrics.

📦 Installation

From Extensions Website

This extension is available on GNOME Extensions Website.

From Source

  1. Clone the repo into your local extensions directory:
    git clone https://github.com/sxoxgxi/gspotify \
      ~/.local/share/gnome-shell/extensions/[email protected]
  2. Compile schemas:
    glib-compile-schemas ~/.local/share/gnome-shell/extensions/[email protected]/schemas
  3. Enable the extension:
    gnome-extensions enable [email protected]
  4. Restart GNOME Shell (on X11 press Alt+F2 then type r and hit enter to restart) or log out and log back in.

🛠 Development

  • Logs are available via:
    journalctl -f -o cat /usr/bin/gnome-shell
  • Modify code and reload GNOME Shell to test changes.
  • Schemas live in schemas/org.gnome.shell.extensions.gspotify.gschema.xml.

About

A label, downloader and integrated Spotify controller for GNOME Shell

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors