Skip to content
Tsumiki

FAQs & Tips

Cannot see system tray?

Another bar may still be running. Stop it first:

Terminal window
pkill bar-name
Cannot see notifications?

Another notification daemon may be handling notifications. Stop common daemons:

Terminal window
pkill -f "mako|dunst|waybar"
Cannot see bar?

Restart Tsumiki from the project root and inspect output:

Terminal window
pkill tsumiki
tsu -start

If you see ModuleNotFoundError, install dependencies:

Terminal window
uv sync

If the issue continues, open an issue and include logs.

Sass compilation error or UI not rendering?

Your config.toml may be outdated or invalid. Reset it from the example:

Terminal window
cp example/config.toml config.toml

This overwrites custom values.

No Icons?

Use an icon theme with broad coverage. Tela Circle is a common choice.

ImportError: cannot import XX

This usually means a required dependency is missing.

Install runtime and Python dependencies:

Terminal window
tsu -setup

or:

Terminal window
uv sync
How to enable blur and effects?

Add these layerrule entries to hyprland.conf:

Terminal window
layerrule = blur, ^tsumiki-notifications$
layerrule = xray 0, ^tsumiki-notifications$
layerrule = blurpopups, ^tsumiki-notifications$
layerrule = ignorezero, ^tsumiki-notifications$
layerrule = noanim , ^tsumiki-notifications$
layerrule = blur, ^fabric$
layerrule = ignorezero, ^fabric$
layerrule = xray 0, ^fabric$
layerrule = blurpopups, ^fabric$
layerrule = blur, ^tsumiki$
layerrule = xray 0, ^tsumiki$
layerrule = blurpopups, ^tsumiki$
layerrule = ignorezero, ^tsumiki$
layerrule = blur ,gtk-layer-shell
layerrule = ignorezero ,gtk-layer-shell
layerrule = blur, ^launcher$
layerrule = xray 0, ^launcher$
layerrule = blurpopups, ^launcher$
layerrule = ignorezero, ^launcher$
layerrule = animation popin, ^launcher$
How do I update Tsumiki?

Pull the latest changes:

Terminal window
cd ~/.config/tsumiki
git pull