kde-plasmoid

Build KDE Plasma plasmoid widgets with Python backend and QML UI.

14|1|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/CodeAtCode/oss-ai-skills --skill kde-plasmoid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kde-plasmoid
Source: https://github.com/CodeAtCode/oss-ai-skills/tree/main/extend/kde-plasmoid
Command: npx skills add https://github.com/CodeAtCode/oss-ai-skills --skill kde-plasmoid

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a complete, modern guide for building KDE Plasma widgets (Plasmoids) using a Python backend with a QML UI, including required metadata configuration and distribution steps for KDE Store.

Core Features & Use Cases

  • Architectural guidance: explains the split between a Python backend (QObject-based logic) and a QML UI powered by Kirigami, with a recommended project structure.
  • Configuration & packaging: covers metadata.json, contents/config, and packaging steps for KDE Store submission.
  • Development workflow: includes setup, testing with plasmoidviewer, and distribution.

Quick Start

Follow this guide to scaffold a Plasma widget project with Python backend and QML UI.

Frequently Asked Questions about kde-plasmoid

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I develop KDE Plasma widgets using Python and QML?

To develop KDE Plasma widgets with Python and QML, structure your project under a plasmoid/ directory, define a QObject-based Python backend, build the UI with Kirigami, and configure metadata.json for Plasma 6+.

What is the correct project structure for a Plasma 6 plasmoid?

A correct Plasma 6 plasmoid structure requires a metadata.json file, a contents/config directory, and a main.qml file, separating Python backend logic from QML UI components.

Can I use Python for backend logic in a KDE Plasma widget?

Yes, you can use Python for backend logic in a KDE Plasma widget by implementing QObject-based classes that interface directly with your QML UI powered by Kirigami.

How do I package and distribute a plasmoid to the KDE Store?

To package and distribute a plasmoid to the KDE Store, configure your metadata.json and contents/config, package the project directory, and submit it through the KDE Store submission workflow.

How do I test a Plasma widget locally during development?

You test a Plasma widget locally during development by using the plasmoidviewer tool to render and interact with your QML UI and Python backend before final packaging.