Omarchy Troubleshooting: 20 Fixes for Common Breakages
Fix the 20 most common Omarchy issues: update rollback, huge apps, Caps Lock, speakers, login lockout, 1Password, and clipboard.
From Omarchy manual Troubleshooting + real Discord fixes โ one page for the breakages that eat hours.
1. Broke system with update
sudo snapper list โ reboot โ Limine snapshots โ rollback โ sudo snapper rollback. If snaps donโt boot: omarchy-debug โ post in #omarchy-help, then omarchy-reinstall.
2. Apps huge on HiDPI
Omarchy sets GDK_SCALE=2 for 2ร displays. On 1080p set to 1 in ~/.config/hypr/hyprland.conf and restart apps. Spotify: Ctrl+Minus to zoom.
3. Caps Lock doesnโt work
Itโs the compose key for emojis. Remap:
# ~/.config/hypr/input.conf
kb_options = compose:ralt
4. External speakers no sound
Top bar speaker โ volume โ set default (d). Check pactl list sinks.
5. Canโt login / sudo
Too many wrong passwords โ faillock. Press Ctrl+Alt+F2, login as root, faillock --reset --user YOURUSER.
6. 1Password SSH prompt missing
Settings โ Advanced โ Hardware Acceleration ON โ reboot, and launch 1Password once after boot.
7. XWayland dies (VMware)
Shows wl_display error 1 and browser wonโt launch. Fix:
echo 'export XWAYLAND_NO_GLAMOR=1' >> ~/.config/uwsm/env
8. Clipboard not syncing
Hyprland doesnโt merge X11/Wayland clipboards. VMware lands on X11 only. Use wl-clipboard daemon that mirrors both. Donโt trust systemctl is-active when XWayland dead.
9. Keyboard layout wrong at LUKS prompt
Layout comes from installer selection (/etc/vconsole.conf). Dvorak vs QWERTY confusion โ check localectl status. For fcitx5 vs Hyprland fight, some remove fcitx5 but lose emoji on XWayland.
10. Gaming crashes (Proton)
SDL_VIDEODRIVER=wayland blocks fallback. Use fallback or unset per game: unset SDL_VIDEODRIVER; %command% or gamescope. See Gaming guide.
11. Screen sharing shows black
Wayland portals need xdg-desktop-portal-hyprland. Share a window, not screen, in Zoom/Chrome, grant via polkit.
12. vmwgfx + mpv crash
Mpv refuses llvmpipe. Set gpu-sw=yes in ~/.config/mpv/mpv.conf.
13. Slow pacman
Run reflector -c IL,DE,US -a 6 --sort rate or Fix Slow Pacman guide, check DNS 1.1.1.1.
14. Bluetooth audio crackling
Set BlueZ sink as default, check wireplumber logs.
15. External monitor wrong scale
Edit ~/.config/hypr/hypr.monitors โ set scale 1 vs 1.25, reload hyprctl reload.
โฆplus 5 more in manual: reminders/notices not showing โ check mako, notices โ ~/.config/omarchy/notices, screenshots โ omarchy capture.
When stuck, run omarchy-debug before asking โ it bundles logs Discord can act on.