-
-
Notifications
You must be signed in to change notification settings - Fork 1
Home
Bobby Comet edited this page Aug 23, 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 | Install, 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 |
| 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 |
| Troubleshooting | Application issues, preview problems, sessions, Theme Wizard, and hardware |
| Troubleshooting Themes | Manager issues, start.sh, paths, missing or blank HUDs |
| Support | Discord, YouTube, sponsors, and getting help |
| Versioning Philosophy | Defining MAJOR.MINOR.FEATURE.PATCH releases |
| Theme vault | Trust model for downloading themes |
| Multi-window support | Overview, Compatibility, Limitations, etc. |
| .cstudio | Project files for portability and remixing |
| Positioning Stage | A visual drag and drop tool to move gauges and other visuals |
| Scale % | Resizing a visual without readjusting everything again |
| Page | What it covers |
|---|---|
| Theme Compatibility | How to manage themes Conky Studio did not create |
| Node Reference | Sources, logic, visuals, and plugin nodes |
| Legacy Import | Import Conky configs, TEXT, and Lua with documented limitations |
| Plugin System | Installing plugins, trust model, official vs community plugins |
| Custom Plugins | Creating JSON-based plugins and extending the node ecosystem |
| Plugin Creation Tool | How to create Plugins inside Studio |
| Store & Community | In-app Store, OpenDesktop, community packs, and sharing plugins |
| Custom Lua API | Drawing engine, Cairo helpers, and advanced visual creation |
| Custom lua/scripts | Specific nodes for the edge cases |
| .cstudio | Project files for portability and remixing |
| Page | What it covers |
|---|---|
| Legacy Importer Internals | Conversion rules, compatibility behavior, and importer design |
| Theme Architecture & Codegen | Build pipeline, graph compilation, and generated output |
| Store & Packaging | Plugin distribution standards and packaging guidelines |
| Packaging | AppImage behavior, desktop sessions, and compositor handling |
| Versioning Philosophy | Defining MAJOR.MINOR.FEATURE.PATCH releases |
| Plugin Test Catalogue | Rules for testing, validating, and promoting public test plugins into the official Plugin Catalogue |
| Custom lua/scripts | Specific nodes for the edge cases |
Quick links