How jtm2kfpv-git/gigactl-g5-mf5 works
gigactl provides daemon-backed fan and keyboard controls, a desktop interface, and a separate Bazzite G5 MF5 manual controller. The main workflow runs from the desktop or CLI through the system-bus daemon to EC access; the daemon also samples telemetry and evaluates automatic fan curves. The Bazzite UI is a separate implementation. Some subsystem paths and links are documented but their source was not sampled, so those relationships are omitted rather than inferred.
Main entry points: service.py D-Bus service · client.py D-Bus client · app.py GigaControl app · window.py Overview window
Components 24
Daemon control
- D-Bus service
daemon/gigactld/service.py - Polkit authorization
daemon/gigactld/authz.py - Saved state
daemon/gigactld/state.py
EC hardware
- Fan control
daemon/gigactld/fans.py - Keyboard control
daemon/gigactld/keyboard.py - EC access layer
daemon/gigactld/ec.py - EC mailbox
daemon/gigactld/mailbox.py
Desktop app
- GigaControl app
gui/gigactl_gui/app.py - Overview window
gui/gigactl_gui/window.py - Curve editor page
gui/gigactl_gui/curve_page.py - D-Bus client
gui/gigactl_gui/client.py - Tray controls
gui/gigactl_gui/tray.py - Tray menu
gui/gigactl_gui/tray_menu.py - Keyboard preview
gui/gigactl_gui/preview.py
Bazzite controller
- Manual fan dashboard
bazzite-g5-mf5/gfan_ui.py - Cooling curve logic
bazzite-g5-mf5/gfan_curve.py - CPU and GPU load
bazzite-g5-mf5/gfan_load.py - Manual fan controller
bazzite-g5-mf5/gfan.py - ACPI EC interface
bazzite-g5-mf5/acpi_ec/src/acpi_ec.c
Curve and telemetry
- Fan curve engine
daemon/gigactld/curve.py - Telemetry sampling
daemon/gigactld/telemetry.py
Other components
- Laptop user
- Fan and keyboard CLI
- Laptop embedded controller
Connections 28
- Laptop user → GigaControl app: opens
- Laptop user → Fan and keyboard CLI: runs
- GigaControl app → Overview window: shows
gui/gigactl_gui/app.py - GigaControl app → Tray controls: starts
gui/gigactl_gui/app.py - GigaControl app → D-Bus client: connects
gui/gigactl_gui/app.py - Overview window → Curve editor page: opens
gui/gigactl_gui/window.py - Overview window → D-Bus client: requests state
gui/gigactl_gui/window.py - Overview window → Keyboard preview: updates
gui/gigactl_gui/window.py - Tray controls → Tray menu: uses
gui/gigactl_gui/tray.py - Tray menu → D-Bus client: reads profiles
gui/gigactl_gui/tray_menu.py - Curve editor page → D-Bus client: sends controls
gui/gigactl_gui/curve_page.py - D-Bus client → D-Bus service: calls over D-Bus
- Fan and keyboard CLI → D-Bus service: controls over D-Bus
- D-Bus service → Polkit authorization: authorizes requests
daemon/gigactld/service.py - D-Bus service → Fan control: dispatches fan control
daemon/gigactld/service.py - D-Bus service → Keyboard control: dispatches keyboard control
daemon/gigactld/service.py - D-Bus service → EC access layer: reads and writes
daemon/gigactld/service.py - D-Bus service → Fan curve engine: evaluates curves
daemon/gigactld/service.py - D-Bus service → Telemetry sampling: publishes telemetry
daemon/gigactld/service.py - D-Bus service → Saved state: loads and saves
daemon/gigactld/service.py - Fan control → EC mailbox: issues commands
daemon/gigactld/fans.py - Keyboard control → EC mailbox: issues commands
daemon/gigactld/keyboard.py - EC access layer → Laptop embedded controller: accesses
- EC mailbox → EC access layer: writes registers
daemon/gigactld/mailbox.py - Laptop user → Manual fan dashboard: uses
- Laptop user → Manual fan controller: runs
- Manual fan dashboard → Cooling curve logic: uses
bazzite-g5-mf5/gfan_ui.py - Manual fan dashboard → CPU and GPU load: samples load
bazzite-g5-mf5/gfan_ui.py