nico 3c69367660 Replace aether with a homegrown theme system + desktop theme widget
aether (the third-party GUI app) is gone - it didn't work reliably. Replaced
with theme/: colors.toml (palette), templates/<app>/ (Hyprland, Kitty, Rofi,
mako; unused Waybar template dropped), render.py (renders + reloads apps,
supports --set/--get/--dump), and wallpaper.py (archives + swaps the
wallpaper, deduped by hash, via a native zenity picker).

New ThemeWidget.qml: a small standalone widget pinned to the top-left corner
of the main monitor, independent of the bar and sitting on the Bottom wlr
layer (so normal windows can cover it). Two buttons - wallpaper gallery/picker,
and a color-role picker with a preset palette + hex input - call straight into
the scripts above.

Also includes an unrelated hyprland.lua fix found while testing the widget:
new kitty windows were coming up in genuine Hyprland fullscreen regardless of
workspace; a fullscreen_state window rule forces it off (plain
'fullscreen = false' turned out to be a no-op).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Dujsk9jYfxUVLtb5B8eC94
2026-09-28 01:53:04 +02:00
…

ricing

My personal dotfiles for a Hyprland desktop on Arch Linux. This repo tracks only the rice-relevant configs out of ~/.config (see .gitignore) — everything else in the home config directory is left untouched.

Heads up: the majority of this configuration — especially the entire Quickshell bar — was built with Claude Code. I described what I wanted, reviewed the results, and iterated from there rather than hand-writing most of the QML/config myself. If you're browsing this repo for ideas, keep that in mind: it's an AI-assisted rice, not a from-scratch hand-tuned one.

Stack

