Skip to content
Tsumiki

Troubleshooting

This page covers issues beyond the FAQ.

Panel Does Not Appear

Section titled “Panel Does Not Appear”
  1. Ensure Hyprland is running and the layer rules from Post Installation are applied.
  2. Kill any conflicting bar: pkill bar-name.
  3. Start Tsumiki: tsu -start and watch the log output.

Widget Missing

Section titled “Widget Missing”
  • Confirm the widget is enabled in config.toml under [widgets.<name>].
  • Verify the widget is listed in a layout section.
  • Check for ModuleNotFoundError and install dependencies with tsu -setup.

Theme Not Applying

Section titled “Theme Not Applying”
  • Confirm theme_name in config.toml matches a file in themes/.
  • Recompile styles: ./init.sh -recompile.
  • For Matugen, see Theming with Matugen.

High CPU or Memory

Section titled “High CPU or Memory”
  • Reduce polling intervals in widget config.
  • Disable unused widgets and modules.
  • Enable auto_hide to reduce redraws.

Still Stuck?

Section titled “Still Stuck?”

Open an issue with your config.toml and logs from tsu -start.