Skip to content
Service seglcdd

Service seglcdd

seglcdd feeds the display with sensor values and offers a D-Bus interface; seglcd-gtk is its settings app. Use one of the two variants – two instances would send alternately.

System service (RPM/DEB/AUR)User service (install-user.sh)
Startautomatically when the display is present (udev); prevent with systemctl mask seglcddat login: systemctl --user enable --now seglcdd
Runs asuser seglcd (seglcdd --system)the logged-in user
Configuration/etc/seglcd/config.toml~/.config/seglcd/config.toml
D-Bussystem bus – read: everybody, change: active local user, root, group seglcd (polkit; others after admin authentication)session bus
Logjournalctl -u seglcddjournalctl --user -u seglcdd

Configuration: Sensors & configuration and seglcdd.toml(5). Reference: seglcdd(1).

Installation

Packages: see packaging/README.md. Settings: seglcd-gtk or D-Bus (below).

Per user, without root (requires the .NET SDK, hidapi and the udev rule):

packaging/install-user.sh      # --reset-config replaces config.toml (backup .bak), --no-start, --help
packaging/uninstall-user.sh    # --purge also removes ~/.config/seglcd

Operation

systemctl --user reload seglcdd      # reload the configuration without the display going dark
journalctl --user -u seglcdd -f      # system service: without --user
SituationBehavior
display missing or passed through to a VMretries every second, connects automatically
service stoppedsends the off packet, releases the device
configuration invaliderror in the journal, defaults are used
no D-Buswarning, the display keeps running

Before experiments with seglcd (send, probe, raw, …) pause the service; this sends the off packet and releases the device:

set N io.github.fubar_coder.SegLcd1; set P /io/github/fubar_coder/SegLcd1
busctl --user set-property $N $P $N Enabled b false     # … and b true afterwards

D-Bus interface

Name and interface io.github.fubar_coder.SegLcd1, object /io/github/fubar_coder/SegLcd1, defined in src/SegLcd.Daemon/DBus/io.github.fubar_coder.SegLcd1.xml. For the system service use busctl --system.

PropertyTypeAccessMeaning
Enabledbrwfeed the display; false = off packet, device released
UpdateIntervalMsurw50–400 ms
SampleIntervalMsurw100–10000 ms
CpuClockModesrwCPU clock from the cores: avg, max, min, first
Connected, DevicePath, Model, ConfigPathb, srstate and paths
SensorSpecsa{ss}rfield → configured spec (empty = automatic)
Sourcesa{ss}rfield → resolved sensor (empty = none)
CurrentValuesa{sd}rlast values (cpu_temperature, gpu_temperature, fan, …)
LastPacketayrlast 64-byte packet
MethodMeaning
SetSensor(field, spec) → sourceset a sensor (spec syntax); not saved until SaveConfig
ListSensors() → a(sssd)usable sensors: spec, kind (temperature, power, fan, …), description, value (NaN = not readable)
ReloadConfig()re-read config.toml; on error the old settings stay active
SaveConfig()write the current settings; user service: config.toml (comments are lost), system service: the values that differ from /etc to /var/lib/seglcd/config.toml

PropertiesChanged is sent for all properties except CurrentValues and LastPacket. Invalid values are rejected with InvalidArgs.

busctl --user get-property $N $P $N Connected CurrentValues
busctl --user set-property $N $P $N UpdateIntervalMs u 200
busctl --user call $N $P $N SetSensor ss pump it8686_31050607:fan5
busctl --user call $N $P $N SaveConfig