Skip to content

Repository files navigation

Conky Studio

Conky Studio

Design Conky HUDs visually. Ship real themes.

2 nodes = 1 widget in 30 seconds.

Design visually → export real Conky themes. Start simple. Scale to anything.

Conky Studio Node Demo

No mockups. No fake canvas. No runtime lock-in.

Build desktop HUDs visually with a node-based workflow, then export standard Conky themes that run without Conky Studio.

Video Showcase Discord YouTube Wiki Download Latest Build Conky Studio History Features KOFI

1.1.0 — Architectural Release

1.1.0 isn't Conky Studio becoming a different application. It's Conky Studio becoming the application it was designed to be.

This release completes the original Studio architecture rather than replacing it. The node graph is still the foundation; 1.1.0 builds the surrounding UX needed to make that architecture practical from creation through preview, packaging, export, installation, and reuse.

The result is a more complete authoring environment without abandoning the design that has powered Studio from the beginning.

1.1.0 highlights

  • Multi-window / multi-monitor projects with shared data and per-window scenes
  • Portable .cstudio source packages with bundled project assets
  • Position Stage built directly on Studio's existing X/Y property system
  • Scale % for uniform visual scaling
  • Expanded Cairo visuals and effects
  • Theme Vault + Node Vault
  • Simple / Full / Showcase Theme Wizard
  • 1.0.x-compatible project migration
  • Guided learning tours
  • Plugin Creation: promote Custom Nodes into validated, portable plugins
  • A complete theme lifecycle from authoring → preview → build → install → manage
  • Use Studio as the editor, use any manager, even if it is not Studio's

Why this exists

Conky is extremely powerful, but creating advanced HUDs traditionally means:

Traditional workflow Conky Studio
Edit Lua → restart → repeat Change properties and preview instantly
Manually position ${goto} and drawing code Arrange elements visually
Connect scripts by hand Use sources as nodes
Risk breaking existing themes Import, edit, and rebuild safely

The goal is simple:
Make Conky as easy to design as it is powerful to run.

  • No Lua editing (unless you want to)
  • No restart loops
  • No fake previews (real Conky process refreshes as you edit)
  • Advanced options for power users
  • Build simple, or build something complex

Getting Started


What makes this different

Conky Studio is a visual authoring tool for Conky, not a replacement runtime.

Your designs are converted into normal Conky files:

  • conky.conf
  • render.lua
  • start.sh
  • custom scripts
  • assets and resources

Exported themes run independently using Conky’s normal pipeline.

Live preview = export.
The preview uses the same build path as the final theme — what you see is what you ship.

How Conky Studio Compares

Capability Raw Lua/Text Editing Conky Manager Conky Studio
Visual Node Authoring None None Yes (Sources → Logic → Visuals)
Real Process Live Preview Manual terminal reloads None Yes (~350 ms feedback)
Multi-monitor / Multi-window Manual Limited Yes (separate processes + scene filters)
Portable Projects None None Yes (.cstudio packages)
Procedural Animation (PAS) Hand-coded Cairo None Yes (Sensor rate, Draw FPS, Smooth nodes)
Theme Lifecycle Manager Manual Basic toggle Yes (Start/Stop, Zip, Duplicate, monitor pin)
No Runtime Lock-In Native Native Yes (standard Conky output)
Plugin Ecosystem None None Yes (Node Vault + local creation)
Theme Wizard None None Yes (learning + starter graphs)
Community Stores None Limited Yes (Theme Vault + Node Vault)

Create your first widget in 30 seconds

  1. Drop a CPU source
  2. Drop a gauge, bar, or text node
  3. Connect them
  4. Enable live preview

That is a real Conky widget, not a mockup.

Creating your first widget

From there you can build complete HUDs with:

  • Logic chains and smoothing
  • Gradients and Scale %
  • Multi-window layouts
  • Custom scripts and Custom Lua
  • 98+ built-in nodes + community plugins
  • Newest decorative nodes: holographic globe, holographic DNA strand, morphing neon geometry

