Files
NowPlaying/README.md

1.6 KiB

NowPlaying

NowPlaying is a KDE Plasma 6 widget inspired by the Cleartext Rainmeter widget. It displays the current song and artist with compact media controls, and is meant to live on the desktop rather than in a panel.

Now on KDE 6: https://www.pling.com/p/2195583/

Prerequisites

You need the basic KDE and Qt 6 tools for Plasma widget development.

On Arch Linux, this is roughly:

sudo pacman -S plasma-sdk inotify-tools kirigami2 qt6-base qt6-declarative

Development

Run the widget directly from the local package:

make dev

Other test modes are available:

make dev MODE=panel
make dev MODE=desktop
make dev MODE=hidpi

Use hot reload while editing:

make watch

Install or upgrade the widget in your local Plasma package store:

make install

Create a distributable package:

make package

The package is written to build/org.ruiny.NowPlaying.plasmoid.

Project Structure

.
├── package/
│   ├── metadata.json
│   └── contents/
│       ├── config/
│       │   ├── config.qml
│       │   └── main.xml
│       └── ui/
│           ├── configGeneral.qml
│           ├── main.qml
│           ├── Player.qml
│           └── Representation.qml
├── scripts/
│   └── watch.sh
└── Makefile

Maintenance

Format files:

make format

Run lint checks:

make lint

Enable the repository pre-commit hook:

make hooks-install

Credits

Full credit to the Windows creator for the original idea. I just made a KDE clone.