Material 3 desktop clock widgets for Quickshell on Wayland. Four interchangeable faces share a Matugen-driven color pipeline and a single config surface.
Scalloped Analog | Stacked Digital | Pill Digital | World Clock |
- Scalloped Analog. Canvas-drawn 12-lobed flower face using cubic bezier curves. Pill-shaped hour and minute hands with rotation animations. Orbiting seconds dot with spring interpolation.
- Stacked Digital. Hero hours-over-minutes layout with rolling digit transitions.
- Pill Digital. Horizontal pill layout with tonal fill for narrow panels.
- World Clock. Stacked surface cards showing local time, relative offsets, and day status per timezone.
Copy the module into your Quickshell config path:
cp -r m3qs ~/.config/quickshell/
quickshell -p ~/.config/quickshell/m3qsEdit Config.qml:
| Property | Type | Default | Description |
|---|---|---|---|
variant | string | "stacked" | Active face: "stacked", "scalloped", "pill", "world" |
theme | string | "pixel-blue" | Color palette key from themes/Themes.qml |
radiusScale | real | 1.0 | Multiplier for all corner radii |
animationSpeed | real | 1.0 | Duration multiplier for all animations (0 disables motion) |
use24Hour | bool | false | 24-hour vs 12-hour display |
anchorPosition | string | "center" | Screen position: "center", "topLeft", "topRight", "bottomLeft", "bottomRight" |
worldTimezones | list | See Config.qml | List of { label, zone } objects (IANA tz identifiers) |
Register the template in your Matugen config:
[templates.m3qs]
input_path = "~/.config/quickshell/m3qs/matugen/templates/colors.qml"output_path = "~/.config/quickshell/m3qs/Colors.qml"Run Matugen on wallpaper change. Quickshell hot-reloads Colors.qml automatically. A static fallback palette ships by default if Matugen is not installed.
Eight color presets are available — switch via Config.qml:
propertystringtheme:"emerald-green"// see themes/Themes.qml for all keys| Theme | Primary | Description |
|---|---|---|
pixel-blue | #D0BCFF | Android dynamic blue (default) |
emerald-green | #6BBF8A | Botanical green |
amethyst-purple | #B59CFF | Rich violet |
crimson-rose | #FFB4AB | Warm red |
amber-sunset | #FFB870 | Golden orange |
teal-cyan | #78D8D8 | Ocean teal |
charcoal | #9E9E9E | Monochrome greyscale |
nordic-slate | #8EADC8 | Cool blue-grey |
All palettes are defined in themes/Themes.qml. See themes/README.md for details.
wallpaper / system theme
|
v
Matugen -> Colors.qml -> all components
|
shell.qml (Loader + MotionBlurWrapper)
ScallopedAnalogClock / StackedDigitalClock
PillDigitalClock / WorldClock
See docs/ARCHITECTURE.md and docs/DESIGN.md.
See CONTRIBUTING.md.
MIT. See LICENSE.
