Skip to content

Store and Community

Bobby Comet edited this page Jul 31, 2026 · 3 revisions

Store & Community

In-app Store tab

The Store tab is the in-app surface for discovering and installing community content (themes and related assets) when a source is configured.

Typical capabilities (as the integration matures):

  • Browse listings from configured feeds
  • Install via packaged archives (e.g. .zip, .tar.gz) or online sources
  • Open external catalog pages (e.g. OpenDesktop-style flows in the browser) when the app hands off a URL

Exact availability depends on network access, feed configuration, and release channel. If the Store looks empty, check connectivity and whether a catalog URL is set for your build.

Community store (concept)

“Community store” means shared, redistributable Conky Studio–oriented content:

Kind Who it’s for
Built themes End users who only need to run a HUD
Project JSON + assets Authors who want to remix graphs in Studio
Plugin packs Extra logic/visual nodes (JSON + Lua)
Art / image packs Assets referenced by Image nodes or wizard themes

Preferred public packaging:

  1. Primary: built theme folder (or archive) with start.sh — works without Studio
  2. Optional: project JSON for remixing, plus plugin list and asset paths documented

See Sharing Projects.

OpenDesktop / browser hand-off

Some install or browse actions open the system browser (OpenDesktop or similar). That is intentional: catalog, login, or download flows may live on the web while Studio handles local install into ~/.config/conky/ or the plugins directory.

Discord & videos

Also available from Help → Support in the app.

Trust and safety

  • Treat downloaded themes and plugin packs like any script you run: Lua and shell execute under your user in Conky’s process
  • Prefer known authors and reviewed packs
  • Prefer built themes from strangers if you only need to run a HUD and are not auditing a graph

Contributing content

  • Themes: export a clean build; include README and theme.json
  • Plugins: follow the Plugins authoring rules; PR or publish a manifest JSON
  • Report import/preview issues with Studio version, distro, X11/Wayland, and Conky version (Tools → Hardware & Session helps)

Clone this wiki locally