Node Reference Sources

Node Reference — Sources

Every source has one output socket (kind below). Properties are usually constants (device names, formats), not bindable inputs.

---

System

CPU Usage — source.cpu_percent

Output	percent
core	enum — overall or a specific core

RAM Usage — source.ram_percent

Output	percent

Disk Usage — source.disk_percent

Output	percent
mount_path	path (default /)

Battery — source.battery_percent

Output	percent
device	string (default BAT0)

---

Network

Network Download — source.net_down

Output	number (rate; units as implemented in codegen)
interface	string — auto or iface name (e.g. wlan0)

Network Upload — source.net_up

Output	number
interface	string — auto or iface name

---

System info

Uptime — source.uptime

Output	text
format	enum (e.g. short / long style)

Hostname — source.hostname

Output	text

Kernel Version — source.kernel

Output	text

Process Count — source.process_count

Output	number

---

Time

Greeting — source.greeting

Output	text (time-of-day phrase)

Date / Time — source.datetime

Output	text
strftime_format	string (strftime pattern, e.g. %A %H:%M)

---

Sensors (often need lm-sensors / GPU tools)

CPU Temperature — source.cpu_temp

Output	celsius
chip_pattern	regex for sensor chip names
amd_drm_card	optional AMD DRM card hint

GPU Utilization — source.gpu_util

Output	percent

GPU Temperature — source.gpu_temp

Output	celsius

GPU VRAM Used (MB) — source.gpu_vram_used

Output	number

GPU VRAM Total (MB) — source.gpu_vram_total

Output	number

Disk Temperature — source.disk_temp

Output	celsius
device	path (e.g. /dev/sda)
poll_mode	enum — execi vs daemon
poll_interval	int seconds (daemon; typical min 60)
fallback_location	optional fallback

---

Weather (script + cache; needs network / curl as configured)

Weather Condition — source.weather_condition

Output	text

Weather Category — source.weather_category

Output	category (for icon / branch logic)

Weather Temp (F) — source.weather_temp_f

Output	number (°F)
Notes	Convert with plugin Temp Convert or Map Range / Scale for °C displays

---

Media (needs playerctl + active player)

Track Title — source.nowplaying_title → text

Track Artist — source.nowplaying_artist → text

Track Album — source.nowplaying_album → text

Playback Status — source.nowplaying_status → category

Playback Progress % — source.nowplaying_progress → percent

Optional player hint may appear on related props depending on build (e.g., player name).

---

Custom

Custom Script — source.custom_script

Output	Controlled by Treat output as (output_kind): text, number, percent, celsius, category; must match what the script prints and what downstream sockets accept
Script path	Optional path to an executable/script; copied into the theme’s scripts/ at Build
Inline script	Monospace editor in the property panel (same idea as Custom Lua). If non-empty, this body is written to scripts/ at Build, and wins over Script path
poll	Polling mode: execi (simple ${execi}) or daemon (background loop + cache); Refresh every (sec) sets the interval
Notes	Print a single line to stdout (or simple key=value for structured use). Prefer Inline script when fixing a legacy import so you can edit without leaving Studio. Legacy import preloads small companion scripts into Inline script when possible

Behaviour: Script stdout is parsed as the source value. Daemon mode uses background polling + cache; execi uses Conky-native intervals. Empty or failed scripts yield empty/zero depending on kind.

---

Wiring tips

Source kind	Typical visual targets
percent	Arc gauge, bar, LED threshold, history graph
celsius	Text (via format), gauges after Map Range to 0–100
text	Text label, string-format logic
category	Conditional / pick / image swaps
number	Bars after scaling, text via Unit Format plugin