fcitx5 rewrote these files, commenting out every key set to its
default value (empty Layout in profile, Dubeolsik keyboard and
default keybindings in hangul.conf). Nothing behavioral changes, so
commit the normalized form rather than fight it on every rewrite.
The SUPER+SHIFT+F23 combo exists on the laptop's Copilot key only. On
other keyboards (TypeMatrix 2030 with Dvorak, laptops without a Copilot
key) there is no F23, so bind the same state-guarded scripts to
SUPER+SHIFT+Pause as well: Pause is Fn+F12 on the TypeMatrix and a
spare key elsewhere. Binds stay modifier-gated so bare Pause keeps its
existing use.
The Copilot key only exists on one laptop; the binding is the
SUPER+SHIFT+F23 combo, which any keyboard can send. Name the combo and
mention the Copilot key only as the thing that emits it.
The rest of the list does not assume a distro, so the AUR mention and
the Arch package names for the Vulkan driver should not either. State
what is needed and give the Arch names as a parenthetical.
No other feature gets its own README section; the install doc is a
dependency list and keybindings live in the cheatsheet. The detailed
setup notes live in the knowledge base, so the README only keeps the
short parentheticals a fresh install actually needs.
Keep the dictation daemon config versioned with the rest of the setup.
The file carries no secrets (local backend), but if a cloud backend with
an API key is ever configured it must not be committed; whisrs accepts
WHISRS_GROQ_API_KEY-style env vars instead.
Manual re-application of the PKGBUILD edits is easy to forget after an
AUR update, which would silently bring back the five-second stock
build. The tracked rebuild script in ~/Projects/whisrs-local-build
does pull, patch, build, install and restart in one command.
Long holds occasionally dropped the release event in Hyprland, leaving
whisrs recording until its silence auto-stop, and any stray toggle
(key repeat, re-fired press) could invert the state so that pressing
stopped and releasing started. The press and release binds now go
through tiny scripts that check the daemon status first, making the
toggle pair idempotent: start only when idle, stop only when recording.
Also a note-to-self: Hyprland auto-reloads when files under the config
symlink change, so a git rebase in this repo can transiently drop
newly added binds; run hyprctl reload after git operations.
wtype is not actually used by whisrs: injection happens through the
Wayland virtual-keyboard protocol with a uinput fallback, so listing
wtype as a dependency would send fresh installs down the wrong path.
pipewire-alsa on the other hand is essential and was missing: whisrs
captures through raw ALSA, and without the PipeWire bridge the default
PCM is the silent headset-jack mic.
Also document the hold-to-talk binding, the [audio] device setting, and
the local rebuild (-march=native plus the vulkan feature) that moved
decoding to the iGPU, since the stock AUR build is far too slow for
dictation.
Bind the Copilot key (SUPER+SHIFT+F23) to whisrs on press and release,
so holding it records and letting go transcribes. Injection uses wtype,
which works natively on Hyprland and reaches any focused window,
including TUIs running in the dockerized agent containers.
Decoding runs on the iGPU through the Vulkan feature of a locally
rebuilt whisrs-git: the stock AUR build is CPU-only and compiled with
generic -march, which made dictation take around five seconds. Requires
whisrs-git (AUR), wtype and pipewire-alsa; documented in the README
along with the config and model locations.
With fade_on_empty=true, a 0.3-alpha inner_color and placeholder_text=$LAYOUT
(which resolves empty under fcitx5), the empty input field faded to nothing —
only the clock rendered and there was no visible way to type the password.
- fade_on_empty = false
- inner_color alpha 0.3 -> 0.6
- static placeholder 'Enter password' instead of $LAYOUT
Also document the graceful emergency unlock (pkill -USR1 hyprlock) in
lock.sh: SIGTERM/SIGKILL on a running lock latches Hyprland's crashed-
lockscreen state, requiring hl.clear_crashed_lockscreen() to recover.
Clarify in hyprlock.conf that the fingerprint auth block is for Chester and
is a no-op on machines without fprintd (e.g. Rutherford).
The Lua conversion had introduced a named 'magic' special workspace on the
SUPER+S keybinding while KeePassXC and the terminal still targeted the default
'special' workspace, splitting them into two separate scratchpads and making
KeePassXC unreachable. Route everything through the single default special
workspace to match the original .conf behavior.
Restore hypridle.conf to the working Chester baseline (Step 1 dim + simple
step-3 resume) keeping our after_sleep_cmd (sleep 2; dpms on). Remove the
orphaned wake-display.sh / unstick-display.sh scripts added upstream for the
multi-GPU black-screen workaround.
require() only needs the module's side effects; the returned value is
ignored by hyprland.lua. Chester.lua and example.lua now match
Rutherford.lua in ending after their config statements.
hyprland.lua now just uses its defaults when no hosts/<hostname>.lua
matches, instead of requiring hosts/example.lua. example.lua is kept only
as a documented template for contributors.
Hyprland loads hyprland.lua (not hyprland.conf) when present, so the
hyprlang configs are dead weight. Delete the Hyprland .conf files and
their gitignored host .conf counterparts, leaving only hypridle.conf and
hyprlock.conf (used by separate tools that still use hyprlang).
Enable misc:key_press_enables_dpms / mouse_move_enables_dpms so the
compositor re-enables the display on input when hypridle's after-sleep
dpms-on races with GPU resume. Also delay after_sleep_cmd dpms-on by 2s.
Fixes black Hyprland VT after wake while kernel console stays visible.
dim creates a wlr-layer-shell surface that Hyprland never cleans up
when the process exits — leaves an opaque full-screen overlay (pid=-1)
covering the entire display until the layer tree is rebuilt.
Removing step 1 (dim) from hypridle prevents future occurrences.
unstick-display.sh now restarts waybar to force a layer tree rebuild
as a recovery measure.
Both scripts used ls | head -1 to find the socket, which picks the wrong
(dead) session when old socket dirs linger. Now iterates over all sockets
and picks the one that actually responds.
- AQ_DRM_DEVICES=/dev/dri/card0 forces Aquamarine to use only the
Intel iGPU, avoiding EGL_BAD_MATCH errors from the NVIDIA RTX 3060
after VT/DPMS cycles (page-flip lockups, black display)
- lock.sh: guard against duplicate hyprlock instances (second instance
steals surfaces, leaves screen black)
- lid-close.sh: same guard for laptop
- wake-display.sh: conditional DPMS cycle (only when display is off)
to restore hyprlock surfaces without flicker
- unstick-display.sh: emergency recovery script for tty3
Logging in via a bare Hyprland session never activates
graphical-session.target, so the systemd xdg-desktop-portal units can't
start. The old script worked around this by killing and relaunching the
portals manually, but that delayed the portal past waybar/chromium
startup, so they intermittently came up in light mode.
Switch to the "Hyprland (uwsm-managed)" session: uwsm activates
graphical-session.target and systemd starts the portals in the right
order. The startup script now detects that target and bows out, falling
back to the manual launch only on a bare session (e.g. another machine
without uwsm). Document uwsm in the README.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Adds a "Mirror Display" entry that calls a helper script which finds
the first connected non-internal monitor and toggles mirroring of
eDP-1 onto it via hyprctl. Use case: plugging into a conference room
TV/projector while travelling.
Also fixes the menu's "Screenshot full" entry to capture the active
output instead of the hardcoded DP-1, matching the equivalent fix to
the Ctrl+Print keybind.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Ctrl+Print was tied to DP-1, so it failed on the laptop alone or with
a different external. Using -m active picks the currently focused
output, so the same bind works on any host.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Move FIFO setup and percentage emission into helper scripts so the
Hyprland config has no raw $VAR references — Hyprland's parser
substitutes $varname at parse time, which mangled awk's $2 and
$HYPRLAND_INSTANCE_SIGNATURE and left binds broken after reload.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- Add lid-close.sh: starts hyprlock in background and immediately cuts
the display via dpms off, so the display is dark while hyprlock renders
- William.conf: bind lid close to lid-close.sh; bind lid open to kill dim
and turn display back on
- lock.sh: pass --no-fade-in to hyprlock
- hyprlock.conf: disable fadeOut animation
- hypridle.conf: add inhibit_sleep = 3 and use loginctl lock-session
Mutes audio at 21:00 and unmutes at 07:00, but only when the
idle-inhibit toggle is active (PID file exists). This is useful
for leaving the computer running overnight for SSH access while
keeping it quiet for sleeping.
