82 lines
1.6 KiB
Markdown
82 lines
1.6 KiB
Markdown
# 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.
|
|
|
|
https://www.pling.com/p/2195583/
|
|
|
|
> I think this is pretty much in a "done" state now feature-wise, except of course any bug fixes
|
|
|
|
## Prerequisites
|
|
|
|
You need the basic KDE and Qt 6 tools for Plasma widget development.
|
|
|
|
On Arch Linux, this is roughly:
|
|
|
|
```bash
|
|
sudo pacman -S plasma-sdk inotify-tools kirigami2 qt6-base qt6-declarative
|
|
```
|
|
|
|
## Development
|
|
|
|
Run the widget directly from the local package:
|
|
|
|
```bash
|
|
make dev
|
|
```
|
|
|
|
Other test modes are available:
|
|
|
|
```bash
|
|
make dev MODE=panel
|
|
make dev MODE=desktop
|
|
make dev MODE=hidpi
|
|
```
|
|
|
|
Use hot reload while editing:
|
|
|
|
```bash
|
|
make watch
|
|
```
|
|
|
|
Install or upgrade the widget in your local Plasma package store:
|
|
|
|
```bash
|
|
make install
|
|
```
|
|
|
|
Create a distributable package:
|
|
|
|
```bash
|
|
make package
|
|
```
|
|
|
|
## Customization
|
|
|
|
The widget appearance can be tuned from the Plasma widget settings, including:
|
|
|
|
- custom multiline label text
|
|
- independent label, title, and artist font sizes
|
|
- title/artist vertical spacing
|
|
- NOW/PLAYING label vertical spacing
|
|
- separator gap from labels
|
|
- separator gap from track text
|
|
- separator height percentage
|
|
|
|
## Release Upload
|
|
|
|
Required GitHub repository secrets:
|
|
|
|
- `PLING_PROJECT_ID`
|
|
- `PLING_USERNAME`
|
|
- `PLING_PASSWORD`
|
|
|
|
To dry run
|
|
|
|
```bash
|
|
uv run --env-file .env python scripts/pling_upload.py --dry-run
|
|
```
|
|
|
|
## Credits
|
|
|
|
Full credit to the Windows creator for the original idea. I just made a KDE clone.
|