Troubleshooting

Troubleshooting

Quick checklist

1. Tools → Hardware & Session; display server, desktop, Conky installed/version/Wayland build, sensors, GPU, net iface
2. Confirm Conky runs from a terminal (conky -v / a minimal conf)
3. Confirm Live Preview vs Manager Start (preview uses generated files; Manager runs installed start.sh)
4. Note X11 vs Wayland and compositor name

Conky missing or wrong build

Symptom	Try
Preview never starts	Install Conky; ensure it is on PATH
Wayland session, nothing on screen	Need a Conky build with Wayland support; some packages (e.g. certain conky-all builds) are X11-only
Works on X11 session only	Expected on some distros — use X11 for HUDs or install a Wayland-capable Conky

Wayland

Environment	Typical outlook
wlroots (Sway, Hyprland, Wayfire, …)	Usually workable for overlays
KDE Plasma (Wayland)	Often workable
GNOME (Mutter)	Poor fit for this class of overlay — Conky + Mutter limitation, not a Studio toggle
Mir-based	Often discussed as supported in product docs

Studio can detect and warn; it cannot add protocol support the compositor lacks.

Live Preview issues

Symptom	Try
Status says failed / no window	Read preview logs; check Conky install; try Build to a folder and run ./start.sh manually
Delayed data (weather, sensors)	Wait for script cache; check network / lm-sensors
Wrong size or position	Canvas width/height, alignment, gap_x/gap_y on the Canvas node
Looks fine in preview, wrong in Manager	Re-Build & Install; confirm you started the same theme name

Studio / graph issues

Symptom	Try
Property panel empty	Select a node; open the Properties dock
Cannot connect sockets	Kind mismatch (e.g., text into a pure number input); use Logic to convert or pick a compatible visual input
Plugin node missing / broken	Install the pack (Plugins); reload project
Graph very busy	Group nodes, collapse groups, labels (editor-only)

Fonts

Tools → Install Font helps register fonts for themes that need them. After install, set the font on Text / related nodes and rebuild.

Still stuck

Gather: Studio version, distro, X11/Wayland, compositor, Conky version (conky -v), and whether the failure is Preview or Manager. Ask on Discord or see Support.