Work in Progress!!

Original Readme

KDE Plasma 6 Widget Collection

A modern, highly customizable, and unified collection of widgets for KDE Plasma 6.

Features • Widgets • Installation • Configuration • Contribute

---

Overview

This repository contains a suite of plasmoids ranging from advanced system tools (File Search, System Monitor) to essential desktop utilities (Clock, Calendar, Notes), all re-engineered for performance, visual consistency, and ease of use.

If you find this collection useful, please consider starring the repository!

---

Key Features

Feature	Description
Plasma 6 Native	Built fully on Qt6 and QML, optimized for the latest KDE Plasma desktop.
Unified Design	All widgets share a consistent look using system theme icons (breeze-icons).
Localization	Standard Gettext-based localization (.po/.mo) supporting 20+ languages including English, Turkish, German, French, Spanish, Russian, Portuguese, Italian, and more.
Modular Architecture	Clean code with reusable components and logic separated into JavaScript modules.
Power User Features	Smart Query in File Finder, dynamic MPRIS discovery, offline-first Calendar, and more.

---

Widget Catalog

MFile Search

A powerful Spotlight/Raycast alternative for Plasma.

• Smart Query: Understands KRunner prefixes (timeline:/, gg:) with interactive hint buttons
• Pinned Items: Pin favorite apps or files to the top for instant access
• Customizable Appearance: Select corner radius (Square to Round) and adjust panel height (18-96px)
• Localized: Full support for 20 languages including interactive prefix suggestions
• View Profiles: Minimal, Developer (with live telemetry), and Power User modes
• Rich Previews: Instant hover previews with async thumbnail caching
• Read detailed documentation

MWeather

A responsive, multi-provider weather dashboard with stunning animations.

• Adaptive Layouts: Morphs between Small, Wide (Card), and Large (Grid) modes
• Morphing Details: Unique overlay that expands smoothly from UI elements
• Widget Edge Margin: Customizable margins (Normal, Less, None) for better panel integration
• Zero Config: Works out-of-the-box with Open-Meteo (no API key required)
• Read detailed documentation

MBrowser Search

A minimalist browser search bar with quick access to history and settings.

• Multi-Engine: Support for Google, DuckDuckGo, Bing, and more
• Quick Access: Dedicated buttons for browser history and settings
• Widget Edge Margin: Adjustable spacing for a perfect panel fit
• Read detailed documentation

Music Player

A dynamic media controller that adapts to your workflow.

• Universal Control: Automatically finds active media players (Spotify, VLC, browser, etc.)
• Smart Discovery: Scans all active MPRIS services
• Visual Polish: Squeeze animations, dynamic pill-shaped badge, themed icons
• Read detailed documentation

MCalendar

A clean, offline-focused calendar widget.

• Privacy-First: No external dependencies for a fast, local experience
• System Integration: Uses system locale for date formats
• Modern UI: Fluid animations and improved event markers
• Read detailed documentation

Battery

A multi-device power monitor.

• Peripheral Support: Up to 4 devices (Mouse, Keyboard, Headphones, etc.)
• Dynamic UI: Charging indicators adapt to available space

Clocks

Analog & Digital clock widgets.

• Analog: Minimalist design with dynamic opacity and hand smoothing
• Digital: Configurable fonts (Roboto Condensed Variable) and hover-reveal seconds

Advanced Reboot

Power management with granular control.

• Boot Options: List and select UEFI/BIOS entries directly (requires bootctl)
• Safe UI: Confirmation interface to prevent accidental actions

Other Utilities

Widget	Description
Browser Search	Multi-engine search bar with history access
System Monitor	CPU, RAM, and Disk visualization
Notes	List-based notes with drag-and-drop reordering
Control Center	Quick toggles for system settings
AUR Updates	(Arch Linux) Update monitoring
World Clock	Multiple timezone display
Photos	Photo frame widget
Spotify	Dedicated Spotify controller
Events	Event reminder widget
Alarms	Alarm clock widget
MSI Control	MSI laptop control (temps, fan, shift modes)

---

Installation

Prerequisites

# Required packages
kpackagetool6      # Plasma widget installer
plasmawindowed     # For standalone testing (optional)

Quick Install (Recommended)

# Clone the repository
git clone https://github.com/MCC45TR/Plasma6Widgets.git
cd Plasma6Widgets

# Install all widgets
chmod +x install_all.sh
./install_all.sh

Install & Test Single Widget

# Install only a specific widget
./install_all.sh weather

# Install AND launch test window immediately
./install_all.sh -t weather

Manual Installation

cd widget-directory-name
kpackagetool6 --type Plasma/Applet --install .

# To update an existing widget:
kpackagetool6 --type Plasma/Applet --upgrade .

---

Configuration

Most widgets have a rich configuration panel accessible via Right Click → Configure.

Widget	Configuration Options
File Search	View Profile (Minimal/Developer/Power User), Search History
Music Player	Default player selection
Weather	Provider selection, Location, Units, Icon Pack
Clocks	Font, Size, Format options

---

Troubleshooting

Widget not showing after install?

Restart the Plasma shell:

systemctl --user restart plasma-plasmashell

Or log out and log back in.

"Error loading QML"?

Check real-time logs:

journalctl --user -f -g plasmashell

Missing Icons?

Ensure you have breeze-icon-theme or a compatible system icon theme installed.

---

Contribution

Contributions are welcome! Please follow these guidelines:

1. Localization: Add new strings to template.pot or relevant .po files in the widget's translations/ folder using Gettext
2. Icons: Prefer system icons over local assets
3. Versioning: Update metadata.json version when making changes

---

License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details.

---

Development Status

Widget	Status	Widget	Status
Analog Clock	Stable	Control Center	Planned
Calendar	Stable	Digital Clock	Planned
File Search	Stable	Events	Planned
Music Player	Stable	Minimal Analog Clock	Planned
Weather	Stable	Notes	Planned
App Menu	WIP	Photos	Planned
Browser Search	WIP	Spotify	Planned
Plasma Advanced Reboot	Stable	System Monitor	Planned
Alarms	Planned	World Clock	Planned
AUR Updates	Planned	MSI Control	WIP
Battery	WIP	AFAD-Earthquake	WIP

---

Maintained by MCC45TR

_{Note: AI tools were used in the development of this project.}