Skip to content

Repository files navigation

Dropbeat

Dropbeat is a GNOME shell extension that shows a cool card to control your media player. Supports GNOME 46–51.

Screenshot

Screenshot uses art from Magnific.

You can also click the album art to get a fullscreen display window.

Fullscreen Screenshot

Screenshot uses art from Magnific.

GNOME 51 unstable is now supported in the development copy.

Features

  • View album art, track title, and artist name
  • Play, pause, skip, and seek with the animated progress bar (UNRELEASED)
  • Works with any MPRIS player such as Firefox, Spotify, VLC, etc.
  • Click the Album Art to open a fullscreen pop-up
  • Configurable global shortcut to toggle open the card
  • Enable the progress bar to show progress and seek to position
  • Very configurable, check Settings for a list of settings

Requires

ImageMagick (available in pretty much all distros' official repos)

Installation

GNOME Extensions

Recommended method, although updates are sometimes delayed. You still need to make sure your system has ImageMagick installed yourself. The extension explains how to do this on most distros.

Get on GNOME Extensions

Manual Installation

Guaranteed to be up-to-date, but generally not recommended. You still need to make sure your system has ImageMagick installed yourself. The extension explains how to do this on most distros.

git clone https://github.com/romanlefler/dropbeat.git
cd dropbeat

# Stable branch recommended
git switch stable

make install

Building

Below are various commands to build and test the extension.

Build to dist/build:

make

Launch test GNOME shell instance (make sure mutter devkit is installed):

./debug.sh

Install via Makefile:

make install

Create ZIP file:

make pack

Contributing

Everyone is welcome to contribute via pull requests.

Translating

Translations are welcome. Read Translating for more details.

Code

Everyone is welcome to contribute code. A few things to keep in mind:

  • If you're going to add features or anything like that it is recommended to make an issue first.
  • Please test your contribution using ./debug.sh before opening a pull request (make sure you have mutter devkit installed).
  • Do not put translation changes AND code changes in the same pull request. You can always make multiple.
  • Please keep your pull request to one general topic; do not make a bunch of unrelated changes in the same pull request. You can always open multiple.

About

A flashy GNOME shell extension to view your music/media.

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages