noc-plugins

A collection of Qt6/QML plugins for the Noctalia desktop shell.

Plugins

kde-connect

Shows paired and reachable KDE Connect devices in the Noctalia bar and panel. The panel displays device availability and battery state, and provides quick actions for pinging a device, ringing it, and sending the local clipboard. Requires the KDE Connect desktop package and the KDE Connect daemon.

Entry points: Main, BarWidget, Panel, Settings

ai-usage

Tracks DeepSeek API balance and per-model token usage. Shows current balance in the bar with a detail panel for per-model breakdown (V3, R1). Requires an API key configured in settings.

Entry points: Main, BarWidget, Panel, Settings

---

restart-quickshell

Control center button that restarts the Noctalia shell. Useful after configuration changes or when troubleshooting.

Entry points: ControlCenterWidget

---

roku-remote

Roku TV remote control from the Noctalia bar. Auto-discovers Roku devices on the local network via SSDP. Provides a full remote layout with d-pad, playback controls, volume, and app shortcuts. Configure a fixed IP in settings if auto-discovery is unavailable.

Entry points: Main, BarWidget, Panel, Settings

---

vps-monitor

Live VPS system statistics over SSH tunnel. Displays CPU usage (with sparkline), memory, disk, and network throughput in a compact bar widget. The detail panel adds per-metric graphs and a service uptime list with green/red status indicators.

Entry points: Main, BarWidget, Panel, Settings

Requires a small Python agent running on the VPS (agent.py) that collects stats every second and serves them via HTTP on localhost:19765.

Requirements

• Noctalia >= 3.6.0
• Qt 6 / QuickShell

Installation

cp -r <plugin> ~/.config/noctalia/plugins/

Then register the plugin in ~/.config/noctalia/plugins.json and add widgets to the bar via settings.json.

License

MIT