53 lines
1.4 KiB
Markdown
53 lines
1.4 KiB
Markdown
# katoclock
|
|
|
|
Just a QML-only cat clock widget for KDE Plasma 6. Bootstrapped from my [kde-6-widget-starter](https://github.com/ruinivist/kde-6-widget-starter)
|
|
|
|
[Pling page](https://www.pling.com/p/2349620/)
|
|
|
|
|
|
|
|
# Install
|
|
|
|
- clone the repo
|
|
- `make install` from repo root
|
|
|
|
# Package
|
|
|
|
- `make package` builds a `.plasmoid` archive from the QML package and bundled image assets
|
|
|
|
# Pling Upload
|
|
|
|
This repo includes the same OpenDesktop/Pling uploader flow used by
|
|
`kde-6-widget-starter`.
|
|
|
|
Dry run validates login, project edit-page access, and upload endpoint discovery:
|
|
|
|
```bash
|
|
uv run python scripts/pling_upload.py --dry-run
|
|
```
|
|
|
|
Live mode uploads the packaged plasmoid and replaces the current files on the
|
|
target Pling project:
|
|
|
|
```bash
|
|
uv run python scripts/pling_upload.py -f build/katoclock.ruiny.de.plasmoid
|
|
```
|
|
|
|
The uploader reads the same environment variables as the starter:
|
|
`PLING_PROJECT_ID`, `PLING_USERNAME`, `PLING_PASSWORD`, `PLING_FILES`,
|
|
`PLING_TIMEOUT`, and `PLING_MAX_RETRIES`.
|
|
|
|
# GitHub Actions Release Upload
|
|
|
|
The workflow lives at `.github/workflows/pling-release-upload.yml`.
|
|
|
|
- Trigger: push a git tag matching `release*`, for example `release-v1.0.1`
|
|
- Build artifact: `build/katoclock.ruiny.de.plasmoid`
|
|
- Upload target: the Pling project identified by `PLING_PROJECT_ID`
|
|
|
|
Required GitHub repository secrets:
|
|
|
|
- `PLING_PROJECT_ID`
|
|
- `PLING_USERNAME`
|
|
- `PLING_PASSWORD`
|