Piece Tool
Compositor Hyprland
Login screen SDDM — stock theme, not customized/tracked here (config lives under /etc, outside this repo's scope)
Bar Custom Quickshell shell (quickshell/default/) — replaces Waybar entirely
Launcher Rofi
Terminal Kitty
Cursor Custom Arch-logo cursor set (pointer, text, resize, wait spinner, …) in the rice palette — artwork in shapes.py, build.py installs a Hyprcursor and an XCursor theme to ~/.local/share/icons/ArchLogo
Notifications mako — themed from the palette, same as the rest
Theming theme/ — homegrown palette-driven theme generator (render.py), controlled from the Quickshell desktop widget or the CLI
Qt/GTK theming qt5ct, qt6ct, nwg-look
File manager Dolphin (kdeglobals, dolphinrc)

The bar

Waybar has been fully retired. The whole top bar is one Quickshell shell (quickshell/default/Bar.qml), instantiated per monitor, laid out with real QML layouts instead of a mix of two independent renderers guessing at each other's positions. It includes:

  • Logo + workspaces — per-monitor workspace pills (Hyprland IPC), click to switch. Click the logo itself to toggle taskbar mode (below)
  • Taskbar mode — clicking the logo swaps the workspace pills, window title, and stat pills for a compact Windows-style taskbar of every open window, shown as icon buttons (resolved via DesktopEntries.heuristicLookup(), the same mechanism app launchers use, falling back to the title's first letter if no icon is found). Hover a button for the full title, click to focus. Clock and power button stay visible in both modes
  • Window switcher — Mod+Shift+A drops down a list of every open window across all workspaces; click one to focus it
  • Active window title — per-monitor, shows the title of whichever window is focused on that specific screen
  • System tray — StatusNotifierItem icons with left-click activate / right-click context menu
  • CPU / RAM / disk / GPU — live stats pills, each with a titled hover tooltip; click the CPU or GPU pill to toggle it between usage % and temperature (the icon stays put, only the color/value change). The disk pill defaults to /; click it to cycle through every real mounted filesystem (a USB stick, /boot, …), hovering always lists all of them with their device name (e.g. nvme0n1p2), used/free space and live read/write speed
  • Volume — click opens the mixer, right-click mutes, scroll adjusts volume (via wpctl)
  • Network — shows the active connection (Wi-Fi SSID or wired); hover shows the local IP (click toggles to the public IP), the network device (e.g. enp7s0) and the live up/download rate in decimal bit units (Kbit/Mbit/Gbit/s, like a speedtest), refreshed every second independently of the slower connection/SSID lookup
  • Clock — hover for the full date + ISO week number, click opens a small month calendar
  • Notification panel — the bell button (with an unread badge) opens a panel down the right screen edge, top to bottom, listing recent notifications from mako's history. Click a notification (or “Mark all read”) to mark it read and drop it from the list. mako can't delete single history entries, so read state is kept by scripts/notifs.py in ~/.local/state/quickshell/notifs-read
  • Keybinds help — in taskbar mode, a ? button next to the clock (hover: hints what it does; click: opens a centered cheatsheet of every keybind, grouped by category). Also reachable from either mode via Mod+Shift+H. The list is hand-kept in sync with the Hotkeys section below — Hyprland's Lua config binds everything through one opaque __lua dispatcher, so hyprctl binds can't recover a human-readable action to auto-generate it from
  • Power menu — restart / shutdown / logout dropdown

All the stats are pulled by small shell scripts in quickshell/default/scripts/ rather than baked into the QML.

Hyprland itself is configured via hypr/hyprland.lua (Hyprland's Lua config API) — that's the active config; hyprland.conf is kept around for reference but is no longer loaded. One consequence: hyprctl dispatch (and anything sending it a raw dispatch string, like this bar's workspace/window-switcher clicks) needs the new hl.dsp.* Lua-expression syntax instead of the classic one, e.g. hl.dsp.focus({workspace = 1}) rather than workspace 1.

There's also a no_fullscreen_kitty window rule in there working around a real Hyprland quirk: newly opened kitty windows were coming up in genuine fullscreen (hasfullscreen: true, not just a full-size tile) regardless of workspace, needing fullscreen() dispatched twice to clear. Root cause not found (no rule/config was causing it); fullscreen_state = "0 0" on kitty forces both the internal and client-requested state off on open. Plain fullscreen = false is a no-op — that's just the default, it doesn't override anything.

Cursor

The mouse cursor is a custom theme, ArchLogo, with every shape redrawn in the rice style instead of only the arrow:

  • Default pointer — the Arch logo, rotated like a classic arrow, plain accent blue without an outline. Copy / context-menu / alias / help / no-drop are the same arrow with a small badge, and the link pointer is the logo upright
  • Everything else — text I-beam, resize arrows (edges, corners, column/row, all-direction), crosshair, cell, grab/grabbing hand, zoom, X, and a red not-allowed sign. These have a dark outline plus a light rim so they stay visible on blue or dark backgrounds
  • Animated — wait is a spinning ring, progress is the arrow with a small spinner badge

The artwork is drawn procedurally in hypr/cursor/shapes.py; hypr/cursor/build.py renders it (needs rsvg-convert and hyprcursor-util) into a Hyprcursor theme for Hyprland and an XCursor theme for GTK/Qt/XWayland apps, both installed to ~/.local/share/icons/ArchLogo. Adwaita is only used as the shape/alias list and fallback. It also writes ~/.local/share/icons/default/index.theme (Inherits=ArchLogo), Xcursor's fallback theme, so apps that never see XCURSOR_THEME (Steam and Proton games started before the env was set) get the cursor too — restart Steam once after installing. After editing shapes.py, run python3 hypr/cursor/build.py and hyprctl setcursor ArchLogo 24. hyprland.lua sets the theme via XCURSOR_THEME / HYPRCURSOR_THEME and gsettings.

Theming

Theming used to go through a third-party app called aether; it's gone now (it didn't work reliably), replaced with a small homegrown system in theme/:

  • theme/colors.toml is the single source of truth for the palette (accent, cursor, foreground/background, 16 ANSI colors)
  • theme/templates/<app>/ holds one {config.json, template} pair per themed app (Hyprland, Kitty, Rofi, mako). config.json names the destination file; the template uses {key} placeholders ({color4}, {background}, {accent}, …), {key.strip} for the hex without #, or {key.rgba:ALPHA} for a rgba(r, g, b, ALPHA) string
  • theme/render.py renders every template to its destination and reloads the affected apps (hyprctl reload, makoctl reload, kitty via SIGUSR1). Run it after editing a template by hand, or use --set KEY '#rrggbb' to change one color from a terminal, --get KEY / --dump to read the palette back out
  • theme/wallpaper.py swaps the wallpaper: apply <path> archives the current one (deduped by hash) into ~/.local/share/quickshell/wallpapers/ and copies the new one to hypr/wallpaper.png (loaded via swaybg in hyprland.lua), pick does the same via a native file picker, list feeds the widget's gallery of past wallpapers

mako's per-urgency border colors (normal = accent, low = muted, critical = red) work the same way as Hyprland's border colors: edit the template at theme/templates/mako/colors.ini, not mako/colors.ini itself — that gets overwritten on the next render.

Day to day, neither script needs to be run by hand — the theme widget, a small standalone Quickshell window pinned to the top-left corner of the main monitor (independent of the bar), has two buttons: a picture icon opens the wallpaper gallery/picker, a paintbrush icon opens a menu to pick which color role to change and then a palette (plus a hex field) to change it to. Both call straight into the scripts above.

It's a blue theme (#1793d1 accent on a dark #1a1b26 background) built around the stock default Hyprland wallpaper — the anime girl waiting at the train stop with the glowing blue Hyprland-logo cats. Every accent color across the bar, Rofi, Kitty, and the rest was picked to match that wallpaper's palette rather than the other way around.

Hotkeys

Mod = Super.

Apps

Key Action
Mod + Return Terminal (Kitty)
Mod + W Browser (Zen)
Mod + N File manager (Dolphin)
Mod + Space App launcher (Rofi)
Mod + Shift + P Spotify
Mod + Shift + C Discord
Mod + Shift + S Steam
Mod + Shift + T btop (in terminal)
Mod + Alt + C Qalculate
Mod + C Clipboard history (cliphist + Rofi)

Bar

Key Action
Mod + Shift + A Toggle the window switcher dropdown
Mod + Shift + H Toggle the keybinds panel (also reachable via the taskbar-mode help button)

Windows

Key Action
Mod + Q Close active window
Mod + Shift + E Exit Hyprland
Mod + F Toggle fullscreen
Mod + V Toggle floating
Mod + P Toggle pseudotiling
Mod + ← / → / K / J Move focus (left/right/up/down)
Mod + Shift + ← / → / ↑ / ↓ Move window
Mod + Ctrl + H / L / K / J Resize active window
Mod + LMB drag Move window
Mod + RMB drag Resize window

Workspaces

Key Action
Mod + 1 … Mod + 9 Switch to workspace 1–9
Mod + Shift + 1 … Mod + Shift + 9 Move window to workspace 1–9
Mod + Scroll Next/previous workspace

Screenshots

Key Action
Print Region screenshot → clipboard
Shift + Print Region screenshot → ~/Pictures/Screenshots/

Media / audio / brightness

Key Action
XF86AudioRaiseVolume / LowerVolume Volume up/down
XF86AudioMute Mute
XF86AudioMicMute Mute mic
XF86MonBrightnessUp / Down Brightness up/down
XF86AudioPlay / Next / Prev Media playback control

Requirements

Beyond Hyprland itself, the bar's scripts expect: quickshell, nmcli, wpctl, nvidia-smi (GPU stats — no-ops gracefully if absent), sensors (lm_sensors, for CPU temperature), python3, and curl (for the network widget's public-IP lookup). The theme widget's wallpaper picker additionally needs zenity (native file picker) and swaybg.

Layout

hypr/        Hyprland config (hyprland.lua is active, .conf kept for reference) + wallpaper.png + cursor/ (cursor theme source)
quickshell/  The bar (Bar.qml + helper QML components + scripts/) + ThemeWidget.qml (theming widget)
rofi/        Launcher config + theme
kitty/       Terminal config + theme
mako/        Notification daemon config (colors.ini generated by theme/render.py)
theme/       Palette source (colors.toml), per-app templates, render.py + wallpaper.py
btop/        System monitor config
qt5ct/ qt6ct/ nwg-look/ gtk-3.0/   Qt/GTK theming
Description
No description provided
Readme 40 MiB
Languages
QML 68.8%
Python 17.7%
Lua 6%
Shell 3.1%
Scheme 2.9%
Other 1.5%