| name | quickshell-clock-label |
| description | Use when creating live time/date labels, clocks, timers, or date display widgets in Quickshell. |
| source_examples | ["examples/quickshell/components/SystemClockLabel.qml","examples/quickshell/standalone/panel-corner-card.qml"] |
| source_docs | ["https://quickshell.org/docs/v0.3.0/types/Quickshell/SystemClock/","https://doc.qt.io/qt-6/qml-qtqml-timer.html"] |
Quickshell Clock Label
When to use
Use this for any widget that claims to show current time, date, or an updating clock.
Steps
- Prefer Quickshell
SystemClock over a hand-rolled timer for Quickshell artifacts.
- Set
precision: SystemClock.Seconds for second-level clocks or SystemClock.Minutes when seconds are not displayed.
- Bind the label to
Qt.formatDateTime(clock.date, format).
- Do not use static placeholders such as
"12:00" in generated artifacts.
- If a pure Qt fallback is required, use
Timer { interval; repeat: true; running: true; onTriggered: ... } and record why SystemClock was not used.
Safety baseline
- Keep work in the project sandbox unless explicitly asked to edit source.
- Do not write to
~/.config/quickshell.
- Do not launch a live persistent widget from a skill; generate/static-review first.
- Keep KDE/Wayland examples free of
hyprctl and FloatingWindow.
Verification
- Clock artifact contains
SystemClock and Qt.formatDateTime(clock.date when targeting Quickshell.
- No static placeholder time remains.
- The manifest or report identifies the exact artifact path and hash used for review.