-
-
Notifications
You must be signed in to change notification settings - Fork 1
Home
Bobby Comet edited this page Aug 3, 2026
·
31 revisions
Design desktop HUDs visually. Ship real Conky themes.
Conky Studio is a visual system designer for Conky: a node graph for data, logic, and drawing; a live preview driven by a real Conky process; and a build step that writes a normal theme folder. What you preview is what you export.
You place Source nodes (system data), optional Logic nodes (math, thresholds, smoothing), and Visual nodes (gauges, text, shapes). Wires carry data. Build writes start.sh, conky.conf, render.lua, and scripts under a theme folder. Live Preview runs that same pipeline in a real Conky instance, not a mock canvas.
| Page | What it covers |
|---|---|
| Getting Started | First launch, first widget, tabs, canvas size |
| Concepts | Core ideas behind Conky Studio: nodes, data flow, projects, builds, plugins, and the design philosophy |
| Features | Comprehensive feature list by area |
| FAQ | Short answers to common questions |
| Compatibility | X11, Wayland, compositors, sensors, and desktop support |
| Requirements | Required packages and optional dependencies for specific nodes |
| Node Reference | Sources, logic, visuals, and plugin nodes |
| Canvas Performance | Draw rate, sensor refresh, and balancing visuals vs data polling |
| Runtime Performance | How Studio and generated themes maintain performance |
| Theme Layout |
start.sh, theme.json, runtime structure, and generated theme organization |
| Sharing Projects & JSON | Project JSON vs built themes; what to share with others |
| Legacy Import | Import Conky configs, TEXT, and Lua with documented limitations |
| Legacy Importer Internals | Conversion rules, compatibility behavior, and importer design |
| Plugin System | Installing plugins, trust model, official vs community plugins |
| Custom Plugins | Creating JSON-based plugins and extending the node ecosystem |
| Store & Community | In-app Store, OpenDesktop, community packs, and sharing plugins |
| Store & Packaging | Plugin distribution standards and packaging guidelines |
| Theme Architecture & Codegen | Build pipeline, graph compilation, and generated output |
| Custom Lua API | Drawing engine, Cairo helpers, and advanced visual creation |
| Packaging | AppImage behavior, desktop sessions, and compositor handling |
| Troubleshooting | Application issues, preview problems, sessions, and hardware |
| Troubleshooting Themes | Manager issues, start.sh, paths, missing or blank HUDs |
| Support | Discord, YouTube, sponsors, and getting help |
Quick links