dms-warp-toggle
June 26, 2026 · View on GitHub
A minimal DankMaterialShell plugin that toggles Cloudflare WARP via warp-cli with real-time status updates.

Features
- Real-time status — Uses
warp-cli -l statuslive stream for instant state updates - Minimal & polished — Card-based UI with badge-style bar pill, spinner animation, and a clean popout panel following DMS Material 3 design
- No DBus, no native bindings — Interacts with WARP exclusively via subprocess calls
- Settings — Toggle the listener, manual refresh
Requirements
warp-cliinstalled and available in$PATH- DankMaterialShell >= 1.4.0
Permissions
process— spawnwarp-clisubprocessessettings_read/settings_write— persist plugin preferences
Usage
- Click the bar pill to toggle WARP on/off
- Expand the widget to see detailed status and a toggle button
- Open plugin settings to configure the listener behavior
Files
| File | Description |
|---|---|
plugin.json | Plugin manifest |
WarpToggle.qml | Main UI component (bar pill + popout) |
WarpToggleService.qml | Singleton service (listener process + toggle logic) |
WarpToggleSettings.qml | Settings panel |
components/WarpToggleButton.qml | Reusable toggle button |
qmldir | QML singleton registration |
License
MIT