Skip to content

KDE Plasma widget that shows currently playing song information and provide playback controls.

License

Notifications You must be signed in to change notification settings

ccatterina/plasmusic-toolbar

Repository files navigation

PlasMusic Toolbar

AUR Version nixpkgs unstable package

Overview

PlasMusic Toolbar is a widget for KDE Plasma 6 that shows currently playing song information and provide playback controls.

A Plasma 5 version of the widget is available in the plasma5 branch.

Features

🎵 Now Playing Song

  • Show the currently playing song's title and artist in the KDE panel

⏯️ Playback Controls

  • Manage your music effortlessly with Play, Pause, Next, and Previous controls directly from the KDE panel.

📸 Full View

  • Full View provides the album image, along with Play, Pause, Next, Previous, Shuffle, and Repeat controls. Adjust the volume and track position with ease.

🛠️ Configurations

  • Icon customization: Change the widget's icon in the panel view to suit your preferences. You can also choose to display the album cover.
  • Font customization: Change the widget's text font to suit your preferences.
  • Playback controls visibility: Choose whether to display Play, Pause, Next, and Previous controls in the panel view.
  • Preferred source: Change the widget preferred source for music information.
  • Playing song max display width: Determine the maximum width for displaying the currently playing song in the panel. When the song's text exceeds this maximum width, the text will scroll horizontally.
  • Playing song scrolling speed: Change the scrolling speed of the song's text.
  • and more...

Installation

KDE store

You can install the widget directly from the kde store:

AUR package

For those using an Arch-based distribution, an AUR package is available:

Thanks to @D3SOX for creating and maintaining the package!

Nix package

For those using NixOS or the nix package manager, a Nix package is available in nixpkgs-unstable.

To install the widget use one of these methods:

  • NixOS

    environment.systemPackages = with pkgs; [
      plasmusic-toolbar
    ];
  • Home-manager

    home.packages = with pkgs; [
      plasmusic-toolbar
    ];
  • Plasma-manager: If the widget gets added to a panel it will automatically be installed

  • Other distros using nix package manager

    # without flakes:
    nix-env -iA nixpkgs.plasmusic-toolbar
    # with flakes:
    nix profile install nixpkgs#plasmusic-toolbar
    

Manual

  1. Clone the repository:

    git clone https://github.com/ccatterina/plasmusic-toolbar.git /tmp/plasmusic-toolbar
  2. Install the widget:

    kpackagetool6 -i /tmp/plasmusic-toolbar/src/ --type Plasma/Applet
  3. Upgrading the widget:

    kpackagetool6 -u /tmp/plasmusic-toolbar/src/ --type Plasma/Applet
  4. Removing the widget:

    kpackagetool6 -r plasmusic-toolbar --type Plasma/Applet

Screenshots