Check Requirements and Compatibility to get started.

Core Features (1.1.0)

  • Visual node editor — Sources → Logic → Visuals
  • Position Stage — drag visual proxies on a true window-sized plane
  • Scale % — uniform scaling of geometry, text, strokes, and images
  • Live Preview — real Conky process
  • Multi-window / multi-monitor — each window is an independent Conky process with optional scene filters
  • .cstudio projects — portable packages containing the graph, assets, and fonts
  • Theme Wizard — Simple / Full / Showcase complexity tiers
  • Theme Manager — Start/Stop, install, duplicate, export, monitor pinning
  • Theme Vault — community theme catalog
  • Node Vault — community plugin catalog
  • Plugin Creation tool — turn Custom Lua / Custom Script into distributable plugins
  • Legacy importer — convert existing themes into editable graphs
  • Guided tours — Learn Studio, Theme Wizard, and Full Tour
  • Clean exports — standard Conky theme folders that run without Studio

Combine with the Griffin Updater for auto-updates.


Community Stores

Store Purpose Link
Theme Vault Browse and install community themes Theme Community Store
Node Vault Browse and install community plugins Community Plugins

Both stores are also available inside Conky Studio (Store tab and Tools → Plugins).


How to install

Download Latest Build

Installation & Running

Full guide and dependencies:
Installation

Before running the AppImage, make it executable:

Option 1: Terminal (Recommended)

chmod +x Conky-Studio-1.0.3_x84_64.AppImage
./Conky-Studio-1.0.3_x84_64.AppImage

Option 2: GUI

  • Right-click the AppImage → Properties
  • Permissions tab → “Allow executing file as program”
  • Double-click to run

Source releases include the full tree. Place the packaging folder inside the conkystudio directory when building from source.


Screenshots

Studio Live Preview Theme Manager Starter Theme
Gamer Theme Colour Speed Undocking
:-----------: :------: :-----: :---------:

Current Official Compatible Themes

Click an image, download the zip, drop into Manager

Skyrim Vanilla Skyrim Parchment CorePulse Batman

Theme Compatibility

The Manager runs any Conky theme that provides a working start.sh (or lets Studio generate a minimal one). This includes:

  • Themes created with Conky Studio
  • Manually written Conky themes
  • Third-party themes from Pling / openDesktop / GitHub

Studio does not need to stay open after you Start a theme.
You can also launch manually:

cd ~/.config/conky/<theme-folder>
./start.sh

See Theme Compatibility.


DE Compatibility

Full details: Compatibility

GLIBC 2.38+ is required for the AppImage.

Environment Notes
X11 (any WM) Most predictable
Sway / Hyprland / other wlroots Layer-shell supported
KDE Plasma (Wayland) Supported path
GNOME Wayland (Mutter) Limited — no reliable desktop overlays

Live Preview intentionally uses normal window type. Final exported themes follow the window type you set (auto / desktop / dock).


Runtime Performance

Conky Studio is an authoring tool. The node graph is converted into ordinary Conky files at build time. The exported theme runs independently of Studio. Performance is determined by the generated Lua, update intervals, and normal Conky execution — not by the number of nodes in the editor.


Built for Conky, not a replacement or fork

Conky Studio is an independent project that generates and manages HUDs for Conky. It is not affiliated with, endorsed by, or sponsored by the official Conky project.

IMPORTANT: Report Conky Studio bugs to the Conky Studio project, not to the Conky maintainers.

If an exported theme fails outside Studio, test it directly:

./start.sh

Continue exploring

Full technical documentation: Wiki

About

Conky can be hard for those who do not know how to code, or just want to manage their themes, that is what Conky studio is for; The studio is in active development, and it has many features, including a node system for easy wiring, managing your themes, plugins, Community store, OpenDesktop/Pling integration, and more.

Resources

Code of conduct

Security policy

Stars

10 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages