Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ccatterina/plasmusic-toolbar

KDE Plasma widget that shows currently playing song information and provide playback controls.
https://github.com/ccatterina/plasmusic-toolbar

kde music plasma plasma-applet plasma5 plasma6 spotify toolbar vlc widget

Last synced: 5 days ago
JSON representation

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

Awesome Lists containing this project

README

        

# PlasMusic Toolbar

[![AUR Version](https://img.shields.io/aur/version/plasma6-applets-plasmusic-toolbar)](https://aur.archlinux.org/packages/plasma6-applets-plasmusic-toolbar) [![nixpkgs unstable package](https://repology.org/badge/version-for-repo/nix_unstable/plasmusic-toolbar.svg)](https://repology.org/project/plasmusic-toolbar/versions)

## 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](https://github.com/ccatterina/plasmusic-toolbar/tree/plasma5).

## 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:

- https://store.kde.org/p/2128143

### AUR package

For those using an Arch-based distribution, an AUR package is available:
- https://aur.archlinux.org/packages/plasma6-applets-plasmusic-toolbar

Thanks to [@D3SOX](https://www.github.com/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

```nix
environment.systemPackages = with pkgs; [
plasmusic-toolbar
];
```

- [Home-manager](https://github.com/nix-community/home-manager)

```nix
home.packages = with pkgs; [
plasmusic-toolbar
];
```

- [Plasma-manager](https://github.com/nix-community/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:
```sh
git clone https://github.com/ccatterina/plasmusic-toolbar.git /tmp/plasmusic-toolbar
```

2. Install the widget:

```sh
kpackagetool6 -i /tmp/plasmusic-toolbar/src/ --type Plasma/Applet
```

3. Upgrading the widget:

```sh
kpackagetool6 -u /tmp/plasmusic-toolbar/src/ --type Plasma/Applet
```

4. Removing the widget:

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

## Screenshots