Troubleshooting
Icons look generic
Section titled “Icons look generic”Both GPU frontends show a four-tile app symbol when no resolved font provides the icon. Install a Nerd Font such as JetBrainsMono Nerd Font and reopen hyprburst; your text font can stay unchanged. Set ui.show_icons = false to hide icons entirely.
If icons show as tofu squares (□) in hyprburst tui, configure a Nerd Font or font fallback in the hosting terminal.
Text is too small
Section titled “Text is too small”Raise [font] size (default 20.0).
The window doesn’t open
Section titled “The window doesn’t open”hyprburst needs a Wayland session with OpenGL. From an SSH or no-GPU session, run hyprburst tui instead. If it can’t find a font, set [font] path.
Wrong placement or not fullscreen
Section titled “Wrong placement or not fullscreen”On Hyprland 0.55+ Lua configs, use the minimal hyprburst.lua bind and set [window] placement to "fullscreen" or "centered". Legacy hyprlang users rely on the static rules in hyprburst.conf. See Hyprland setup.
Waybar renders on top
Section titled “Waybar renders on top”Waybar is a layer-shell surface on the top layer, which a normal floating window can’t cover. Set Waybar’s config to "layer": "bottom" and restart it.
Blur or transparency doesn’t show
Section titled “Blur or transparency doesn’t show”Keep [window] transparent = true (the default) and enable Hyprland’s decoration:blur:enabled = true globally.
Blur washes out the text
Section titled “Blur washes out the text”Raise [window] opacity (default 0.85) toward 1.0. At 1.0 the background panel is fully opaque.
Super+Space does nothing
Section titled “Super+Space does nothing”Confirm the bind loads (bind = SUPER, Space, exec, hyprburst, or the Lua hl.bind(...)) and that hyprburst is on the PATH Hyprland sees.
My config isn’t taking effect
Section titled “My config isn’t taking effect”An invalid config is rejected and hyprburst falls back to built-in defaults, printing the reason to stderr. Run hyprburst tui from a shell to see the message, then fix the named field. Theme edits apply on the next launch, not live. The [terminal] section was removed in 0.5 and now errors; see Upgrading from 0.4.x.