Troubleshooting

Troubleshooting

First look at the log: ~/.cache/mist/ui.log (rotated at 1 MB to ui.log.1).

tail -50 ~/.cache/mist/ui.log

Mist does not start

• The guard exits right away. mist-ui quits when a mist-ui-bin already runs (pgrep -x mist-ui-bin). Stop both and start again: pkill -x mist-ui; pkill -x mist-ui-bin; ~/.local/bin/mist-ui.
• "giving up after 5 crashes" in the log: mist-ui-bin crashed 5 times in 2 minutes and the guard stopped. The lines above it say why. Set MIST_FALLBACK to start another bar in that case.
• Old Hyprland or the hyprlang config. Mist needs Hyprland 0.55+ with hyprland.lua.

No blur behind the glass

Hyprland draws the blur, not Mist. The layer rules from examples/hyprland/mist.lua (hl.layer_rule with blur = true, ignore_alpha) must be loaded, and decoration.blur.enabled must be on.

Notifications, polkit or tray do not work

Only one program can own each D-Bus name. With another daemon running the log says:

notif: org.freedesktop.Notifications is taken
polkit agent: ...

Remove mako / dunst / swaync and other polkit agents from your autostart. What the tray sees: mist-ui-bin --tray-dump.

Text looks different from the screenshots

The screenshots use SF Pro, which Mist does not ship. Put the variable SF-Pro.ttf in ~/.local/share/fonts/SF-Pro/, or live with Inter Variable / Noto Sans.

Dock, island and desktop are on the wrong monitor

They go on Hyprland's first monitor. Set "primary" in ~/.config/mist/settings.json or MIST_PRIMARY (Languages and monitors).

Garmin / running cards are missing

Expected without ~/.config/mist/influx.json (Desktop and cards). With it, check that InfluxDB answers on the URL in the file; a 401 means the user / password differ from garmin-grafana's .env.

Calls do not show up in the island

KDE Connect telephony stays silent on some phones; use the ADB fallback (Phone).

High CPU or memory

mist-ui-bin msg ui stats                               # paints per surface: something animating?
bench/measure.sh 30 mist-ui-bin mist-wall-bin mistd     # PSS and CPU over 30 s

A live wallpaper costs a GL process; a photo wallpaper does not (Wallpapers). Expected numbers are in docs/BENCHMARKS.md.

Building fails or the binary segfaults at link time

Keep lto = false in the workspace Cargo.toml: Arch's rustc with the system LLVM crashes with LTO.

Reporting a bug

Open an issue with the Hyprland version (hyprctl version), the GPU, and the end of ui.log. Check the log for anything private first.