⚠️ MAINTAINERS NEEDED! See #222

Show controls and information of the currently playing media in the panel.

• Customize the extension the way you want it
• Basic media controls (play/pause/next/previous/loop/shuffle/seek)
• Mouse actions lets you run different actions via left/middle/right/scroll.
• Popup with album art and a slider to control the playback
• Scrolling animations
• Blacklist players

Install from source

• Download archive file from the releases tab
• Open a terminal in the directory containing the downloaded file
• Install and enable the extension by executing gnome-extensions install extension.zip --force in the terminal

• Make sure your issue isn't a duplicate
• Include the following information when creating the issue,
  • Extension version
  • Gnome version
  • Your distribution
  • A screenshot if it is possible

This project uses pnpm for package management and script execution. Make sure you have pnpm installed.

Building:

• pnpm build - Build the extension
• pnpm build:release - Build release version (strips debug code)
• pnpm clean - Clean build directory

Development:

• pnpm debug - Build, install, and enable extension for debugging
• pnpm reload - Build, install, and reload extension (X11 only)
• pnpm reinstall - Disable, uninstall, build, and install (common dev workflow)

Extension Management:

• pnpm run install - Install the extension
• pnpm run uninstall - Uninstall the extension
• pnpm run enable - Enable the extension
• pnpm run disable - Disable the extension
• pnpm run prefs - Open extension preferences

Development Tools:

• pnpm watch - Watch for setting changes
• pnpm translations - Update translation files
• pnpm format - Format code with Prettier

1. Clone the repository
2. Install dependencies: pnpm install
3. Build and install: pnpm reinstall
4. Enable the extension: pnpm run enable
5. Open preferences to test: pnpm run prefs

For active development, use pnpm reload (X11) or pnpm debug (Wayland) to test changes.

Any type of contribution is appreciated! If you have any suggestions for new features feel free to open a new issue.

If you are interested in translating, download the po file and translate it. Then open a pull request with the translated file. You can use Gtranslator or Poedit to translate.

If you are interested in contributing code. There are no specific guidelines for contributing. Just make sure you follow the coding style of the project. To update the translation files run pnpm run translations in the extensions directory after your changes are done. This will update the files in the locale folder.

Made with contrib.rocks.