Skip to content
Tsumiki

Your language is missing?

Help us translate this documentation!

See how to contribute translations →

FAQs & Tips

Cannot see system tray?

Be sure to kill any bars that you may be running. You can kill other bars with:

Terminal window
pkill bar-name
Cannot see notifications?

Be sure to kill other notification daemons that you may be running. You can kill other daemons with:

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

Kill the app with pkill tsumiki. Run init.sh -start. This should show some logs.

If it shows ModuleNotFoundError, run:

Terminal window
pip install -r requirements.txt

If this does not solve the issue, report a bug with a screenshot of the log.

Sass compilation error or UI not rendering?

Your theme.json may be incorrect or outdated. You can copy the latest theme.json from the example/ directory:

Terminal window
cp example/theme.json theme.json

Be aware that this will overwrite any custom changes you’ve made.

No Icons?

Make sure your icon theme has the required icons. One of the recommended icon themes is Tela Circle.

ImportError: cannot import XX

This error usually occurs when the required module/package is not installed or cannot be found. Make sure you have all the necessary dependencies installed.

You can run:

Terminal window
./init.sh -install

to install all the required packages and dependencies. Additionally, you can also manually install the package. Follow the instructions in the Installation section of the README.

How to enable blur and effects?

Add these rules to your hyprland.conf to make blur and other effects work properly:

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?

Updating to the latest commit is fairly simple, just git pull the latest changes:

Terminal window
cd ~/.config/tsumiki
git pull