From 832309ffdd12316b9b178dd58bee8a7cc2c12cca Mon Sep 17 00:00:00 2001
From: damachin3 <damachin3@proton.me>
Date: Thu, 9 Apr 2026 15:40:24 +0200
Subject: [PATCH 01/10] version 3.1.0

---
 .SRCINFO                                      |   2 +-
 .github/workflows/install.yml                 |   8 +-
 Makefile                                      | 185 +++++++++++++-----
 PKGBUILD                                      |   2 -
 VERSION                                       |   2 +-
 aur/PKGBUILD                                  |   1 -
 .../plugins/coolerdash/config.json            |   4 +-
 .../plugins/coolerdash/manifest.toml          |   2 +-
 .../plugins/coolerdash/ui/index.html          |  20 +-
 packaging/coolerdash.spec                     |   1 -
 packaging/debian/install                      |   1 -
 src/device/config.c                           |  12 ++
 src/device/config.h                           |   2 +
 src/main.c                                    | 126 +++++++++++-
 src/mods/circle.c                             |  21 +-
 src/mods/circle.h                             |   6 +
 src/mods/display.c                            |  20 +-
 src/mods/display.h                            |   2 +
 src/mods/dual.c                               |  11 +-
 src/srv/cc_conf.c                             |  16 +-
 src/srv/cc_conf.h                             |   6 +
 src/srv/cc_main.c                             |  18 ++
 src/srv/cc_main.h                             |   7 +
 tests/test_scaling.c                          | 150 +++++++-------
 24 files changed, 470 insertions(+), 155 deletions(-)

diff --git a/.SRCINFO b/.SRCINFO
index 263bbf9..99f944e 100644
--- a/.SRCINFO
+++ b/.SRCINFO
@@ -1,6 +1,6 @@
 pkgbase = coolerdash
 	pkgdesc = Plug-in for CoolerControl that extends the LCD functionality with additional features
-	pkgver = 3.0.5
+	pkgver = 3.1.0
 	pkgrel = 1
 	url = https://github.com/damachine/coolerdash
 	install = coolerdash.install
diff --git a/.github/workflows/install.yml b/.github/workflows/install.yml
index db4b518..095dc82 100644
--- a/.github/workflows/install.yml
+++ b/.github/workflows/install.yml
@@ -125,12 +125,12 @@ jobs:
             exit 1
           fi
 
-          # Check CC-Plugin Lib JS files
+          # Check CC-Plugin Lib JS is NOT installed (served by CoolerControl)
           if [ -f "/tmp/install-test/etc/coolercontrol/plugins/coolerdash/ui/cc-plugin-lib.js" ]; then
-            echo "✅ Plugin Lib JS files installed"
-          else
-            echo "❌ Plugin Lib JS files not found"
+            echo "❌ Plugin Lib JS should NOT be installed (served by CoolerControl)"
             exit 1
+          else
+            echo "✅ Plugin Lib JS correctly not installed (served by CoolerControl)"
           fi
 
           # Check desktop files
diff --git a/Makefile b/Makefile
index 54f2640..11dbc3e 100644
--- a/Makefile
+++ b/Makefile
@@ -1,12 +1,33 @@
-.PHONY: clean install uninstall debug logs help detect-distro install-deps check-deps
+.PHONY: all clean distclean install install-strip installdirs uninstall check debug logs help detect-distro install-deps check-deps
+.DELETE_ON_ERROR:
 VERSION := $(shell cat VERSION)
 
-SUDO ?= sudo
+# Auto-detect: skip sudo when running as root (e.g. sudo make install)
+ifeq ($(shell id -u),0)
+    SUDO ?=
+else
+    SUDO ?= sudo
+endif
 REALOS ?= yes
 
-CC = gcc
-CFLAGS = -Wall -Wextra -O2 -std=c99 -march=x86-64-v3 -Iinclude $(shell pkg-config --cflags cairo jansson libcurl)
-LIBS = $(shell pkg-config --libs cairo jansson libcurl) -lm
+# Compiler
+CC ?= gcc
+MARCH ?= x86-64-v3
+
+# External dependencies (pkg-config, cached)
+PKG_CFLAGS := $(shell pkg-config --cflags cairo jansson libcurl)
+PKG_LIBS := $(shell pkg-config --libs cairo jansson libcurl)
+
+# User-overridable flags
+CFLAGS ?= -Wall -Wextra -O2 -march=$(MARCH)
+CPPFLAGS ?=
+LDFLAGS ?=
+
+# Required project flags (always applied)
+override CFLAGS += -std=c99
+override CPPFLAGS += -Iinclude $(PKG_CFLAGS)
+LDLIBS = $(PKG_LIBS) -lm
+
 TARGET = coolerdash
 
 # Directories
@@ -25,6 +46,23 @@ MANIFEST = etc/coolercontrol/plugins/coolerdash/manifest.toml
 MANPAGE = man/coolerdash.1
 README = README.md
 
+# GNU standard install directories
+prefix ?= /usr
+exec_prefix ?= $(prefix)
+libexecdir ?= $(exec_prefix)/libexec
+sysconfdir ?= /etc
+datarootdir ?= $(prefix)/share
+datadir ?= $(datarootdir)
+mandir ?= $(datarootdir)/man
+
+# Install commands
+INSTALL ?= install
+INSTALL_PROGRAM ?= $(INSTALL)
+INSTALL_DATA ?= $(INSTALL) -m 644
+
+# Plugin directory (derived)
+PLUGINDIR = $(sysconfdir)/coolercontrol/plugins/coolerdash
+
 # Colors for terminal output
 RED = \033[0;31m
 GREEN = \033[0;32m
@@ -35,15 +73,19 @@ CYAN = \033[0;36m
 WHITE = \033[1;37m
 RESET = \033[0m
 
+# Default target (GNU convention)
+all: $(TARGET)
+
 # Standard Build Target - Standard C99 project structure
 $(TARGET): $(OBJDIR) $(BINDIR) $(OBJECTS) $(MAIN_SOURCE)
 	@printf "\n$(PURPLE)Manual Installation Check:$(RESET)\n"
 	@printf "If you see errors about 'conflicting files' or manual installation, run 'make uninstall' and remove leftover files in /opt/coolerdash, /etc/coolerdash, /etc/systemd/system/coolerdash.service.\n\n"
 	@printf "$(CYAN)Compiling $(TARGET) (Standard C99 structure)...$(RESET)\n"
 	@printf "$(BLUE)Structure:$(RESET) src/ include/ build/ bin/\n"
+	@printf "$(BLUE)CPPFLAGS:$(RESET) $(CPPFLAGS)\n"
 	@printf "$(BLUE)CFLAGS:$(RESET) $(CFLAGS)\n"
-	@printf "$(BLUE)LIBS:$(RESET) $(LIBS)\n"
-	$(CC) $(CFLAGS) -o $(BINDIR)/$(TARGET) $(MAIN_SOURCE) $(OBJECTS) $(LIBS)
+	@printf "$(BLUE)LDLIBS:$(RESET) $(LDLIBS)\n"
+	$(CC) $(CPPFLAGS) $(CFLAGS) $(LDFLAGS) -o $(BINDIR)/$(TARGET) $(MAIN_SOURCE) $(OBJECTS) $(LDLIBS)
 	@printf "$(GREEN)Build successful: $(BINDIR)/$(TARGET)$(RESET)\n"
 
 # Create build directory
@@ -61,7 +103,7 @@ $(BINDIR):
 $(OBJDIR)/%.o: $(SRCDIR)/%.c | $(OBJDIR)
 	@mkdir -p $(dir $@)
 	@printf "$(YELLOW)Compiling module: $<$(RESET)\n"
-	@$(CC) $(CFLAGS) -MMD -MP -c $< -o $@
+	@$(CC) $(CPPFLAGS) $(CFLAGS) -MMD -MP -c $< -o $@
 
 -include $(OBJECTS:.o=.d)
 
@@ -88,6 +130,9 @@ clean:
 	rm -rf $(OBJDIR) $(BINDIR)
 	@printf "$(GREEN)Cleanup completed$(RESET)\n"
 
+# GNU standard: distclean removes everything clean does (no autoconf here)
+distclean: clean
+
 # Detect Linux distro via release files, os-release as fallback
 detect-distro:
 	@if [ -f /etc/arch-release ]; then \
@@ -187,11 +232,23 @@ check-deps:
 		printf "$(GREEN)All dependencies found$(RESET)\n"; \
 	fi
 
+# Run tests (GNU standard target)
+check: $(OBJDIR)
+	@printf "$(CYAN)Running tests...$(RESET)\n"
+	$(CC) $(CPPFLAGS) $(CFLAGS) -I./src -o $(OBJDIR)/test_scaling tests/test_scaling.c -lm
+	./$(OBJDIR)/test_scaling
+	@printf "$(GREEN)All tests passed$(RESET)\n"
+
 # Install binary to /usr/libexec, plugin data to /etc/coolercontrol/plugins/coolerdash/
 install: check-deps $(TARGET)
 	@printf "\n"
 	@printf "$(WHITE)=== COOLERDASH INSTALLATION ===$(RESET)\n"
 	@printf "\n"
+	@if [ -z "$(DESTDIR)" ] && [ "$(REALOS)" = "yes" ] && [ "$$(id -u)" -ne 0 ]; then \
+		printf "$(RED)Error: Installation requires root privileges$(RESET)\n"; \
+		printf "$(YELLOW)Run: sudo make install$(RESET)\n"; \
+		exit 1; \
+	fi
 	@if [ "$(REALOS)" = "yes" ]; then \
 		printf "$(CYAN)Migration: Checking for legacy files and services...$(RESET)\n"; \
 		LEGACY_FOUND=0; \
@@ -283,41 +340,45 @@ install: check-deps $(TARGET)
 	fi
 	@printf "\n"
 	@printf "$(CYAN)Installing plugin files...$(RESET)\n"
-	@install -dm755 "$(DESTDIR)/etc/coolercontrol/plugins/coolerdash"
-	@install -Dm755 $(BINDIR)/$(TARGET) "$(DESTDIR)/usr/libexec/coolerdash/coolerdash"
-	@install -m644 $(README) "$(DESTDIR)/etc/coolercontrol/plugins/coolerdash/README.md"
-	@install -m644 CHANGELOG.md "$(DESTDIR)/etc/coolercontrol/plugins/coolerdash/CHANGELOG.md"
-	@install -m644 VERSION "$(DESTDIR)/etc/coolercontrol/plugins/coolerdash/VERSION"
-	@install -m666 etc/coolercontrol/plugins/coolerdash/config.json "$(DESTDIR)/etc/coolercontrol/plugins/coolerdash/config.json"
-	@install -dm755 "$(DESTDIR)/etc/coolercontrol/plugins/coolerdash/ui"
-	@install -m644 etc/coolercontrol/plugins/coolerdash/ui/index.html "$(DESTDIR)/etc/coolercontrol/plugins/coolerdash/ui/index.html"
-	@install -m644 etc/coolercontrol/plugins/coolerdash/ui/cc-plugin-lib.js "$(DESTDIR)/etc/coolercontrol/plugins/coolerdash/ui/cc-plugin-lib.js"
-	@install -m644 images/shutdown.png "$(DESTDIR)/etc/coolercontrol/plugins/coolerdash/shutdown.png"
-	@install -m644 $(MANIFEST) "$(DESTDIR)/etc/coolercontrol/plugins/coolerdash/manifest.toml"
-	@sed -i 's/{{VERSION}}/$(VERSION)/g' "$(DESTDIR)/etc/coolercontrol/plugins/coolerdash/manifest.toml"
-	@sed -i 's/{{VERSION}}/$(VERSION)/g' "$(DESTDIR)/etc/coolercontrol/plugins/coolerdash/ui/index.html"
-	@printf "  $(GREEN)Binary:$(RESET)       $(DESTDIR)/usr/libexec/coolerdash/coolerdash\n"
-	@printf "  $(GREEN)Config JSON:$(RESET)  $(DESTDIR)/etc/coolercontrol/plugins/coolerdash/config.json\n"
-	@printf "  $(GREEN)Web UI:$(RESET)       $(DESTDIR)/etc/coolercontrol/plugins/coolerdash/ui/index.html\n"
-	@printf "  $(GREEN)Plugin Lib:$(RESET)   $(DESTDIR)/etc/coolercontrol/plugins/coolerdash/ui/cc-plugin-lib.js\n"
-	@printf "  $(GREEN)Plugin:$(RESET)       $(DESTDIR)/etc/coolercontrol/plugins/coolerdash/manifest.toml\n"
+	@$(INSTALL) -d "$(DESTDIR)$(PLUGINDIR)"
+	@$(INSTALL_PROGRAM) -D $(BINDIR)/$(TARGET) "$(DESTDIR)$(libexecdir)/coolerdash/coolerdash"
+	@$(INSTALL_DATA) $(README) "$(DESTDIR)$(PLUGINDIR)/README.md"
+	@$(INSTALL_DATA) CHANGELOG.md "$(DESTDIR)$(PLUGINDIR)/CHANGELOG.md"
+	@$(INSTALL_DATA) VERSION "$(DESTDIR)$(PLUGINDIR)/VERSION"
+	@if [ -f "$(DESTDIR)$(PLUGINDIR)/config.json" ]; then \
+		$(INSTALL) -m 666 etc/coolercontrol/plugins/coolerdash/config.json "$(DESTDIR)$(PLUGINDIR)/config.json.new"; \
+		printf "  $(YELLOW)Config:$(RESET) Existing config.json preserved. New defaults saved as config.json.new\n"; \
+	else \
+		$(INSTALL) -m 666 etc/coolercontrol/plugins/coolerdash/config.json "$(DESTDIR)$(PLUGINDIR)/config.json"; \
+	fi
+	@$(INSTALL) -d "$(DESTDIR)$(PLUGINDIR)/ui"
+	@$(INSTALL_DATA) etc/coolercontrol/plugins/coolerdash/ui/index.html "$(DESTDIR)$(PLUGINDIR)/ui/index.html"
+	@$(INSTALL_DATA) images/shutdown.png "$(DESTDIR)$(PLUGINDIR)/shutdown.png"
+	@$(INSTALL_DATA) $(MANIFEST) "$(DESTDIR)$(PLUGINDIR)/manifest.toml"
+	@sed -i 's/{{VERSION}}/$(VERSION)/g' "$(DESTDIR)$(PLUGINDIR)/manifest.toml"
+	@sed -i 's/{{VERSION}}/$(VERSION)/g' "$(DESTDIR)$(PLUGINDIR)/ui/index.html"
+	@printf "  $(GREEN)Binary:$(RESET)       $(DESTDIR)$(libexecdir)/coolerdash/coolerdash\n"
+	@printf "  $(GREEN)Config JSON:$(RESET)  $(DESTDIR)$(PLUGINDIR)/config.json\n"
+	@printf "  $(GREEN)Web UI:$(RESET)       $(DESTDIR)$(PLUGINDIR)/ui/index.html\n"
+	@printf "  $(GREEN)Plugin Lib:$(RESET)   Served by CoolerControl at /plugins/lib/cc-plugin-lib.js\n"
+	@printf "  $(GREEN)Plugin:$(RESET)       $(DESTDIR)$(PLUGINDIR)/manifest.toml\n"
 	@printf "  $(GREEN)Image:$(RESET)        shutdown.png (coolerdash.png)\n"
 	@printf "  $(GREEN)Documentation:$(RESET) README.md, LICENSE, CHANGELOG.md, VERSION\n"
 	@printf "\n"
-	@printf "$(CYAN)Note: Plugin binary is available at /usr/libexec/coolerdash/coolerdash$(RESET)\\n"
+	@printf "$(CYAN)Note: Plugin binary is available at $(libexecdir)/coolerdash/coolerdash$(RESET)\\n"
 	@printf "\n"
 	@printf "$(CYAN)Installing documentation...$(RESET)\n"
-	@install -Dm644 $(MANPAGE) "$(DESTDIR)/usr/share/man/man1/coolerdash.1"
-	@printf "  $(GREEN)Manual:$(RESET)  $(DESTDIR)/usr/share/man/man1/coolerdash.1\n"
+	@$(INSTALL_DATA) -D $(MANPAGE) "$(DESTDIR)$(mandir)/man1/coolerdash.1"
+	@printf "  $(GREEN)Manual:$(RESET)  $(DESTDIR)$(mandir)/man1/coolerdash.1\n"
 	@printf "$(CYAN)Installing license...$(RESET)\n"
-	@install -Dm644 LICENSE "$(DESTDIR)/usr/share/licenses/coolerdash/LICENSE"
-	@printf "  $(GREEN)License:$(RESET) $(DESTDIR)/usr/share/licenses/coolerdash/LICENSE\n"
+	@$(INSTALL_DATA) -D LICENSE "$(DESTDIR)$(datarootdir)/licenses/coolerdash/LICENSE"
+	@printf "  $(GREEN)License:$(RESET) $(DESTDIR)$(datarootdir)/licenses/coolerdash/LICENSE\n"
 	@printf "$(CYAN)Installing desktop shortcut...$(RESET)\n"
-	@install -Dm644 etc/applications/coolerdash.desktop "$(DESTDIR)/usr/share/applications/coolerdash.desktop"
-	@printf "  $(GREEN)Shortcut:$(RESET) $(DESTDIR)/usr/share/applications/coolerdash.desktop\n"
+	@$(INSTALL_DATA) -D etc/applications/coolerdash.desktop "$(DESTDIR)$(datadir)/applications/coolerdash.desktop"
+	@printf "  $(GREEN)Shortcut:$(RESET) $(DESTDIR)$(datadir)/applications/coolerdash.desktop\n"
 	@printf "$(CYAN)Installing icon...$(RESET)\n"
-	@install -Dm644 etc/icons/coolerdash.svg "$(DESTDIR)/usr/share/icons/hicolor/scalable/apps/coolerdash.svg"
-	@printf "  $(GREEN)Icon:$(RESET)     $(DESTDIR)/usr/share/icons/hicolor/scalable/apps/coolerdash.svg\n"
+	@$(INSTALL_DATA) -D etc/icons/coolerdash.svg "$(DESTDIR)$(datadir)/icons/hicolor/scalable/apps/coolerdash.svg"
+	@printf "  $(GREEN)Icon:$(RESET)     $(DESTDIR)$(datadir)/icons/hicolor/scalable/apps/coolerdash.svg\n"
 	@printf "\n"
 	@printf "$(WHITE)INSTALLATION SUCCESSFUL$(RESET)\n"
 	@printf "\n"
@@ -332,11 +393,30 @@ install: check-deps $(TARGET)
 	@printf "  $(PURPLE)Show manual:$(RESET)    man coolerdash\n"
 	@printf "\n"
 
+# Install with stripped binary (GNU standard target)
+install-strip:
+	$(MAKE) install INSTALL_PROGRAM='$(INSTALL_PROGRAM) -s'
+
+# Create install directories without installing (GNU standard target)
+installdirs:
+	$(INSTALL) -d "$(DESTDIR)$(libexecdir)/coolerdash"
+	$(INSTALL) -d "$(DESTDIR)$(PLUGINDIR)"
+	$(INSTALL) -d "$(DESTDIR)$(PLUGINDIR)/ui"
+	$(INSTALL) -d "$(DESTDIR)$(mandir)/man1"
+	$(INSTALL) -d "$(DESTDIR)$(datarootdir)/licenses/coolerdash"
+	$(INSTALL) -d "$(DESTDIR)$(datadir)/applications"
+	$(INSTALL) -d "$(DESTDIR)$(datadir)/icons/hicolor/scalable/apps"
+
 # Uninstall Target
 uninstall:
 	@printf "\n"
 	@printf "$(WHITE)=== COOLERDASH UNINSTALLATION ===$(RESET)\n"
 	@printf "\n"
+	@if [ -z "$(DESTDIR)" ] && [ "$(REALOS)" = "yes" ] && [ "$$(id -u)" -ne 0 ]; then \
+		printf "$(RED)Error: Uninstallation requires root privileges$(RESET)\n"; \
+		printf "$(YELLOW)Run: sudo make uninstall$(RESET)\n"; \
+		exit 1; \
+	fi
 	@if [ "$(REALOS)" = "yes" ]; then \
 		printf "$(CYAN)Stopping and disabling services...$(RESET)\n"; \
 		$(SUDO) systemctl stop cc-plugin-coolerdash.service >/dev/null 2>&1 || true; \
@@ -397,14 +477,14 @@ uninstall:
 			LEGACY_FOUND=1; \
 		fi; \
 	fi
-	@$(SUDO) rm -rf "$(DESTDIR)/etc/coolercontrol/plugins/coolerdash"
-	@$(SUDO) rm -rf "$(DESTDIR)/usr/libexec/coolerdash"
-	@$(SUDO) rm -rf "$(DESTDIR)/usr/share/licenses/coolerdash"
-	@$(SUDO) rm -f "$(DESTDIR)/usr/share/man/man1/coolerdash.1"
-	@$(SUDO) rm -f "$(DESTDIR)/usr/share/applications/coolerdash.desktop"
+	@$(SUDO) rm -rf "$(DESTDIR)$(PLUGINDIR)"
+	@$(SUDO) rm -rf "$(DESTDIR)$(libexecdir)/coolerdash"
+	@$(SUDO) rm -rf "$(DESTDIR)$(datarootdir)/licenses/coolerdash"
+	@$(SUDO) rm -f "$(DESTDIR)$(mandir)/man1/coolerdash.1"
+	@$(SUDO) rm -f "$(DESTDIR)$(datadir)/applications/coolerdash.desktop"
 	# Legacy cleanup: remove udev rule if installed by older version
 	@$(SUDO) rm -f "$(DESTDIR)/usr/lib/udev/rules.d/99-coolerdash.rules"
-	@$(SUDO) rm -f "$(DESTDIR)/usr/share/icons/hicolor/scalable/apps/coolerdash.svg"
+	@$(SUDO) rm -f "$(DESTDIR)$(datadir)/icons/hicolor/scalable/apps/coolerdash.svg"
 	@if [ "$(REALOS)" = "yes" ]; then \
 		if id -u coolerdash >/dev/null 2>&1; then \
 			$(SUDO) userdel -rf coolerdash; \
@@ -417,8 +497,9 @@ uninstall:
 	@printf "\n"
 
 # Debug Build
-debug: CFLAGS += -g -DDEBUG -fsanitize=address
-debug: LIBS += -fsanitize=address
+debug: CPPFLAGS += -DDEBUG
+debug: CFLAGS += -g -fsanitize=address
+debug: LDFLAGS += -fsanitize=address
 debug: $(TARGET)
 	@printf "$(GREEN)Debug build created with AddressSanitizer: $(BINDIR)/$(TARGET)$(RESET)\n"
 
@@ -434,13 +515,17 @@ help:
 	@printf "$(WHITE)========================================$(RESET)\n"
 	@printf "\n"
 	@printf "$(YELLOW)Build Targets:$(RESET)\n"
-	@printf "  $(GREEN)make$(RESET)          - Compiles the program\n"
-	@printf "  $(GREEN)make clean$(RESET)    - Removes compiled files\n"
-	@printf "  $(GREEN)make debug$(RESET)    - Debug build with AddressSanitizer\n"
+	@printf "  $(GREEN)make$(RESET)              - Compiles the program\n"
+	@printf "  $(GREEN)make clean$(RESET)        - Removes compiled files\n"
+	@printf "  $(GREEN)make distclean$(RESET)    - Same as clean (no autoconf)\n"
+	@printf "  $(GREEN)make check$(RESET)        - Runs unit tests\n"
+	@printf "  $(GREEN)make debug$(RESET)        - Debug build with AddressSanitizer\n"
 	@printf "\n"
 	@printf "$(YELLOW)Installation:$(RESET)\n"
-	@printf "  $(GREEN)make install$(RESET)  - Installs binary + plugin data + systemd units\n"
-	@printf "  $(GREEN)make uninstall$(RESET)- Uninstalls the program\n"
+	@printf "  $(GREEN)make install$(RESET)      - Installs binary + plugin data\n"
+	@printf "  $(GREEN)make install-strip$(RESET)- Installs with stripped binary\n"
+	@printf "  $(GREEN)make installdirs$(RESET) - Creates install directories only\n"
+	@printf "  $(GREEN)make uninstall$(RESET)   - Uninstalls the program\n"
 	@printf "\n"
 	@printf "$(YELLOW)Plugin Management:$(RESET)\n"
 	@printf "  $(GREEN)systemctl enable --now coolercontrold.service$(RESET)    - Active CoolerControl service\n"
@@ -457,7 +542,7 @@ help:
 	@printf "  $(GREEN)README.md$(RESET)         - English (main documentation)\n"
 	@printf "\n"
 	@printf "$(YELLOW)Version Usage:$(RESET)\n"
-	@printf "  $(GREEN)Program:$(RESET) /usr/libexec/coolerdash/coolerdash [mode]\n"
-	@printf "  $(GREEN)Config:$(RESET)  /etc/coolercontrol/plugins/coolerdash/config.json\n"
+	@printf "  $(GREEN)Program:$(RESET) $(libexecdir)/coolerdash/coolerdash [mode]\n"
+	@printf "  $(GREEN)Config:$(RESET)  $(PLUGINDIR)/config.json\n"
 	@printf "  $(GREEN)Web UI:$(RESET)  CoolerControl Plugin Settings\n"
 	@printf "\n"
diff --git a/PKGBUILD b/PKGBUILD
index 7deb63b..355ca99 100644
--- a/PKGBUILD
+++ b/PKGBUILD
@@ -47,7 +47,6 @@ build() {
     cp -a README.md CHANGELOG.md VERSION LICENSE "${srcdir}/"
     cp -a etc/coolercontrol/plugins/coolerdash/config.json "${srcdir}/etc/coolercontrol/plugins/coolerdash/"
     cp -a etc/coolercontrol/plugins/coolerdash/ui/index.html "${srcdir}/etc/coolercontrol/plugins/coolerdash/ui/"
-    cp -a etc/coolercontrol/plugins/coolerdash/ui/cc-plugin-lib.js "${srcdir}/etc/coolercontrol/plugins/coolerdash/ui/"
     cp -a images/shutdown.png "${srcdir}/images/"
     cp -a man/coolerdash.1 "${srcdir}/man/"
     cp -a etc/coolercontrol/plugins/coolerdash/manifest.toml "${srcdir}/etc/coolercontrol/plugins/coolerdash/"
@@ -79,7 +78,6 @@ package() {
 
     install -dm755 "${pkgdir}/etc/coolercontrol/plugins/coolerdash/ui"
     install -m644 "${srcdir}/etc/coolercontrol/plugins/coolerdash/ui/index.html" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/ui/index.html"
-    install -m644 "${srcdir}/etc/coolercontrol/plugins/coolerdash/ui/cc-plugin-lib.js" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/ui/cc-plugin-lib.js"
     install -Dm644 "${srcdir}/images/shutdown.png" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/shutdown.png"
     install -Dm644 "${srcdir}/etc/coolercontrol/plugins/coolerdash/manifest.toml" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/manifest.toml"
 
diff --git a/VERSION b/VERSION
index eca690e..fd2a018 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-3.0.5
+3.1.0
diff --git a/aur/PKGBUILD b/aur/PKGBUILD
index 17f2310..1f09e6b 100644
--- a/aur/PKGBUILD
+++ b/aur/PKGBUILD
@@ -65,7 +65,6 @@ package() {
 
     install -dm755 "${pkgdir}/etc/coolercontrol/plugins/coolerdash/ui"
     install -m644 "${srcdir}/${pkgname}/etc/coolercontrol/plugins/coolerdash/ui/index.html" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/ui/index.html"
-    install -m644 "${srcdir}/${pkgname}/etc/coolercontrol/plugins/coolerdash/ui/cc-plugin-lib.js" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/ui/cc-plugin-lib.js"
     install -m644 "${srcdir}/${pkgname}/images/shutdown.png" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/shutdown.png"
     install -m644 "${srcdir}/${pkgname}/etc/coolercontrol/plugins/coolerdash/manifest.toml" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/manifest.toml"
 
diff --git a/etc/coolercontrol/plugins/coolerdash/config.json b/etc/coolercontrol/plugins/coolerdash/config.json
index 9d3c34e..80fc1e0 100644
--- a/etc/coolercontrol/plugins/coolerdash/config.json
+++ b/etc/coolercontrol/plugins/coolerdash/config.json
@@ -107,6 +107,8 @@
   "positioning": {
     "degree_spacing": 16,
     "label_offset_x": 0,
-    "label_offset_y": 0
+    "label_offset_y": 0,
+    "margin_top": 0,
+    "margin_bottom": 0
   }
 }
diff --git a/etc/coolercontrol/plugins/coolerdash/manifest.toml b/etc/coolercontrol/plugins/coolerdash/manifest.toml
index d50e6fe..8cf79d3 100644
--- a/etc/coolercontrol/plugins/coolerdash/manifest.toml
+++ b/etc/coolercontrol/plugins/coolerdash/manifest.toml
@@ -3,7 +3,7 @@ type = "integration"
 version = "{{VERSION}}"
 description = "Monitor telemetry data on an AIO liquid cooler with an integrated LCD display"
 executable = "/usr/libexec/coolerdash/coolerdash"
-#args = "--verbose"
+args = "--verbose"
 privileged = true
 url = "https://github.com/damachine/coolerdash"
 author = "damachine"
diff --git a/etc/coolercontrol/plugins/coolerdash/ui/index.html b/etc/coolercontrol/plugins/coolerdash/ui/index.html
index c508bb5..d8a199d 100644
--- a/etc/coolercontrol/plugins/coolerdash/ui/index.html
+++ b/etc/coolercontrol/plugins/coolerdash/ui/index.html
@@ -4,7 +4,7 @@
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>CoolerDash Settings</title>
-    <script type="text/javascript" src="cc-plugin-lib.js" onerror="console.warn('cc-plugin-lib.js not found, using fallback')"></script>
+    <script type="text/javascript" src="/plugins/lib/cc-plugin-lib.js" onerror="console.warn('cc-plugin-lib.js not found, using fallback')"></script>
     <style>
         * { margin: 0; padding: 0; box-sizing: border-box; }
 
@@ -901,6 +901,18 @@ <h3 class="section-title">Background &amp; Shutdown Images</h3>
                                 <input type="number" name="positioning.degree_spacing" class="form-control" min="0" max="100">
                             </div>
                         </div>
+                        <div class="grid grid-2" style="margin-top: 12px;">
+                            <div class="form-group">
+                                <label class="form-label">Margin Top</label>
+                                <span class="form-hint">Vertical top margin in logical units. 0 = auto (circular ~3%, rectangular 0)</span>
+                                <input type="number" name="positioning.margin_top" class="form-control" step="1">
+                            </div>
+                            <div class="form-group">
+                                <label class="form-label">Margin Bottom</label>
+                                <span class="form-hint">Vertical bottom margin in logical units. 0 = auto (circular ~3%, rectangular 0)</span>
+                                <input type="number" name="positioning.margin_bottom" class="form-control" step="1">
+                            </div>
+                        </div>
                     </div>
                 </details>
 
@@ -1145,7 +1157,7 @@ <h3 class="section-title">System Environment</h3>
         <!-- Restart Notice -->
         <div style="margin-top: 16px; padding: 12px; background: rgba(255, 140, 0, 0.05); border-left: 3px solid #ff8c00; border-radius: 4px;">
             <p style="margin: 0; color: var(--text-dim); font-size: 13px;">
-                <strong>Note:</strong> After saving, the service must be restarted manually: <code style="background: rgba(255,255,255,0.08); padding: 2px 6px; border-radius: 3px; font-size: 12px;">systemctl restart cc-plugin-coolerdash.service</code>
+                <strong>Note:</strong> After saving, reload the config with <code style="background: rgba(255,255,255,0.08); padding: 2px 6px; border-radius: 3px; font-size: 12px;">kill -HUP $(pgrep coolerdash)</code> or restart the service: <code style="background: rgba(255,255,255,0.08); padding: 2px 6px; border-radius: 3px; font-size: 12px;">systemctl restart cc-plugin-coolerdash.service</code>
             </p>
         </div>
     </div>
@@ -1254,7 +1266,9 @@ <h3 class="section-title">System Environment</h3>
             positioning: {
                 degree_spacing: 16,
                 label_offset_x: 0,
-                label_offset_y: 0
+                label_offset_y: 0,
+                margin_top: 0,
+                margin_bottom: 0
             }
         };
 
diff --git a/packaging/coolerdash.spec b/packaging/coolerdash.spec
index 4eba070..3dab031 100644
--- a/packaging/coolerdash.spec
+++ b/packaging/coolerdash.spec
@@ -142,7 +142,6 @@ fi
 /etc/coolercontrol/plugins/coolerdash/manifest.toml
 %dir /etc/coolercontrol/plugins/coolerdash/ui
 /etc/coolercontrol/plugins/coolerdash/ui/index.html
-/etc/coolercontrol/plugins/coolerdash/ui/cc-plugin-lib.js
 /etc/coolercontrol/plugins/coolerdash/shutdown.png
 /etc/coolercontrol/plugins/coolerdash/README.md
 /etc/coolercontrol/plugins/coolerdash/CHANGELOG.md
diff --git a/packaging/debian/install b/packaging/debian/install
index 920e12b..09fc557 100644
--- a/packaging/debian/install
+++ b/packaging/debian/install
@@ -7,7 +7,6 @@ etc/coolercontrol/plugins/coolerdash/README.md
 etc/coolercontrol/plugins/coolerdash/VERSION
 etc/coolercontrol/plugins/coolerdash/CHANGELOG.md
 etc/coolercontrol/plugins/coolerdash/ui/index.html
-etc/coolercontrol/plugins/coolerdash/ui/cc-plugin-lib.js
 usr/share/man/man1/coolerdash.1
 usr/share/applications/coolerdash.desktop
 usr/share/icons/hicolor/scalable/apps/coolerdash.svg
diff --git a/src/device/config.c b/src/device/config.c
index a669655..7de3302 100644
--- a/src/device/config.c
+++ b/src/device/config.c
@@ -1212,6 +1212,18 @@ static void load_positioning_from_json(json_t *root, Config *config)
     {
         config->display_label_offset_y = (int)json_integer_value(label_offset_y);
     }
+
+    json_t *margin_top = json_object_get(positioning, "margin_top");
+    if (margin_top && json_is_integer(margin_top))
+    {
+        config->display_margin_top = (int)json_integer_value(margin_top);
+    }
+
+    json_t *margin_bottom = json_object_get(positioning, "margin_bottom");
+    if (margin_bottom && json_is_integer(margin_bottom))
+    {
+        config->display_margin_bottom = (int)json_integer_value(margin_bottom);
+    }
 }
 
 // ============================================================================
diff --git a/src/device/config.h b/src/device/config.h
index 476ce58..f10c3e4 100644
--- a/src/device/config.h
+++ b/src/device/config.h
@@ -152,6 +152,8 @@ typedef struct Config
     int display_degree_spacing;
     int display_label_offset_x;
     int display_label_offset_y;
+    int display_margin_top;    /**< Vertical top margin (0 = auto-detect) */
+    int display_margin_bottom; /**< Vertical bottom margin (0 = auto-detect) */
 
     // Per-sensor configuration (thresholds, colors, offsets)
     SensorConfig sensor_configs[MAX_SENSOR_CONFIGS]; /**< Sensor-specific configs */
diff --git a/src/main.c b/src/main.c
index f4fdae0..d69dada 100644
--- a/src/main.c
+++ b/src/main.c
@@ -32,6 +32,7 @@
 
 // Include project headers
 #include "device/config.h"
+#include "mods/circle.h"
 #include "mods/display.h"
 #include "srv/cc_conf.h"
 #include "srv/cc_main.h"
@@ -45,7 +46,16 @@
  * @brief Global variables for daemon management.
  * @details Used for controlling the main daemon loop and shutdown image logic.
  */
-static volatile sig_atomic_t running = 1; // flag whether daemon is running
+static volatile sig_atomic_t running = 1;       // flag whether daemon is running
+static volatile sig_atomic_t reload_config = 0; // flag for SIGHUP config reload
+
+/**
+ * @brief File-scope storage for config reload.
+ * @details Preserved across reload so reload_daemon_config() can re-read
+ * config.json and re-apply CLI overrides.
+ */
+static const char *s_config_path = NULL;
+static char s_display_mode_override[16] = {0};
 
 /**
  * @brief Global logging control.
@@ -330,6 +340,20 @@ static void handle_shutdown_signal(int signum)
     running = 0;
 }
 
+/**
+ * @brief Signal handler for SIGHUP (config reload).
+ * @details Sets the reload flag so the main loop re-reads config.json.
+ * Only uses async-signal-safe functions.
+ */
+static void handle_reload_signal(int signum)
+{
+    (void)signum;
+    static const char msg[] = "Received SIGHUP - scheduling config reload\n";
+    ssize_t written = write(STDERR_FILENO, msg, sizeof(msg) - 1);
+    (void)written;
+    reload_config = 1;
+}
+
 /**
  * @brief Setup enhanced signal handlers with comprehensive signal management.
  * @details Installs signal handlers for graceful shutdown and blocks unwanted
@@ -365,10 +389,22 @@ static void setup_enhanced_signal_handlers(void)
                     strerror(errno));
     }
 
+    // Install SIGHUP handler for config reload
+    struct sigaction sa_reload;
+    memset(&sa_reload, 0, sizeof(sa_reload));
+    sa_reload.sa_handler = handle_reload_signal;
+    sigemptyset(&sa_reload.sa_mask);
+    sa_reload.sa_flags = SA_RESTART;
+
+    if (sigaction(SIGHUP, &sa_reload, NULL) == -1)
+    {
+        log_message(LOG_WARNING, "Failed to install SIGHUP handler: %s",
+                    strerror(errno));
+    }
+
     // Block unwanted signals to prevent interference
     sigemptyset(&block_mask);
     sigaddset(&block_mask, SIGPIPE); // Prevent broken pipe crashes
-    sigaddset(&block_mask, SIGHUP);  // Ignore hangup signal for daemon operation
 
     if (pthread_sigmask(SIG_BLOCK, &block_mask, NULL) != 0)
     {
@@ -376,12 +412,62 @@ static void setup_enhanced_signal_handlers(void)
     }
 }
 
+/**
+ * @brief Reload configuration from config.json (SIGHUP handler).
+ * @details Resets all module state, re-reads config.json, and re-initializes
+ * CoolerControl session and device cache. On failure, logs error but the
+ * daemon continues running with the previous configuration values.
+ */
+static void reload_daemon_config(Config *config)
+{
+    log_message(LOG_STATUS, "SIGHUP received — reloading configuration...");
+
+    // 1. Tear down module state (reverse order of init)
+    cleanup_sensor_curl_handle();
+    reset_coolercontrol_session();
+    reset_device_cache();
+    reset_circle_state();
+
+    // 2. Re-read config.json into the existing struct
+    load_plugin_config(config, s_config_path);
+
+    // 3. Re-apply CLI display mode override if it was set at startup
+    if (s_display_mode_override[0] != '\0')
+    {
+        cc_safe_strcpy(config->display_mode, sizeof(config->display_mode),
+                       s_display_mode_override);
+        log_message(LOG_INFO, "Display mode overridden by CLI: %s",
+                    config->display_mode);
+    }
+
+    // 4. Re-initialize CoolerControl session with potentially new token/address
+    if (!init_coolercontrol_session(config))
+    {
+        log_message(LOG_ERROR,
+                    "Config reload: session re-init failed — continuing with degraded state");
+        return;
+    }
+
+    // 5. Re-populate device cache
+    if (!init_device_cache(config))
+    {
+        log_message(LOG_ERROR,
+                    "Config reload: device cache re-init failed — continuing with degraded state");
+        return;
+    }
+
+    // 6. Update LCD dimensions from device if config has width/height=0
+    update_config_from_device(config);
+
+    log_message(LOG_STATUS, "Configuration reloaded successfully");
+}
+
 /**
  * @brief Enhanced main daemon loop with improved timing and error handling.
  * @details Runs the main loop with precise timing, optimized sleep, and
- * graceful error recovery.
+ * graceful error recovery. Handles SIGHUP for live config reload.
  */
-static int run_daemon(const Config *config)
+static int run_daemon(Config *config)
 {
     if (!config)
     {
@@ -391,12 +477,12 @@ static int run_daemon(const Config *config)
 
     // Convert float seconds to timespec (e.g., 2.50 -> tv_sec=2,
     // tv_nsec=500000000)
-    const long interval_sec = (long)config->display_refresh_interval;
-    const long interval_nsec =
+    long interval_sec = (long)config->display_refresh_interval;
+    long interval_nsec =
         (long)((config->display_refresh_interval - interval_sec) * 1000000000);
 
-    const struct timespec interval = {.tv_sec = interval_sec,
-                                      .tv_nsec = interval_nsec};
+    struct timespec interval = {.tv_sec = interval_sec,
+                                .tv_nsec = interval_nsec};
 
     struct timespec next_time;
     if (clock_gettime(CLOCK_MONOTONIC, &next_time) != 0)
@@ -407,6 +493,21 @@ static int run_daemon(const Config *config)
 
     while (running)
     {
+        // Check for pending config reload (SIGHUP)
+        if (reload_config)
+        {
+            reload_config = 0;
+            reload_daemon_config(config);
+
+            // Recalculate interval from potentially changed refresh_interval
+            interval_sec = (long)config->display_refresh_interval;
+            interval_nsec = (long)((config->display_refresh_interval -
+                                    interval_sec) *
+                                   1000000000);
+            interval.tv_sec = interval_sec;
+            interval.tv_nsec = interval_nsec;
+        }
+
         // Calculate next execution time with overflow protection
         next_time.tv_sec += interval.tv_sec;
         next_time.tv_nsec += interval.tv_nsec;
@@ -651,6 +752,11 @@ int main(int argc, char **argv)
     char display_mode_override[16] = {0};
     const char *config_path = parse_arguments(argc, argv, display_mode_override);
 
+    // Store in file-scope statics for SIGHUP reload
+    s_config_path = config_path;
+    cc_safe_strcpy(s_display_mode_override, sizeof(s_display_mode_override),
+                   display_mode_override);
+
     log_message(LOG_STATUS, "CoolerDash v%s starting up...",
                 read_version_from_file());
 
@@ -663,10 +769,10 @@ int main(int argc, char **argv)
     }
 
     // Apply CLI display mode override if provided
-    if (display_mode_override[0] != '\0')
+    if (s_display_mode_override[0] != '\0')
     {
         cc_safe_strcpy(config.display_mode, sizeof(config.display_mode),
-                       display_mode_override);
+                       s_display_mode_override);
         log_message(LOG_INFO, "Display mode overridden by CLI: %s",
                     config.display_mode);
     }
diff --git a/src/mods/circle.c b/src/mods/circle.c
index 23b722e..4dd7081 100644
--- a/src/mods/circle.c
+++ b/src/mods/circle.c
@@ -35,6 +35,16 @@
 static int current_slot_index = 0; // 0=slot1, 1=slot2, 2=slot3
 static time_t last_switch_time = 0;
 
+/**
+ * @brief Resets circle mode state for config reload (SIGHUP).
+ * @details Resets slot cycling to the first sensor and clears the switch timer.
+ */
+void reset_circle_state(void)
+{
+    current_slot_index = 0;
+    last_switch_time = 0;
+}
+
 /**
  * @brief Find pump RPM sensor for a Liquidctl device.
  * @details Searches for an RPM sensor whose name contains "pump"
@@ -400,15 +410,18 @@ static void draw_single_sensor(cairo_t *cr, const struct Config *config,
 
     const double grouped_height =
         bar_height + (label_text ? (region_gap + label_band_height) : 0.0);
+    const double available_height =
+        config->display_height - params->margin_top - params->margin_bottom;
     const int bar_y =
-        (int)lround(fmax(0.0, (config->display_height - grouped_height) / 2.0));
+        (int)lround(fmax(0.0, params->margin_top +
+                                  (available_height - grouped_height) / 2.0));
     const double value_bar_gap = region_gap * 0.05;
 
-    const double value_box_y = 0.0;
-    const double value_box_height = fmax(0.0, bar_y - value_bar_gap);
+    const double value_box_y = params->margin_top;
+    const double value_box_height = fmax(0.0, bar_y - value_bar_gap - params->margin_top);
     const double label_box_y = bar_y + bar_height + region_gap;
     const double label_box_height =
-        fmax(0.0, config->display_height - label_box_y);
+        fmax(0.0, config->display_height - params->margin_bottom - label_box_y);
 
     if (verbose_logging)
     {
diff --git a/src/mods/circle.h b/src/mods/circle.h
index fdee872..dba8063 100644
--- a/src/mods/circle.h
+++ b/src/mods/circle.h
@@ -34,4 +34,10 @@ struct Config;
  */
 void draw_circle_image(const struct Config *config);
 
+/**
+ * @brief Resets circle mode state for config reload (SIGHUP).
+ * @details Resets slot cycling to the first sensor and clears the switch timer.
+ */
+void reset_circle_state(void);
+
 #endif // CIRCLE_H
diff --git a/src/mods/display.c b/src/mods/display.c
index ad3dbd3..2b0a036 100644
--- a/src/mods/display.c
+++ b/src/mods/display.c
@@ -715,16 +715,32 @@ void calculate_scaling_params(const struct Config *config,
 
     params->corner_radius = 8.0 * params->scale_uniform;
 
+    // Calculate vertical margins (0 = auto-detect based on display shape)
+    if (config->display_margin_top != 0)
+        params->margin_top = config->display_margin_top * params->scale_uniform;
+    else
+        params->margin_top = params->is_circular
+                                 ? (config->display_height * 0.03)
+                                 : 0.0;
+
+    if (config->display_margin_bottom != 0)
+        params->margin_bottom = config->display_margin_bottom * params->scale_uniform;
+    else
+        params->margin_bottom = params->is_circular
+                                    ? (config->display_height * 0.03)
+                                    : 0.0;
+
     // Log detailed scaling calculations
     log_message(
         LOG_INFO,
-        "Scaling: display=%ux%u scale=(%.3f, %.3f) uniform=%.3f shape=%s inscribe=%.4f content=%.3f safe_area=%.0fpx bar_width=%dpx (%.0f%%) margin=%.1fpx",
+        "Scaling: display=%ux%u scale=(%.3f, %.3f) uniform=%.3f shape=%s inscribe=%.4f content=%.3f safe_area=%.0fpx bar_width=%dpx (%.0f%%) margin=%.1fpx margin_v=(%.1f, %.1f)",
         config->display_width, config->display_height, params->scale_x,
         params->scale_y, params->scale_uniform,
         params->is_circular ? "circular" : "rectangular",
         params->inscribe_factor, content_scale, safe_area_width,
         params->safe_bar_width, bar_width_factor * 100.0,
-        params->safe_content_margin);
+        params->safe_content_margin,
+        params->margin_top, params->margin_bottom);
 }
 
 /**
diff --git a/src/mods/display.h b/src/mods/display.h
index 737d068..48e24a0 100644
--- a/src/mods/display.h
+++ b/src/mods/display.h
@@ -60,6 +60,8 @@ typedef struct
     double inscribe_factor;     /**< 1.0 for rectangular, M_SQRT1_2 for circular */
     int safe_bar_width;         /**< Safe bar width for circular displays */
     double safe_content_margin; /**< Horizontal margin for safe content area */
+    double margin_top;          /**< Vertical top margin in pixels */
+    double margin_bottom;       /**< Vertical bottom margin in pixels */
     int is_circular;            /**< 1 if circular display, 0 if rectangular */
 } ScalingParams;
 
diff --git a/src/mods/dual.c b/src/mods/dual.c
index aff838d..630e19b 100644
--- a/src/mods/dual.c
+++ b/src/mods/dual.c
@@ -99,8 +99,11 @@ static int calculate_dual_layout(const struct Config *config,
     else
         return 0;
 
+    const double available_height =
+        config->display_height - params->margin_top - params->margin_bottom;
     const int start_y =
-        (int)lround(((double)config->display_height - total_height) / 2.0);
+        (int)lround(params->margin_top +
+                    (available_height - total_height) / 2.0);
     layout->up_bar_y = start_y;
     layout->down_bar_y = start_y + layout->bar_height_up +
                          layout->bar_gap;
@@ -111,13 +114,13 @@ static int calculate_dual_layout(const struct Config *config,
     layout->label_spacing = get_effective_label_spacing(config, params);
     const double value_bar_gap = layout->label_spacing * 0.05;
 
-    layout->top_value_box_y = 0.0;
+    layout->top_value_box_y = params->margin_top;
     layout->top_value_box_height =
-        fmax(0.0, layout->up_bar_y - value_bar_gap);
+        fmax(0.0, layout->up_bar_y - value_bar_gap - params->margin_top);
     layout->bottom_value_box_y =
         layout->down_bar_y + layout->bar_height_down + value_bar_gap;
     layout->bottom_value_box_height =
-        fmax(0.0, config->display_height - layout->bottom_value_box_y);
+        fmax(0.0, config->display_height - params->margin_bottom - layout->bottom_value_box_y);
 
     if (verbose_logging)
     {
diff --git a/src/srv/cc_conf.c b/src/srv/cc_conf.c
index 3e99ff0..90f2944 100644
--- a/src/srv/cc_conf.c
+++ b/src/srv/cc_conf.c
@@ -82,6 +82,17 @@ static struct
 } device_name_cache[MAX_DEVICE_NAME_CACHE];
 static int device_name_cache_count = 0;
 
+/**
+ * @brief Resets device cache for config reload (SIGHUP).
+ * @details Clears all cached device data so it will be re-fetched from the API.
+ */
+void reset_device_cache(void)
+{
+    memset(&device_cache, 0, sizeof(device_cache));
+    memset(device_name_cache, 0, sizeof(device_name_cache));
+    device_name_cache_count = 0;
+}
+
 /**
  * @brief Get device display name by UID.
  */
@@ -153,9 +164,8 @@ int is_circular_display_device(const char *device_name, int screen_width,
         return is_large_display ? 1 : 0;
     }
 
-    // Placeholder for future circular display device names
-    // Currently no other brands detected, only by display size
-    return 0;
+    // Unknown device: detect by display size (>240px = circular LCD)
+    return (screen_width > 240 || screen_height > 240) ? 1 : 0;
 }
 
 /**
diff --git a/src/srv/cc_conf.h b/src/srv/cc_conf.h
index 745fb9d..f747b89 100644
--- a/src/srv/cc_conf.h
+++ b/src/srv/cc_conf.h
@@ -56,6 +56,12 @@ int get_cached_lcd_device_data(const struct Config *config, char *device_uid,
  */
 int init_device_cache(const struct Config *config);
 
+/**
+ * @brief Resets device cache for config reload (SIGHUP).
+ * @details Clears all cached device data so it will be re-fetched from the API.
+ */
+void reset_device_cache(void);
+
 /**
  * @brief Update config with device screen dimensions (only if not set in
  * config.json).
diff --git a/src/srv/cc_main.c b/src/srv/cc_main.c
index c15c075..9db004c 100644
--- a/src/srv/cc_main.c
+++ b/src/srv/cc_main.c
@@ -243,6 +243,24 @@ void cleanup_coolercontrol_session(void)
     }
 }
 
+/**
+ * @brief Resets the CoolerControl session for config reload (SIGHUP).
+ * @details Unlike cleanup_coolercontrol_session(), this does NOT call
+ * curl_global_cleanup() and does NOT set the one-shot cleanup_done guard.
+ * The session can be re-initialized via init_coolercontrol_session().
+ */
+void reset_coolercontrol_session(void)
+{
+    if (cc_session.curl_handle)
+    {
+        curl_easy_cleanup(cc_session.curl_handle);
+        cc_session.curl_handle = NULL;
+    }
+
+    cc_session.session_initialized = 0;
+    cc_session.access_token[0] = '\0';
+}
+
 /**
  * @brief Returns the active Bearer auth header string (or empty string).
  */
diff --git a/src/srv/cc_main.h b/src/srv/cc_main.h
index 7a47f51..f2301da 100644
--- a/src/srv/cc_main.h
+++ b/src/srv/cc_main.h
@@ -89,6 +89,13 @@ int is_session_initialized(void);
  */
 void cleanup_coolercontrol_session(void);
 
+/**
+ * @brief Resets the CoolerControl session for config reload (SIGHUP).
+ * @details Destroys the CURL handle without global cleanup, allowing
+ * re-initialization via init_coolercontrol_session().
+ */
+void reset_coolercontrol_session(void);
+
 /**
  * @brief Returns the active Bearer access token (empty string if not set).
  * @details Used by cc_conf and cc_sensor to attach auth headers.
diff --git a/tests/test_scaling.c b/tests/test_scaling.c
index 35b76f9..1231242 100644
--- a/tests/test_scaling.c
+++ b/tests/test_scaling.c
@@ -1,6 +1,13 @@
 /*
  * Simple test harness for safe_area calculations
- * Validates safe_area_width and safe_bar_width for given display_inscribe_factor values.
+ * Validates safe_area_width and safe_bar_width for current scaling logic.
+ *
+ * Current formula (from display.c calculate_scaling_params):
+ *   inscribe_factor = is_circular ? M_SQRT1_2 : 1.0
+ *   safe_area_width = display_width * inscribe_factor
+ *   content_scale   = display_content_scale_factor (0..1, fallback 0.98)
+ *   bar_width_factor = layout_bar_width/100 (fallback 0.98)
+ *   safe_bar_width  = safe_area_width * content_scale * bar_width_factor
  */
 #define _POSIX_C_SOURCE 200112L
 // cppcheck-suppress-begin missingIncludeSystem
@@ -11,7 +18,6 @@
 
 #include "../src/device/config.h"
 
-// Use same constant
 #ifndef M_SQRT1_2
 #define M_SQRT1_2 0.7071067811865476
 #endif
@@ -21,95 +27,107 @@ static int almost_equal(double a, double b, double eps)
     return fabs(a - b) <= eps;
 }
 
-static void run_case(const char *name, int width, float content_scale, float inscribe_cfg, int rectangular_force, double expected_safe_area, double expected_safe_bar)
+static int failures = 0;
+
+static void run_case(const char *name, int width, float content_scale,
+                     uint8_t bar_width_pct, int is_circular,
+                     double expected_safe_area, int expected_safe_bar)
 {
     Config cfg;
     memset(&cfg, 0, sizeof(cfg));
     cfg.display_width = (uint16_t)width;
-    // Use snprintf for a local, safe copy to avoid external symbol dependency during unit tests
-    snprintf(cfg.display_shape, sizeof(cfg.display_shape), "%s", "circular");
+    cfg.display_height = (uint16_t)width;
     cfg.display_content_scale_factor = content_scale;
-    cfg.display_inscribe_factor = inscribe_cfg;
-
-    double inscribe_used;
-    if (rectangular_force)
-        inscribe_used = 1.0;
-    else if (strcmp(cfg.display_shape, "rectangular") == 0)
-        inscribe_used = 1.0;
-    else
-    {
-        if (cfg.display_inscribe_factor == 0.0f)
-            inscribe_used = M_SQRT1_2;
-        else if (cfg.display_inscribe_factor > 0.0f && cfg.display_inscribe_factor <= 1.0f)
-            inscribe_used = (double)cfg.display_inscribe_factor;
-        else
-            inscribe_used = M_SQRT1_2;
-    }
+    cfg.layout_bar_width = bar_width_pct;
 
-    double safe_area = (double)cfg.display_width * inscribe_used;
-    double safe_bar = safe_area * (double)cfg.display_content_scale_factor;
+    double inscribe_factor = is_circular ? M_SQRT1_2 : 1.0;
+    double safe_area_width = (double)cfg.display_width * inscribe_factor;
 
-    int pass_area = almost_equal(safe_area, expected_safe_area, 0.001);
-    int pass_bar = almost_equal(safe_bar, expected_safe_bar, 0.01);
+    float cs = (cfg.display_content_scale_factor > 0.0f &&
+                cfg.display_content_scale_factor <= 1.0f)
+                   ? cfg.display_content_scale_factor
+                   : 0.98f;
+    double bwf = (cfg.layout_bar_width > 0)
+                     ? (cfg.layout_bar_width / 100.0)
+                     : 0.98;
+    int safe_bar_width = (int)(safe_area_width * cs * bwf);
+
+    int pass_area = almost_equal(safe_area_width, expected_safe_area, 0.01);
+    int pass_bar = (safe_bar_width == expected_safe_bar);
 
     printf("Case: %s\n", name);
-    printf("  width=%d, content_scale=%.5f, cfg_inscribe=%.8f -> inscribe_used=%.8f\n", width, content_scale, inscribe_cfg, inscribe_used);
-    printf("  safe_area=%.6f expected=%.6f [ %s ]\n", safe_area, expected_safe_area, pass_area ? "OK" : "FAIL");
-    printf("  safe_bar=%.6f expected=%.6f [ %s ]\n", safe_bar, expected_safe_bar, pass_bar ? "OK" : "FAIL");
+    printf("  width=%d, shape=%s, content_scale=%.2f, bar_width=%u%%\n",
+           width, is_circular ? "circular" : "rectangular", content_scale,
+           bar_width_pct);
+    printf("  safe_area=%.4f expected=%.4f [ %s ]\n",
+           safe_area_width, expected_safe_area, pass_area ? "OK" : "FAIL");
+    printf("  safe_bar=%d expected=%d [ %s ]\n",
+           safe_bar_width, expected_safe_bar, pass_bar ? "OK" : "FAIL");
     printf("\n");
+
+    if (!pass_area || !pass_bar)
+        failures++;
 }
 
 int main(void)
 {
-    // Use base width 240
-    const int width = 240;
-    const float content_scale = 0.98f; // default
-
-    // Cases for width 240 and 320
+    const float cs = 0.98f;
     int widths[] = {240, 320};
     size_t wcount = sizeof(widths) / sizeof(widths[0]);
+
     for (size_t i = 0; i < wcount; ++i)
     {
         int w = widths[i];
-        // auto (0.0)
-        double inscribe = M_SQRT1_2;
-        double expected_safe_area = w * inscribe;
-        double expected_safe_bar = expected_safe_area * content_scale;
         char buf[128];
-        snprintf(buf, sizeof(buf), "auto(0.0) width=%d", w);
-        run_case(buf, w, content_scale, 0.0f, 0, expected_safe_area, expected_safe_bar);
-
-        // explicit geometric
-        inscribe = 0.70710678;
-        expected_safe_area = w * inscribe;
-        expected_safe_bar = expected_safe_area * content_scale;
-        snprintf(buf, sizeof(buf), "explicit 0.70710678 width=%d", w);
-        run_case(buf, w, content_scale, 0.70710678f, 0, expected_safe_area, expected_safe_bar);
-
-        // explicit custom 0.85
-        inscribe = 0.85;
-        expected_safe_area = w * inscribe;
-        expected_safe_bar = expected_safe_area * content_scale;
-        snprintf(buf, sizeof(buf), "custom 0.85 width=%d", w);
-        run_case(buf, w, content_scale, 0.85f, 0, expected_safe_area, expected_safe_bar);
-
-        // rectangular shape forced (inscribe=1.0)
-        inscribe = 1.0;
-        expected_safe_area = w * inscribe;
-        expected_safe_bar = expected_safe_area * content_scale;
-        snprintf(buf, sizeof(buf), "rectangular forced width=%d", w);
-        run_case(buf, w, content_scale, 0.0f, 1, expected_safe_area, expected_safe_bar);
+
+        /* Circular display: inscribe = M_SQRT1_2, default bar_width 98% */
+        double area = w * M_SQRT1_2;
+        int bar = (int)(area * cs * 0.98);
+        snprintf(buf, sizeof(buf), "circular default width=%d", w);
+        run_case(buf, w, cs, 98, 1, area, bar);
+
+        /* Rectangular display: inscribe = 1.0, default bar_width 98% */
+        area = w * 1.0;
+        bar = (int)(area * cs * 0.98);
+        snprintf(buf, sizeof(buf), "rectangular default width=%d", w);
+        run_case(buf, w, cs, 98, 0, area, bar);
+
+        /* Circular with custom bar_width 80% */
+        area = w * M_SQRT1_2;
+        bar = (int)(area * cs * 0.80);
+        snprintf(buf, sizeof(buf), "circular bar80%% width=%d", w);
+        run_case(buf, w, cs, 80, 1, area, bar);
+
+        /* Rectangular with content_scale 1.0 */
+        area = w * 1.0;
+        bar = (int)(area * 1.0 * 0.98);
+        snprintf(buf, sizeof(buf), "rectangular cs=1.0 width=%d", w);
+        run_case(buf, w, 1.0f, 98, 0, area, bar);
+    }
+
+    /* Fallback tests: invalid content_scale => fallback 0.98 */
+    {
+        int w = 240;
+        double area = w * M_SQRT1_2;
+        int bar = (int)(area * 0.98 * 0.98);
+        run_case("cs=0 fallback", w, 0.0f, 98, 1, area, bar);
+        run_case("cs=-1 fallback", w, -1.0f, 98, 1, area, bar);
+        run_case("cs=1.5 fallback", w, 1.5f, 98, 1, area, bar);
     }
 
-    // Invalid values -> fallback to M_SQRT1_2
+    /* Fallback tests: bar_width=0 => fallback 0.98 */
     {
         int w = 240;
-        double inscribe = M_SQRT1_2;
-        double expected_safe_area = w * inscribe;
-        double expected_safe_bar = expected_safe_area * content_scale;
-        run_case("invalid -1 -> fallback", w, content_scale, -1.0f, 0, expected_safe_area, expected_safe_bar);
-        run_case("invalid 1.5 -> fallback", w, content_scale, 1.5f, 0, expected_safe_area, expected_safe_bar);
+        double area = w * M_SQRT1_2;
+        int bar = (int)(area * cs * 0.98);
+        run_case("bar_width=0 fallback", w, cs, 0, 1, area, bar);
     }
 
+    if (failures > 0)
+    {
+        printf("FAILED: %d test(s)\n", failures);
+        return 1;
+    }
+    printf("All tests passed.\n");
     return 0;
 }

From 15e6849e9f8e2729c363277c8de872edba6fa544 Mon Sep 17 00:00:00 2001
From: damachin3 <damachin3@proton.me>
Date: Thu, 9 Apr 2026 15:51:20 +0200
Subject: [PATCH 02/10] ci: refresh suse install procedures

---
 .github/workflows/install.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/install.yml b/.github/workflows/install.yml
index 095dc82..3d35f76 100644
--- a/.github/workflows/install.yml
+++ b/.github/workflows/install.yml
@@ -45,12 +45,12 @@ jobs:
           # openSUSE family
           - distro: "opensuse/tumbleweed"
             name: "openSUSE Tumbleweed"
-            pre_install: "zypper refresh"
+            pre_install: "zypper --gpg-auto-import-keys refresh || true"
             install_deps: "zypper install -y tar sudo systemd cairo-devel libcurl-devel gcc make pkg-config libjansson-devel google-roboto-fonts file"
 
           - distro: "opensuse/leap:16.0"
             name: "openSUSE Leap 16.0"
-            pre_install: "zypper refresh"
+            pre_install: "zypper --gpg-auto-import-keys refresh || true"
             install_deps: "zypper install -y sudo systemd cairo-devel libcurl-devel gcc make pkg-config libjansson-devel google-roboto-fonts file"
 
     container:

From d3f2ec90b764d4ef24b0714eb8271c398d9b40a3 Mon Sep 17 00:00:00 2001
From: damachin3 <damachin3@proton.me>
Date: Thu, 9 Apr 2026 19:34:39 +0200
Subject: [PATCH 03/10] refactor: update packaging

---
 Makefile                                      |   4 +-
 PKGBUILD                                      |   4 +-
 aur/PKGBUILD                                  |   2 +-
 .../plugins/coolerdash/ui/cc-plugin-lib.js    | 259 ------------------
 etc/udev/rules.d/99-coolerdash.rules          |  13 -
 packaging/coolerdash.spec                     |   2 +-
 packaging/debian/postinst                     |   2 +-
 7 files changed, 7 insertions(+), 279 deletions(-)
 delete mode 100644 etc/coolercontrol/plugins/coolerdash/ui/cc-plugin-lib.js
 delete mode 100644 etc/udev/rules.d/99-coolerdash.rules

diff --git a/Makefile b/Makefile
index 11dbc3e..29d4e93 100644
--- a/Makefile
+++ b/Makefile
@@ -346,10 +346,10 @@ install: check-deps $(TARGET)
 	@$(INSTALL_DATA) CHANGELOG.md "$(DESTDIR)$(PLUGINDIR)/CHANGELOG.md"
 	@$(INSTALL_DATA) VERSION "$(DESTDIR)$(PLUGINDIR)/VERSION"
 	@if [ -f "$(DESTDIR)$(PLUGINDIR)/config.json" ]; then \
-		$(INSTALL) -m 666 etc/coolercontrol/plugins/coolerdash/config.json "$(DESTDIR)$(PLUGINDIR)/config.json.new"; \
+		$(INSTALL) -m 600 etc/coolercontrol/plugins/coolerdash/config.json "$(DESTDIR)$(PLUGINDIR)/config.json.new"; \
 		printf "  $(YELLOW)Config:$(RESET) Existing config.json preserved. New defaults saved as config.json.new\n"; \
 	else \
-		$(INSTALL) -m 666 etc/coolercontrol/plugins/coolerdash/config.json "$(DESTDIR)$(PLUGINDIR)/config.json"; \
+		$(INSTALL) -m 600 etc/coolercontrol/plugins/coolerdash/config.json "$(DESTDIR)$(PLUGINDIR)/config.json"; \
 	fi
 	@$(INSTALL) -d "$(DESTDIR)$(PLUGINDIR)/ui"
 	@$(INSTALL_DATA) etc/coolercontrol/plugins/coolerdash/ui/index.html "$(DESTDIR)$(PLUGINDIR)/ui/index.html"
diff --git a/PKGBUILD b/PKGBUILD
index 355ca99..6dbb2ae 100644
--- a/PKGBUILD
+++ b/PKGBUILD
@@ -42,7 +42,7 @@ build() {
     make
 
     # Copy files to srcdir for packaging (fakeroot cannot access startdir)
-    mkdir -p "${srcdir}/bin" "${srcdir}/images" "${srcdir}/man" "${srcdir}/etc/coolercontrol/plugins/coolerdash/ui" "${srcdir}/etc/applications" "${srcdir}/etc/icons" "${srcdir}/etc/udev/rules.d"
+    mkdir -p "${srcdir}/bin" "${srcdir}/images" "${srcdir}/man" "${srcdir}/etc/coolercontrol/plugins/coolerdash/ui" "${srcdir}/etc/applications" "${srcdir}/etc/icons"
     cp -a bin/coolerdash "${srcdir}/bin/coolerdash"
     cp -a README.md CHANGELOG.md VERSION LICENSE "${srcdir}/"
     cp -a etc/coolercontrol/plugins/coolerdash/config.json "${srcdir}/etc/coolercontrol/plugins/coolerdash/"
@@ -74,7 +74,7 @@ package() {
     install -Dm644 "${srcdir}/README.md" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/README.md"
     install -Dm644 "${srcdir}/VERSION" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/VERSION"
     install -Dm644 "${srcdir}/CHANGELOG.md" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/CHANGELOG.md"
-    install -Dm666 "${srcdir}/etc/coolercontrol/plugins/coolerdash/config.json" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/config.json"
+    install -Dm600 "${srcdir}/etc/coolercontrol/plugins/coolerdash/config.json" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/config.json"
 
     install -dm755 "${pkgdir}/etc/coolercontrol/plugins/coolerdash/ui"
     install -m644 "${srcdir}/etc/coolercontrol/plugins/coolerdash/ui/index.html" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/ui/index.html"
diff --git a/aur/PKGBUILD b/aur/PKGBUILD
index 1f09e6b..012081f 100644
--- a/aur/PKGBUILD
+++ b/aur/PKGBUILD
@@ -61,7 +61,7 @@ package() {
     install -m644 "${srcdir}/${pkgname}/README.md" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/README.md"
     install -m644 "${srcdir}/${pkgname}/VERSION" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/VERSION"
     install -m644 "${srcdir}/${pkgname}/CHANGELOG.md" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/CHANGELOG.md"
-    install -m666 "${srcdir}/${pkgname}/etc/coolercontrol/plugins/coolerdash/config.json" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/config.json"
+    install -m600 "${srcdir}/${pkgname}/etc/coolercontrol/plugins/coolerdash/config.json" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/config.json"
 
     install -dm755 "${pkgdir}/etc/coolercontrol/plugins/coolerdash/ui"
     install -m644 "${srcdir}/${pkgname}/etc/coolercontrol/plugins/coolerdash/ui/index.html" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/ui/index.html"
diff --git a/etc/coolercontrol/plugins/coolerdash/ui/cc-plugin-lib.js b/etc/coolercontrol/plugins/coolerdash/ui/cc-plugin-lib.js
deleted file mode 100644
index 93365c7..0000000
--- a/etc/coolercontrol/plugins/coolerdash/ui/cc-plugin-lib.js
+++ /dev/null
@@ -1,259 +0,0 @@
-/*
- * CoolerControl - monitor and control your cooling and other devices
- * Copyright (c) 2021-2025  Guy Boldon and contributors
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
- */
-
-//! This is a library for CoolerControl plugins
-//! It provides a set of functions to interact with the CoolerControl app
-//! It is provided by the daemon for all plugins, and just needs it linked in the plugin's HTML file
-//! i.e.: <script type="text/javascript" src="../../cc-plugin-lib.js"></script>
-
-// Internal Variables
-/////////////////////////////////////////////////////////////
-let _messageCount = 0
-let _successfulConfigSaveCallback = () => {}
-let _pluginConfig = {}
-const _modes = []
-const _alerts = []
-const _profiles = []
-const _functions = []
-const _devices = []
-let _status = new Map()
-
-const _increaseMessageCount = () => _messageCount++
-const _decreaseMessageCount = () => {
-    if (_messageCount > 0) {
-        _messageCount--
-    }
-    // dispatch event asynchronously
-    setTimeout(() => window.dispatchEvent(new CustomEvent('decreasedMessageCount')), 0)
-}
-
-// Utility Functions
-/////////////////////////////////////////////////////////////
-const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
-const waitTillAllMessagesReceived = async () => {
-    while (_messageCount !== 0) {
-        await new Promise((resolve) =>
-            window.addEventListener('decreasedMessageCount', resolve, { once: true }),
-        )
-    }
-}
-
-// Message Processing Functions
-/////////////////////////////////////////////////////////////
-const _processMessages = (messageEvent) => {
-    // console.log("iframe message received:", event);
-    // The parent window messages do send an origin, even in a sandbox, so we only accept and send messages to same-origin
-    if (!messageEvent.isTrusted || messageEvent.origin !== document.location.origin) {
-        console.debug('Received invalid message', messageEvent)
-        return
-    }
-    if (messageEvent.data == null) {
-        console.log('message event data is null', messageEvent)
-        return
-    }
-    switch (messageEvent.data.type) {
-        case 'style':
-            if (messageEvent.data.body == null) break
-            const linkEl = document.createElement('link')
-            linkEl.rel = 'stylesheet'
-            linkEl.href = messageEvent.data.body
-            document.head.appendChild(linkEl)
-            break
-        case 'customStyle':
-            if (messageEvent.data.body == null) break
-            Object.entries(messageEvent.data.body).forEach(([key, value]) =>
-                document.documentElement.style.setProperty(key, value),
-            )
-            break
-        case 'config':
-            if (messageEvent.data.body == null) break
-            _pluginConfig = messageEvent.data.body
-            break
-        case 'configSaved':
-            if (messageEvent.data.body == null) {
-                console.warn('Plugin config was not successfully saved')
-                break
-            }
-            console.debug('Plugin config successfully saved', messageEvent.data.body)
-            _pluginConfig = messageEvent.data.body
-            _successfulConfigSaveCallback()
-            break
-        case 'modes':
-            if (messageEvent.data.body == null) break
-            _modes.length = 0
-            _modes.push(...messageEvent.data.body)
-            break
-        case 'alerts':
-            if (messageEvent.data.body == null) break
-            _alerts.length = 0
-            _alerts.push(...messageEvent.data.body)
-            break
-        case 'profiles':
-            if (messageEvent.data.body == null) break
-            _profiles.length = 0
-            _profiles.push(...messageEvent.data.body)
-            break
-        case 'functions':
-            if (messageEvent.data.body == null) break
-            _functions.length = 0
-            _functions.push(...messageEvent.data.body)
-            break
-        case 'devices':
-            if (messageEvent.data.body == null) break
-            _devices.length = 0
-            _devices.push(...messageEvent.data.body)
-            break
-        case 'status':
-            if (messageEvent.data.body == null) break
-            _status = messageEvent.data.body
-            break
-        default:
-            console.log('Unknown message type', messageEvent)
-    }
-    _decreaseMessageCount()
-}
-
-// Core Plugin Functions
-/////////////////////////////////////////////////////////////
-
-/* Load CC parent Styles into the iframe asynchronously */
-const loadParentStyles = () => {
-    _increaseMessageCount()
-    window.parent.postMessage({ type: 'style' }, document.location.origin)
-    _increaseMessageCount()
-    window.parent.postMessage({ type: 'customStyle' }, document.location.origin)
-}
-
-/* A convenience function for simulating a cached synchronous Plugin Config request */
-const getPluginConfig = async (force = false) => {
-    if (_pluginConfig.length > 0 && !force) return _pluginConfig
-    _increaseMessageCount()
-    window.parent.postMessage({ type: 'loadConfig' }, document.location.origin)
-    await waitTillAllMessagesReceived()
-    return _pluginConfig
-}
-
-/* Convert a FormData object to a JavaScript object. Also supports multi-value fields */
-const convertFormToObject = (formData) => {
-    const object = {}
-    formData.forEach((value, key) => {
-        if (!Reflect.has(object, key)) {
-            object[key] = value
-            return
-        }
-        if (!Array.isArray(object[key])) {
-            object[key] = [object[key]]
-        }
-        object[key].push(value)
-    })
-    return object
-}
-
-/* A convenience function for saving the plugin config. Note: the pluginConfig must be a JSON Object */
-const savePluginConfig = async (pluginConfig) => {
-    _increaseMessageCount()
-    window.parent.postMessage({ type: 'saveConfig', body: pluginConfig }, document.location.origin)
-    await waitTillAllMessagesReceived()
-}
-
-const successfulConfigSaveCallback = async (callback) => {
-    _successfulConfigSaveCallback = callback
-}
-
-/* Close the plugin modal. This will end the plugin session. */
-const close = () => {
-    window.parent.postMessage({ type: 'close' }, document.location.origin)
-}
-
-/* Restart the daemon & UI. This has the effect of applying any plugin changes to service configs. */
-const restart = () => {
-    window.parent.postMessage({ type: 'restart' }, document.location.origin)
-}
-
-// Data Exchange Functions
-/////////////////////////////////////////////////////////////
-
-/* A convenience function for simulating a cached synchronous Modes request */
-const getModes = async (force = false) => {
-    if (_modes.length > 0 && !force) return _modes
-    _increaseMessageCount()
-    window.parent.postMessage({ type: 'modes' }, document.location.origin)
-    await waitTillAllMessagesReceived()
-    return _modes
-}
-
-/* A convenience function for simulating a cached synchronous Alerts request */
-const getAlerts = async (force = false) => {
-    if (_alerts.length > 0 && !force) return _alerts
-    _increaseMessageCount()
-    window.parent.postMessage({ type: 'alerts' }, document.location.origin)
-    await waitTillAllMessagesReceived()
-    return _alerts
-}
-
-/* A convenience function for simulating a cached synchronous Profiles request */
-const getProfiles = async (force = false) => {
-    if (_profiles.length > 0 && !force) return _profiles
-    _increaseMessageCount()
-    window.parent.postMessage({ type: 'profiles' }, document.location.origin)
-    await waitTillAllMessagesReceived()
-    return _profiles
-}
-
-/* A convenience function for simulating a cached synchronous Functions request */
-const getFunctions = async (force = false) => {
-    if (_functions.length > 0 && !force) return _functions
-    _increaseMessageCount()
-    window.parent.postMessage({ type: 'functions' }, document.location.origin)
-    await waitTillAllMessagesReceived()
-    return _functions
-}
-
-/* A convenience function for simulating a cached synchronous Devices request */
-const getDevices = async (force = false) => {
-    if (_devices.length > 0 && !force) return _devices
-    _increaseMessageCount()
-    window.parent.postMessage({ type: 'devices' }, document.location.origin)
-    await waitTillAllMessagesReceived()
-    return _devices
-}
-
-/* A convenience function for simulating a cached synchronous Status request */
-const getStatus = async (force = false) => {
-    if (_status.length > 0 && !force) return _status
-    _increaseMessageCount()
-    window.parent.postMessage({ type: 'status' }, document.location.origin)
-    await waitTillAllMessagesReceived()
-    return _status
-}
-
-// Plugin Running Functions
-/////////////////////////////////////////////////////////////
-
-/* A convenience function for running the plugin's JavaScript in an async wrapper. */
-const runPluginScript = (mainPluginFunction, loadParentStyle = true) => {
-    ;(async () => {
-        if (loadParentStyle) {
-            loadParentStyles()
-            await waitTillAllMessagesReceived()
-        }
-        await mainPluginFunction()
-    })()
-}
-
-window.addEventListener('message', _processMessages)
diff --git a/etc/udev/rules.d/99-coolerdash.rules b/etc/udev/rules.d/99-coolerdash.rules
deleted file mode 100644
index b1d32f0..0000000
--- a/etc/udev/rules.d/99-coolerdash.rules
+++ /dev/null
@@ -1,13 +0,0 @@
-# CoolerDash - USB Device Power Management
-# https://github.com/damachine/coolerdash
-
-# NZXT Vendor ID: 1e71
-# Disable autosuspend and enable persist for all NZXT devices (Kraken, etc.)
-# Disable USB autosuspend for NZXT devices to prevent "bucket switch" errors
-#ACTION=="add|bind|change", SUBSYSTEM=="usb", ATTR{idVendor}=="1e71", ATTR{power/control}="on"
-#ACTION=="add|bind|change", SUBSYSTEM=="usb", ATTR{idVendor}=="1e71", ATTR{power/autosuspend_delay_ms}="-1"
-#ACTION=="add|bind|change", SUBSYSTEM=="usb", ATTR{idVendor}=="1e71", ATTR{power/persist}="1"
-#ACTION=="add|bind|change", SUBSYSTEM=="usb", ATTR{idVendor}=="1e71", ATTR{power/wakeup}="disabled"
-#ACTION=="add|bind|change", SUBSYSTEM=="usb", ATTR{idVendor}=="1e71", ATTR{avoid_reset_quirk}="1"
-
-# Placeholder for additional rules if needed in the future
diff --git a/packaging/coolerdash.spec b/packaging/coolerdash.spec
index 3dab031..7f9929b 100644
--- a/packaging/coolerdash.spec
+++ b/packaging/coolerdash.spec
@@ -76,7 +76,7 @@ fi
 
 %post
 if [ -f /etc/coolercontrol/plugins/coolerdash/config.json ]; then
-    chmod 666 /etc/coolercontrol/plugins/coolerdash/config.json
+    chmod 600 /etc/coolercontrol/plugins/coolerdash/config.json
 fi
 # Remove legacy files
 rm -f /etc/systemd/system/multi-user.target.wants/coolerdash-helperd.service
diff --git a/packaging/debian/postinst b/packaging/debian/postinst
index 7bbda52..7133af7 100755
--- a/packaging/debian/postinst
+++ b/packaging/debian/postinst
@@ -5,7 +5,7 @@ case "$1" in
     configure)
         # Set config permissions
         if [ -f /etc/coolercontrol/plugins/coolerdash/config.json ]; then
-            chmod 666 /etc/coolercontrol/plugins/coolerdash/config.json
+            chmod 600 /etc/coolercontrol/plugins/coolerdash/config.json
         fi
 
         # Remove legacy files

From 15ed29351a98f7a6c3efa3f5825646624691ea34 Mon Sep 17 00:00:00 2001
From: damachin3 <damachin3@proton.me>
Date: Thu, 9 Apr 2026 21:39:39 +0200
Subject: [PATCH 04/10] gui: fix device info

---
 .../plugins/coolerdash/ui/index.html          | 208 ++++++++++++++----
 1 file changed, 168 insertions(+), 40 deletions(-)

diff --git a/etc/coolercontrol/plugins/coolerdash/ui/index.html b/etc/coolercontrol/plugins/coolerdash/ui/index.html
index d8a199d..1f651a8 100644
--- a/etc/coolercontrol/plugins/coolerdash/ui/index.html
+++ b/etc/coolercontrol/plugins/coolerdash/ui/index.html
@@ -1157,7 +1157,7 @@ <h3 class="section-title">System Environment</h3>
         <!-- Restart Notice -->
         <div style="margin-top: 16px; padding: 12px; background: rgba(255, 140, 0, 0.05); border-left: 3px solid #ff8c00; border-radius: 4px;">
             <p style="margin: 0; color: var(--text-dim); font-size: 13px;">
-                <strong>Note:</strong> After saving, reload the config with <code style="background: rgba(255,255,255,0.08); padding: 2px 6px; border-radius: 3px; font-size: 12px;">kill -HUP $(pgrep coolerdash)</code> or restart the service: <code style="background: rgba(255,255,255,0.08); padding: 2px 6px; border-radius: 3px; font-size: 12px;">systemctl restart cc-plugin-coolerdash.service</code>
+                <strong>Note:</strong> Clicking <em>Save</em> will automatically apply the configuration and restart the plugin.
             </p>
         </div>
     </div>
@@ -1352,23 +1352,66 @@ <h3 class="section-title">System Environment</h3>
         }
 
         // Fallback for getDevices() — used when cc-plugin-lib.js is not loaded (dev/browser mode)
-        // Inside CC4's sandboxed iframe, cc-plugin-lib.js provides the real getDevices() via postMessage.
+        // Note: cc-plugin-lib defines functions with `const` (not var/window), so typeof check always
+        // triggers even when cc-plugin-lib is loaded. We therefore implement postMessage for CC4 context.
         if (typeof getDevices === 'undefined') {
             window.getDevices = async function() {
-                var headers = makeAuthHeaders(lastApiToken);
-                var res = await fetch((lastApiAddress || 'http://localhost:11987') + '/devices', { headers: headers });
-                if (!res.ok) return { devices: [] };
-                return res.json();
+                if (isInCoolerControl) {
+                    return new Promise(function(resolve) {
+                        var handler = function(event) {
+                            if (event.data && event.data.type === 'devices') {
+                                window.removeEventListener('message', handler);
+                                var body = event.data.body || [];
+                                resolve({ devices: Array.isArray(body) ? body : (body.devices || []) });
+                            }
+                        };
+                        window.addEventListener('message', handler);
+                        window.parent.postMessage({ type: 'devices' }, document.location.origin);
+                        setTimeout(function() {
+                            window.removeEventListener('message', handler);
+                            resolve({ devices: [] });
+                        }, 3000);
+                    });
+                }
+                try {
+                    var headers = makeAuthHeaders(lastApiToken);
+                    var res = await fetch((lastApiAddress || 'http://localhost:11987') + '/devices', { headers: headers });
+                    if (!res.ok) return { devices: [] };
+                    return res.json();
+                } catch (e) {
+                    return { devices: [] };
+                }
             };
         }
 
         // Fallback for getStatus() — used when cc-plugin-lib.js is not loaded (dev/browser mode)
         if (typeof getStatus === 'undefined') {
             window.getStatus = async function() {
-                var headers = makeAuthHeaders(lastApiToken);
-                var res = await fetch((lastApiAddress || 'http://localhost:11987') + '/status', { headers: headers });
-                if (!res.ok) throw new Error('HTTP ' + res.status);
-                return res.json();
+                if (isInCoolerControl) {
+                    return new Promise(function(resolve) {
+                        var handler = function(event) {
+                            if (event.data && event.data.type === 'status') {
+                                window.removeEventListener('message', handler);
+                                var body = event.data.body;
+                                resolve(body || { devices: [] });
+                            }
+                        };
+                        window.addEventListener('message', handler);
+                        window.parent.postMessage({ type: 'status' }, document.location.origin);
+                        setTimeout(function() {
+                            window.removeEventListener('message', handler);
+                            resolve({ devices: [] });
+                        }, 3000);
+                    });
+                }
+                try {
+                    var headers = makeAuthHeaders(lastApiToken);
+                    var res = await fetch((lastApiAddress || 'http://localhost:11987') + '/status', { headers: headers });
+                    if (!res.ok) return { devices: [] };
+                    return res.json();
+                } catch (e) {
+                    return { devices: [] };
+                }
             };
         }
 
@@ -1379,6 +1422,32 @@ <h3 class="section-title">System Environment</h3>
             return {};
         }
 
+        // Normalize getDevices() return value: cc-plugin-lib returns an Array directly,
+        // the REST API and our fallback return { devices: [...] }.
+        function normalizeDevices(raw) {
+            if (!raw) return [];
+            if (Array.isArray(raw)) return raw;
+            if (Array.isArray(raw.devices)) return raw.devices;
+            return [];
+        }
+
+        // Normalize getStatus() return value: cc-plugin-lib returns a Map or { devices: [...] },
+        // the REST API returns { devices: [...] }.
+        function normalizeStatus(raw) {
+            if (!raw) return [];
+            if (Array.isArray(raw)) return raw;
+            if (raw instanceof Map) {
+                // Map keyed by uid, values are status objects
+                var arr = [];
+                raw.forEach(function(val, key) {
+                    arr.push(typeof val === 'object' ? Object.assign({ uid: key }, val) : { uid: key });
+                });
+                return arr;
+            }
+            if (Array.isArray(raw.devices)) return raw.devices;
+            return [];
+        }
+
         function splitPatternList(patternList) {
             if (!patternList) return [];
             return String(patternList)
@@ -1446,33 +1515,45 @@ <h3 class="section-title">System Environment</h3>
         }
 
         function scoreDetectedDevice(device, detectionSettings) {
+            if (!device || !device.uid) return -1000;
             var lcdInfo = getDeviceLcdInfo(device);
-            if (!device || !device.uid || !lcdInfo) return -1000;
 
             if (candidateMatchesPatterns(device, detectionSettings.blocklist)) return -1000;
             if (candidateMatchesPatterns(device, detectionSettings.allowlist)) {
-                return 1000 + ((lcdInfo.screen_width || 0) * (lcdInfo.screen_height || 0));
+                return 1000 + ((lcdInfo ? (lcdInfo.screen_width || 0) * (lcdInfo.screen_height || 0) : 0));
             }
 
             var score = 0;
             var type = String(device.d_type || device.type || '');
             var name = String(device.name || '');
 
+            // Device type: Liquidctl = AIO cooler driver, others penalised
             if (type === 'Liquidctl') score += 30;
             else if (type === 'Hwmon' || type === 'CustomSensors' || type === 'CPU' || type === 'GPU') score -= 40;
             else if (type) score += 8;
 
-            if (ciContains(name, 'kraken') || ciContains(name, 'elite') || ciContains(name, 'hydro') ||
-                ciContains(name, 'capellix') || ciContains(name, 'lcd') || ciContains(name, 'display') ||
+            // Capability signals (independent of brand): has an 'lcd' channel key
+            var channels = (device.info && device.info.channels) ? device.info.channels : {};
+            if (Object.prototype.hasOwnProperty.call(channels, 'lcd')) score += 30;
+
+            // Has liquidctl firmware info → confirmed AIO cooler
+            if (device.lc_info && device.lc_info.driver_type) score += 15;
+
+            // Generic name hints only (no brand names)
+            if (ciContains(name, 'lcd') || ciContains(name, 'display') ||
                 ciContains(name, 'screen') || ciContains(name, 'aio')) {
-                score += 24;
+                score += 12;
             }
 
             if (looksLikeMainboardCandidate(name)) score -= 80;
 
-            if (lcdInfo.screen_width === lcdInfo.screen_height) score += 6;
-            else score += 3;
-            if (lcdInfo.screen_width >= 240 && lcdInfo.screen_height >= 240) score += 4;
+            // lcd_info dimensions (present after REST enrichment)
+            if (lcdInfo) {
+                score += 20; // has a real lcd_info → definitive LCD hardware
+                if (lcdInfo.screen_width === lcdInfo.screen_height) score += 6;
+                else score += 3;
+                if (lcdInfo.screen_width >= 240 && lcdInfo.screen_height >= 240) score += 4;
+            }
 
             if (detectionSettings.mode === 'relaxed') return Math.max(score, 0);
             if (detectionSettings.mode === 'balanced') return score >= 0 ? score : -1;
@@ -1525,14 +1606,14 @@ <h3 class="section-title">System Environment</h3>
                 // Falls back to direct fetch in dev/browser mode via the fallback definitions above.
                 const devData = await getDevices();
                 const deviceNames = {};
-                for (const dev of (devData.devices || [])) {
+                for (const dev of normalizeDevices(devData)) {
                     if (dev.uid) deviceNames[dev.uid] = dev.name || dev.uid;
                 }
 
                 const statusData = await getStatus();
 
                 const sensors = [];
-                for (const dev of (statusData.devices || [])) {
+                for (const dev of normalizeStatus(statusData)) {
                     const uid = dev.uid || '';
                     const devName = deviceNames[uid] || uid;
                     const lastStatus = Array.isArray(dev.status_history) && dev.status_history.length > 0
@@ -2053,11 +2134,24 @@ <h3 class="section-title">System Environment</h3>
             errorEl.style.display = 'none';
 
             try {
-                // Use cc-plugin-lib (bypasses CORS sandbox); falls back to direct fetch in dev mode.
+                // Use getDevices() — cc-plugin-lib postMessage path works in the CC4 sandbox;
+                // direct fetch() is blocked by the iframe sandbox.
                 var data = await getDevices();
 
-                var devices = data.devices || [];
-                var found = findBestDetectedDevice(devices, buildConfig());
+                var devices = normalizeDevices(data);
+
+                // Read detection settings directly from DOM to avoid buildConfig() dependency.
+                var modeEl = document.querySelector('[name="device_detection.mode"]');
+                var allowEl = document.querySelector('[name="device_detection.allowlist"]');
+                var blockEl = document.querySelector('[name="device_detection.blocklist"]');
+                var detectionCfg = {
+                    device_detection: {
+                        mode: modeEl ? modeEl.value : 'strict',
+                        allowlist: allowEl ? allowEl.value : '',
+                        blocklist: blockEl ? blockEl.value : ''
+                    }
+                };
+                var found = findBestDetectedDevice(devices, detectionCfg);
 
                 loadingEl.style.display = 'none';
 
@@ -2067,6 +2161,27 @@ <h3 class="section-title">System Environment</h3>
                     document.getElementById('device-name').textContent = name;
                     document.getElementById('device-uid').textContent = uid;
 
+                    // cc-plugin-lib postMessage omits lc_info and lcd_info.
+                    // Try a direct REST fetch to fill in the missing fields (best-effort).
+                    if (found.uid && apiAddress) {
+                        try {
+                            var devHeaders = makeAuthHeaders(token);
+                            var fullRes = await fetch(apiAddress + '/devices', { headers: devHeaders });
+                            if (fullRes.ok) {
+                                var fullData = await fullRes.json();
+                                var fullDevices = normalizeDevices(fullData);
+                                for (var fi = 0; fi < fullDevices.length; fi++) {
+                                    if (fullDevices[fi].uid === found.uid) {
+                                        found = fullDevices[fi];
+                                        break;
+                                    }
+                                }
+                            }
+                        } catch (fetchErr) {
+                            console.debug('Full device fetch failed (sandbox), using postMessage data:', fetchErr);
+                        }
+                    }
+
                     var firmware = (found.lc_info && found.lc_info.firmware_version) || '\u2014';
                     document.getElementById('device-firmware').textContent = firmware;
 
@@ -2081,8 +2196,7 @@ <h3 class="section-title">System Environment</h3>
                     var shapeEl = document.getElementById('device-shape');
                     if (width > 0 && height > 0) {
                         resEl.textContent = width + ' \u00D7 ' + height + ' px';
-                        var isCircular = name.includes('Kraken') && (width > 240 || height > 240);
-                        shapeEl.textContent = isCircular ? 'Circular' : 'Rectangular';
+                        shapeEl.textContent = (width === height) ? 'Circular' : 'Rectangular';
                     } else {
                         resEl.textContent = 'Not available';
                         shapeEl.textContent = 'Unknown';
@@ -2105,12 +2219,10 @@ <h3 class="section-title">System Environment</h3>
             } catch (error) {
                 console.warn('Device detection failed:', error);
                 loadingEl.style.display = 'none';
-                document.getElementById('device-status').innerHTML =
-                    '<span class="device-status error"><span class="device-status-dot"></span> Detection failed</span>';
-                document.getElementById('device-error-text').textContent =
-                    'Could not connect to CoolerControl API (' + error.message + ').';
+                var statusEl = document.getElementById('device-status');
+                if (statusEl) statusEl.innerHTML =
+                    '<span class="device-status error"><span class="device-status-dot"></span> Detection failed: ' + (error && error.message ? error.message : String(error)) + '</span>';
                 contentEl.style.display = 'block';
-                errorEl.style.display = 'block';
             }
         }
 
@@ -2123,32 +2235,48 @@ <h3 class="section-title">System Environment</h3>
                 lastApiAddress = apiAddress;
                 lastApiToken = token;
 
-                // /health has no cc-plugin-lib equivalent; only fetch it in dev/browser mode
+                // /health fetch isolated so a failure doesn't block the kernel lookup below.
+                // Also used as fallback in dev/browser mode where fetch() works.
+                var healthFetched = false;
                 if (!isInCoolerControl) {
-                    var headers = makeAuthHeaders(token);
-                    var healthRes = await fetch(apiAddress + '/health', { headers: headers });
-                    if (healthRes.ok) {
-                        var health = await healthRes.json();
-                        var ccVersion = (health.details && health.details.version) || '\u2014';
-                        document.getElementById('sys-cc-version').textContent = ccVersion;
+                    try {
+                        var headers = makeAuthHeaders(token);
+                        var healthRes = await fetch(apiAddress + '/health', { headers: headers });
+                        if (healthRes.ok) {
+                            var health = await healthRes.json();
+                            var ccVersion = (health.details && health.details.version) || '\u2014';
+                            document.getElementById('sys-cc-version').textContent = ccVersion;
+                            healthFetched = true;
+                        }
+                    } catch (healthErr) {
+                        console.warn('Health fetch failed:', healthErr);
                     }
                 }
 
                 // Use cc-plugin-lib (bypasses CORS sandbox); falls back to direct fetch in dev mode.
+                // CC version: device with drv_type='CoolerControl' carries driver_info.version = CC version.
+                // Kernel version: device with drv_type='Kernel' carries driver_info.version.
                 var data = await getDevices();
-                var devices = data.devices || [];
+                var devices = normalizeDevices(data);
                 var kernel = '';
+                var ccVer = '';
                 for (var i = 0; i < devices.length; i++) {
                     var drvType = devices[i].info && devices[i].info.driver_info && devices[i].info.driver_info.drv_type;
                     var ver = devices[i].info && devices[i].info.driver_info && devices[i].info.driver_info.version;
-                    if (drvType === 'Kernel' && ver) {
+                    if (drvType === 'Kernel' && ver && !kernel) {
                         kernel = ver;
-                        break;
                     }
+                    if (drvType === 'CoolerControl' && ver && !ccVer) {
+                        ccVer = ver;
+                    }
+                    if (kernel && ccVer) break;
                 }
                 if (kernel) {
                     document.getElementById('sys-kernel').textContent = kernel;
                 }
+                if (ccVer && !healthFetched) {
+                    document.getElementById('sys-cc-version').textContent = ccVer;
+                }
             } catch (error) {
                 console.warn('System info fetch failed:', error);
             }

From ff3a4d17377a7a802ff3e42227d75e696785d808 Mon Sep 17 00:00:00 2001
From: damachin3 <damachin3@proton.me>
Date: Fri, 10 Apr 2026 00:05:54 +0200
Subject: [PATCH 05/10] refactor: update labels for dual mode, add circle
 display interval setting, improve about info link, config file handling and
 installation instructions

---
 Makefile                                      |  16 +-
 PKGBUILD                                      |   2 +-
 coolerdash.install                            |  42 +++++
 .../plugins/coolerdash/config.json            |  13 +-
 .../plugins/coolerdash/coolercontrol.json     |  10 +
 .../plugins/coolerdash/ui/index.html          | 102 ++++++----
 packaging/coolerdash.spec                     |  19 +-
 packaging/debian/postinst                     |  20 +-
 src/device/config.c                           | 174 +++++++++++++++++-
 src/device/config.h                           |   2 +
 src/mods/circle.c                             |  11 +-
 src/mods/dual.c                               |  41 ++++-
 12 files changed, 383 insertions(+), 69 deletions(-)
 create mode 100644 etc/coolercontrol/plugins/coolerdash/coolercontrol.json

diff --git a/Makefile b/Makefile
index 29d4e93..a534818 100644
--- a/Makefile
+++ b/Makefile
@@ -346,10 +346,17 @@ install: check-deps $(TARGET)
 	@$(INSTALL_DATA) CHANGELOG.md "$(DESTDIR)$(PLUGINDIR)/CHANGELOG.md"
 	@$(INSTALL_DATA) VERSION "$(DESTDIR)$(PLUGINDIR)/VERSION"
 	@if [ -f "$(DESTDIR)$(PLUGINDIR)/config.json" ]; then \
-		$(INSTALL) -m 600 etc/coolercontrol/plugins/coolerdash/config.json "$(DESTDIR)$(PLUGINDIR)/config.json.new"; \
-		printf "  $(YELLOW)Config:$(RESET) Existing config.json preserved. New defaults saved as config.json.new\n"; \
+		$(INSTALL) -m 644 etc/coolercontrol/plugins/coolerdash/config.json "$(DESTDIR)$(PLUGINDIR)/config.json.new"; \
+		chmod 644 "$(DESTDIR)$(PLUGINDIR)/config.json"; \
+		printf "  $(YELLOW)Config:$(RESET) Existing config.json preserved (permissions updated to 644). New defaults saved as config.json.new\n"; \
 	else \
-		$(INSTALL) -m 600 etc/coolercontrol/plugins/coolerdash/config.json "$(DESTDIR)$(PLUGINDIR)/config.json"; \
+		$(INSTALL) -m 644 etc/coolercontrol/plugins/coolerdash/config.json "$(DESTDIR)$(PLUGINDIR)/config.json"; \
+	fi
+	@if [ -f "$(DESTDIR)$(PLUGINDIR)/coolercontrol.json" ]; then \
+		printf "  $(YELLOW)Daemon:$(RESET) Existing coolercontrol.json preserved\n"; \
+	else \
+		$(INSTALL) -m 600 etc/coolercontrol/plugins/coolerdash/coolercontrol.json "$(DESTDIR)$(PLUGINDIR)/coolercontrol.json"; \
+		printf "  $(GREEN)Daemon:$(RESET) $(DESTDIR)$(PLUGINDIR)/coolercontrol.json (chmod 600 — edit as root to set address + access_token)\n"; \
 	fi
 	@$(INSTALL) -d "$(DESTDIR)$(PLUGINDIR)/ui"
 	@$(INSTALL_DATA) etc/coolercontrol/plugins/coolerdash/ui/index.html "$(DESTDIR)$(PLUGINDIR)/ui/index.html"
@@ -358,7 +365,8 @@ install: check-deps $(TARGET)
 	@sed -i 's/{{VERSION}}/$(VERSION)/g' "$(DESTDIR)$(PLUGINDIR)/manifest.toml"
 	@sed -i 's/{{VERSION}}/$(VERSION)/g' "$(DESTDIR)$(PLUGINDIR)/ui/index.html"
 	@printf "  $(GREEN)Binary:$(RESET)       $(DESTDIR)$(libexecdir)/coolerdash/coolerdash\n"
-	@printf "  $(GREEN)Config JSON:$(RESET)  $(DESTDIR)$(PLUGINDIR)/config.json\n"
+	@printf "  $(GREEN)Config JSON:$(RESET)  $(DESTDIR)$(PLUGINDIR)/config.json (chmod 644)\n"
+	@printf "  $(GREEN)Daemon JSON:$(RESET)  $(DESTDIR)$(PLUGINDIR)/coolercontrol.json (chmod 600)\n"
 	@printf "  $(GREEN)Web UI:$(RESET)       $(DESTDIR)$(PLUGINDIR)/ui/index.html\n"
 	@printf "  $(GREEN)Plugin Lib:$(RESET)   Served by CoolerControl at /plugins/lib/cc-plugin-lib.js\n"
 	@printf "  $(GREEN)Plugin:$(RESET)       $(DESTDIR)$(PLUGINDIR)/manifest.toml\n"
diff --git a/PKGBUILD b/PKGBUILD
index 6dbb2ae..8e33d03 100644
--- a/PKGBUILD
+++ b/PKGBUILD
@@ -74,7 +74,7 @@ package() {
     install -Dm644 "${srcdir}/README.md" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/README.md"
     install -Dm644 "${srcdir}/VERSION" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/VERSION"
     install -Dm644 "${srcdir}/CHANGELOG.md" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/CHANGELOG.md"
-    install -Dm600 "${srcdir}/etc/coolercontrol/plugins/coolerdash/config.json" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/config.json"
+    install -Dm644 "${srcdir}/etc/coolercontrol/plugins/coolerdash/config.json" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/config.json"
 
     install -dm755 "${pkgdir}/etc/coolercontrol/plugins/coolerdash/ui"
     install -m644 "${srcdir}/etc/coolercontrol/plugins/coolerdash/ui/index.html" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/ui/index.html"
diff --git a/coolerdash.install b/coolerdash.install
index 492dd11..4c29810 100644
--- a/coolerdash.install
+++ b/coolerdash.install
@@ -41,6 +41,27 @@ post_install() {
     rm -rf /etc/systemd/system/cc-plugin-coolerdash.service.d
     rm -f /usr/lib/udev/rules.d/99-coolerdash.rules
 
+    # Create coolercontrol.json (600) only if it does not exist — NEVER overwritten on update
+    if [ ! -f /etc/coolercontrol/plugins/coolerdash/coolercontrol.json ]; then
+        install -Dm600 /dev/null /etc/coolercontrol/plugins/coolerdash/coolercontrol.json
+        cat > /etc/coolercontrol/plugins/coolerdash/coolercontrol.json << 'EOF'
+{
+  "_comment": "CoolerDash daemon configuration — chmod 600, never overwritten by updates",
+  "_info": "Edit this file as root. Changes take effect after plugin restart.",
+
+  "daemon": {
+    "address": "http://localhost:11987",
+    "access_token": "",
+    "_comment_token": "Create a token in CoolerControl UI \u2192 Access Protection. Format: cc_<uuid>."
+  }
+}
+EOF
+        chmod 600 /etc/coolercontrol/plugins/coolerdash/coolercontrol.json
+    fi
+
+    # Ensure correct permissions on config.json
+    chmod 644 /etc/coolercontrol/plugins/coolerdash/config.json 2>/dev/null || true
+
     systemctl daemon-reload
 
     # Restart plugin service directly if it already exists (reinstall case)
@@ -66,6 +87,25 @@ post_upgrade() {
     rm -rf /etc/systemd/system/cc-plugin-coolerdash.service.d
     rm -f /usr/lib/udev/rules.d/99-coolerdash.rules
 
+    # Ensure correct permissions — coolercontrol.json is NEVER touched if it exists
+    chmod 644 /etc/coolercontrol/plugins/coolerdash/config.json 2>/dev/null || true
+    if [ ! -f /etc/coolercontrol/plugins/coolerdash/coolercontrol.json ]; then
+        install -Dm600 /dev/null /etc/coolercontrol/plugins/coolerdash/coolercontrol.json
+        cat > /etc/coolercontrol/plugins/coolerdash/coolercontrol.json << 'EOF'
+{
+  "_comment": "CoolerDash daemon configuration — chmod 600, never overwritten by updates",
+  "_info": "Edit this file as root. Changes take effect after plugin restart.",
+
+  "daemon": {
+    "address": "http://localhost:11987",
+    "access_token": "",
+    "_comment_token": "Create a token in CoolerControl UI \u2192 Access Protection. Format: cc_<uuid>."
+  }
+}
+EOF
+        chmod 600 /etc/coolercontrol/plugins/coolerdash/coolercontrol.json
+    fi
+
     systemctl daemon-reload
 
     # Restart plugin
@@ -75,6 +115,8 @@ post_upgrade() {
 
     echo "================================================================"
     echo "CoolerDash upgraded successfully."
+    echo "Note: config.json is preserved. If a new template was shipped,"
+    echo "      compare it with /etc/coolercontrol/plugins/coolerdash/config.json.pacnew"
     echo "================================================================"
 }
 
diff --git a/etc/coolercontrol/plugins/coolerdash/config.json b/etc/coolercontrol/plugins/coolerdash/config.json
index 80fc1e0..630bff9 100644
--- a/etc/coolercontrol/plugins/coolerdash/config.json
+++ b/etc/coolercontrol/plugins/coolerdash/config.json
@@ -1,11 +1,6 @@
 {
   "_comment": "CoolerDash Plugin Configuration - All values with defaults",
-
-  "daemon": {
-    "address": "http://localhost:11987",
-    "access_token": "",
-    "_comment_token": "Create a token in CoolerControl UI → Access Protection. Format: cc_<uuid>."
-  },
+  "_comment_daemon": "daemon section (address, access_token) is stored in coolercontrol.json (chmod 600)",
 
   "device_detection": {
     "mode": "strict",
@@ -22,7 +17,7 @@
 
   "display": {
     "mode": "circle",
-    "circle_switch_interval": 5,
+    "circle_switch_interval": 6,
     "circle_show_extra_info": true,
     "refresh_interval": 2.5,
     "brightness": 80,
@@ -33,8 +28,8 @@
     "height": 0,
     "content_scale_factor": 0.98,
     "sensor_slot_1": "cpu",
-    "sensor_slot_2": "liquid",
-    "sensor_slot_3": "gpu"
+    "sensor_slot_2": "gpu",
+    "sensor_slot_3": "liquid"
   },
 
   "layout": {
diff --git a/etc/coolercontrol/plugins/coolerdash/coolercontrol.json b/etc/coolercontrol/plugins/coolerdash/coolercontrol.json
new file mode 100644
index 0000000..8b8a1e2
--- /dev/null
+++ b/etc/coolercontrol/plugins/coolerdash/coolercontrol.json
@@ -0,0 +1,10 @@
+{
+  "_comment": "CoolerDash daemon configuration — chmod 600, never overwritten by make install",
+  "_info": "Edit this file as root. Changes take effect after plugin restart.",
+
+  "daemon": {
+    "address": "http://localhost:11987",
+    "access_token": "",
+    "_comment_token": "Create a token in CoolerControl UI → Access Protection. Format: cc_<uuid>."
+  }
+}
diff --git a/etc/coolercontrol/plugins/coolerdash/ui/index.html b/etc/coolercontrol/plugins/coolerdash/ui/index.html
index 1f651a8..bc61f94 100644
--- a/etc/coolercontrol/plugins/coolerdash/ui/index.html
+++ b/etc/coolercontrol/plugins/coolerdash/ui/index.html
@@ -600,7 +600,7 @@ <h3 class="section-title">Authentication &mdash; CC4 (Bearer Token)</h3>
                 </div>
                 <div class="form-group">
                     <label class="form-label">Access Token</label>
-                    <span class="form-hint">Enter a CC4 Bearer token (cc_&hellip;).</span>
+                    <span class="form-hint">Enter a CC4 Bearer token (cc_&hellip;). After saving, the token is stored securely in <code>coolercontrol.json</code> (chmod 600) &mdash; this field will appear empty on the next load.</span>
                     <input type="password" name="daemon.access_token" class="form-control" autocomplete="off" spellcheck="false" placeholder="cc_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx">
                 </div>
             </div>
@@ -620,8 +620,8 @@ <h3 class="section-title">Display Mode</h3>
 
                     <div class="form-group" id="circle_interval_group" style="display: none;">
                         <label class="form-label">Switch Interval (Seconds)</label>
-                        <span class="form-hint">How long each sensor is shown (Default: 5)</span>
                         <input type="number" name="display.circle_switch_interval" class="form-control" min="1" max="60" step="1">
+                        <span class="form-hint">How long each sensor is shown (Default: 6)</span>
                     </div>
                     <div class="form-group" id="circle_extra_info_group" style="display: none;">
                         <label class="form-label">
@@ -655,7 +655,7 @@ <h3 class="section-title">Sensor Slots</h3>
 
                     <div class="form-group" id="sensor_slot_2_group">
                         <label class="form-label">Slot 2</label>
-                        <span class="form-hint">Default: Liquid (Circle only)</span>
+                        <span class="form-hint">Default: GPU (Circle only)</span>
                         <select name="display.sensor_slot_2" id="sensor_slot_2" class="form-control sensor-slot-select" onchange="validateSensorSlots()">
                             <optgroup label="Standard">
                                 <option value="cpu">CPU</option>
@@ -668,7 +668,7 @@ <h3 class="section-title">Sensor Slots</h3>
 
                     <div class="form-group">
                         <label class="form-label">Slot 3</label>
-                        <span class="form-hint">Default: GPU</span>
+                        <span class="form-hint">Default: Liquid</span>
                         <select name="display.sensor_slot_3" id="sensor_slot_3" class="form-control sensor-slot-select" onchange="validateSensorSlots()">
                             <optgroup label="Standard">
                                 <option value="cpu">CPU</option>
@@ -715,6 +715,14 @@ <h3 class="section-title">Display Geometry</h3>
                         </select>
                     </div>
 
+                    <div class="form-group">
+                        <label class="form-label">Content Scale</label>
+                        <span class="form-hint">Default: 0.98</span>
+                        <input type="number" name="display.content_scale_factor" class="form-control" min="0.5" max="1.0" step="0.01">
+                    </div>
+                </div>
+
+                <div class="grid grid-2">
                     <div class="form-group">
                         <label class="form-label">Width (Pixels)</label>
                         <span class="form-hint">0 = automatic. Live device LCD size from CoolerControl is preferred at runtime; use a fixed value only as fallback/testing override.</span>
@@ -726,12 +734,6 @@ <h3 class="section-title">Display Geometry</h3>
                         <span class="form-hint">0 = automatic. Live device LCD size from CoolerControl is preferred at runtime; use a fixed value only as fallback/testing override.</span>
                         <input type="number" name="display.height" class="form-control" min="0" max="1024">
                     </div>
-
-                    <div class="form-group">
-                        <label class="form-label">Content Scale</label>
-                        <span class="form-hint">Default: 0.98</span>
-                        <input type="number" name="display.content_scale_factor" class="form-control" min="0.5" max="1.0" step="0.01">
-                    </div>
                 </div>
 
                 <h3 class="section-title">Background &amp; Shutdown Images</h3>
@@ -1060,10 +1062,6 @@ <h3 class="section-title">Detected LCD Device</h3>
                             <span class="device-info-label">LCD Resolution</span>
                             <span class="device-info-value mono" id="device-resolution">&mdash;</span>
                         </div>
-                        <div class="device-info-row">
-                            <span class="device-info-label">Display Shape</span>
-                            <span class="device-info-value" id="device-shape">&mdash;</span>
-                        </div>
                         <div class="device-info-row">
                             <span class="device-info-label">Firmware</span>
                             <span class="device-info-value mono" id="device-firmware">&mdash;</span>
@@ -1104,7 +1102,7 @@ <h3 class="section-title">About CoolerDash</h3>
                     </div>
                     <div class="info-item">
                         <div class="info-item-label">Website</div>
-                        <div class="info-item-value"><a href="https://github.com/damachine/coolerdash" target="_blank" rel="noopener">github.com/damachine/coolerdash</a></div>
+                        <div class="info-item-value"><a href="https://github.com/damachine/coolerdash" target="_blank" rel="noopener" onclick="openExternalUrl('https://github.com/damachine/coolerdash'); return false;">github.com/damachine/coolerdash</a></div>
                     </div>
                     <div class="info-item">
                         <div class="info-item-label">License</div>
@@ -1121,15 +1119,15 @@ <h3 class="section-title">Community &amp; Feedback</h3>
                 <div class="device-info-card">
                     <div class="info-item">
                         <div class="info-item-label">Bug Reports &amp; Feature Requests</div>
-                        <div class="info-item-value"><a href="https://github.com/damachine/coolerdash/issues" target="_blank" rel="noopener">GitHub Issues</a></div>
+                        <div class="info-item-value"><a href="https://github.com/damachine/coolerdash/issues" target="_blank" rel="noopener" onclick="openExternalUrl('https://github.com/damachine/coolerdash/issues'); return false;">GitHub Issues</a></div>
                     </div>
                     <div class="info-item">
                         <div class="info-item-label">Discussions</div>
-                        <div class="info-item-value"><a href="https://github.com/damachine/coolerdash/discussions" target="_blank" rel="noopener">GitHub Discussions</a></div>
+                        <div class="info-item-value"><a href="https://github.com/damachine/coolerdash/discussions" target="_blank" rel="noopener" onclick="openExternalUrl('https://github.com/damachine/coolerdash/discussions'); return false;">GitHub Discussions</a></div>
                     </div>
                     <div class="info-item" style="margin-bottom: 0;">
                         <div class="info-item-label">Discord</div>
-                        <div class="info-item-value"><a href="https://discord.com/channels/908873022105079848/1461781766791499981" target="_blank" rel="noopener">CoolerControl Discord &mdash; #coolerdash</a></div>
+                        <div class="info-item-value"><a href="https://discord.com/channels/908873022105079848/1461781766791499981" target="_blank" rel="noopener" onclick="openExternalUrl('https://discord.com/channels/908873022105079848/1461781766791499981'); return false;">CoolerControl Discord &mdash; #coolerdash</a></div>
                     </div>
                 </div>
 
@@ -1180,7 +1178,7 @@ <h3 class="section-title">System Environment</h3>
             },
             display: {
                 mode: "circle",
-                circle_switch_interval: 5,
+                circle_switch_interval: 6,
                 circle_show_extra_info: true,
                 refresh_interval: 2.5,
                 brightness: 80,
@@ -1191,8 +1189,8 @@ <h3 class="section-title">System Environment</h3>
                 height: 0,
                 content_scale_factor: 0.98,
                 sensor_slot_1: "cpu",
-                sensor_slot_2: "liquid",
-                sensor_slot_3: "gpu"
+                sensor_slot_2: "gpu",
+                sensor_slot_3: "liquid"
             },
             layout: {
                 bar_height: 24,
@@ -1232,7 +1230,9 @@ <h3 class="section-title">System Environment</h3>
                     threshold_3_color: { r: 255, g: 70, b: 0 },
                     threshold_4_color: { r: 255, g: 0, b: 0 },
                     offset_x: 0,
-                    offset_y: 0
+                    offset_y: 0,
+                    value_to_bar_gap: 0,
+                    label_to_bar_gap: 0
                 },
                 gpu: {
                     threshold_1: 55.0,
@@ -1246,7 +1246,9 @@ <h3 class="section-title">System Environment</h3>
                     threshold_3_color: { r: 255, g: 70, b: 0 },
                     threshold_4_color: { r: 255, g: 0, b: 0 },
                     offset_x: 0,
-                    offset_y: 0
+                    offset_y: 0,
+                    value_to_bar_gap: 0,
+                    label_to_bar_gap: 0
                 },
                 liquid: {
                     threshold_1: 30.0,
@@ -1260,7 +1262,9 @@ <h3 class="section-title">System Environment</h3>
                     threshold_3_color: { r: 255, g: 70, b: 0 },
                     threshold_4_color: { r: 255, g: 0, b: 0 },
                     offset_x: 0,
-                    offset_y: 0
+                    offset_y: 0,
+                    value_to_bar_gap: 0,
+                    label_to_bar_gap: 0
                 }
             },
             positioning: {
@@ -1278,6 +1282,18 @@ <h3 class="section-title">System Environment</h3>
         let discoveredSensors = [];
         let currentSensorConfig = {};
 
+        /**
+         * @brief Open an external URL — works inside CC4's iframe sandbox via postMessage.
+         */
+        function openExternalUrl(url) {
+            // CC4 listens for 'openUrl' postMessage to open links in the host browser
+            if (isInCoolerControl) {
+                window.parent.postMessage({ type: 'openUrl', body: { url: url } }, '*');
+            } else {
+                window.open(url, '_blank', 'noopener,noreferrer');
+            }
+        }
+
         /**
          * @brief Escape HTML special characters to prevent XSS.
          */
@@ -1796,7 +1812,8 @@ <h3 class="section-title">System Environment</h3>
                 threshold_2_color: { r: 255, g: 140, b: 0 },
                 threshold_3_color: { r: 255, g: 70, b: 0 },
                 threshold_4_color: { r: 255, g: 0, b: 0 },
-                offset_x: 0, offset_y: 0
+                offset_x: 0, offset_y: 0,
+                value_to_bar_gap: 0, label_to_bar_gap: 0
             };
 
             if (sensorId === 'liquid') {
@@ -1931,6 +1948,8 @@ <h3 class="section-title">System Environment</h3>
                 var eFontSize = Number(sc.font_size_temp) || 0;
                 var eOffsetX = Number(sc.offset_x) || 0;
                 var eOffsetY = Number(sc.offset_y) || 0;
+                var eValueGap = Number(sc.value_to_bar_gap) || 0;
+                var eLabelGap = Number(sc.label_to_bar_gap) || 0;
                 var eThresh1 = Number(sc.threshold_1 !== undefined ? sc.threshold_1 : defs.threshold_1);
                 var eThresh2 = Number(sc.threshold_2 !== undefined ? sc.threshold_2 : defs.threshold_2);
                 var eThresh3 = Number(sc.threshold_3 !== undefined ? sc.threshold_3 : defs.threshold_3);
@@ -1968,6 +1987,16 @@ <h3 class="section-title">System Environment</h3>
                                     '<span class="form-hint">Auto-layout fine-tuning only</span>' +
                                     '<input type="number" data-sensor="' + eSensorId + '" data-field="offset_y" class="form-control sensor-field" value="' + eOffsetY + '" step="1">' +
                                 '</div>' +
+                                '<div class="form-group">' +
+                                    '<label class="form-label">Value Gap</label>' +
+                                    '<span class="form-hint">% of height above bar (0 = auto)</span>' +
+                                    '<input type="number" data-sensor="' + eSensorId + '" data-field="value_to_bar_gap" class="form-control sensor-field" value="' + eValueGap + '" min="0" max="100" step="0.1">' +
+                                '</div>' +
+                                '<div class="form-group">' +
+                                    '<label class="form-label">Label Gap</label>' +
+                                    '<span class="form-hint">% of height below bar (0 = auto)</span>' +
+                                    '<input type="number" data-sensor="' + eSensorId + '" data-field="label_to_bar_gap" class="form-control sensor-field" value="' + eLabelGap + '" min="0" max="100" step="0.1">' +
+                                '</div>' +
                             '</div>' +
 
                             // Thresholds section
@@ -2192,14 +2221,18 @@ <h3 class="section-title">System Environment</h3>
                     var width = lcdInfo ? (lcdInfo.screen_width || 0) : 0;
                     var height = lcdInfo ? (lcdInfo.screen_height || 0) : 0;
 
+                    // Fallback: use configured display dimensions if API doesn't report lcd_info
+                    if (width === 0 || height === 0) {
+                        var cfgW = parseInt((document.querySelector('[name="display.width"]') || {}).value, 10) || 0;
+                        var cfgH = parseInt((document.querySelector('[name="display.height"]') || {}).value, 10) || 0;
+                        if (cfgW > 0 && cfgH > 0) { width = cfgW; height = cfgH; }
+                    }
+
                     var resEl = document.getElementById('device-resolution');
-                    var shapeEl = document.getElementById('device-shape');
                     if (width > 0 && height > 0) {
                         resEl.textContent = width + ' \u00D7 ' + height + ' px';
-                        shapeEl.textContent = (width === height) ? 'Circular' : 'Rectangular';
                     } else {
                         resEl.textContent = 'Not available';
-                        shapeEl.textContent = 'Unknown';
                     }
 
                     document.getElementById('device-status').innerHTML =
@@ -2209,7 +2242,6 @@ <h3 class="section-title">System Environment</h3>
                     document.getElementById('device-name').textContent = '\u2014';
                     document.getElementById('device-uid').textContent = '\u2014';
                     document.getElementById('device-resolution').textContent = '\u2014';
-                    document.getElementById('device-shape').textContent = '\u2014';
                     document.getElementById('device-firmware').textContent = '\u2014';
                     document.getElementById('device-liquidctl').textContent = '\u2014';
                     document.getElementById('device-status').innerHTML =
@@ -2309,7 +2341,7 @@ <h3 class="section-title">System Environment</h3>
                 if (midSlot) midSlot.value = 'none';
             } else if (mode === 'circle') {
                 var midSlot = document.getElementById('sensor_slot_2');
-                if (midSlot && midSlot.value === 'none') midSlot.value = 'liquid';
+                if (midSlot && midSlot.value === 'none') midSlot.value = 'gpu';
             }
             validateSensorSlots();
         }
@@ -2479,7 +2511,7 @@ <h3 class="section-title">System Environment</h3>
 
             // Sensor slot selects: ensure custom values are available as options
             var slotFields = ['sensor_slot_1', 'sensor_slot_2', 'sensor_slot_3'];
-            var slotDefaults = { sensor_slot_1: 'cpu', sensor_slot_2: 'liquid', sensor_slot_3: 'gpu' };
+            var slotDefaults = { sensor_slot_1: 'cpu', sensor_slot_2: 'gpu', sensor_slot_3: 'liquid' };
             for (var sf = 0; sf < slotFields.length; sf++) {
                 var slotValue = config.display && config.display[slotFields[sf]];
                 if (slotValue) {
@@ -2643,19 +2675,19 @@ <h3 class="section-title">System Environment</h3>
                 if (!sensors.hasOwnProperty(id)) continue;
                 // Remove corrupt numeric sensor IDs from old parseFloat bug
                 if (/^\d+$/.test(id)) continue;
-                var defaults = merged.sensors[id] || getDefaultSensorConfig(id);
-                merged.sensors[id] = Object.assign({}, defaults, sensors[id]);
+                var sensorDefaults = merged.sensors[id] || getDefaultSensorConfig(id);
+                merged.sensors[id] = Object.assign({}, sensorDefaults, sensors[id]);
                 // Deep merge color objects
                 var colorKeys = ['threshold_1_color', 'threshold_2_color', 'threshold_3_color', 'threshold_4_color'];
                 for (var c = 0; c < colorKeys.length; c++) {
                     if (sensors[id][colorKeys[c]]) {
-                        merged.sensors[id][colorKeys[c]] = Object.assign({}, defaults[colorKeys[c]] || {}, sensors[id][colorKeys[c]]);
+                        merged.sensors[id][colorKeys[c]] = Object.assign({}, sensorDefaults[colorKeys[c]] || {}, sensors[id][colorKeys[c]]);
                     }
                 }
             }
 
             // Sanitize corrupt numeric slot values (from old parseFloat bug)
-            var slotDefaults = { sensor_slot_1: 'cpu', sensor_slot_2: 'liquid', sensor_slot_3: 'gpu' };
+            var slotDefaults = { sensor_slot_1: 'cpu', sensor_slot_2: 'gpu', sensor_slot_3: 'liquid' };
             for (var slotKey in slotDefaults) {
                 if (merged.display && merged.display[slotKey] !== undefined) {
                     var sv = String(merged.display[slotKey]);
diff --git a/packaging/coolerdash.spec b/packaging/coolerdash.spec
index 7f9929b..5cc770b 100644
--- a/packaging/coolerdash.spec
+++ b/packaging/coolerdash.spec
@@ -76,7 +76,23 @@ fi
 
 %post
 if [ -f /etc/coolercontrol/plugins/coolerdash/config.json ]; then
-    chmod 600 /etc/coolercontrol/plugins/coolerdash/config.json
+    chmod 644 /etc/coolercontrol/plugins/coolerdash/config.json
+fi
+# coolercontrol.json: create only if not present — never overwritten on update
+if [ ! -f /etc/coolercontrol/plugins/coolerdash/coolercontrol.json ]; then
+    cat > /etc/coolercontrol/plugins/coolerdash/coolercontrol.json << 'CCEOF'
+{
+  "_comment": "CoolerDash daemon configuration — chmod 600, never overwritten by updates",
+  "_info": "Edit this file as root. Changes take effect after plugin restart.",
+
+  "daemon": {
+    "address": "http://localhost:11987",
+    "access_token": "",
+    "_comment_token": "Create a token in CoolerControl UI -> Access Protection. Format: cc_<uuid>."
+  }
+}
+CCEOF
+    chmod 600 /etc/coolercontrol/plugins/coolerdash/coolercontrol.json
 fi
 # Remove legacy files
 rm -f /etc/systemd/system/multi-user.target.wants/coolerdash-helperd.service
@@ -139,6 +155,7 @@ fi
 /usr/libexec/coolerdash/coolerdash
 %dir /etc/coolercontrol/plugins/coolerdash
 %config(noreplace) /etc/coolercontrol/plugins/coolerdash/config.json
+%ghost /etc/coolercontrol/plugins/coolerdash/coolercontrol.json
 /etc/coolercontrol/plugins/coolerdash/manifest.toml
 %dir /etc/coolercontrol/plugins/coolerdash/ui
 /etc/coolercontrol/plugins/coolerdash/ui/index.html
diff --git a/packaging/debian/postinst b/packaging/debian/postinst
index 7133af7..26ddf8b 100755
--- a/packaging/debian/postinst
+++ b/packaging/debian/postinst
@@ -3,9 +3,25 @@ set -e
 
 case "$1" in
     configure)
-        # Set config permissions
+        # Set permissions on config.json
         if [ -f /etc/coolercontrol/plugins/coolerdash/config.json ]; then
-            chmod 600 /etc/coolercontrol/plugins/coolerdash/config.json
+            chmod 644 /etc/coolercontrol/plugins/coolerdash/config.json
+        fi
+        # coolercontrol.json: create only if not present — never overwritten on update
+        if [ ! -f /etc/coolercontrol/plugins/coolerdash/coolercontrol.json ]; then
+            cat > /etc/coolercontrol/plugins/coolerdash/coolercontrol.json << 'CCEOF'
+{
+  "_comment": "CoolerDash daemon configuration — chmod 600, never overwritten by updates",
+  "_info": "Edit this file as root. Changes take effect after plugin restart.",
+
+  "daemon": {
+    "address": "http://localhost:11987",
+    "access_token": "",
+    "_comment_token": "Create a token in CoolerControl UI -> Access Protection. Format: cc_<uuid>."
+  }
+}
+CCEOF
+            chmod 600 /etc/coolercontrol/plugins/coolerdash/coolercontrol.json
         fi
 
         # Remove legacy files
diff --git a/src/device/config.c b/src/device/config.c
index 7de3302..60526cd 100644
--- a/src/device/config.c
+++ b/src/device/config.c
@@ -19,6 +19,7 @@
 #include <stdarg.h>
 #include <stdio.h>
 #include <string.h>
+#include <sys/stat.h>
 #include <jansson.h>
 // cppcheck-suppress-end missingIncludeSystem
 
@@ -162,7 +163,7 @@ static void set_display_defaults(Config *config)
         cc_safe_strcpy(config->display_background_image_fit,
                        sizeof(config->display_background_image_fit), "cover");
     if (config->circle_switch_interval == 0)
-        config->circle_switch_interval = 5;
+        config->circle_switch_interval = 6;
     if (config->circle_show_extra_info < 0)
         config->circle_show_extra_info = 1; // enabled by default
     if (config->display_content_scale_factor == 0.0f)
@@ -175,9 +176,9 @@ static void set_display_defaults(Config *config)
     if (config->sensor_slot_1[0] == '\0')
         cc_safe_strcpy(config->sensor_slot_1, sizeof(config->sensor_slot_1), "cpu");
     if (config->sensor_slot_2[0] == '\0')
-        cc_safe_strcpy(config->sensor_slot_2, sizeof(config->sensor_slot_2), "liquid");
+        cc_safe_strcpy(config->sensor_slot_2, sizeof(config->sensor_slot_2), "gpu");
     if (config->sensor_slot_3[0] == '\0')
-        cc_safe_strcpy(config->sensor_slot_3, sizeof(config->sensor_slot_3), "gpu");
+        cc_safe_strcpy(config->sensor_slot_3, sizeof(config->sensor_slot_3), "liquid");
 }
 
 /**
@@ -535,13 +536,13 @@ static void validate_sensor_slots(Config *config)
     }
     if (!is_valid_sensor_slot(config->sensor_slot_2))
     {
-        log_message(LOG_WARNING, "Invalid sensor_slot_2 value, using 'liquid'");
-        cc_safe_strcpy(config->sensor_slot_2, sizeof(config->sensor_slot_2), "liquid");
+        log_message(LOG_WARNING, "Invalid sensor_slot_2 value, using 'gpu'");
+        cc_safe_strcpy(config->sensor_slot_2, sizeof(config->sensor_slot_2), "gpu");
     }
     if (!is_valid_sensor_slot(config->sensor_slot_3))
     {
-        log_message(LOG_WARNING, "Invalid sensor_slot_3 value, using 'gpu'");
-        cc_safe_strcpy(config->sensor_slot_3, sizeof(config->sensor_slot_3), "gpu");
+        log_message(LOG_WARNING, "Invalid sensor_slot_3 value, using 'liquid'");
+        cc_safe_strcpy(config->sensor_slot_3, sizeof(config->sensor_slot_3), "liquid");
     }
 
     // Check for duplicates (only among active slots, "none" can appear multiple times)
@@ -583,8 +584,8 @@ static void validate_sensor_slots(Config *config)
     if (reset_needed)
     {
         cc_safe_strcpy(config->sensor_slot_1, sizeof(config->sensor_slot_1), "cpu");
-        cc_safe_strcpy(config->sensor_slot_2, sizeof(config->sensor_slot_2), "liquid");
-        cc_safe_strcpy(config->sensor_slot_3, sizeof(config->sensor_slot_3), "gpu");
+        cc_safe_strcpy(config->sensor_slot_2, sizeof(config->sensor_slot_2), "gpu");
+        cc_safe_strcpy(config->sensor_slot_3, sizeof(config->sensor_slot_3), "liquid");
         log_message(LOG_STATUS, "Sensor slots reset to defaults: 1=cpu, 2=liquid, 3=gpu");
     }
 }
@@ -674,6 +675,129 @@ static const char *find_config_json(const char *custom_path)
     return NULL;
 }
 
+/* Forward declarations — defined below, used here before their definition */
+static void load_daemon_from_json(json_t *root, Config *config);
+static const char *find_coolercontrol_json(void);
+
+/**
+ * @brief Migrate access_token from config.json to coolercontrol.json and strip it.
+ * @details Called after loading config.json. If config.json contains a non-empty access_token
+ *          that differs from the coolercontrol.json baseline, the token is written to
+ *          coolercontrol.json (chmod 600) and removed from config.json (chmod 644).
+ *          This ensures the token never persists in the world-readable config.json.
+ */
+static void migrate_token_from_config_json(const char *config_json_path,
+                                           const char *new_token,
+                                           const char *cc_token)
+{
+    /* Only migrate if config.json had a non-empty token that differs from coolercontrol.json */
+    if (!new_token || new_token[0] == '\0')
+        return;
+    if (cc_token && strcmp(new_token, cc_token) == 0)
+        return;
+
+    /* 1. Write token to coolercontrol.json */
+    const char *cc_path = find_coolercontrol_json();
+    if (cc_path)
+    {
+        json_error_t error;
+        json_t *cc_root = json_load_file(cc_path, 0, &error);
+        if (cc_root)
+        {
+            json_t *daemon = json_object_get(cc_root, "daemon");
+            if (!daemon)
+            {
+                daemon = json_object();
+                json_object_set_new(cc_root, "daemon", daemon);
+            }
+            json_object_set_new(daemon, "access_token", json_string(new_token));
+            if (json_dump_file(cc_root, cc_path, JSON_INDENT(2)) == 0)
+                log_message(LOG_STATUS, "Access token migrated to coolercontrol.json (chmod 600)");
+            else
+                log_message(LOG_WARNING, "Failed to write token to coolercontrol.json");
+            json_decref(cc_root);
+        }
+        else
+        {
+            log_message(LOG_WARNING, "Cannot parse coolercontrol.json for migration: %s", error.text);
+        }
+    }
+    else
+    {
+        log_message(LOG_WARNING, "coolercontrol.json not found — token migration skipped");
+        return;
+    }
+
+    /* 2. Strip access_token from config.json */
+    if (!config_json_path)
+        return;
+    json_error_t error;
+    json_t *cfg_root = json_load_file(config_json_path, 0, &error);
+    if (!cfg_root)
+        return;
+    json_t *daemon = json_object_get(cfg_root, "daemon");
+    if (daemon && json_is_object(daemon))
+    {
+        json_object_del(daemon, "access_token");
+        /* Remove daemon section entirely if it only contained access_token */
+        if (json_object_size(daemon) == 0)
+            json_object_del(cfg_root, "daemon");
+    }
+    if (json_dump_file(cfg_root, config_json_path, JSON_INDENT(2)) == 0)
+        log_message(LOG_INFO, "access_token stripped from config.json");
+    else
+        log_message(LOG_WARNING, "Failed to strip access_token from config.json");
+    json_decref(cfg_root);
+}
+
+/**
+ * @brief Try to locate coolercontrol.json (chmod 600, separate from config.json).
+ * @details Contains the daemon section (address + access_token). Never overwritten by make install.
+ */
+static const char *find_coolercontrol_json(void)
+{
+    static const char *cc_paths[] = {
+        "/etc/coolercontrol/plugins/coolerdash/coolercontrol.json",
+        NULL};
+
+    for (int i = 0; cc_paths[i] != NULL; i++)
+    {
+        FILE *fp = fopen(cc_paths[i], "r");
+        if (fp)
+        {
+            fclose(fp);
+            return cc_paths[i];
+        }
+    }
+
+    return NULL;
+}
+
+/**
+ * @brief Load daemon section from coolercontrol.json (chmod 600).
+ * @details Read before config.json so GUI saves in config.json override the baseline.
+ */
+static void load_coolercontrol_json(Config *config)
+{
+    const char *cc_path = find_coolercontrol_json();
+    if (!cc_path)
+        return;
+
+    json_error_t error;
+    json_t *root = json_load_file(cc_path, 0, &error);
+    if (!root)
+    {
+        log_message(LOG_WARNING, "Failed to parse coolercontrol.json %s: %s (line %d)",
+                    cc_path, error.text, error.line);
+        return;
+    }
+
+    load_daemon_from_json(root, config);
+    log_message(LOG_INFO, "Daemon config loaded from coolercontrol.json");
+
+    json_decref(root);
+}
+
 /**
  * @brief Load daemon settings from JSON.
  */
@@ -1097,6 +1221,22 @@ static void load_sensor_config_from_json(json_t *obj, SensorConfig *sc)
     if (val && json_is_integer(val))
         sc->offset_y = (int)json_integer_value(val);
 
+    val = json_object_get(obj, "value_to_bar_gap");
+    if (val && json_is_number(val))
+    {
+        double v = json_number_value(val);
+        if (v >= 0.0 && v <= 100.0)
+            sc->value_to_bar_gap = (float)v;
+    }
+
+    val = json_object_get(obj, "label_to_bar_gap");
+    if (val && json_is_number(val))
+    {
+        double v = json_number_value(val);
+        if (v >= 0.0 && v <= 100.0)
+            sc->label_to_bar_gap = (float)v;
+    }
+
     val = json_object_get(obj, "font_size_temp");
     if (val && json_is_number(val))
         sc->font_size_temp = (float)json_number_value(val);
@@ -1257,12 +1397,23 @@ int load_plugin_config(Config *config, const char *config_path)
     config->display_degree_spacing = -1;
     // Note: All colors have is_set=0 after memset, so defaults will be applied
 
+    // Load coolercontrol.json (600) first — sets daemon baseline before config.json can override
+    load_coolercontrol_json(config);
+
+    // Remember token from coolercontrol.json before config.json may override it
+    char cc_token_baseline[CONFIG_MAX_TOKEN_LEN];
+    cc_token_baseline[0] = '\0';
+    SAFE_STRCPY(cc_token_baseline, config->access_token);
+
     // Try to find and load JSON config
     const char *json_path = find_config_json(config_path);
     int loaded_from_json = 0;
 
     if (json_path)
     {
+        /* Ensure config.json stays world-readable (CC4 overwrites as root on save) */
+        chmod(json_path, 0644);
+
         log_message(LOG_INFO, "Loading plugin config from: %s", json_path);
 
         json_error_t error;
@@ -1283,6 +1434,11 @@ int load_plugin_config(Config *config, const char *config_path)
             json_decref(root);
             loaded_from_json = 1;
             log_message(LOG_STATUS, "Plugin configuration loaded from JSON");
+
+            // If config.json delivered a token that differs from coolercontrol.json,
+            // migrate it to coolercontrol.json (600) and strip it from config.json (644)
+            if (config->access_token[0] != '\0')
+                migrate_token_from_config_json(json_path, config->access_token, cc_token_baseline);
         }
         else
         {
diff --git a/src/device/config.h b/src/device/config.h
index f10c3e4..ba18035 100644
--- a/src/device/config.h
+++ b/src/device/config.h
@@ -82,6 +82,8 @@ typedef struct
     int offset_y;                         /**< Display Y offset for value text */
     float font_size_temp;                 /**< Per-sensor temp font size (0 = use global) */
     char label[32];                       /**< Custom display label (empty = auto) */
+    float value_to_bar_gap;               /**< Gap above bar as % of available_height (0 = auto) */
+    float label_to_bar_gap;               /**< Gap below bar as % of available_height (0 = auto) */
 } SensorConfig;
 
 /**
diff --git a/src/mods/circle.c b/src/mods/circle.c
index 4dd7081..196199b 100644
--- a/src/mods/circle.c
+++ b/src/mods/circle.c
@@ -418,8 +418,15 @@ static void draw_single_sensor(cairo_t *cr, const struct Config *config,
     const double value_bar_gap = region_gap * 0.05;
 
     const double value_box_y = params->margin_top;
-    const double value_box_height = fmax(0.0, bar_y - value_bar_gap - params->margin_top);
-    const double label_box_y = bar_y + bar_height + region_gap;
+    const SensorConfig *sc_gap = get_sensor_config(config, slot_value);
+    const double gap_above = (sc_gap && sc_gap->value_to_bar_gap > 0.0f)
+        ? available_height * (sc_gap->value_to_bar_gap / 100.0)
+        : value_bar_gap;
+    const double gap_below = (sc_gap && sc_gap->label_to_bar_gap > 0.0f)
+        ? available_height * (sc_gap->label_to_bar_gap / 100.0)
+        : region_gap;
+    const double value_box_height = fmax(0.0, bar_y - gap_above - params->margin_top);
+    const double label_box_y = bar_y + bar_height + gap_below;
     const double label_box_height =
         fmax(0.0, config->display_height - params->margin_bottom - label_box_y);
 
diff --git a/src/mods/dual.c b/src/mods/dual.c
index 630e19b..985da73 100644
--- a/src/mods/dual.c
+++ b/src/mods/dual.c
@@ -114,11 +114,22 @@ static int calculate_dual_layout(const struct Config *config,
     layout->label_spacing = get_effective_label_spacing(config, params);
     const double value_bar_gap = layout->label_spacing * 0.05;
 
+    const SensorConfig *sc_up = get_sensor_config(config, config->sensor_slot_1);
+    const SensorConfig *sc_down = get_sensor_config(config, config->sensor_slot_3);
+    const double dual_avail_height =
+        config->display_height - params->margin_top - params->margin_bottom;
+    const double gap_above_top = (sc_up && sc_up->value_to_bar_gap > 0.0f)
+                                     ? dual_avail_height * (sc_up->value_to_bar_gap / 100.0)
+                                     : value_bar_gap;
+    const double gap_below_bottom = (sc_down && sc_down->value_to_bar_gap > 0.0f)
+                                        ? dual_avail_height * (sc_down->value_to_bar_gap / 100.0)
+                                        : value_bar_gap;
+
     layout->top_value_box_y = params->margin_top;
     layout->top_value_box_height =
-        fmax(0.0, layout->up_bar_y - value_bar_gap - params->margin_top);
+        fmax(0.0, layout->up_bar_y - gap_above_top - params->margin_top);
     layout->bottom_value_box_y =
-        layout->down_bar_y + layout->bar_height_down + value_bar_gap;
+        layout->down_bar_y + layout->bar_height_down + gap_below_bottom;
     layout->bottom_value_box_height =
         fmax(0.0, config->display_height - params->margin_bottom - layout->bottom_value_box_y);
 
@@ -302,8 +313,18 @@ static void draw_labels(cairo_t *cr, const struct Config *config,
     const char *slot_up = config->sensor_slot_1;
     const char *slot_down = config->sensor_slot_3;
 
-    const char *label_up = get_slot_label(config, data, slot_up);
-    const char *label_down = get_slot_label(config, data, slot_down);
+    const double dual_avail_height =
+        config->display_height - params->margin_top - params->margin_bottom;
+
+    /* Dual mode: use custom label if set, otherwise always "CPU" / "GPU" */
+    const SensorConfig *sc_lbl_up = get_sensor_config(config, slot_up);
+    const SensorConfig *sc_lbl_down = get_sensor_config(config, slot_down);
+    const char *label_up = (sc_lbl_up && sc_lbl_up->label[0] != '\0')
+                               ? sc_lbl_up->label
+                               : "CPU";
+    const char *label_down = (sc_lbl_down && sc_lbl_down->label[0] != '\0')
+                                 ? sc_lbl_down->label
+                                 : "GPU";
 
     SlotValueLayout up_layout = {0};
     SlotValueLayout down_layout = {0};
@@ -385,7 +406,11 @@ static void draw_labels(cairo_t *cr, const struct Config *config,
                 label_font_size = min_label_font_size;
         }
 
-        double up_label_y = layout.up_bar_y - layout.label_spacing - font_ext.descent;
+        const SensorConfig *sc_up_lbl = get_sensor_config(config, slot_up);
+        const double up_label_gap = (sc_up_lbl && sc_up_lbl->label_to_bar_gap > 0.0f)
+                                        ? dual_avail_height * (sc_up_lbl->label_to_bar_gap / 100.0)
+                                        : layout.label_spacing;
+        double up_label_y = layout.up_bar_y - up_label_gap - font_ext.descent;
         up_label_y += get_scaled_label_offset_y(config, params);
 
         const double up_label_right = label_x + fmax(up_label_ext.x_advance, up_label_ext.width);
@@ -433,8 +458,12 @@ static void draw_labels(cairo_t *cr, const struct Config *config,
                 label_font_size = min_label_font_size;
         }
 
+        const SensorConfig *sc_down_lbl = get_sensor_config(config, slot_down);
+        const double down_label_gap = (sc_down_lbl && sc_down_lbl->label_to_bar_gap > 0.0f)
+                                          ? dual_avail_height * (sc_down_lbl->label_to_bar_gap / 100.0)
+                                          : layout.label_spacing;
         double down_label_y = layout.down_bar_y + layout.bar_height_down +
-                              layout.label_spacing + font_ext.ascent;
+                              down_label_gap + font_ext.ascent;
         down_label_y += get_scaled_label_offset_y(config, params);
 
         const double down_label_right =

From 258a984f34d3e7fd4231c438e8ffc8ec8813d146 Mon Sep 17 00:00:00 2001
From: damachin3 <damachin3@proton.me>
Date: Fri, 10 Apr 2026 01:48:25 +0200
Subject: [PATCH 06/10] circle: rework UI and rendering

---
 Makefile                                      |  17 +--
 PKGBUILD                                      |   2 +-
 aur/coolerdash.install                        |   8 +
 coolerdash.install                            |  40 +----
 .../plugins/coolerdash/config.json            |   6 +-
 .../plugins/coolerdash/coolercontrol.json     |  10 --
 .../plugins/coolerdash/ui/index.html          |  23 ++-
 packaging/coolerdash.spec                     |  19 +--
 packaging/debian/postinst                     |  18 +--
 src/device/config.c                           | 139 +-----------------
 src/mods/circle.c                             |  96 +++++++++++-
 11 files changed, 134 insertions(+), 244 deletions(-)
 delete mode 100644 etc/coolercontrol/plugins/coolerdash/coolercontrol.json

diff --git a/Makefile b/Makefile
index a534818..b296b8f 100644
--- a/Makefile
+++ b/Makefile
@@ -346,17 +346,11 @@ install: check-deps $(TARGET)
 	@$(INSTALL_DATA) CHANGELOG.md "$(DESTDIR)$(PLUGINDIR)/CHANGELOG.md"
 	@$(INSTALL_DATA) VERSION "$(DESTDIR)$(PLUGINDIR)/VERSION"
 	@if [ -f "$(DESTDIR)$(PLUGINDIR)/config.json" ]; then \
-		$(INSTALL) -m 644 etc/coolercontrol/plugins/coolerdash/config.json "$(DESTDIR)$(PLUGINDIR)/config.json.new"; \
-		chmod 644 "$(DESTDIR)$(PLUGINDIR)/config.json"; \
-		printf "  $(YELLOW)Config:$(RESET) Existing config.json preserved (permissions updated to 644). New defaults saved as config.json.new\n"; \
+		$(INSTALL) -m 600 etc/coolercontrol/plugins/coolerdash/config.json "$(DESTDIR)$(PLUGINDIR)/config.json.new"; \
+		chmod 600 "$(DESTDIR)$(PLUGINDIR)/config.json"; \
+		printf "  $(YELLOW)Config:$(RESET) Existing config.json preserved (permissions updated to 600). New defaults saved as config.json.new\n"; \
 	else \
-		$(INSTALL) -m 644 etc/coolercontrol/plugins/coolerdash/config.json "$(DESTDIR)$(PLUGINDIR)/config.json"; \
-	fi
-	@if [ -f "$(DESTDIR)$(PLUGINDIR)/coolercontrol.json" ]; then \
-		printf "  $(YELLOW)Daemon:$(RESET) Existing coolercontrol.json preserved\n"; \
-	else \
-		$(INSTALL) -m 600 etc/coolercontrol/plugins/coolerdash/coolercontrol.json "$(DESTDIR)$(PLUGINDIR)/coolercontrol.json"; \
-		printf "  $(GREEN)Daemon:$(RESET) $(DESTDIR)$(PLUGINDIR)/coolercontrol.json (chmod 600 — edit as root to set address + access_token)\n"; \
+		$(INSTALL) -m 600 etc/coolercontrol/plugins/coolerdash/config.json "$(DESTDIR)$(PLUGINDIR)/config.json"; \
 	fi
 	@$(INSTALL) -d "$(DESTDIR)$(PLUGINDIR)/ui"
 	@$(INSTALL_DATA) etc/coolercontrol/plugins/coolerdash/ui/index.html "$(DESTDIR)$(PLUGINDIR)/ui/index.html"
@@ -365,8 +359,7 @@ install: check-deps $(TARGET)
 	@sed -i 's/{{VERSION}}/$(VERSION)/g' "$(DESTDIR)$(PLUGINDIR)/manifest.toml"
 	@sed -i 's/{{VERSION}}/$(VERSION)/g' "$(DESTDIR)$(PLUGINDIR)/ui/index.html"
 	@printf "  $(GREEN)Binary:$(RESET)       $(DESTDIR)$(libexecdir)/coolerdash/coolerdash\n"
-	@printf "  $(GREEN)Config JSON:$(RESET)  $(DESTDIR)$(PLUGINDIR)/config.json (chmod 644)\n"
-	@printf "  $(GREEN)Daemon JSON:$(RESET)  $(DESTDIR)$(PLUGINDIR)/coolercontrol.json (chmod 600)\n"
+	@printf "  $(GREEN)Config JSON:$(RESET)  $(DESTDIR)$(PLUGINDIR)/config.json (chmod 600)\n"
 	@printf "  $(GREEN)Web UI:$(RESET)       $(DESTDIR)$(PLUGINDIR)/ui/index.html\n"
 	@printf "  $(GREEN)Plugin Lib:$(RESET)   Served by CoolerControl at /plugins/lib/cc-plugin-lib.js\n"
 	@printf "  $(GREEN)Plugin:$(RESET)       $(DESTDIR)$(PLUGINDIR)/manifest.toml\n"
diff --git a/PKGBUILD b/PKGBUILD
index 8e33d03..6dbb2ae 100644
--- a/PKGBUILD
+++ b/PKGBUILD
@@ -74,7 +74,7 @@ package() {
     install -Dm644 "${srcdir}/README.md" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/README.md"
     install -Dm644 "${srcdir}/VERSION" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/VERSION"
     install -Dm644 "${srcdir}/CHANGELOG.md" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/CHANGELOG.md"
-    install -Dm644 "${srcdir}/etc/coolercontrol/plugins/coolerdash/config.json" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/config.json"
+    install -Dm600 "${srcdir}/etc/coolercontrol/plugins/coolerdash/config.json" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/config.json"
 
     install -dm755 "${pkgdir}/etc/coolercontrol/plugins/coolerdash/ui"
     install -m644 "${srcdir}/etc/coolercontrol/plugins/coolerdash/ui/index.html" "${pkgdir}/etc/coolercontrol/plugins/coolerdash/ui/index.html"
diff --git a/aur/coolerdash.install b/aur/coolerdash.install
index 492dd11..7c9ce85 100644
--- a/aur/coolerdash.install
+++ b/aur/coolerdash.install
@@ -41,6 +41,9 @@ post_install() {
     rm -rf /etc/systemd/system/cc-plugin-coolerdash.service.d
     rm -f /usr/lib/udev/rules.d/99-coolerdash.rules
 
+    # Ensure correct permissions on config.json
+    chmod 600 /etc/coolercontrol/plugins/coolerdash/config.json 2>/dev/null || true
+
     systemctl daemon-reload
 
     # Restart plugin service directly if it already exists (reinstall case)
@@ -66,6 +69,9 @@ post_upgrade() {
     rm -rf /etc/systemd/system/cc-plugin-coolerdash.service.d
     rm -f /usr/lib/udev/rules.d/99-coolerdash.rules
 
+    # Ensure correct permissions on config.json
+    chmod 600 /etc/coolercontrol/plugins/coolerdash/config.json 2>/dev/null || true
+
     systemctl daemon-reload
 
     # Restart plugin
@@ -75,6 +81,8 @@ post_upgrade() {
 
     echo "================================================================"
     echo "CoolerDash upgraded successfully."
+    echo "Note: config.json is preserved. If a new template was shipped,"
+    echo "      compare it with /etc/coolercontrol/plugins/coolerdash/config.json.pacnew"
     echo "================================================================"
 }
 
diff --git a/coolerdash.install b/coolerdash.install
index 4c29810..7c9ce85 100644
--- a/coolerdash.install
+++ b/coolerdash.install
@@ -41,26 +41,8 @@ post_install() {
     rm -rf /etc/systemd/system/cc-plugin-coolerdash.service.d
     rm -f /usr/lib/udev/rules.d/99-coolerdash.rules
 
-    # Create coolercontrol.json (600) only if it does not exist — NEVER overwritten on update
-    if [ ! -f /etc/coolercontrol/plugins/coolerdash/coolercontrol.json ]; then
-        install -Dm600 /dev/null /etc/coolercontrol/plugins/coolerdash/coolercontrol.json
-        cat > /etc/coolercontrol/plugins/coolerdash/coolercontrol.json << 'EOF'
-{
-  "_comment": "CoolerDash daemon configuration — chmod 600, never overwritten by updates",
-  "_info": "Edit this file as root. Changes take effect after plugin restart.",
-
-  "daemon": {
-    "address": "http://localhost:11987",
-    "access_token": "",
-    "_comment_token": "Create a token in CoolerControl UI \u2192 Access Protection. Format: cc_<uuid>."
-  }
-}
-EOF
-        chmod 600 /etc/coolercontrol/plugins/coolerdash/coolercontrol.json
-    fi
-
     # Ensure correct permissions on config.json
-    chmod 644 /etc/coolercontrol/plugins/coolerdash/config.json 2>/dev/null || true
+    chmod 600 /etc/coolercontrol/plugins/coolerdash/config.json 2>/dev/null || true
 
     systemctl daemon-reload
 
@@ -87,24 +69,8 @@ post_upgrade() {
     rm -rf /etc/systemd/system/cc-plugin-coolerdash.service.d
     rm -f /usr/lib/udev/rules.d/99-coolerdash.rules
 
-    # Ensure correct permissions — coolercontrol.json is NEVER touched if it exists
-    chmod 644 /etc/coolercontrol/plugins/coolerdash/config.json 2>/dev/null || true
-    if [ ! -f /etc/coolercontrol/plugins/coolerdash/coolercontrol.json ]; then
-        install -Dm600 /dev/null /etc/coolercontrol/plugins/coolerdash/coolercontrol.json
-        cat > /etc/coolercontrol/plugins/coolerdash/coolercontrol.json << 'EOF'
-{
-  "_comment": "CoolerDash daemon configuration — chmod 600, never overwritten by updates",
-  "_info": "Edit this file as root. Changes take effect after plugin restart.",
-
-  "daemon": {
-    "address": "http://localhost:11987",
-    "access_token": "",
-    "_comment_token": "Create a token in CoolerControl UI \u2192 Access Protection. Format: cc_<uuid>."
-  }
-}
-EOF
-        chmod 600 /etc/coolercontrol/plugins/coolerdash/coolercontrol.json
-    fi
+    # Ensure correct permissions on config.json
+    chmod 600 /etc/coolercontrol/plugins/coolerdash/config.json 2>/dev/null || true
 
     systemctl daemon-reload
 
diff --git a/etc/coolercontrol/plugins/coolerdash/config.json b/etc/coolercontrol/plugins/coolerdash/config.json
index 630bff9..13eb77c 100644
--- a/etc/coolercontrol/plugins/coolerdash/config.json
+++ b/etc/coolercontrol/plugins/coolerdash/config.json
@@ -1,6 +1,10 @@
 {
   "_comment": "CoolerDash Plugin Configuration - All values with defaults",
-  "_comment_daemon": "daemon section (address, access_token) is stored in coolercontrol.json (chmod 600)",
+
+  "daemon": {
+    "address": "http://localhost:11987",
+    "access_token": ""
+  },
 
   "device_detection": {
     "mode": "strict",
diff --git a/etc/coolercontrol/plugins/coolerdash/coolercontrol.json b/etc/coolercontrol/plugins/coolerdash/coolercontrol.json
deleted file mode 100644
index 8b8a1e2..0000000
--- a/etc/coolercontrol/plugins/coolerdash/coolercontrol.json
+++ /dev/null
@@ -1,10 +0,0 @@
-{
-  "_comment": "CoolerDash daemon configuration — chmod 600, never overwritten by make install",
-  "_info": "Edit this file as root. Changes take effect after plugin restart.",
-
-  "daemon": {
-    "address": "http://localhost:11987",
-    "access_token": "",
-    "_comment_token": "Create a token in CoolerControl UI → Access Protection. Format: cc_<uuid>."
-  }
-}
diff --git a/etc/coolercontrol/plugins/coolerdash/ui/index.html b/etc/coolercontrol/plugins/coolerdash/ui/index.html
index bc61f94..bff4814 100644
--- a/etc/coolercontrol/plugins/coolerdash/ui/index.html
+++ b/etc/coolercontrol/plugins/coolerdash/ui/index.html
@@ -4,7 +4,7 @@
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>CoolerDash Settings</title>
-    <script type="text/javascript" src="/plugins/lib/cc-plugin-lib.js" onerror="console.warn('cc-plugin-lib.js not found, using fallback')"></script>
+    <script type="text/javascript" src="/plugins/lib/cc-plugin-lib.js"></script>
     <style>
         * { margin: 0; padding: 0; box-sizing: border-box; }
 
@@ -600,7 +600,7 @@ <h3 class="section-title">Authentication &mdash; CC4 (Bearer Token)</h3>
                 </div>
                 <div class="form-group">
                     <label class="form-label">Access Token</label>
-                    <span class="form-hint">Enter a CC4 Bearer token (cc_&hellip;). After saving, the token is stored securely in <code>coolercontrol.json</code> (chmod 600) &mdash; this field will appear empty on the next load.</span>
+                    <span class="form-hint">Enter a CC4 Bearer token (cc_&hellip;). After saving, the token is stored securely in <code>config.json</code> (chmod 600). If a token is already set, the field shows <strong>***</strong> &mdash; enter a new value to replace it, or leave <strong>***</strong> unchanged.</span>
                     <input type="password" name="daemon.access_token" class="form-control" autocomplete="off" spellcheck="false" placeholder="cc_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx">
                 </div>
             </div>
@@ -668,7 +668,7 @@ <h3 class="section-title">Sensor Slots</h3>
 
                     <div class="form-group">
                         <label class="form-label">Slot 3</label>
-                        <span class="form-hint">Default: Liquid</span>
+                        <span class="form-hint">Default: Liquid (Circle) / GPU (Dual)</span>
                         <select name="display.sensor_slot_3" id="sensor_slot_3" class="form-control sensor-slot-select" onchange="validateSensorSlots()">
                             <optgroup label="Standard">
                                 <option value="cpu">CPU</option>
@@ -2339,9 +2339,13 @@ <h3 class="section-title">System Environment</h3>
             if (mode === 'dual') {
                 var midSlot = document.getElementById('sensor_slot_2');
                 if (midSlot) midSlot.value = 'none';
+                var slot3 = document.getElementById('sensor_slot_3');
+                if (slot3 && (slot3.value === 'liquid' || slot3.value === 'none')) slot3.value = 'gpu';
             } else if (mode === 'circle') {
                 var midSlot = document.getElementById('sensor_slot_2');
                 if (midSlot && midSlot.value === 'none') midSlot.value = 'gpu';
+                var slot3 = document.getElementById('sensor_slot_3');
+                if (slot3 && slot3.value === 'gpu') slot3.value = 'liquid';
             }
             validateSensorSlots();
         }
@@ -2480,7 +2484,9 @@ <h3 class="section-title">System Environment</h3>
             var extraInfoCb = document.getElementById('circle_show_extra_info');
             config.display.circle_show_extra_info = extraInfoCb ? extraInfoCb.checked : false;
 
-            return mergeConfigWithDefaults(config, DEFAULT_CONFIG || FACTORY_DEFAULTS);
+            var merged = mergeConfigWithDefaults(config, DEFAULT_CONFIG || FACTORY_DEFAULTS);
+
+            return merged;
         }
 
         // ===== POPULATE FORM FROM CONFIG =====
@@ -2617,6 +2623,15 @@ <h3 class="section-title">System Environment</h3>
         async function resetConfig() {
             try {
                 var factoryConfig = cloneConfig(RESET_CONFIG || DEFAULT_CONFIG || FACTORY_DEFAULTS);
+                // Preserve the existing access_token — never reset it to default
+                var tokenInput = document.querySelector('[name="daemon.access_token"]');
+                var existingToken = (tokenInput && tokenInput.dataset.realToken) || '';
+                if (existingToken) {
+                    if (!factoryConfig.daemon) factoryConfig.daemon = {};
+                    factoryConfig.daemon.access_token = existingToken;
+                } else if (factoryConfig.daemon) {
+                    delete factoryConfig.daemon.access_token;
+                }
                 await saveAndRestartConfig(factoryConfig);
                 populateForm(factoryConfig);
                 alert('Reset to factory defaults! Plugin will restart.');
diff --git a/packaging/coolerdash.spec b/packaging/coolerdash.spec
index 5cc770b..7f9929b 100644
--- a/packaging/coolerdash.spec
+++ b/packaging/coolerdash.spec
@@ -76,23 +76,7 @@ fi
 
 %post
 if [ -f /etc/coolercontrol/plugins/coolerdash/config.json ]; then
-    chmod 644 /etc/coolercontrol/plugins/coolerdash/config.json
-fi
-# coolercontrol.json: create only if not present — never overwritten on update
-if [ ! -f /etc/coolercontrol/plugins/coolerdash/coolercontrol.json ]; then
-    cat > /etc/coolercontrol/plugins/coolerdash/coolercontrol.json << 'CCEOF'
-{
-  "_comment": "CoolerDash daemon configuration — chmod 600, never overwritten by updates",
-  "_info": "Edit this file as root. Changes take effect after plugin restart.",
-
-  "daemon": {
-    "address": "http://localhost:11987",
-    "access_token": "",
-    "_comment_token": "Create a token in CoolerControl UI -> Access Protection. Format: cc_<uuid>."
-  }
-}
-CCEOF
-    chmod 600 /etc/coolercontrol/plugins/coolerdash/coolercontrol.json
+    chmod 600 /etc/coolercontrol/plugins/coolerdash/config.json
 fi
 # Remove legacy files
 rm -f /etc/systemd/system/multi-user.target.wants/coolerdash-helperd.service
@@ -155,7 +139,6 @@ fi
 /usr/libexec/coolerdash/coolerdash
 %dir /etc/coolercontrol/plugins/coolerdash
 %config(noreplace) /etc/coolercontrol/plugins/coolerdash/config.json
-%ghost /etc/coolercontrol/plugins/coolerdash/coolercontrol.json
 /etc/coolercontrol/plugins/coolerdash/manifest.toml
 %dir /etc/coolercontrol/plugins/coolerdash/ui
 /etc/coolercontrol/plugins/coolerdash/ui/index.html
diff --git a/packaging/debian/postinst b/packaging/debian/postinst
index 26ddf8b..c139131 100755
--- a/packaging/debian/postinst
+++ b/packaging/debian/postinst
@@ -5,23 +5,7 @@ case "$1" in
     configure)
         # Set permissions on config.json
         if [ -f /etc/coolercontrol/plugins/coolerdash/config.json ]; then
-            chmod 644 /etc/coolercontrol/plugins/coolerdash/config.json
-        fi
-        # coolercontrol.json: create only if not present — never overwritten on update
-        if [ ! -f /etc/coolercontrol/plugins/coolerdash/coolercontrol.json ]; then
-            cat > /etc/coolercontrol/plugins/coolerdash/coolercontrol.json << 'CCEOF'
-{
-  "_comment": "CoolerDash daemon configuration — chmod 600, never overwritten by updates",
-  "_info": "Edit this file as root. Changes take effect after plugin restart.",
-
-  "daemon": {
-    "address": "http://localhost:11987",
-    "access_token": "",
-    "_comment_token": "Create a token in CoolerControl UI -> Access Protection. Format: cc_<uuid>."
-  }
-}
-CCEOF
-            chmod 600 /etc/coolercontrol/plugins/coolerdash/coolercontrol.json
+            chmod 600 /etc/coolercontrol/plugins/coolerdash/config.json
         fi
 
         # Remove legacy files
diff --git a/src/device/config.c b/src/device/config.c
index 60526cd..acd3fef 100644
--- a/src/device/config.c
+++ b/src/device/config.c
@@ -675,128 +675,8 @@ static const char *find_config_json(const char *custom_path)
     return NULL;
 }
 
-/* Forward declarations — defined below, used here before their definition */
+/* Forward declaration — defined below, used here before its definition */
 static void load_daemon_from_json(json_t *root, Config *config);
-static const char *find_coolercontrol_json(void);
-
-/**
- * @brief Migrate access_token from config.json to coolercontrol.json and strip it.
- * @details Called after loading config.json. If config.json contains a non-empty access_token
- *          that differs from the coolercontrol.json baseline, the token is written to
- *          coolercontrol.json (chmod 600) and removed from config.json (chmod 644).
- *          This ensures the token never persists in the world-readable config.json.
- */
-static void migrate_token_from_config_json(const char *config_json_path,
-                                           const char *new_token,
-                                           const char *cc_token)
-{
-    /* Only migrate if config.json had a non-empty token that differs from coolercontrol.json */
-    if (!new_token || new_token[0] == '\0')
-        return;
-    if (cc_token && strcmp(new_token, cc_token) == 0)
-        return;
-
-    /* 1. Write token to coolercontrol.json */
-    const char *cc_path = find_coolercontrol_json();
-    if (cc_path)
-    {
-        json_error_t error;
-        json_t *cc_root = json_load_file(cc_path, 0, &error);
-        if (cc_root)
-        {
-            json_t *daemon = json_object_get(cc_root, "daemon");
-            if (!daemon)
-            {
-                daemon = json_object();
-                json_object_set_new(cc_root, "daemon", daemon);
-            }
-            json_object_set_new(daemon, "access_token", json_string(new_token));
-            if (json_dump_file(cc_root, cc_path, JSON_INDENT(2)) == 0)
-                log_message(LOG_STATUS, "Access token migrated to coolercontrol.json (chmod 600)");
-            else
-                log_message(LOG_WARNING, "Failed to write token to coolercontrol.json");
-            json_decref(cc_root);
-        }
-        else
-        {
-            log_message(LOG_WARNING, "Cannot parse coolercontrol.json for migration: %s", error.text);
-        }
-    }
-    else
-    {
-        log_message(LOG_WARNING, "coolercontrol.json not found — token migration skipped");
-        return;
-    }
-
-    /* 2. Strip access_token from config.json */
-    if (!config_json_path)
-        return;
-    json_error_t error;
-    json_t *cfg_root = json_load_file(config_json_path, 0, &error);
-    if (!cfg_root)
-        return;
-    json_t *daemon = json_object_get(cfg_root, "daemon");
-    if (daemon && json_is_object(daemon))
-    {
-        json_object_del(daemon, "access_token");
-        /* Remove daemon section entirely if it only contained access_token */
-        if (json_object_size(daemon) == 0)
-            json_object_del(cfg_root, "daemon");
-    }
-    if (json_dump_file(cfg_root, config_json_path, JSON_INDENT(2)) == 0)
-        log_message(LOG_INFO, "access_token stripped from config.json");
-    else
-        log_message(LOG_WARNING, "Failed to strip access_token from config.json");
-    json_decref(cfg_root);
-}
-
-/**
- * @brief Try to locate coolercontrol.json (chmod 600, separate from config.json).
- * @details Contains the daemon section (address + access_token). Never overwritten by make install.
- */
-static const char *find_coolercontrol_json(void)
-{
-    static const char *cc_paths[] = {
-        "/etc/coolercontrol/plugins/coolerdash/coolercontrol.json",
-        NULL};
-
-    for (int i = 0; cc_paths[i] != NULL; i++)
-    {
-        FILE *fp = fopen(cc_paths[i], "r");
-        if (fp)
-        {
-            fclose(fp);
-            return cc_paths[i];
-        }
-    }
-
-    return NULL;
-}
-
-/**
- * @brief Load daemon section from coolercontrol.json (chmod 600).
- * @details Read before config.json so GUI saves in config.json override the baseline.
- */
-static void load_coolercontrol_json(Config *config)
-{
-    const char *cc_path = find_coolercontrol_json();
-    if (!cc_path)
-        return;
-
-    json_error_t error;
-    json_t *root = json_load_file(cc_path, 0, &error);
-    if (!root)
-    {
-        log_message(LOG_WARNING, "Failed to parse coolercontrol.json %s: %s (line %d)",
-                    cc_path, error.text, error.line);
-        return;
-    }
-
-    load_daemon_from_json(root, config);
-    log_message(LOG_INFO, "Daemon config loaded from coolercontrol.json");
-
-    json_decref(root);
-}
 
 /**
  * @brief Load daemon settings from JSON.
@@ -1397,22 +1277,14 @@ int load_plugin_config(Config *config, const char *config_path)
     config->display_degree_spacing = -1;
     // Note: All colors have is_set=0 after memset, so defaults will be applied
 
-    // Load coolercontrol.json (600) first — sets daemon baseline before config.json can override
-    load_coolercontrol_json(config);
-
-    // Remember token from coolercontrol.json before config.json may override it
-    char cc_token_baseline[CONFIG_MAX_TOKEN_LEN];
-    cc_token_baseline[0] = '\0';
-    SAFE_STRCPY(cc_token_baseline, config->access_token);
-
     // Try to find and load JSON config
     const char *json_path = find_config_json(config_path);
     int loaded_from_json = 0;
 
     if (json_path)
     {
-        /* Ensure config.json stays world-readable (CC4 overwrites as root on save) */
-        chmod(json_path, 0644);
+        /* Ensure config.json stays protected (contains access_token) */
+        chmod(json_path, 0600);
 
         log_message(LOG_INFO, "Loading plugin config from: %s", json_path);
 
@@ -1434,11 +1306,6 @@ int load_plugin_config(Config *config, const char *config_path)
             json_decref(root);
             loaded_from_json = 1;
             log_message(LOG_STATUS, "Plugin configuration loaded from JSON");
-
-            // If config.json delivered a token that differs from coolercontrol.json,
-            // migrate it to coolercontrol.json (600) and strip it from config.json (644)
-            if (config->access_token[0] != '\0')
-                migrate_token_from_config_json(json_path, config->access_token, cc_token_baseline);
         }
         else
         {
diff --git a/src/mods/circle.c b/src/mods/circle.c
index 196199b..b251967 100644
--- a/src/mods/circle.c
+++ b/src/mods/circle.c
@@ -229,6 +229,85 @@ static int get_extra_info_line2(const monitor_sensor_data_t *data,
     return 0;
 }
 
+/**
+ * @brief Check if text at position starts with a known unit suffix.
+ * @details Recognises MHz, GHz, RPM (3-char) and W (1-char, only when
+ * followed by end-of-string, space, or another separator).
+ * @param text Pointer into the string to test
+ * @return Length of matched unit token, or 0 if no match
+ */
+static int match_unit_at(const char *text)
+{
+    if (strncmp(text, "MHz", 3) == 0)
+        return 3;
+    if (strncmp(text, "GHz", 3) == 0)
+        return 3;
+    if (strncmp(text, "RPM", 3) == 0)
+        return 3;
+    if (text[0] == 'W' && (text[1] == '\0' || text[1] == ' '))
+        return 1;
+    return 0;
+}
+
+/**
+ * @brief Render text with unit suffixes (MHz, GHz, W, RPM) at 2/3 font size.
+ * @details Walks the string, renders numeric/space segments at @p full_size
+ * and recognised unit tokens at 2/3 of @p full_size.  Uses Cairo's
+ * current-point advancement so no manual x-tracking is needed.
+ * @param cr      Cairo context (font face must already be selected)
+ * @param full_size  Font size for numeric parts
+ * @param x       Left start position
+ * @param y       Baseline position
+ * @param text    The combined info string (e.g. "1500 MHz  95W")
+ */
+static void render_text_with_small_units(cairo_t *cr, double full_size,
+                                         double x, double y,
+                                         const char *text)
+{
+    if (!cr || !text || text[0] == '\0')
+        return;
+
+    const double unit_size = full_size * (2.0 / 3.0);
+    const char *p = text;
+    char segment[64];
+
+    cairo_move_to(cr, x, y);
+    cairo_set_font_size(cr, full_size);
+
+    while (*p)
+    {
+        int unit_len = match_unit_at(p);
+        if (unit_len > 0)
+        {
+            if ((size_t)unit_len >= sizeof(segment))
+                unit_len = (int)(sizeof(segment) - 1);
+            memcpy(segment, p, (size_t)unit_len);
+            segment[unit_len] = '\0';
+
+            cairo_set_font_size(cr, unit_size);
+            cairo_show_text(cr, segment);
+            cairo_set_font_size(cr, full_size);
+
+            p += unit_len;
+        }
+        else
+        {
+            int len = 0;
+            while (p[len] && match_unit_at(p + len) == 0)
+                len++;
+            if ((size_t)len >= sizeof(segment))
+                len = (int)(sizeof(segment) - 1);
+            memcpy(segment, p, (size_t)len);
+            segment[len] = '\0';
+
+            cairo_set_font_size(cr, full_size);
+            cairo_show_text(cr, segment);
+
+            p += len;
+        }
+    }
+}
+
 /**
  * @brief Get the slot value for a given slot index.
  * @param config Configuration
@@ -420,11 +499,11 @@ static void draw_single_sensor(cairo_t *cr, const struct Config *config,
     const double value_box_y = params->margin_top;
     const SensorConfig *sc_gap = get_sensor_config(config, slot_value);
     const double gap_above = (sc_gap && sc_gap->value_to_bar_gap > 0.0f)
-        ? available_height * (sc_gap->value_to_bar_gap / 100.0)
-        : value_bar_gap;
+                                 ? available_height * (sc_gap->value_to_bar_gap / 100.0)
+                                 : value_bar_gap;
     const double gap_below = (sc_gap && sc_gap->label_to_bar_gap > 0.0f)
-        ? available_height * (sc_gap->label_to_bar_gap / 100.0)
-        : region_gap;
+                                 ? available_height * (sc_gap->label_to_bar_gap / 100.0)
+                                 : region_gap;
     const double value_box_height = fmax(0.0, bar_y - gap_above - params->margin_top);
     const double label_box_y = bar_y + bar_height + gap_below;
     const double label_box_height =
@@ -684,8 +763,8 @@ static void draw_single_sensor(cairo_t *cr, const struct Config *config,
                                  ((double)params->safe_bar_width * left_margin_factor) +
                                  get_scaled_label_offset_x(config, params);
 
-                cairo_move_to(cr, extra_x, extra_y);
-                cairo_show_text(cr, extra_buf);
+                render_text_with_small_units(cr, extra_font_size,
+                                             extra_x, extra_y, extra_buf);
 
                 // Second line: fan RPM for CPU/GPU
                 char line2_buf[64];
@@ -719,8 +798,9 @@ static void draw_single_sensor(cairo_t *cr, const struct Config *config,
                         config->display_height)
                     {
                         set_cairo_color(cr, value_col);
-                        cairo_move_to(cr, extra_x, line2_y);
-                        cairo_show_text(cr, line2_buf);
+                        render_text_with_small_units(cr, line2_font_size,
+                                                     extra_x, line2_y,
+                                                     line2_buf);
                     }
                 }
             }

From 85eba7aef1aaf3d6541d3de61283bade78ff4b5b Mon Sep 17 00:00:00 2001
From: damachin3 <damachin3@proton.me>
Date: Fri, 10 Apr 2026 12:49:07 +0200
Subject: [PATCH 07/10] fix: Update LCD image upload to use PATCH settings
 endpoint instead of multipart API upload to improve reliability and
 performance.

---
 .../plugins/coolerdash/manifest.toml          |  2 +-
 src/main.c                                    | 33 +++------
 src/srv/cc_main.c                             | 71 +++++++++++++++----
 src/srv/cc_main.h                             |  7 +-
 4 files changed, 73 insertions(+), 40 deletions(-)

diff --git a/etc/coolercontrol/plugins/coolerdash/manifest.toml b/etc/coolercontrol/plugins/coolerdash/manifest.toml
index 8cf79d3..d50e6fe 100644
--- a/etc/coolercontrol/plugins/coolerdash/manifest.toml
+++ b/etc/coolercontrol/plugins/coolerdash/manifest.toml
@@ -3,7 +3,7 @@ type = "integration"
 version = "{{VERSION}}"
 description = "Monitor telemetry data on an AIO liquid cooler with an integrated LCD display"
 executable = "/usr/libexec/coolerdash/coolerdash"
-args = "--verbose"
+#args = "--verbose"
 privileged = true
 url = "https://github.com/damachine/coolerdash"
 author = "damachine"
diff --git a/src/main.c b/src/main.c
index d69dada..c5856c3 100644
--- a/src/main.c
+++ b/src/main.c
@@ -154,27 +154,6 @@ static int is_started_as_plugin(void)
     return (invocation_id && invocation_id[0]) ? 1 : 0;
 }
 
-/**
- * @brief Remove generated image file during cleanup.
- * @details Securely removes the generated PNG image file with proper error
- * reporting.
- */
-static void remove_image_file(const char *image_file)
-{
-    if (!image_file || !image_file[0])
-        return;
-
-    if (unlink(image_file) == 0)
-    {
-        log_message(LOG_INFO, "Image file removed");
-    }
-    else if (errno != ENOENT)
-    {
-        log_message(LOG_WARNING, "Could not remove image file '%s': %s", image_file,
-                    strerror(errno));
-    }
-}
-
 /**
  * @brief Enhanced help display with improved formatting and security
  * information.
@@ -725,18 +704,21 @@ static void initialize_device_info(Config *config)
 
 /**
  * @brief Perform cleanup operations.
- * @details Removes image files and closes CoolerControl session.
+ * @details Closes CoolerControl session and frees resources.
+ * The LCD image file is intentionally kept on disk so that CoolerControl
+ * can still find it when applying saved settings on next startup
+ * (coolerdash is started after CC applies settings).
  * Shutdown image is handled by CC4 natively via register_shutdown_image_with_cc().
  */
 static void perform_cleanup(const Config *config)
 {
+    (void)config;
     log_message(LOG_INFO, "Daemon shutdown initiated");
 
     // Close CoolerControl session and free resources
     cleanup_coolercontrol_session();
     cleanup_sensor_curl_handle();
 
-    remove_image_file(config->paths_image_coolerdash);
     running = 0;
     log_message(LOG_INFO, "CoolerDash shutdown complete");
 }
@@ -789,6 +771,11 @@ int main(int argc, char **argv)
     log_message(LOG_STATUS, "CoolerDash initializing device cache...\n");
     initialize_device_info(&config);
 
+    // Render initial image immediately so the PNG exists on disk
+    // before CC applies saved LCD settings (avoids startup race condition)
+    log_message(LOG_INFO, "Rendering initial display image...");
+    draw_display_image(&config);
+
     /* CC4: Register shutdown.png once at startup so CoolerControl displays
      * it natively when the CC daemon stops (MR !417 / CC 4.0). */
     if (config.paths_image_shutdown[0])
diff --git a/src/srv/cc_main.c b/src/srv/cc_main.c
index 9db004c..e28cab8 100644
--- a/src/srv/cc_main.c
+++ b/src/srv/cc_main.c
@@ -18,6 +18,7 @@
 // Include necessary headers
 // cppcheck-suppress-begin missingIncludeSystem
 #include <curl/curl.h>
+#include <jansson.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
@@ -480,9 +481,10 @@ static int check_upload_response(CURLcode res, long http_response_code,
 }
 
 /**
- * @brief Sends an image to the LCD display.
- * @details This function uploads an image to the LCD display using a multipart
- * HTTP PUT request.
+ * @brief Sends an image path to the LCD display via JSON settings endpoint.
+ * @details Instead of uploading the full image binary via multipart, this sends
+ * the file path to CoolerControl which reads the image directly from disk.
+ * Uses PUT /devices/{uid}/settings/lcd/lcd with LcdSettings JSON body.
  */
 int send_image_to_lcd(const Config *config, const char *image_path,
                       const char *device_uid)
@@ -491,24 +493,60 @@ int send_image_to_lcd(const Config *config, const char *image_path,
         return 0;
 
     char upload_url[CC_URL_SIZE];
-    snprintf(upload_url, sizeof(upload_url),
-             "%s/devices/%s/settings/lcd/lcd/images?log=false",
-             config->daemon_address, device_uid);
+    int written = snprintf(upload_url, sizeof(upload_url),
+                           "%s/devices/%s/settings/lcd/lcd",
+                           config->daemon_address, device_uid);
+    if (!validate_snprintf(written, sizeof(upload_url), upload_url))
+    {
+        log_message(LOG_ERROR, "LCD settings URL truncated");
+        return 0;
+    }
 
-    curl_mime *form = build_lcd_upload_form(config, image_path);
-    if (!form)
+    // Build JSON body: LcdSettings with image_file_processed path
+    json_t *body = json_object();
+    if (!body)
+    {
+        log_message(LOG_ERROR, "Failed to create JSON object for LCD settings");
+        return 0;
+    }
+
+    json_object_set_new(body, "mode", json_string("image"));
+    json_object_set_new(body, "image_file_processed", json_string(image_path));
+    json_object_set_new(body, "brightness", json_integer(config->lcd_brightness));
+    json_object_set_new(body, "orientation", json_integer(config->lcd_orientation));
+    json_object_set_new(body, "colors", json_array());
+
+    char *json_str = json_dumps(body, JSON_COMPACT);
+    json_decref(body);
+    if (!json_str)
+    {
+        log_message(LOG_ERROR, "Failed to serialize LCD settings JSON");
         return 0;
+    }
 
     http_response response = {0};
     if (!cc_init_response_buffer(&response, 4096))
     {
         log_message(LOG_ERROR, "Failed to initialize response buffer");
-        curl_mime_free(form);
+        free(json_str);
         return 0;
     }
 
-    struct curl_slist *headers =
-        configure_lcd_upload_curl(config, upload_url, form, &response);
+    // Configure CURL for JSON PUT request
+    curl_easy_setopt(cc_session.curl_handle, CURLOPT_URL, upload_url);
+    curl_easy_setopt(cc_session.curl_handle, CURLOPT_CUSTOMREQUEST, "PUT");
+    curl_easy_setopt(cc_session.curl_handle, CURLOPT_POSTFIELDS, json_str);
+    curl_easy_setopt(
+        cc_session.curl_handle, CURLOPT_WRITEFUNCTION,
+        (size_t (*)(const void *, size_t, size_t, void *))write_callback);
+    curl_easy_setopt(cc_session.curl_handle, CURLOPT_WRITEDATA, &response);
+
+    struct curl_slist *headers = NULL;
+    headers = curl_slist_append(headers, "Content-Type: application/json");
+    headers = curl_slist_append(headers, "User-Agent: CoolerDash/1.0");
+    headers = curl_slist_append(headers, "Accept: application/json");
+    headers = curl_slist_append(headers, cc_session.access_token);
+    curl_easy_setopt(cc_session.curl_handle, CURLOPT_HTTPHEADER, headers);
 
     CURLcode res = curl_easy_perform(cc_session.curl_handle);
     long http_response_code = -1;
@@ -517,11 +555,18 @@ int send_image_to_lcd(const Config *config, const char *image_path,
 
     int success = check_upload_response(res, http_response_code, &response);
 
+    // Cleanup
     cc_cleanup_response_buffer(&response);
     if (headers)
         curl_slist_free_all(headers);
-    curl_mime_free(form);
-    cleanup_lcd_upload_curl();
+    free(json_str);
+
+    // Reset CURL options
+    curl_easy_setopt(cc_session.curl_handle, CURLOPT_POSTFIELDS, NULL);
+    curl_easy_setopt(cc_session.curl_handle, CURLOPT_CUSTOMREQUEST, NULL);
+    curl_easy_setopt(cc_session.curl_handle, CURLOPT_WRITEFUNCTION, NULL);
+    curl_easy_setopt(cc_session.curl_handle, CURLOPT_WRITEDATA, NULL);
+    curl_easy_setopt(cc_session.curl_handle, CURLOPT_HTTPHEADER, NULL);
 
     return success;
 }
diff --git a/src/srv/cc_main.h b/src/srv/cc_main.h
index f2301da..6fae4af 100644
--- a/src/srv/cc_main.h
+++ b/src/srv/cc_main.h
@@ -103,9 +103,10 @@ void reset_coolercontrol_session(void);
 const char *get_session_access_token(void);
 
 /**
- * @brief Sends an image directly to the LCD of the CoolerControl device.
- * @details Uploads an image to the LCD display using a multipart HTTP PUT
- * request with brightness and orientation settings.
+ * @brief Sends an image path to the LCD via JSON settings endpoint.
+ * @details Uses PUT /devices/{uid}/settings/lcd/lcd with LcdSettings JSON body
+ * containing image_file_processed path. CoolerControl reads the image directly
+ * from disk instead of receiving full binary data over HTTP.
  */
 int send_image_to_lcd(const struct Config *config, const char *image_path,
                       const char *device_uid);

From fc770c9b8c8a14de535d753151a76654b8cae205 Mon Sep 17 00:00:00 2001
From: damachin3 <damachin3@proton.me>
Date: Fri, 10 Apr 2026 12:56:08 +0200
Subject: [PATCH 08/10] ci: update gitlab/release workflow to v4

---
 .github/workflows/gitlab.yml  |  2 +-
 .github/workflows/release.yml | 12 ++++++------
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/gitlab.yml b/.github/workflows/gitlab.yml
index b67efe8..1549773 100644
--- a/.github/workflows/gitlab.yml
+++ b/.github/workflows/gitlab.yml
@@ -17,7 +17,7 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11  # v4.1.1
+      uses: actions/checkout@v4
       with:
         fetch-depth: 0  # Fetch complete history for proper sync
 
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 0430c21..6704742 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -25,7 +25,7 @@ jobs:
       commit_sha: ${{ steps.commit.outputs.sha }}
     steps:
       - name: Checkout code
-        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
@@ -178,7 +178,7 @@ jobs:
             git
 
       - name: Checkout code
-        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11
+        uses: actions/checkout@v4
         with:
           ref: master
           fetch-depth: 0
@@ -259,7 +259,7 @@ jobs:
     if: github.ref == 'refs/heads/master'
     steps:
       - name: Checkout code
-        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
@@ -308,7 +308,7 @@ jobs:
           git push origin "$TAG"
 
       - name: Create GitHub Release
-        uses: softprops/action-gh-release@de2c0eb89ae2a093876385947365aca7b0e5f844
+        uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ needs.prepare-version.outputs.tag }}
           name: ${{ needs.prepare-version.outputs.release_msg }}
@@ -445,7 +445,7 @@ jobs:
           ls -lh SHA256SUMS*
 
       - name: Upload packages to release
-        uses: softprops/action-gh-release@de2c0eb89ae2a093876385947365aca7b0e5f844
+        uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ needs.prepare-version.outputs.tag }}
           files: |
@@ -466,7 +466,7 @@ jobs:
     if: github.ref == 'refs/heads/master'
     steps:
       - name: Checkout main repository
-        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 

From 5bb76c27b7cdd8ffafbc0dd0e3dbc83b1d57cd38 Mon Sep 17 00:00:00 2001
From: damachin3 <damachin3@proton.me>
Date: Fri, 10 Apr 2026 16:19:06 +0200
Subject: [PATCH 09/10] docs: rewrite documentation

---
 docs/config-guide.md                          |  244 +--
 docs/coolercontrol-api.md                     | 1560 ++---------------
 docs/developer-guide.md                       | 1294 +-------------
 docs/devices.md                               |   31 +-
 docs/display-detection.md                     |  361 +---
 docs/display-modes.md                         |  836 +--------
 docs/plugin-integration.md                    |  156 +-
 docs/plugin-ui-theming.md                     |  193 +-
 .../plugins/coolerdash/config.json            |    6 +-
 .../plugins/coolerdash/ui/index.html          |   20 +-
 man/coolerdash.1                              |  474 +----
 src/device/config.c                           |    6 +-
 src/main.c                                    |    7 +-
 13 files changed, 574 insertions(+), 4614 deletions(-)

diff --git a/docs/config-guide.md b/docs/config-guide.md
index 7969f39..aa09171 100644
--- a/docs/config-guide.md
+++ b/docs/config-guide.md
@@ -1,25 +1,15 @@
 # CoolerDash Configuration Guide
 
-Complete guide for configuring CoolerDash through the `config.json` file.
+Config file: `/etc/coolercontrol/plugins/coolerdash/config.json`
 
-## Configuration File Location
-
-```
-/etc/coolercontrol/plugins/coolerdash/config.json
-```
-
-## Applying Changes
-
-Restaring CoolerControl reloads the plugin and picks up config changes:
+Restart to apply changes:
 ```bash
 sudo systemctl restart coolercontrold
 ```
 
 ---
 
-## Daemon Settings
-
-Connection to the CoolerControl daemon.
+## Daemon
 
 ```json
 "daemon": {
@@ -30,18 +20,13 @@ Connection to the CoolerControl daemon.
 
 | Key | Default | Description |
 |-----|---------|-------------|
-| `address` | `http://localhost:11987` | API endpoint |
-| `access_token` | `""` | Bearer token from CoolerControl UI → Access Protection. Format: `cc_<uuid>`. Required for authenticated API access. |
-
-Generate a token in CoolerControl UI under **Access Protection** and paste it into `access_token`.
+| `address` | `http://localhost:11987` | CoolerControl API endpoint |
+| `access_token` | `""` | Bearer token (`cc_<uuid>`) from CoolerControl UI > Access Protection |
 
 ---
 
-## File Paths
+## Paths
 
-System file and directory locations.
-
-### Example
 ```json
 "paths": {
     "images": "/etc/coolercontrol/plugins/coolerdash",
@@ -50,140 +35,52 @@ System file and directory locations.
 }
 ```
 
-### Settings
-- **`images`**: Directory for generated display images
-- **`image_coolerdash`**: Generated display image path
-- **`image_shutdown`**: Image displayed on daemon shutdown
+| Key | Description |
+|-----|-------------|
+| `images` | Directory for generated images |
+| `image_coolerdash` | Generated display image path |
+| `image_shutdown` | Image shown on daemon shutdown |
 
 ---
 
-## 🖥️ Display Settings
-
-LCD display configuration tested with NZXT Kraken 2023.
+## Display
 
-### Basic Configuration
 ```json
 "display": {
     "mode": "dual",
     "width": 0,
     "height": 0,
-    "refresh_interval": 2.5,
+    "refresh_interval": 3.5,
     "brightness": 80,
     "orientation": 0,
     "shape": "auto",
-    "circle_switch_interval": 5,
+    "circle_switch_interval": 8,
     "content_scale_factor": 0.98,
-    "inscribe_factor": 0.70710678
+    "inscribe_factor": 0.70710678,
+    "sensor_slot_1": "cpu",
+    "sensor_slot_2": "liquid",
+    "sensor_slot_3": "gpu"
 }
 ```
 
-> `width`/`height` set to `0` means CoolerDash queries the actual device dimensions from the API at startup.
-
-### Settings
-- **`mode`**: Display mode: `dual` (default) or `circle`
-- **`width`** / **`height`**: Screen dimensions in pixels; `0` = auto-detect from API
-- **`refresh_interval`**: Update interval in seconds (0.01–60.0, default: `2.5`)
-- **`brightness`**: LCD brightness 0–100% (default: `80`)
-- **`orientation`**: Screen rotation: `0`, `90`, `180`, `270` degrees
-- **`shape`**: Display shape: `auto` (default), `rectangular`, or `circular`
-- **`circle_switch_interval`**: Slot switch interval for circle mode in seconds (1–60, default: `5`)
-- **`content_scale_factor`**: Safe area percentage (0.5–1.0, default: `0.98`)
-- **`inscribe_factor`**: Inscribe factor for circular displays (default: `0.70710678` = 1/√2)
-- **`sensor_slot_1`**: Sensor for slot 1: `cpu`, `gpu`, or `liquid` (default: `cpu`)
-- **`sensor_slot_2`**: Sensor for slot 2 (default: `liquid`)
-- **`sensor_slot_3`**: Sensor for slot 3 (default: `gpu`)
-
-Sensor slots control which sensor appears in each display position for both dual and circle mode.
-
-### Brightness Examples
-```json
-"brightness": 40,   // dim for night use
-"brightness": 80,   // recommended default
-"brightness": 100   // maximum
-```
-
-### Refresh Rate Examples
-```json
-"refresh_interval": 1.0,  // fast
-"refresh_interval": 2.5,  // default
-"refresh_interval": 5.0   // power-saving
-```
-
-### Display Shape Override
-
-The `shape` parameter allows manual control of the **inscribe factor** used for layout calculations:
-
-- **`auto`** (default): Automatic detection based on device database
-- **`rectangular`**: Force inscribe factor = 1.0 (use full display width)
-- **`circular`**: Force inscribe factor = 0.7071 (inscribed square for round displays)
-
-**When to use:**
-- Testing different layouts on your display
-- Troubleshooting clipping issues on circular displays
-- Overriding auto-detection if it's incorrect for your device
-
-**Examples:**
-```json
-"shape": "auto"        // recommended
-"shape": "rectangular" // full width, inscribe_factor = 1.0
-"shape": "circular"    // inscribed square, inscribe_factor = 0.7071
-```
-
-**Priority:** `shape` config > auto-detection
-
-**Note:** See [Display Detection Guide](display-detection.md) for technical details about inscribe factors.
-
-#### Circle Mode Sensor Switching
-
-**Parameter:** `circle_switch_interval`
-
-Controls how frequently the circle mode rotates between available sensors:
-
-- **Range:** 1-60 seconds
-- **Default:** 5 seconds
-- **Applies to:** Circle mode only
-
-**Example:**
-```json
-"mode": "circle",
-"circle_switch_interval": 10
-```
-
-**Use Cases:**
-- **Fast switching (1-3s):** Quick overview of all sensors
-- **Moderate (5-8s):** Default balanced viewing
-- **Slow switching (10-60s):** Focus on individual sensors longer
-
-#### Content Scale Factor
-
-**Parameter:** `content_scale_factor`
-
-Controls the safe area percentage used for rendering content (determines margin/padding):
-
-- **Range:** 0.5-1.0 (50%-100%)
-- **Default:** 0.98 (98% = 2% margin)
-- **Applies to:** Both dual and circle modes
-
-**Example:**
-```json
-"content_scale_factor": 0.95
-```
-
-**Use Cases:**
-- **0.98-1.0:** Minimal margins, maximum screen usage
-- **0.90-0.97:** Comfortable padding, safe for text rendering
-- **0.70-0.89:** Extra margins, conservative layout
-- **0.5-0.69:** Large margins, centered content focus
-
-**Visual Impact:**
-- Higher values (0.95-1.0) = content fills more screen area, less padding
-- Lower values (0.5-0.8) = more white space around content, safer margins
+| Key | Default | Description |
+|-----|---------|-------------|
+| `mode` | `dual` | `dual` or `circle` |
+| `width` / `height` | `0` | Pixels. `0` = auto-detect from API |
+| `refresh_interval` | `3.5` | Update interval in seconds (0.01–60.0) |
+| `brightness` | `80` | LCD brightness 0–100% |
+| `orientation` | `0` | Rotation: `0`, `90`, `180`, `270` |
+| `shape` | `auto` | `auto`, `rectangular`, `circular` |
+| `circle_switch_interval` | `8` | Sensor rotation interval in circle mode (1–60s) |
+| `content_scale_factor` | `0.98` | Safe area percentage (0.5–1.0) |
+| `inscribe_factor` | `0.70710678` | Inscribe factor for circular displays (1/√2) |
+| `sensor_slot_1/2/3` | `cpu`/`liquid`/`gpu` | Sensor assignment per slot |
+
+`shape` overrides auto-detection. Priority: `shape` config > auto-detection.
 
 ---
 
-## Visual Layout
-
-All values are in pixels unless noted. Positions are calculated dynamically from display dimensions.
+## Layout
 
 ```json
 "layout": {
@@ -202,20 +99,20 @@ All values are in pixels unless noted. Positions are calculated dynamically from
 
 | Key | Default | Description |
 |-----|---------|-------------|
-| `bar_height` | `24` | Bar height in pixels |
-| `bar_width` | `98` | Bar width in % of display width |
-| `bar_gap` | `12` | Gap between bars in pixels |
-| `bar_border` | `1.0` | Border thickness in pixels |
-| `bar_border_enabled` | `1` | Enable bar border (`1`/`0`) |
+| `bar_height` | `24` | Bar height (px) |
+| `bar_width` | `98` | Bar width (% of display width) |
+| `bar_gap` | `12` | Gap between bars (px) |
+| `bar_border` | `1.0` | Border thickness (px) |
+| `bar_border_enabled` | `1` | Border on/off (`1`/`0`) |
 | `label_margin_left` | `1` | Left label margin multiplier |
-| `label_margin_bar` | `1` | Margin between label and bar |
-| `bar_height_1/2/3` | `0` | Per-slot bar height override. `0` = use `bar_height` |
+| `label_margin_bar` | `1` | Label-to-bar margin multiplier |
+| `bar_height_1/2/3` | `0` | Per-slot height override. `0` = use `bar_height` |
 
 ---
 
 ## Colors
 
-RGB color values (0–255).
+RGB values (0–255):
 
 ```json
 "colors": {
@@ -228,26 +125,28 @@ RGB color values (0–255).
 
 ---
 
-## Font Settings
+## Font
 
 ```json
 "font": {
     "face": "Roboto Black",
     "size_temp": 0,
-    "size_labels": 0
+    "size_labels": 0,
+    "font_growth_factor": 1.33
 }
 ```
 
-- **`face`**: Font family name (must be installed, default: `Roboto Black`)
-- **`size_temp`** / **`size_labels`**: Font size in points. `0` = auto-scale based on display resolution
-  - 240×240: ~100pt temp / ~30pt labels
-  - Formula: `100.0 × (width + height) / (2 × 240.0)`
+| Key | Default | Description |
+|-----|---------|-------------|
+| `face` | `Roboto Black` | Font family (must be installed) |
+| `size_temp` / `size_labels` | `0` | Font size (pt). `0` = auto-scale from resolution |
+| `font_growth_factor` | `1.33` | Scaling multiplier for auto-sized fonts |
 
 ---
 
 ## Temperature Zones
 
-Four color zones based on temperature thresholds. Configured per-sensor in the `sensors` section.
+Four color zones per sensor. Bars transition through colors as temperature rises.
 
 ```json
 "sensors": {
@@ -259,39 +158,36 @@ Four color zones based on temperature thresholds. Configured per-sensor in the `
         "threshold_1_color": { "r": 0,   "g": 255, "b": 0 },
         "threshold_2_color": { "r": 255, "g": 140, "b": 0 },
         "threshold_3_color": { "r": 255, "g": 70,  "b": 0 },
-        "threshold_4_color": { "r": 255, "g": 0,   "b": 0 }
-    },
-    "gpu": { ... }
+        "threshold_4_color": { "r": 255, "g": 0,   "b": 0 },
+        "offset_x": 0,
+        "offset_y": 0
+    }
 }
 ```
 
-`max_scale` sets the temperature at 100% bar fill. Bars transition through 4 color zones as temperature rises through the thresholds.
+`max_scale` = temperature at 100% bar fill. Same structure for `gpu` and `liquid`.
 
 ---
 
-## Complete Example
+## Positioning
 
-See the default config at `/etc/coolercontrol/plugins/coolerdash/config.json` for a full reference. The file is installed with all options and their defaults.
+```json
+"positioning": {
+    "degree_spacing": 16,
+    "label_offset_x": 0,
+    "label_offset_y": 0,
+    "margin_top": 0,
+    "margin_bottom": 0
+}
+```
 
 ---
 
 ## Troubleshooting
 
-1. **Display not updating**: Check `refresh_interval` and restart CoolerControl
-2. **Wrong colors**: Verify RGB values are 0–255
-3. **Text clipped on circular display**: Adjust `inscribe_factor` and `content_scale_factor`
-4. **Bars too wide**: Lower `bar_width` value
-
-### Backup
+- **Display not updating**: Check `refresh_interval`, restart CoolerControl
+- **Wrong colors**: RGB values must be 0–255
+- **Text clipped**: Adjust `inscribe_factor` and `content_scale_factor`
+- **Bars too wide**: Lower `bar_width`
 
-```bash
-sudo cp /etc/coolercontrol/plugins/coolerdash/config.json \
-        /etc/coolercontrol/plugins/coolerdash/config.json.backup
-```
-
-## Developer: Scaling Unit Test
-
-```bash
-gcc -std=c99 -Iinclude -I./src -o build/test_scaling tests/test_scaling.c -lm
-./build/test_scaling
-```
+Full default config: `/etc/coolercontrol/plugins/coolerdash/config.json`
diff --git a/docs/coolercontrol-api.md b/docs/coolercontrol-api.md
index 25b4cdb..3072cac 100644
--- a/docs/coolercontrol-api.md
+++ b/docs/coolercontrol-api.md
@@ -1,152 +1,49 @@
-# CoolerControl API Integration - Developer Guide
+# CoolerControl API Integration
 
-## Table of Contents
-- [Overview](#overview)
-- [Architecture](#architecture)
-- [Module cc_main](#module-cc_main)
-- [Module cc_conf](#module-cc_conf)
-- [Module cc_sensor](#module-cc_sensor)
-- [API Communication Flow](#api-communication-flow)
-- [Data Structures](#data-structures)
-- [Error Handling](#error-handling)
-- [Best Practices](#best-practices)
-- [Troubleshooting](#troubleshooting)
+## Modules
 
----
-
-## Overview
-
-The CoolerControl API integration consists of three core modules that handle all communication with the CoolerControl daemon's REST API:
-
-- **cc_main.c/h**: Session management, authentication, and LCD image upload
-- **cc_conf.c/h**: Device caching, display detection, and configuration utilities
-- **cc_sensor.c/h**: Temperature data retrieval from CPU and GPU sensors
-
-### Purpose
-
-CoolerDash acts as a specialized LCD client for CoolerControl, fetching temperature data and uploading rendered images to CoolerControl-managed devices with LCD displays.
-
-### API Endpoints Used
+| Module | File | Purpose |
+|--------|------|---------|
+| cc_main | `src/srv/cc_main.c/h` | Session management, auth, LCD upload |
+| cc_conf | `src/srv/cc_conf.c/h` | Device cache, display detection |
+| cc_sensor | `src/srv/cc_sensor.c/h` | Temperature retrieval |
 
-```
-GET    /devices                                      - Device enumeration
-POST   /status                                       - Temperature sensor data
-PUT    /devices/{uid}/settings/lcd/lcd/images        - LCD image upload
-PUT    /devices/{uid}/settings/lcd/lcd/shutdown-image - Shutdown image registration (CC4 only)
-```
+## API Endpoints
 
-### Dependencies
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/devices` | GET | Device enumeration (once at startup) |
+| `/status` | POST | Temperature sensor data |
+| `/devices/{uid}/settings/lcd/lcd/images` | PUT | LCD image upload |
+| `/devices/{uid}/settings/lcd/lcd/shutdown-image` | PUT | Shutdown image registration (CC4) |
 
-- **libcurl**: HTTP client for REST API communication
-- **jansson**: JSON parsing and generation
-- **CoolerControl Daemon**: Must be running and accessible (default: `http://127.0.0.1:11987`)
+Base URL: `http://localhost:11987` (configurable)
+Auth: `Authorization: Bearer cc_<uuid>`
 
 ---
 
-## Architecture
+## Session Lifecycle
 
-### Module Relationships
-
-```
-┌─────────────────────────────────────────────────────────┐
-│                      main.c                             │
-│                  (Main Event Loop)                      │
-└──────────────────┬──────────────────────────────────────┘
-                   │
-                   │ Initialization & Data Retrieval
-                   │
-       ┌───────────┴───────────┬──────────────────────────┐
-       │                       │                          │
-┌──────▼──────┐       ┌───────▼────────┐       ┌────────▼────────┐
-│  cc_main.c  │       │   cc_conf.c    │       │  cc_sensor.c    │
-│  Session    │◄──────┤   Device       │       │  Temperature    │
-│  Auth       │       │   Cache        │       │  Data           │
-│  Upload     │       │   Detection    │       │  Retrieval      │
-└─────────────┘       └────────────────┘       └─────────────────┘
-       │                       │                          │
-       │                       │                          │
-       └───────────────────────┴──────────────────────────┘
-                               │
-                               │ libcurl + jansson
-                               │
-                    ┌──────────▼───────────┐
-                    │  CoolerControl       │
-                    │  Daemon (REST API)   │
-                    └──────────────────────┘
 ```
+1. init_coolercontrol_session()
+   - curl_global_init() + curl_easy_init()
+   - Build "Authorization: Bearer cc_<uuid>" header
+   - session_initialized = 1
 
-### Initialization Sequence
-
-```c
-// 1. Configuration loading (config.c)
-Config config = {0};
-load_plugin_config(&config, CONFIG_PATH);
-
-// 2. CoolerControl session initialization
-init_coolercontrol_session(&config);
+2. Main loop (reuse session)
+   - get_temperature_data()  → POST /status
+   - send_image_to_lcd()     → PUT /devices/{uid}/.../images
 
-// 3. Device cache initialization
-init_device_cache(&config);
-
-// 4. Update config with device dimensions (if needed)
-update_config_from_device(&config);
-
-// 5. Main loop: fetch data → render → upload
-while (running) {
-    get_temperature_monitor_data(&config, &data);
-    draw_display_image(&config);  // Dispatches to dual or circle mode
-    // send_image_to_lcd() called internally
-    sleep(update_interval);
-}
-
-// 6. Cleanup
-cleanup_coolercontrol_session();
+3. cleanup_coolercontrol_session()
+   - curl_easy_cleanup() + curl_global_cleanup()
+   - session_initialized = 0
 ```
 
 ---
 
-## Module cc_main
-
-### Purpose
-Handles HTTP session management, authentication, and LCD image upload via multipart PUT requests.
-
-### File: `src/srv/cc_main.c` (600 lines)
-
-### Key Components
-
-#### 1. HTTP Response Buffer
-
-**Purpose**: Dynamic memory management for HTTP responses
-
-```c
-typedef struct http_response {
-    char *data;
-    size_t size;
-    size_t capacity;
-} http_response;
-```
-
-**Functions**:
-- `cc_init_response_buffer()`: Allocate with initial capacity (default: 4096-8192 bytes)
-- `cc_cleanup_response_buffer()`: Free memory and reset state
-- `reallocate_response_buffer()`: Exponential growth (1.5x or exact fit)
-
-**Growth Strategy**:
-```c
-new_capacity = max(required_size, capacity * 3/2)
-```
-
-**Usage Pattern**:
-```c
-http_response response = {0};
-cc_init_response_buffer(&response, 8192);
-// ... use response ...
-cc_cleanup_response_buffer(&response);
-```
-
-#### 2. Session State
+## cc_main — Session & Upload
 
-**Purpose**: Maintain persistent CURL session with Bearer-token authentication
+### Session State
 
 ```c
 typedef struct {
@@ -154,260 +51,55 @@ typedef struct {
     char access_token[CC_BEARER_HEADER_SIZE];
     int session_initialized;
 } CoolerControlSession;
-
-static CoolerControlSession cc_session = {
-    .curl_handle = NULL,
-    .access_token = {0},
-    .session_initialized = 0
-};
 ```
 
-#### 3. Authentication Flow
-
-**Function**: `init_coolercontrol_session(const Config *config)`
+### Public API
 
-CoolerDash uses one authentication mode only:
+| Function | Purpose |
+|----------|---------|
+| `init_coolercontrol_session(config)` | Init CURL + Bearer header |
+| `is_session_initialized()` | Check session state |
+| `cleanup_coolercontrol_session()` | Free CURL resources |
+| `send_image_to_lcd(config, image_path, device_uid)` | Upload PNG via multipart PUT |
 
-- `access_token` must be set in config
-- All requests use `Authorization: Bearer cc_<uuid>`
-- Token is generated in CoolerControl UI under **Access Protection**
-- No legacy login or session fallback is used
+### LCD Upload
 
----
-
-#### 4. Shutdown Image Registration (CC4)
-
-**Function**: `register_shutdown_image_with_cc(const Config *config, const char *image_path, const char *device_uid)`
-
-Called **once at startup** after device initialization. Registers `shutdown.png` with CC4:
-
-- Endpoint: `PUT {address}/devices/{uid}/settings/lcd/lcd/shutdown-image`
-- Same multipart form as live image upload
-- CC4 stores image server-side; displays it when CoolerControl stops
-- Returns gracefully on 404 when the endpoint is unavailable
-
-**Implementation**:
-```c
-int init_coolercontrol_session(const Config *config)
-{
-    if (!config || config->access_token[0] == '\0')
-        return 0;
-
-    curl_global_init(CURL_GLOBAL_DEFAULT);
-    cc_session.curl_handle = curl_easy_init();
-
-    snprintf(cc_session.access_token, sizeof(cc_session.access_token),
-             "Authorization: Bearer %s", config->access_token);
-    cc_session.session_initialized = 1;
-    return 1;
-}
 ```
+PUT {address}/devices/{uid}/settings/lcd/lcd/images?log=false
+Content-Type: multipart/form-data
 
-**Security Notes**:
-- Bearer token is attached explicitly to every authenticated request
-- No fallback authentication path exists
-
-#### 4. LCD Image Upload
-
-**Function**: `send_image_to_lcd(const Config *config, const char *image_path, const char *device_uid)`
-
-**Purpose**: Upload rendered PNG to device LCD via multipart PUT request
-
-**URL Format**:
-```
-PUT {daemon_address}/devices/{device_uid}/settings/lcd/lcd/images?log=false
-```
-
-**Multipart Form Fields**:
-- `mode`: "image" (static image mode)
-- `brightness`: Integer 0-100 (from config)
-- `orientation`: Integer 0-270 (from config)
-- `images[]`: PNG file (Content-Type: image/png)
-
-**Implementation**:
-```c
-int send_image_to_lcd(const Config *config, const char *image_path, const char *device_uid)
-{
-    // 1. Validate parameters
-    if (!cc_session.curl_handle || !image_path || !device_uid || !cc_session.session_initialized) {
-        return 0;
-    }
-    
-    // 2. Build URL
-    char upload_url[CC_URL_SIZE];
-    snprintf(upload_url, sizeof(upload_url), 
-             "%s/devices/%s/settings/lcd/lcd/images?log=false",
-             config->daemon_address, device_uid);
-    
-    // 3. Build multipart form
-    curl_mime *form = curl_mime_init(cc_session.curl_handle);
-    
-    // Add mode field
-    curl_mimepart *field = curl_mime_addpart(form);
-    curl_mime_name(field, "mode");
-    curl_mime_data(field, "image", CURL_ZERO_TERMINATED);
-    
-    // Add brightness field
-    char brightness_str[8];
-    snprintf(brightness_str, sizeof(brightness_str), "%d", config->lcd_brightness);
-    field = curl_mime_addpart(form);
-    curl_mime_name(field, "brightness");
-    curl_mime_data(field, brightness_str, CURL_ZERO_TERMINATED);
-    
-    // Add orientation field
-    char orientation_str[8];
-    snprintf(orientation_str, sizeof(orientation_str), "%d", config->lcd_orientation);
-    field = curl_mime_addpart(form);
-    curl_mime_name(field, "orientation");
-    curl_mime_data(field, orientation_str, CURL_ZERO_TERMINATED);
-    
-    // Add image file
-    field = curl_mime_addpart(form);
-    curl_mime_name(field, "images[]");
-    curl_mime_filedata(field, image_path);
-    curl_mime_type(field, "image/png");
-    
-    // 4. Configure CURL
-    curl_easy_setopt(cc_session.curl_handle, CURLOPT_URL, upload_url);
-    curl_easy_setopt(cc_session.curl_handle, CURLOPT_MIMEPOST, form);
-    curl_easy_setopt(cc_session.curl_handle, CURLOPT_CUSTOMREQUEST, "PUT");
-    
-    // 5. Send request
-    CURLcode res = curl_easy_perform(cc_session.curl_handle);
-    long http_response_code = -1;
-    curl_easy_getinfo(cc_session.curl_handle, CURLINFO_RESPONSE_CODE, &http_response_code);
-    
-    // 6. Cleanup
-    curl_mime_free(form);
-    
-    // 7. Check result
-    return (res == CURLE_OK && http_response_code == 200);
-}
+Fields:
+  mode: "image"
+  brightness: "80"
+  orientation: "0"
+  images[]: <PNG file>
 ```
 
-**Helper Functions**:
-- `build_lcd_upload_form()`: Construct multipart form
-- `add_mime_field()`: Add string field with error checking
-- `add_image_file_field()`: Add PNG file with MIME type
-- `configure_lcd_upload_curl()`: Set CURL options
-- `cleanup_lcd_upload_curl()`: Reset CURL state
-
-**Error Handling**:
-- Validates session initialization
-- Checks file existence (via `curl_mime_filedata()`)
-- Logs CURL errors and HTTP codes
-- Returns 0 on failure, 1 on success
-
-#### 5. Session Cleanup
-
-**Function**: `cleanup_coolercontrol_session(void)`
-
-**Purpose**: Clean shutdown with resource deallocation
-
-**Steps**:
-1. Cleanup CURL easy handle
-2. Cleanup libcurl global state
-3. Mark session as uninitialized
-4. Clear the cached Bearer header
-5. Set cleanup flag to prevent double-cleanup
+### Shutdown Image (CC4)
 
-**Implementation**:
-```c
-void cleanup_coolercontrol_session(void)
-{
-    static int cleanup_done = 0;
-    if (cleanup_done)
-        return;
-    
-    // Cleanup CURL handle
-    if (cc_session.curl_handle) {
-        curl_easy_cleanup(cc_session.curl_handle);
-        cc_session.curl_handle = NULL;
-    }
-    
-    // Global CURL cleanup
-    curl_global_cleanup();
+Called once at startup. CC4 stores it server-side and displays it when CoolerControl stops.
 
-    // Mark as uninitialized
-    cc_session.session_initialized = 0;
-    cc_session.access_token[0] = '\0';
-    cleanup_done = 1;
-}
+```
+PUT {address}/devices/{uid}/settings/lcd/lcd/shutdown-image
 ```
 
-**Called By**: `main()` via `atexit()` or signal handler
-
-#### 6. CURL Write Callback
-
-**Function**: `write_callback(const void *contents, size_t size, size_t nmemb, http_response *response)`
-
-**Purpose**: Receive HTTP response data from libcurl
-
-**Algorithm**:
-1. Calculate received size: `realsize = size * nmemb`
-2. Check if buffer needs reallocation
-3. If needed, grow buffer exponentially (1.5x or exact)
-4. Copy new data to buffer using `memmove()`
-5. Update size and null-terminate
-6. Return received size (or 0 on error)
-
-**Memory Safety**:
-- Prevents buffer overflow via size checking
-- Exponential growth reduces reallocation frequency
-- Always null-terminates for string safety
-
-### File: `src/srv/cc_main.h`
-
-**Purpose**: Public API declarations for session management
+### HTTP Response Buffer
 
-**Key Definitions**:
 ```c
-// Response buffer
 typedef struct http_response {
     char *data;
     size_t size;
     size_t capacity;
 } http_response;
-
-// Buffer management
-int cc_init_response_buffer(http_response *response, size_t initial_capacity);
-void cc_cleanup_response_buffer(http_response *response);
-
-// Session management
-int init_coolercontrol_session(const struct Config *config);
-int is_session_initialized(void);
-void cleanup_coolercontrol_session(void);
-
-// LCD upload
-int send_image_to_lcd(const struct Config *config, const char *image_path, const char *device_uid);
-
-// CURL callback
-size_t write_callback(const void *contents, size_t size, size_t nmemb, http_response *response);
 ```
 
-**Constants**:
-```c
-#define CC_COOKIE_SIZE 512
-#define CC_UID_SIZE 128
-#define CC_URL_SIZE 512
-#define CC_USERPWD_SIZE 128
-#define CC_MAX_SAFE_ALLOC_SIZE (SIZE_MAX / 2)
-```
+Growth strategy: `new_capacity = max(required_size, capacity * 3/2)`
 
 ---
 
-## Module cc_conf
-
-### Purpose
-Device information caching, circular display detection, and configuration utilities.
-
-### File: `src/srv/cc_conf.c` (488 lines)
+## cc_conf — Device Cache
 
-### Key Components
-
-#### 1. Device Cache
-
-**Purpose**: Store device info once to avoid repeated API calls
+### Cache Structure
 
 ```c
 static struct {
@@ -419,289 +111,53 @@ static struct {
 } device_cache = {0};
 ```
 
-**Rationale**:
-- Device properties don't change during runtime
-- Reduces API overhead (every render cycle)
-- Improves performance and reliability
+Populated once at startup via `GET /devices`. Device properties don't change at runtime.
 
-**Access Function**: `get_cached_lcd_device_data()`
-- Returns cached data if available
-- Initializes cache on first call
-- Thread-safe (single-threaded daemon)
+### Public API
 
-#### 2. Device Detection
+| Function | Purpose |
+|----------|---------|
+| `init_device_cache(config)` | Fetch + cache device info |
+| `get_cached_lcd_device_data(...)` | Read cached UID, name, dimensions |
+| `update_config_from_device(config)` | Set width/height if 0 in config |
+| `is_circular_display_device(name, w, h)` | Detect display shape |
 
-**Function**: `init_device_cache(const Config *config)`
+### Device JSON Structure
 
-**Purpose**: Fetch device list and extract CoolerControl LCD device info
-
-**API Call**:
-```
-GET {daemon_address}/devices
-```
-
-**Response Structure**:
 ```json
 {
-  "devices": [
-    {
-      "uid": "1234-5678-abcd",
-      "name": "NZXT Kraken Elite",
-      "type": "Liquidctl",
-      "info": {
-        "channels": {
-          "lcd": {
-            "lcd_info": {
-              "width": 640,
-              "height": 640
-            }
-          }
+  "devices": [{
+    "uid": "1234-5678-abcd",
+    "name": "NZXT Kraken Elite",
+    "type": "Liquidctl",
+    "info": {
+      "channels": {
+        "lcd": {
+          "lcd_info": { "screen_width": 640, "screen_height": 640 }
         }
       }
     }
-  ]
-}
-```
-
-**Implementation**:
-```c
-int init_device_cache(const Config *config)
-{
-    if (device_cache.initialized)
-        return 1;
-    
-    // Build URL
-    char url[256];
-    snprintf(url, sizeof(url), "%s/devices", config->daemon_address);
-    
-    // Initialize response buffer
-    http_response response = {0};
-    cc_init_response_buffer(&response, 16384);
-    
-    // Send request
-    CURL *curl = curl_easy_init();
-    curl_easy_setopt(curl, CURLOPT_URL, url);
-    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);
-    curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
-    
-    CURLcode res = curl_easy_perform(curl);
-    
-    // Parse JSON response
-    if (res == CURLE_OK) {
-        parse_lcd_device_data(response.data, 
-                            device_cache.device_uid,
-                            sizeof(device_cache.device_uid),
-                            &device_cache.screen_width,
-                            &device_cache.screen_height,
-                            device_cache.device_name,
-                            sizeof(device_cache.device_name));
-        device_cache.initialized = 1;
-    }
-    
-    // Cleanup
-    cc_cleanup_response_buffer(&response);
-    curl_easy_cleanup(curl);
-    
-    return device_cache.initialized;
-}
-```
-
-#### 3. JSON Parsing
-
-**Function**: `parse_lcd_device_data(const char *json, ...)`
-
-**Purpose**: Extract device information from devices JSON response
-
-**Algorithm**:
-1. Parse JSON string with jansson
-2. Get "devices" array
-3. Iterate through devices
-4. Check device type ("Liquidctl")
-5. Extract UID from "uid" field
-6. Extract name from "name" field
-7. Navigate to "info.channels.lcd.lcd_info"
-8. Extract width and height
-9. Return first matching device
-
-**Helper Functions**:
-- `extract_device_type_from_json()`: Get device type string
-- `extract_device_uid()`: Get UID string
-- `extract_device_name()`: Get device name
-- `get_lcd_info_from_device()`: Navigate JSON to lcd_info
-- `extract_lcd_dimensions()`: Get width/height from lcd_info
-- `has_usable_device_uid()`: Verify that the device exposes a usable UID
-
-**Error Handling**:
-- Validates JSON structure at each level
-- Returns 0 if any field is missing
-- Logs errors for debugging
-
-#### 4. Circular Display Detection
-
-**Function**: `is_circular_display_device(const char *device_name, int screen_width, int screen_height)`
-
-**Purpose**: Determine if device has circular LCD display
-
-**Detection Logic**:
-
-```c
-int is_circular_display_device(const char *device_name, int screen_width, int screen_height)
-{
-    if (!device_name)
-        return 0;
-    
-    // NZXT Kraken detection
-    const int is_kraken = (strstr(device_name, "Kraken") != NULL);
-    
-    if (is_kraken) {
-        // Elite models with >240x240 are circular
-        if (screen_width > 240 || screen_height > 240) {
-            return 1;
-        }
-        return 0;  // 240x240 and smaller are rectangular
-    }
-    
-    // Known circular devices list
-    const char *circular_devices[] = {
-        "Corsair iCUE LINK"
-        // Add more models here
-    };
-    
-    for (size_t i = 0; i < num_circular; i++) {
-        if (strstr(device_name, circular_devices[i]) != NULL) {
-            return 1;
-        }
-    }
-    
-    return 0;
-}
-```
-
-**NZXT Kraken Rules**:
-- **240x240**: Rectangular (e.g., Kraken Z53)
-- **>240x240**: Circular (e.g., Kraken Elite 280/360 with 640x640 display)
-
-**Display Shape Override (v1.96+)**:
-
-**Recommended Method:** `display_shape` config parameter (highest priority):
-```ini
-[display]
-shape = auto  # or "rectangular" or "circular"
-```
-
-**Legacy Method:** `force_display_circular` flag (backwards compatibility):
-```ini
-[display]
-force_circular = true
-```
-
-**Priority System:**
-1. `display_shape` config (manual override)
-2. `force_display_circular` flag (legacy)
-3. Automatic device detection (default)
-
-#### 5. Configuration Update
-
-**Function**: `update_config_from_device(Config *config)`
-
-**Purpose**: Update config with device screen dimensions (only if not set in `config.json`)
-
-**Logic**:
-```c
-int update_config_from_device(Config *config)
-{
-    if (!config)
-        return 0;
-    
-    // Only update if config.json values are 0 (auto-detect)
-    if (config->display_width == 0) {
-        config->display_width = device_cache.screen_width;
-        log_message(LOG_INFO, "Updated display width to %d from device", 
-                    device_cache.screen_width);
-    }
-    
-    if (config->display_height == 0) {
-        config->display_height = device_cache.screen_height;
-        log_message(LOG_INFO, "Updated display height to %d from device", 
-                    device_cache.screen_height);
-    }
-    
-    return 1;
+  }]
 }
 ```
 
-**Use Case**: Auto-detect display resolution when user doesn't specify in `config.json`
+### Circular Display Detection
 
-#### 6. Safe String Copy
+- NZXT Kraken ≤240×240 → rectangular
+- NZXT Kraken >240×240 → circular
+- Other devices: check database, default rectangular
 
-**Function**: `cc_safe_strcpy(char *restrict dest, size_t dest_size, const char *restrict src)`
+Override via `config.json`: `"shape": "rectangular"` or `"circular"`
 
-**Purpose**: Bounds-checked string copy with null-termination guarantee
+### cc_safe_strcpy
 
-**Implementation**:
-```c
-int cc_safe_strcpy(char *restrict dest, size_t dest_size, const char *restrict src)
-{
-    if (!dest || !src || dest_size == 0)
-        return -1;
-    
-    for (size_t i = 0; i < dest_size - 1; i++) {
-        dest[i] = src[i];
-        if (src[i] == '\0')
-            return 0;
-    }
-    
-    dest[dest_size - 1] = '\0';
-    return 0;
-}
-```
-
-**Advantages**:
-- Prevents buffer overflow
-- Always null-terminates
-- Simple and portable
-- No dependency on platform-specific functions
-
-### File: `src/srv/cc_conf.h`
-
-**Purpose**: Public API for device caching and detection
-
-**Key Functions**:
-```c
-// Device cache
-int init_device_cache(const struct Config *config);
-int get_cached_lcd_device_data(const struct Config *config, char *device_uid, 
-                       size_t uid_size, char *device_name, size_t name_size, 
-                       int *screen_width, int *screen_height);
-
-// Configuration
-int update_config_from_device(struct Config *config);
-
-// Detection
-int is_circular_display_device(const char *device_name, int screen_width, int screen_height);
-
-// Utilities
-int cc_safe_strcpy(char *restrict dest, size_t dest_size, const char *restrict src);
-const char *extract_device_type_from_json(const json_t *dev);
-```
-
-**Constants**:
-```c
-#define CC_NAME_SIZE 128
-```
+Bounds-checked string copy with guaranteed null-termination. Use instead of `strcpy`/`strncpy`.
 
 ---
 
-## Module cc_sensor
-
-### Purpose
-Retrieve CPU and GPU temperature data from CoolerControl status endpoint.
+## cc_sensor — Temperature
 
-### File: `src/srv/cc_sensor.c` (290 lines)
-
-### Key Components
-
-#### 1. Temperature Data Structure
+### Data Structure
 
 ```c
 typedef struct {
@@ -710,856 +166,60 @@ typedef struct {
 } monitor_sensor_data_t;
 ```
 
-**Usage**:
-```c
-monitor_sensor_data_t data = {0};
-get_temperature_monitor_data(&config, &data);
-printf("CPU: %.1f°C, GPU: %.1f°C\n", data.temp_cpu, data.temp_gpu);
-```
-
-#### 2. Temperature Retrieval
-
-**Function**: `get_temperature_monitor_data(const Config *config, monitor_sensor_data_t *data)`
-
-**Purpose**: High-level API to fetch temperature data
+### API Request
 
-**Implementation**:
-```c
-int get_temperature_monitor_data(const Config *config, monitor_sensor_data_t *data)
-{
-    if (!config || !data)
-        return 0;
-    
-    return get_temperature_data(config, &data->temp_cpu, &data->temp_gpu);
-}
 ```
-
-**Internal Flow**: Delegates to `get_temperature_data()`
-
-#### 3. Status API Request
-
-**Function**: `get_temperature_data(const Config *config, float *temp_cpu, float *temp_gpu)`
-
-**API Call**:
-```
-POST {daemon_address}/status
+POST {address}/status
 Content-Type: application/json
 
-{
-  "all": false,
-  "since": "1970-01-01T00:00:00.000Z"
-}
+{"all": false, "since": "1970-01-01T00:00:00.000Z"}
 ```
 
-**Response Structure**:
-```json
-{
-  "devices": [
-    {
-      "type": "CPU",
-      "status_history": [
-        {
-          "temps": [
-            {
-              "name": "temp1",
-              "temp": 45.0
-            }
-          ]
-        }
-      ]
-    },
-    {
-      "type": "GPU",
-      "status_history": [
-        {
-          "temps": [
-            {
-              "name": "GPU Core",
-              "temp": 52.0
-            }
-          ]
-        }
-      ]
-    }
-  ]
-}
-```
+### Response
 
-**Implementation**:
-```c
-static int get_temperature_data(const Config *config, float *temp_cpu, float *temp_gpu)
+```json
 {
-    // Initialize outputs
-    *temp_cpu = 0.0f;
-    *temp_gpu = 0.0f;
-    
-    // Build URL
-    char url[256];
-    snprintf(url, sizeof(url), "%s/status", config->daemon_address);
-    
-    // Initialize response buffer
-    http_response response = {0};
-    cc_init_response_buffer(&response, 8192);
-    
-    // Configure request
-    CURL *curl = curl_easy_init();
-    curl_easy_setopt(curl, CURLOPT_URL, url);
-    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);
-    curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
-    curl_easy_setopt(curl, CURLOPT_POST, 1L);
-    
-    // POST data
-    const char *post_data = "{\"all\":false,\"since\":\"1970-01-01T00:00:00.000Z\"}";
-    curl_easy_setopt(curl, CURLOPT_POSTFIELDS, post_data);
-    
-    // Set headers
-    struct curl_slist *headers = NULL;
-    headers = curl_slist_append(headers, "accept: application/json");
-    headers = curl_slist_append(headers, "content-type: application/json");
-    curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
-    
-    // Send request
-    CURLcode res = curl_easy_perform(curl);
-    
-    // Parse response
-    if (res == CURLE_OK) {
-        parse_temperature_data(response.data, temp_cpu, temp_gpu);
-    }
-    
-    // Cleanup
-    cc_cleanup_response_buffer(&response);
-    curl_slist_free_all(headers);
-    curl_easy_cleanup(curl);
-    
-    return (res == CURLE_OK);
+  "devices": [{
+    "type": "CPU",
+    "status_history": [{
+      "temps": [{ "name": "temp1", "temp": 45.0 }]
+    }]
+  }]
 }
 ```
 
-#### 4. JSON Temperature Parsing
-
-**Function**: `parse_temperature_data(const char *json, float *temp_cpu, float *temp_gpu)`
-
-**Purpose**: Extract CPU and GPU temperatures from status JSON
-
-**Algorithm**:
-1. Parse JSON with jansson
-2. Get "devices" array
-3. For each device:
-   - Get device type (CPU/GPU)
-   - Get status_history array
-   - Get latest status (last element)
-   - Get temps array
-   - Search for appropriate sensor name
-   - Extract temperature value
-   - Validate range (-50°C to 150°C)
-4. Return when both CPU and GPU found
-
-**Sensor Name Matching**:
-- **CPU**: `temp1` (standard Linux sensor name)
-- **GPU**: Contains "GPU" or "gpu" (varies by manufacturer)
-
-**Helper Function**: `extract_device_temperature()`
-
-```c
-static float extract_device_temperature(const json_t *device, const char *device_type)
-{
-    // Get status history
-    const json_t *status_history = json_object_get(device, "status_history");
-    size_t history_count = json_array_size(status_history);
-    
-    // Get latest status
-    const json_t *last_status = json_array_get(status_history, history_count - 1);
-    
-    // Get temperatures array
-    const json_t *temps = json_object_get(last_status, "temps");
-    
-    // Search for matching sensor
-    size_t temp_count = json_array_size(temps);
-    for (size_t i = 0; i < temp_count; i++) {
-        const json_t *temp_entry = json_array_get(temps, i);
-        const char *sensor_name = json_string_value(json_object_get(temp_entry, "name"));
-        float temperature = json_number_value(json_object_get(temp_entry, "temp"));
-        
-        // Validate range
-        if (temperature < -50.0f || temperature > 150.0f)
-            continue;
-        
-        // Check sensor name
-        if (strcmp(device_type, "CPU") == 0 && strcmp(sensor_name, "temp1") == 0) {
-            return temperature;
-        }
-        else if (strcmp(device_type, "GPU") == 0 && 
-                 (strstr(sensor_name, "GPU") || strstr(sensor_name, "gpu"))) {
-            return temperature;
-        }
-    }
-    
-    return 0.0f;
-}
-```
-
-**Error Handling**:
-- Returns 0.0f on missing data
-- Validates JSON structure at each level
-- Range checks temperature values
-- Logs parsing errors
-
-### File: `src/srv/cc_sensor.h`
-
-**Purpose**: Public API for temperature data retrieval
-
-**Key Definitions**:
-```c
-// Data structure
-typedef struct {
-    float temp_cpu;
-    float temp_gpu;
-} monitor_sensor_data_t;
-
-// High-level API
-int get_temperature_monitor_data(const struct Config *config, monitor_sensor_data_t *data);
-```
+Sensor matching: CPU = `temp1`, GPU = name contains "GPU"/"gpu".
+Validation: -50°C to 150°C range.
 
 ---
 
-## API Communication Flow
-
-### Initialization Phase
-
-```
-main() startup
-    ↓
-1. load_configuration()
-    ↓
-2. init_coolercontrol_session(&config)
-    │
-    └─→ Build Authorization: Bearer cc_<uuid>
-    ↓
-3. init_device_cache(&config)
-    │
-    ├─→ GET /devices
-    │   Response: Device list JSON
-    │
-    ├─→ Parse JSON, find first LCD-capable CoolerControl device
-    │
-    └─→ Cache: UID, name, width, height
-    ↓
-4. update_config_from_device(&config)
-    │
-    └─→ Update display_width/height if 0 in config
-    ↓
-5. Ready for main loop
-```
-
-### Main Loop Phase
-
-```
-while (running)
-    ↓
-1. get_temperature_monitor_data(&config, &data)
-    │
-    ├─→ POST /status
-    │   Content-Type: application/json
-    │   Body: {"all":false,"since":"1970-01-01T00:00:00.000Z"}
-    │   Cookie: {session_cookie}
-    │
-    ├─→ Response: Device status JSON with temps
-    │
-    └─→ Parse: Extract temp_cpu and temp_gpu
-    ↓
-2. draw_display_image(&config)
-    │
-    ├─→ render_dual_display() or render_circle_display()
-    │   │
-    │   ├─→ Cairo rendering
-    │   │
-    │   └─→ Write PNG: /etc/coolercontrol/plugins/coolerdash/coolerdash.png
-    │
-    └─→ send_image_to_lcd(&config, png_path, device_uid)
-        │
-        ├─→ PUT /devices/{uid}/settings/lcd/lcd/images?log=false
-        │   Content-Type: multipart/form-data
-        │   Cookie: {session_cookie}
-        │   
-        │   Fields:
-        │   - mode: "image"
-        │   - brightness: "100"
-        │   - orientation: "0"
-        │   - images[]: {PNG file data}
-        │
-        └─→ Response: 200 OK
-    ↓
-3. sleep(update_interval)
-    ↓
-4. Loop back to step 1
-```
-
-### Shutdown Phase
-
-```
-Signal received (SIGTERM/SIGINT) or exit()
-    ↓
-cleanup_coolercontrol_session()
-    │
-    ├─→ curl_easy_cleanup()
-    │
-    ├─→ curl_global_cleanup()
-    │
-    ├─→ unlink(/tmp/coolerdash_cookie_{PID}.txt)
-    │
-    └─→ session_initialized = 0
-    ↓
-Program exit
-```
-
----
+## Testing API Manually
 
-## Data Structures
-
-### Config Structure (Relevant Fields)
-
-```c
-struct Config {
-    // CoolerControl connection
-    char daemon_address[256];      // e.g., "http://127.0.0.1:11987"
-    char access_token[64];         // Bearer token
-    
-    // Display settings
-    uint16_t display_width;        // e.g., 640 (auto-detected if 0)
-    uint16_t display_height;       // e.g., 640
-    char display_shape[16];        // "auto", "rectangular", or "circular" (v1.96+)
-    int force_display_circular;    // Legacy override (deprecated)
-    
-    // LCD settings
-    int lcd_brightness;            // 0-100
-    int lcd_orientation;           // 0, 90, 180, 270
-    
-    // Display mode
-    char display_mode[16];         // "dual" or "circle"
-    
-    // Paths
-    char paths_image_coolerdash[512]; // PNG output path
-};
-```
-
-### Device Cache
-
-```c
-static struct {
-    int initialized;               // 0 = not cached, 1 = cached
-    char device_uid[128];          // e.g., "1234-5678-abcd"
-    char device_name[CC_NAME_SIZE]; // e.g., "NZXT Kraken Elite"
-    int screen_width;              // e.g., 640
-    int screen_height;             // e.g., 640
-} device_cache;
-```
-
-### Session State
-
-```c
-typedef struct {
-    CURL *curl_handle;             // Persistent CURL handle
-    char access_token[CC_BEARER_HEADER_SIZE]; // Authorization header
-    int session_initialized;       // 0 = not initialized, 1 = ready
-} CoolerControlSession;
-
-static CoolerControlSession cc_session;
-```
-
-### HTTP Response Buffer
-
-```c
-typedef struct http_response {
-    char *data;                    // Dynamic buffer
-    size_t size;                   // Current data size
-    size_t capacity;               // Allocated capacity
-} http_response;
-```
-
-### Temperature Data
-
-```c
-typedef struct {
-    float temp_cpu;                // CPU temperature (°C)
-    float temp_gpu;                // GPU temperature (°C)
-} monitor_sensor_data_t;
-```
-
----
-
-## Error Handling
-
-### Return Value Convention
-
-- **Success**: 1 (true)
-- **Failure**: 0 (false)
-- **Error**: Negative values (rare, mostly in legacy code)
-
-### Logging Levels
-
-```c
-LOG_ERROR    - Critical failures (API unreachable, auth failed)
-LOG_WARNING  - Recoverable issues (sensor missing, invalid data)
-LOG_INFO     - Verbose mode info (API responses, cache hits)
-LOG_STATUS   - Normal operation status (upload success)
-```
-
-### Common Error Scenarios
-
-#### 1. Authentication Failure
-
-**Symptom**: `init_coolercontrol_session()` returns 0
-
-**Causes**:
-- Missing or invalid access token
-- CoolerControl daemon not running
-- Daemon address unreachable
-
-**Debugging**:
-```c
-log_message(LOG_ERROR,
-            "CoolerControl access token missing; token-only authentication is required");
-```
-
-**Resolution**:
-- Verify daemon is running: `systemctl status coolercontrol`
-- Check `access_token` in `config.json`
-- Test connection: `curl http://127.0.0.1:11987/devices`
-
-#### 2. Device Not Found
-
-**Symptom**: `init_device_cache()` returns 0
-
-**Causes**:
-- No LCD-capable CoolerControl device connected
-- Device not detected by CoolerControl
-- Wrong device type in JSON
-
-**Debugging**:
-```c
-log_message(LOG_ERROR, "No LCD device found in API response");
-```
-
-**Resolution**:
-- Check CoolerControl GUI for device list
-- Verify Liquidctl support: `liquidctl list`
-- Ensure device permissions (udev rules)
-
-#### 3. Temperature Data Missing
-
-**Symptom**: `temp_cpu` or `temp_gpu` is 0.0
-
-**Causes**:
-- Sensor not available in CoolerControl
-- Sensor name mismatch
-- Device disconnected
-
-**Debugging**:
-```c
-log_message(LOG_WARNING, "CPU temperature not found in status response");
-```
-
-**Resolution**:
-- Check CoolerControl dashboard for sensor visibility
-- Verify sensor names in JSON response
-- Ensure drivers loaded (lm-sensors, nvidia-smi)
-
-#### 4. LCD Upload Failure
-
-**Symptom**: `send_image_to_lcd()` returns 0
-
-**Causes**:
-- PNG file not found
-- Device UID invalid
-- Session cookie expired
-
-**Debugging**:
-```c
-log_message(LOG_ERROR, "LCD upload failed: CURL code %d, HTTP code %ld", res, http_response_code);
-if (response.data && response.size > 0) {
-    log_message(LOG_ERROR, "Server response: %s", response.data);
-}
-```
-
-**Resolution**:
-- Verify PNG exists: `ls -l /tmp/coolerdash.png`
-- Check device UID matches cache
-- Re-authenticate if session lost
-
----
-
-## Best Practices
-
-### 1. Resource Management
-
-**Always pair initialization with cleanup**:
-```c
-// Buffer
-http_response response = {0};
-cc_init_response_buffer(&response, 8192);
-// ... use response ...
-cc_cleanup_response_buffer(&response);
-
-// CURL
-CURL *curl = curl_easy_init();
-// ... use curl ...
-curl_easy_cleanup(curl);
-
-// Headers
-struct curl_slist *headers = NULL;
-headers = curl_slist_append(headers, "Content-Type: application/json");
-// ... use headers ...
-curl_slist_free_all(headers);
-```
-
-### 2. Session Handling
-
-**Check session before API calls**:
-```c
-if (!is_session_initialized()) {
-    log_message(LOG_ERROR, "Session not initialized");
-    return 0;
-}
-```
-
-**Use persistent session for all requests**:
-- Don't create new CURL handles per request
-- Reuse `cc_session.curl_handle` for performance
-- Cookie persistence handles re-authentication
-
-### 3. JSON Parsing
-
-**Validate structure at each level**:
-```c
-json_t *root = json_loads(json_string, 0, &error);
-if (!root) {
-    log_message(LOG_ERROR, "JSON parse error: %s", error.text);
-    return 0;
-}
-
-const json_t *devices = json_object_get(root, "devices");
-if (!devices || !json_is_array(devices)) {
-    json_decref(root);
-    return 0;
-}
-
-// ... continue parsing ...
-
-json_decref(root);  // Always cleanup
-```
-
-**Always decref JSON objects**:
-```c
-json_t *root = json_loads(...);
-// ... use root ...
-json_decref(root);  // Free memory
-```
-
-### 4. Error Logging
-
-**Provide actionable context**:
-```c
-// Bad
-log_message(LOG_ERROR, "Failed");
-
-// Good
-log_message(LOG_ERROR, "Failed to upload LCD image: HTTP %ld, device UID: %s", 
-            http_code, device_uid);
-```
-
-**Include CURL error details**:
-```c
-CURLcode res = curl_easy_perform(curl);
-if (res != CURLE_OK) {
-    log_message(LOG_ERROR, "CURL request failed: %s", curl_easy_strerror(res));
-}
-```
-
-### 5. String Safety
-
-**Use bounds-checked functions**:
-```c
-// Prefer cc_safe_strcpy over strcpy/strncpy
-cc_safe_strcpy(dest, sizeof(dest), src);
-
-// Always validate snprintf
-int written = snprintf(buffer, sizeof(buffer), format, args);
-if (written < 0 || (size_t)written >= sizeof(buffer)) {
-    log_message(LOG_ERROR, "String truncated");
-    return 0;
-}
-```
-
-### 6. Memory Allocation
-
-**Check allocation success**:
-```c
-char *buffer = malloc(size);
-if (!buffer) {
-    log_message(LOG_ERROR, "Memory allocation failed: %zu bytes", size);
-    return 0;
-}
-```
-
-**Prevent overflow in size calculations**:
-```c
-if (initial_capacity > CC_MAX_SAFE_ALLOC_SIZE) {
-    log_message(LOG_ERROR, "Requested size too large: %zu", initial_capacity);
-    return 0;
-}
-```
-
-### 7. HTTPS Support
-
-**Enable SSL verification**:
-```c
-if (strncmp(config->daemon_address, "https://", 8) == 0) {
-    curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 1L);
-    curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 2L);
-}
-```
-
-**Certificate path** (optional):
-```c
-curl_easy_setopt(curl, CURLOPT_CAINFO, "/etc/ssl/certs/ca-certificates.crt");
-```
-
----
-
-## Troubleshooting
-
-### Debugging API Communication
-
-**Enable CURL verbose output**:
-```c
-curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);
-```
-
-**Capture HTTP headers**:
-```c
-static size_t header_callback(char *buffer, size_t size, size_t nitems, void *userdata)
-{
-    printf("Header: %s", buffer);
-    return size * nitems;
-}
-
-curl_easy_setopt(curl, CURLOPT_HEADERFUNCTION, header_callback);
-```
-
-**Dump response body**:
-```c
-if (response.data && response.size > 0) {
-    FILE *f = fopen("/tmp/coolerdash_api_response.json", "w");
-    fwrite(response.data, 1, response.size, f);
-    fclose(f);
-    log_message(LOG_INFO, "API response saved to /tmp/coolerdash_api_response.json");
-}
-```
-
-### Testing API Calls Manually
-
-**Test authentication**:
 ```bash
+# Devices
 curl http://127.0.0.1:11987/devices \
-    -H "Authorization: Bearer cc_<your-uuid-here>" \
-    -v
-```
+    -H "Authorization: Bearer cc_<uuid>" | jq
 
-**Test device list**:
-```bash
-curl -X GET http://127.0.0.1:11987/devices \
-     -b cookies.txt \
-     -H "Accept: application/json" | jq
-```
-
-**Test temperature data**:
-```bash
+# Temperature
 curl -X POST http://127.0.0.1:11987/status \
-     -b cookies.txt \
-     -H "Content-Type: application/json" \
-     -d '{"all":false,"since":"1970-01-01T00:00:00.000Z"}' | jq
-```
+    -H "Content-Type: application/json" \
+    -H "Authorization: Bearer cc_<uuid>" \
+    -d '{"all":false,"since":"1970-01-01T00:00:00.000Z"}' | jq
 
-**Test LCD upload**:
-```bash
+# LCD upload
 curl -X PUT "http://127.0.0.1:11987/devices/{UID}/settings/lcd/lcd/images?log=false" \
-     -b cookies.txt \
-     -F "mode=image" \
-     -F "brightness=100" \
-     -F "orientation=0" \
-     -F "images[]=@/tmp/coolerdash.png;type=image/png" \
-     -v
-```
-
-### Common Issues
-
-#### Issue: "Session not initialized"
-
-**Check**:
-```bash
-systemctl status coolercontrol
-curl -I http://127.0.0.1:11987
-```
-
-**Fix**: Start CoolerControl daemon
-```bash
-systemctl start coolercontrol
-```
-
-#### Issue: "No LCD device found"
-
-**Check devices**:
-```bash
-curl http://127.0.0.1:11987/devices | jq '.devices[] | {type, name}'
-```
-
-**Verify Liquidctl**:
-```bash
-sudo liquidctl list
-```
-
-#### Issue: "Temperature always 0.0"
-
-**Check sensor names**:
-```bash
-curl -X POST http://127.0.0.1:11987/status \
-     -H "Content-Type: application/json" \
-     -d '{"all":false,"since":"1970-01-01T00:00:00.000Z"}' | \
-jq '.devices[] | select(.type=="CPU" or .type=="GPU") | .status_history[0].temps'
-```
-
-**Adjust sensor name matching** in `extract_device_temperature()` if needed.
-
-#### Issue: "LCD upload fails with HTTP 401"
-
-**Cause**: Session cookie expired
-
-**Fix**: Session re-initialization handled automatically, but check:
-```bash
-ls -la /tmp/coolerdash_cookie_*.txt
-cat /tmp/coolerdash_cookie_*.txt
+    -H "Authorization: Bearer cc_<uuid>" \
+    -F "mode=image" -F "brightness=80" -F "orientation=0" \
+    -F "images[]=@coolerdash.png;type=image/png"
 ```
 
 ---
 
-## Performance Considerations
-
-### API Call Frequency
-
-**Current Setup** (default 2-second interval):
-- Temperature data: POST /status every 2s
-- LCD upload: PUT /devices/.../images every 2s
-- Device list: GET /devices once at startup (cached)
-
-**Optimization**:
-- Device cache eliminates repeated /devices calls
-- Persistent CURL session reuses HTTP connection
-- Shared Bearer header avoids rebuilding auth state on every request
-
-### Memory Usage
-
-**Typical Allocations**:
-- Response buffers: 4-16KB (dynamic)
-- Device cache: ~400 bytes (static)
-- Session state: ~600 bytes (static)
-- JSON parsing: Temporary (freed immediately)
-
-**Buffer Sizing**:
-- `/devices` response: 8-16KB (many devices)
-- `/status` response: 4-8KB (temperature data)
-- Upload response: 4KB (minimal)
-
-### Network Overhead
-
-**Per Update Cycle** (2 seconds):
-- Request: ~500 bytes (POST /status)
-- Response: ~2-4KB (JSON)
-- Upload request: ~50-100KB (PNG + multipart)
-- Upload response: ~200 bytes
-
-**Total**: ~50-104KB per cycle = ~25-52KB/s average
-
----
-
-## Future Enhancements
-
-### Potential Improvements
-
-1. **Asynchronous API Calls**: Use libcurl multi interface for parallel requests
-2. **Connection Pooling**: Reuse connections more efficiently
-3. **Compression**: Enable gzip for JSON responses
-4. **WebSocket Support**: Real-time temperature streaming instead of polling
-5. **Retry Logic**: Automatic retry with exponential backoff on transient failures
-6. **Response Caching**: Skip LCD upload if image hasn't changed
-7. **Multiple Devices**: Support multiple LCD devices simultaneously
-8. **Device Hot-Plug**: Detect device connection/disconnection and re-initialize
-
-### API Version Compatibility
-
-**Current**: CoolerControl v1.x REST API
-
-**Future**: If CoolerControl API changes:
-- Add version detection: GET /version
-- Conditional logic for different API versions
-- Deprecation warnings for old endpoints
-
----
-
-## Conclusion
-
-The CoolerControl API integration provides a robust, efficient interface for:
-- **Authentication**: Bearer token via CoolerControl Access Protection
-- **Device Detection**: Automatic CoolerControl LCD device discovery and caching
-- **Temperature Monitoring**: Real-time CPU/GPU data retrieval
-- **LCD Upload**: Multipart image upload with brightness/orientation control
-- **Error Handling**: Comprehensive validation and logging
-
-### Key Design Principles
-
-- **Caching**: Device information cached to minimize API calls
-- **Persistence**: Reusable CURL session for performance
-- **Safety**: Bounds-checked strings, validated allocations
-- **Modularity**: Separate concerns (auth, config, sensors)
-- **Reliability**: Extensive error checking and logging
-
-### Integration Example
-
-```c
-// Complete workflow
-Config config = load_configuration();
-
-// Initialize API
-if (!init_coolercontrol_session(&config)) {
-    log_message(LOG_ERROR, "Failed to connect to CoolerControl");
-    return 1;
-}
-
-if (!init_device_cache(&config)) {
-    log_message(LOG_ERROR, "No compatible device found");
-    cleanup_coolercontrol_session();
-    return 1;
-}
-
-update_config_from_device(&config);
-
-// Main loop
-while (running) {
-    monitor_sensor_data_t data = {0};
-    if (get_temperature_monitor_data(&config, &data)) {
-        // Render and upload handled by display modules
-        draw_display_image(&config);
-    }
-    sleep(2);
-}
-
-// Cleanup
-cleanup_coolercontrol_session();
-```
-
-For questions or contributions, see `CONTRIBUTING.md`.
-
----
+## Troubleshooting
 
-**Version**: 1.0  
-**Last Updated**: November 6, 2025  
-**Authors**: damachine <christkue79@gmail.com>
+| Problem | Check |
+|---------|-------|
+| Session init fails | `systemctl status coolercontrold`, verify `access_token` |
+| No LCD device found | `curl .../devices \| jq`, check for `"type": "Liquidctl"` |
+| Temperature 0.0 | Check sensor names in `/status` response |
+| Upload fails (401) | Token invalid or missing |
diff --git a/docs/developer-guide.md b/docs/developer-guide.md
index 2905344..b6d5ab0 100644
--- a/docs/developer-guide.md
+++ b/docs/developer-guide.md
@@ -1,1269 +1,167 @@
-# CoolerDash Developer Documentation
+# CoolerDash Developer Guide
 
-**Language:** C99 | **Platform:** Linux x86-64-v3 | **License:** MIT
-**Author:** damachine (damachin3@proton.me)
-**Repository:** https://github.com/damachine/coolerdash
-
----
-
-## Table of Contents
-
-1. [Project Overview](#project-overview)
-2. [Architecture](#architecture)
-3. [Module Structure](#module-structure)
-4. [Build System](#build-system)
-5. [Configuration System](#configuration-system)
-6. [API Integration](#api-integration)
-7. [Rendering Pipeline](#rendering-pipeline)
-8. [Function Reference](#function-reference)
-9. [Development Guidelines](#development-guidelines)
-10. [Testing & Debugging](#testing--debugging)
-
----
-
-## Project Overview
-
-### Purpose
-
-CoolerDash extends the LCD functionality of [CoolerControl](https://gitlab.com/coolercontrol/coolercontrol) for Linux systems, targeting CoolerControl-managed LCD displays such as AIO pump screens and similar supported devices. It provides real-time sensor visualization with customizable UI elements.
-
-### Key Features
-
-- **Real-time Temperature Monitoring:** CPU/GPU/liquid sensor data via CoolerControl REST API
-- **Adaptive Display Rendering:** Automatic circular/rectangular display detection
-- **Customizable UI:** Full color/layout/font/sensor-slot configuration via `config.json`
-- **Authentication:** Bearer Token via CoolerControl Access Protection
-- **Shutdown Image:** Registered with CC4 at startup — CC handles display on daemon stop
-- **Efficient Caching:** One-time device information retrieval at startup
-- **CoolerControl Plugin:** Managed by `cc-plugin-coolerdash.service`, no separate systemd service needed
-
-### System Requirements
-
-- **OS:** Linux (systemd-based)
-- **Architecture:** x86-64-v3 (Intel Haswell+ / AMD Excavator+)
-- **Dependencies:**
-  - `cairo` — PNG generation
-  - `jansson` — JSON parsing (config + API)
-  - `libcurl-gnutls` — HTTP client
-  - `ttf-roboto` — Font rendering
-- **Required Service:** CoolerControl >=4.x
+**C99** | **Linux x86-64-v3** | **MIT License**
+Author: damachine (damachin3@proton.me)
+Repository: https://github.com/damachine/coolerdash
 
 ---
 
 ## Architecture
 
-### High-Level Flow
-
 ```
-┌─────────────────────────────────────────────────────────────────┐
-│                         main.c                                  │
-│  ┌───────────────────────────────────────────────────────────┐  │
-│  │ 1. Configuration Loading (device/config.c)                │  │
-│  │ 2. Session Initialization (cc_main.c)                     │  │
-│  │    └─ Bearer Token header                                │  │
-│  │ 3. Device Cache Setup (cc_conf.c)                         │  │
-│  │ 4. Shutdown Image Registration (cc_main.c, CC4 only)      │  │
-│  │ 5. Main Loop (configurable interval)                      │  │
-│  │    ├─ Temperature Reading (cc_sensor.c)                   │  │
-│  │    ├─ Image Rendering (display.c → dual.c|circle.c)       │  │
-│  │    └─ LCD Upload (cc_main.c)                              │  │
-│  │ 6. Signal Handling (SIGTERM/SIGINT → graceful stop)       │  │
-│  │ 7. Cleanup (session + image files)                        │  │
-│  └───────────────────────────────────────────────────────────┘  │
-└─────────────────────────────────────────────────────────────────┘
-              ↓                    ↓                    ↓
-    ┌─────────────────┐  ┌──────────────────┐  ┌─────────────────┐
-    │  device/        │  │  srv/            │  │  mods/          │
-    │  Configuration  │  │  CoolerControl   │  │  Rendering      │
-    │  Management     │  │  API Client      │  │  Engine         │
-    └─────────────────┘  └──────────────────┘  └─────────────────┘
-         config.c/h           cc_main.c/h           display.c/h
-                              cc_conf.c/h            dual.c/h
-                              cc_sensor.c/h          circle.c/h
+main.c
+ ├─ Configuration loading    (device/config.c)
+ ├─ Session init + auth      (srv/cc_main.c)
+ ├─ Device cache setup       (srv/cc_conf.c)
+ ├─ Shutdown image register  (srv/cc_main.c, CC4)
+ ├─ Main loop
+ │   ├─ Temperature reading  (srv/cc_sensor.c)
+ │   ├─ Image rendering      (mods/display.c → dual.c | circle.c)
+ │   └─ LCD upload           (srv/cc_main.c)
+ ├─ Signal handling          (SIGTERM/SIGINT → graceful stop)
+ └─ Cleanup                  (session + image files)
 ```
 
-### Design Principles
-
-1. **Separation of Concerns:** Clear module boundaries (device/srv/mods)
-2. **Defense in Depth:** Multi-layer error checking and validation
-3. **Resource Safety:** RAII-style cleanup patterns with cleanup guards
-4. **Performance Optimization:** Device caching, exponential buffer growth
-5. **Security First:** PID file race condition prevention, secure parsing
-
----
-
 ## Module Structure
 
-### Directory Layout
-
 ```
-coolerdash/
-├── src/
-│   ├── main.c                    # Main daemon entry point (967 lines, 30 functions)
-│   ├── device/                   # Configuration subsystem
-│   │   └── config.c/h           # JSON config loader + defaults
-│   ├── srv/                     # CoolerControl API client
-│   │   ├── cc_main.c/h          # Session management
-│   │   ├── cc_conf.c/h          # Device cache, display detection
-│   │   └── cc_sensor.c/h        # Temperature monitoring
-│   └── mods/                    # Rendering modules
-│       ├── display.c/h          # Mode dispatcher, shared helpers
-│       ├── dual.c/h             # Dual mode (CPU+GPU simultaneous)
-│       └── circle.c/h           # Circle mode (alternating sensor)
-├── etc/
-│   ├── coolercontrol/plugins/coolerdash/config.json  # User configuration
-│   └── systemd/coolerdash.service         ← managed by CoolerControl (cc-plugin-coolerdash.service)
-├── docs/                        # Documentation
-│   ├── config.md                # Configuration guide
-│   ├── devices.md               # Supported hardware
-│   └── developer-guide.md       # This file
-├── Makefile                     # Build system
-└── PKGBUILD                     # Arch/AUR packaging
+src/
+├── main.c              # Daemon lifecycle, signal handling, PID management
+├── device/
+│   └── config.c/h      # JSON config loader + defaults
+├── srv/
+│   ├── cc_main.c/h     # Session management, auth, LCD upload
+│   ├── cc_conf.c/h     # Device cache, display detection
+│   └── cc_sensor.c/h   # Temperature monitoring
+└── mods/
+    ├── display.c/h      # Mode dispatcher
+    ├── dual.c/h         # Dual mode (CPU+GPU simultaneous)
+    └── circle.c/h       # Circle mode (alternating sensor)
 ```
 
-### Module Responsibilities
-
-| Module | Purpose | Key Functions | Lines | Public API |
-|--------|---------|---------------|-------|------------|
-| **main.c** | Daemon lifecycle | Signal handling, PID management, main loop | — | `main()` |
-| **device/config** | Config system | JSON loading, hardcoded defaults | — | `load_plugin_config()` |
-| **srv/cc_main** | HTTP session | Login/token auth, LCD upload, shutdown image registration | — | 5 functions |
-| **srv/cc_conf** | Device cache | UID/name/dimensions, display shape | — | 4 functions |
-| **srv/cc_sensor** | Temperature | CPU/GPU sensor reading | — | 1 function |
-| **mods/display** | Mode dispatch | Route to dual/circle, shared Cairo helpers | — | `draw_display_image()` |
-| **mods/dual** | Dual rendering | CPU+GPU simultaneous layout | — | `draw_dual_image()` |
-| **mods/circle** | Circle rendering | Alternating single-sensor layout | — | `draw_circle_image()` |
+| Module | Public API |
+|--------|------------|
+| main.c | `main()` |
+| device/config | `load_plugin_config()` |
+| srv/cc_main | `init_coolercontrol_session()`, `is_session_initialized()`, `cleanup_coolercontrol_session()`, `send_image_to_lcd()` |
+| srv/cc_conf | `init_device_cache()`, `get_cached_lcd_device_data()`, `update_config_from_device()`, `is_circular_display_device()` |
+| srv/cc_sensor | `get_temperature_monitor_data()` |
+| mods/display | `draw_display_image()` |
+| mods/dual | `draw_dual_image()` |
+| mods/circle | `draw_circle_image()` |
 
 ---
 
 ## Build System
 
-### Makefile Overview
-
-**Location:** `/Makefile`
-**Build Tool:** GNU Make + GCC
-**Standard:** C99 with strict warnings
-
-#### Key Targets
-
 ```bash
-make                # Standard build (C99, -O2, -march=x86-64-v3)
-make clean          # Remove build artifacts (build/, bin/)
-make install        # System installation with dependency checks
-make uninstall      # Complete removal (service + files)
-make debug          # Debug build (-g -DDEBUG -fsanitize=address)
-make help           # Show all available targets
+make                # C99, -O2, -march=x86-64-v3
+make clean          # Remove build artifacts
+make debug          # Debug build with AddressSanitizer
+make install        # System installation
+make uninstall      # Complete removal
 ```
 
-#### Compiler Flags
-
+Compiler flags:
 ```makefile
 CFLAGS = -Wall -Wextra -O2 -std=c99 -march=x86-64-v3 -Iinclude \
          $(shell pkg-config --cflags cairo jansson libcurl)
 LIBS = $(shell pkg-config --libs cairo jansson libcurl) -lm
 ```
 
-**Optimization Level:** `-O2` (production), `-O0` (debug)
-**Architecture:** `x86-64-v3` (AVX2/BMI2 support)
-**Warnings:** All enabled (`-Wall -Wextra`)
-
-#### Build Workflow
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│ 1. Dependency Detection (pkg-config)                        │
-│    ├─ cairo (graphics)                                      │
-│    ├─ jansson (JSON)                                        │
-│    ├─ libcurl (HTTP)                                        │
-│    └─ jansson (JSON parsing)                                 │
-├─────────────────────────────────────────────────────────────┤
-│ 2. Module Compilation (src/ → build/)                       │
-│    ├─ device/config.o                                       │
-│    ├─ srv/cc_main.o, srv/cc_conf.o, srv/cc_sensor.o        │
-│    └─ mods/display.o, mods/dual.o, mods/circle.o           │
-├─────────────────────────────────────────────────────────────┤
-│ 3. Linking (main.c + modules → bin/coolerdash)             │
-├─────────────────────────────────────────────────────────────┤
-│ 4. Installation (make install)                              │
-│    ├─ Binary: /usr/libexec/coolerdash/coolerdash            │
-│    ├─ Config: /etc/coolercontrol/plugins/coolerdash/config.json │
-│    ├─ Plugin UI: /etc/coolercontrol/plugins/coolerdash/ui/  │
-│    └─ Manual: /usr/share/man/man1/coolerdash.1             │
-└─────────────────────────────────────────────────────────────┘
-```
-
-### Dependency Management
-
-**Automatic Detection:** Makefile checks for missing dependencies via `pkg-config`
-**Distribution Support:** Arch, Debian, Fedora, RHEL, openSUSE
-**Fallback Behavior:** Build fails with clear error messages if deps missing
+Dependencies: `cairo`, `jansson`, `libcurl-gnutls`, `ttf-roboto`
 
 ---
 
 ## Configuration System
 
-### Two-Stage Configuration Loading
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│ Stage 1: Hardcoded Defaults (device/config.c)                    │
-│ ─────────────────────────────────────────────────────────────    │
-│ All Config fields initialized to built-in defaults              │
-│ Function: set_*_defaults(Config *config)                         │
-│ Example: daemon_address = "http://localhost:11987"               │
-├──────────────────────────────────────────────────────────────────┤
-│ Stage 2: JSON Config Override (device/config.c)                  │
-│ ─────────────────────────────────────────────────────────────    │
-│ Parse config.json and override defaults                         │
-│ Function: load_plugin_config(Config *config, const char *path)   │
-│ Path: /etc/coolercontrol/plugins/coolerdash/config.json         │
-├──────────────────────────────────────────────────────────────────┤
-│ Stage 3: Device API Detection (cc_conf.c)                        │
-│ ─────────────────────────────────────────────────────────────    │
-│ Auto-detect display dimensions from CoolerControl API           │
-│ Function: update_config_from_device(Config *config)              │
-│ Behavior: Only updates if width/height are 0 in config           │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-### Configuration Structure
+Three-stage loading:
 
-**File:** `src/device/config.h`
+1. **Hardcoded defaults** — `set_*_defaults()` in `config.c`
+2. **JSON override** — `load_plugin_config()` from `/etc/coolercontrol/plugins/coolerdash/config.json`
+3. **API detection** — `update_config_from_device()` sets width/height if 0
 
-```c
-typedef struct {
-    // Daemon connection
-    char daemon_address[256];        // CoolerControl API URL
-  char access_token[64];           // Bearer token (cc_<uuid>)
-
-    // File paths
-    char paths_images[PATH_MAX];     // Shutdown image directory
-    char paths_image_coolerdash[PATH_MAX];  // Rendered image path
-    char paths_image_shutdown[PATH_MAX];    // Shutdown image path
-    char paths_pid[PATH_MAX];        // PID file location
-
-    // Display settings
-    uint16_t display_width;          // LCD width in pixels (auto-detected)
-    uint16_t display_height;         // LCD height in pixels (auto-detected)
-    float display_refresh_interval;  // Update interval in seconds (e.g., 2.50 = 2.5 seconds)
-    int lcd_brightness;              // 0-100
-    int lcd_orientation;             // 0=0°, 90=90°, 180=180°, 270=270°
-    char display_mode[16];           // Display mode: "dual" or "circle"
-    char display_shape[16];          // Shape override: "auto", "rectangular", "circular"
-    uint16_t circle_switch_interval; // Circle mode sensor switch interval (1-60s, default: 5)
-    float display_content_scale_factor; // Content scale factor (0.5-1.0, default: 0.98)
+### Adding a Config Option
 
-    // Layout configuration
-    int layout_bar_height;           // Temperature bar height
-    int layout_label_size;           // Label font size
-    int layout_value_size;           // Value font size
-    float layout_content_y_offset;   // Vertical positioning (-1.0 to 1.0)
-
-    // Font settings
-    char font_face[128];             // Font family name
-    int font_weight_label;           // CAIRO_FONT_WEIGHT_*
-    int font_weight_value;           // CAIRO_FONT_WEIGHT_*
-
-    // Temperature thresholds
-    float temp_cpu_low;              // CPU low threshold (°C)
-    float temp_cpu_medium;           // CPU medium threshold (°C)
-    float temp_cpu_high;             // CPU high threshold (°C)
-    float temp_gpu_low;              // GPU low threshold (°C)
-    float temp_gpu_medium;           // GPU medium threshold (°C)
-    float temp_gpu_high;             // GPU high threshold (°C)
-
-    // Color definitions (15 colors)
-    Color color_background;          // Display background
-    Color color_cpu_label;           // "CPU" text
-    Color color_cpu_value;           // Temperature value
-    Color color_cpu_bar_low;         // Bar color <low
-    Color color_cpu_bar_medium;      // Bar color low-medium
-    Color color_cpu_bar_high;        // Bar color >medium
-    // ... same for GPU
-    Color color_bar_background;      // Bar background
-    Color color_bar_border;          // Bar border
-} Config;
-```
-
-### Change Tracking System
-
-**Purpose:** Log active configuration to systemd journal at startup
-
-**Implementation (config.c):**
-
-```c
-// Called after JSON loading completes
-void log_config(const Config *config);  // Uses LOG_STATUS level (always visible)
-```
-
-**Example Output (always shown in systemd journal):**
-
-```
-[CoolerDash STATUS] Config loaded: mode=dual, interval=2.5s, brightness=80
-[CoolerDash STATUS] Display: 240x240, shape=auto
-[CoolerDash STATUS] Daemon: http://localhost:11987
-```
-
-**Note:** Changed from LOG_INFO to LOG_STATUS in version 1.96+ to ensure manual configuration changes are always visible in systemd journal, even without --verbose flag.
-
----
-
-## API Integration
-
-### CoolerControl REST API
-
-**Base URL:** `http://localhost:11987` (configurable)
-**Authentication:** Bearer token via `Authorization: Bearer cc_<uuid>`
-**Session Management:** Single initialized CURL session with shared auth header
-
-### API Endpoints Used
-
-#### 1. Session Setup
-
-CoolerDash initializes one CURL session and stores the Bearer header built from the configured access token.
-
-**Implementation:** `src/srv/cc_main.c` → `init_coolercontrol_session()`
-
----
-
-#### 2. Device Information
-
-```http
-GET /devices
-Accept: application/json
-
-Response JSON:
-{
-  "devices": [
-    {
-      "uid": "liquidctl-nzxt-kraken-z-0",
-      "name": "NZXT Kraken Z73",
-      "type": "Liquidctl",
-      "info": {
-        "channels": {
-          "lcd": {
-            "lcd_info": {
-              "screen_width": 320,
-              "screen_height": 320
-            }
-          }
-        }
-      }
-    }
-  ]
-}
-```
-
-**Implementation:** `src/srv/cc_conf.c` → `initialize_device_cache()`
-**Caching:** One-time fetch at startup, stored in static struct
-**Display Detection:** Kraken devices: >240x240 = circular, ≤240 = rectangular
+1. Add field to `Config` struct in `config.h`
+2. Set default in `set_*_defaults()` in `config.c`
+3. Add JSON parsing in `load_*_from_json()` in `config.c`
+4. Add to `config.json`
+5. Update `docs/config-guide.md`
 
 ---
 
-#### 3. Temperature Data
-
-```http
-POST /status
-Content-Type: application/json
-Accept: application/json
-
-Request Body:
-{
-  "all": false,
-  "since": "1970-01-01T00:00:00.000Z"
-}
+## Rendering Pipeline
 
-Response JSON:
-{
-  "devices": [
-    {
-      "type": "CPU",
-      "status_history": [
-        {
-          "temps": [
-            {
-              "name": "temp1",
-              "temp": 45.0
-            }
-          ]
-        }
-      ]
-    },
-    {
-      "type": "GPU",
-      "status_history": [
-        {
-          "temps": [
-            {
-              "name": "GPU Core",
-              "temp": 52.0
-            }
-          ]
-        }
-      ]
-    }
-  ]
-}
 ```
-
-**Implementation:** `src/srv/cc_sensor.c` → `get_temperature_data()`
-**Sensor Selection:** CPU = "temp1", GPU = name contains "GPU"/"gpu"
-**Validation:** Temperature range -50°C to +150°C
-
----
-
-#### 4. LCD Image Upload
-
-```http
-PUT /devices/{device_uid}/settings/lcd/lcd/images?log=false
-Content-Type: multipart/form-data
-
-Form Fields:
-  - mode: "image"
-  - brightness: "80"
-  - orientation: "0"
-  - images[]: <PNG file data>
-
-Response: 200 OK
+draw_display_image(config)
+ ├─ get_cached_lcd_device_data()
+ ├─ get_temperature_monitor_data()
+ └─ dispatch → draw_dual_image() or draw_circle_image()
+      ├─ cairo_image_surface_create(ARGB32, w, h)
+      ├─ cairo_create(surface)
+      ├─ draw background + bars + labels + temperatures
+      ├─ cairo_surface_write_to_png(surface, path)
+      ├─ cairo_destroy(cr) + cairo_surface_destroy(surface)
+      └─ send_image_to_lcd(config, path, uid)
 ```
 
-**Implementation:** `src/srv/cc_main.c` → `send_image_to_lcd()`
-**Image Format:** PNG, dimensions match device LCD
-**Multipart Construction:** CURL mime API with proper MIME types
+### Display Shape
 
----
-
-### HTTP Session Management
-
-**Session Lifecycle:**
+- NZXT Kraken ≤240×240 → rectangular (inscribe_factor = 1.0)
+- NZXT Kraken >240×240 → circular (inscribe_factor = 1/√2 ≈ 0.7071)
+- Override via `config.json`: `"shape": "rectangular"` or `"circular"`
 
-```
-┌─────────────────────────────────────────────────────────────┐
-│ 1. init_coolercontrol_session()                             │
-│    ├─ curl_global_init()                                    │
-│    ├─ curl_easy_init()                                      │
-│    ├─ Build Authorization: Bearer cc_<uuid> header          │
-│    └─ Set session_initialized = 1                           │
-├─────────────────────────────────────────────────────────────┤
-│ 2. Repeated API Calls (reuse initialized session)           │
-│    ├─ send_image_to_lcd() - every 60s                       │
-│    └─ get_temperature_data() - every 60s                    │
-├─────────────────────────────────────────────────────────────┤
-│ 3. cleanup_coolercontrol_session()                          │
-│    ├─ curl_easy_cleanup()                                   │
-│    ├─ curl_global_cleanup()                                 │
-│    └─ Set session_initialized = 0                           │
-└─────────────────────────────────────────────────────────────┘
-```
+### Scaling
 
-**Security Features:**
-- Explicit Bearer auth header on each API request
-- Cleanup protection with static flag (prevents double-free)
+Base resolution: 240×240. Content scales dynamically.
+Circular displays: `safe_area = display_width × inscribe_factor`
 
 ---
 
-## Rendering Pipeline
+## Code Style
 
-### Cairo Graphics Workflow
-
-**Library:** cairo 1.x (vector graphics)
-**Output Format:** PNG image matching LCD dimensions
-**Color Depth:** 24-bit RGB
-
-### Rendering Steps
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│ 1. draw_display_image(config)                                    │
-│    ├─ Get device info from cache                                 │
-│    ├─ Fetch temperature data (cc_sensor.c)                       │
-│    └─ Dispatch to draw_dual_image() or draw_circle_image()       │
-├──────────────────────────────────────────────────────────────────┤
-│ 2. render_display(config, data, device_name)                     │
-│    ├─ Detect display shape (circular vs rectangular)             │
-│    ├─ Calculate scaling parameters                               │
-│    │   ├─ Circular: inscribe_factor = 1/√2 (≈0.7071, default)
-│    │   │   * Can be overridden in `config.json` with `inscribe_factor` (>=0; 0 = auto)
-│    │   └─ Rectangular: inscribe_factor = 1.0                     │
-│    ├─ Create Cairo surface (width × height × ARGB32)             │
-│    ├─ Draw background                                            │
-│    ├─ Draw CPU section (label + value + bar)                     │
-│    ├─ Draw GPU section (label + value + bar)                     │
-│    ├─ Write PNG to /etc/coolercontrol/plugins/coolerdash/coolerdash.png  │
-│    └─ Upload to LCD via send_image_to_lcd()                      │
-└──────────────────────────────────────────────────────────────────┘
-```
+- C99 + POSIX.1-2001
+- 4 spaces, no tabs, 120 char max line
+- Functions: `snake_case`, Structs: `PascalCase`, Constants: `UPPER_SNAKE_CASE`
+- Use `cc_safe_strcpy()` instead of `strcpy`/`strncpy`
+- Check every `malloc`, `fopen`, `curl_easy_perform`
+- Return 1 on success, 0 on failure
 
-### Display Shape Detection
-
-**File:** `src/srv/cc_conf.c` → `is_circular_display_device()`
-
-**Algorithm:**
+### Logging
 
 ```c
-int is_circular_display_device(const char *device_name, int width, int height) {
-    const int is_kraken = (strstr(device_name, "Kraken") != NULL);
-
-    if (is_kraken) {
-        // NZXT Kraken: >240x240 = circular, ≤240 = rectangular
-        const int is_large_display = (width > 240 || height > 240);
-        return is_large_display ? 1 : 0;
-    }
-
-    // Add other circular display brands here
-    return 0;
-}
+log_message(LOG_INFO, "...");     // --verbose only
+log_message(LOG_STATUS, "...");   // always shown
+log_message(LOG_WARNING, "...");  // always shown
+log_message(LOG_ERROR, "...");    // always shown
 ```
-### Scaling unit tests
 
-There is a small test harness at `tests/test_scaling.c` that validates `safe_area` and `safe_bar` calculations.
-Use it to verify behavior across cases:
+---
 
-- `inscribe_factor = 0.0` → auto fallback (1/√2)
-- `inscribe_factor = 0.70710678` → explicit geometry
-- `inscribe_factor = 0.85` → custom factor
-- For rectangular overrides the `inscribe_factor = 1.0`.
-- Invalid values (e.g. -1 or 1.5) fallback to the geometric factor.
+## Testing
 
-Build & run:
 ```bash
+# Unit test
 gcc -std=c99 -Iinclude -I./src -o build/test_scaling tests/test_scaling.c -lm
 ./build/test_scaling
-```
-
-This script prints a table summarizing `inscribe_used`, `safe_area`, and `safe_bar` for the test cases and whether they meet expectations.
-
-
-**Known Devices:**
-- **NZXT Kraken Z53** (280x280) → Circular
-- **NZXT Kraken Z73** (320x320) → Circular
-- **NZXT Kraken Elite** (640x640) → Circular
-- **NZXT Kraken (240x240 or smaller)** → Rectangular
-
-### Circular Display Rendering
-
-**Challenge:** Circular LCD requires content within inscribed square
-**Solution:** Apply inscribe factor 1/√2 ≈ 0.7071 to all coordinates
-
-**Mathematical Basis:**
-
-```
-Circle radius = R
-Inscribed square side = R * √2 / 2 = R * 1/√2
-```
-
-**Example (320x320 circular display):**
-
-```
-Original coordinates: (0, 0) to (320, 320)
-Safe drawing area: (48, 48) to (272, 272)  [≈70.71% of original]
-```
-
-**Implementation (dual.c):**
-
-```c
-ScalingParams params;
-
-// Priority: shape config > force flag > auto-detection
-if (strcmp(config->display_shape, "rectangular") == 0) {
-    params.inscribe_factor = 1.0;
-} else if (strcmp(config->display_shape, "circular") == 0) {
-    params.inscribe_factor = M_SQRT1_2;
-} else {
-    // Auto-detection fallback
-    int is_circular = config->force_display_circular ||
-                      is_circular_display_device(device_name, width, height);
-    params.inscribe_factor = is_circular ? M_SQRT1_2 : 1.0;
-}
-
-params.safe_content_margin = (1.0 - params.inscribe_factor) / 2.0;  // ≈0.1464
-
-// Apply to all drawing coordinates
-double safe_x = params.safe_content_margin * config->display_width;
-double safe_y = params.safe_content_margin * config->display_height;
-```
-
-**Configuration Override (v1.96+):**
-
-```ini
-[display]
-# Manual override (recommended for testing/troubleshooting)
-shape = auto  # or "rectangular" or "circular"
-```
-
-### Temperature Bar Rendering
-
-**Color Selection Logic:**
-
-```c
-const Color *get_bar_color(float temp, float low, float medium) {
-    if (temp < low)
-        return &config->color_cpu_bar_low;       // Green
-    else if (temp < medium)
-        return &config->color_cpu_bar_medium;    // Yellow
-    else
-        return &config->color_cpu_bar_high;      // Red
-}
-```
-
-**Fill Width Calculation:**
-
-```c
-int calculate_temp_fill_width(float temp, int max_width, float max_temp) {
-    if (temp <= 0.0f)
-        return 0;
-
-    const float ratio = fminf(temp / max_temp, 1.0f);  // Clamp to 1.0
-    return (int)(ratio * max_width);
-}
-```
-
----
-
-## Function Reference
-
-### Module: main.c (Daemon Lifecycle)
-
-#### Core Functions
-
-| Function | Purpose | Returns |
-|----------|---------|---------|
-| `main(argc, argv)` | Entry point, orchestrates daemon lifecycle | `int` exit code |
-| `parse_arguments()` | Parse CLI args (`--verbose`, `-v`, `--help`, etc.) | `const char*` config path |
-| `initialize_config_and_instance()` | Load config, check existing instance | `int` success |
-| `initialize_coolercontrol_services()` | Start API session, cache devices | `int` success |
-| `run_daemon(config)` | Main loop: read temps → render → sleep 60s | `int` exit code |
-
-#### Signal Handling
-
-| Function | Purpose |
-|----------|---------|
-| `setup_enhanced_signal_handlers()` | Register SIGTERM/SIGINT/SIGHUP handlers |
-| `handle_shutdown_signal(signum)` | Display shutdown image, stop loop |
-
-#### PID Management
-
-| Function | Purpose |
-|----------|---------|
-| `write_pid_file(path)` | Atomic PID file creation with O_EXCL |
-| `remove_pid_file(path)` | Secure deletion with validation |
-| `check_existing_instance_and_handle(path)` | Detect running instance via PID |
-
-#### Cleanup
-
-| Function | Purpose |
-|----------|---------|
-| `perform_cleanup(config)` | Cleanup session + PID + temp image |
-| `send_shutdown_image_if_needed()` | Upload shutdown.png on exit |
-
----
-
-### Module: device/config.c (Configuration System)
-
-| Function | Purpose |
-|----------|---------|
-| `load_plugin_config(config, path)` | Load JSON config, apply defaults, log result |
-| `set_*_defaults(config)` | Initialize subsystem fields with hardcoded defaults |
-| `log_message(level, format, ...)` | Global logging function (respects verbose flag) |
-
-**Default Values:**
-
-```c
-daemon_address = "http://localhost:11987"
-access_token = ""
-display_width = 0  // auto-detected from API
-display_refresh_interval = 2.5
-lcd_brightness = 80
-```
-
-**JSON Sections:**
-
-```json
-{
-  "daemon": { "address": "...", "access_token": "cc_<uuid>" },
-  "display": { "width": 0, "height": 0, "brightness": 80, "mode": "dual" },
-  "layout": { "bar_height": 30, "label_size": 18, "value_size": 24 },
-  "font": { "face": "Roboto" },
-  "temperature": { "cpu_low": 50, "cpu_medium": 70, "cpu_high": 85 },
-  "colors": { "background": [0,0,0], "cpu_label": [255,255,255] }
-}
-
----
-
-### Module: srv/cc_main.c (Session Management)
-
-#### Public API (4 functions)
-
-| Function | Purpose | Returns |
-|----------|---------|---------|
-| `init_coolercontrol_session(config)` | Initialize CURL session and Bearer header | `int` success |
-| `is_session_initialized()` | Check session state | `int` boolean |
-| `cleanup_coolercontrol_session()` | Cleanup CURL session resources | `void` |
-| `send_image_to_lcd(config, image_path, device_uid)` | Upload PNG to LCD | `int` success |
-
-#### Internal Helpers (15 functions)
-
-```c
-cc_init_response_buffer()        // Allocate HTTP response buffer
-write_callback()                 // libcurl write callback
-build_login_credentials()        // Construct login URL + credentials
-configure_login_curl()           // Setup CURL for login
-build_lcd_upload_form()          // Create multipart form (mode/brightness/image)
-add_mime_field()                 // Add string field to form
-add_image_file_field()           // Add PNG file to form
-configure_lcd_upload_curl()      // Setup CURL for upload
-validate_upload_params()         // Check parameters before upload
-check_upload_response()          // Validate HTTP 200 response
-```
-
-**Session State:**
-
-```c
-static CoolerControlSession cc_session = {
-    .curl_handle = NULL,
-    .cookie_jar = {0},
-    .session_initialized = 0
-};
-```
-
----
-
-### Module: srv/cc_conf.c (Device Cache)
-
-#### Public API (4 functions)
-
-| Function | Purpose | Returns |
-|----------|---------|---------|
-| `init_device_cache(config)` | Fetch device info once (GET /devices) | `int` success |
-| `get_cached_lcd_device_data(config, uid, name, width, height)` | Read cached data | `int` success |
-| `update_config_from_device(config)` | Auto-set width/height if 0 | `int` updated |
-| `is_circular_display_device(name, width, height)` | Detect display shape | `int` boolean |
-
-#### Internal Helpers (16 functions)
-
-```c
-initialize_device_cache()        // HTTP GET + JSON parse + cache population
-parse_lcd_device_data()          // Extract device info from JSON
-extract_device_type_from_json()  // Get "type" field
-extract_device_uid()             // Get "uid" field
-extract_device_name()            // Get "name" field
-extract_lcd_dimensions()         // Get screen_width/screen_height
-search_lcd_device()              // Find first CoolerControl LCD device in array
-configure_device_cache_curl()    // Setup CURL for /devices request
-process_device_cache_response()  // Parse response + populate cache
-```
-
-**Cache Structure:**
-
-```c
-static struct {
-    int initialized;
-    char device_uid[128];
-    char device_name[CC_NAME_SIZE];
-    int screen_width;
-    int screen_height;
-} device_cache = {0};
-```
-
----
-
-### Module: srv/cc_sensor.c (Temperature Monitoring)
-
-#### Public API (1 function)
-
-| Function | Purpose | Returns |
-|----------|---------|---------|
-| `get_temperature_monitor_data(config, data)` | Read CPU/GPU temps | `int` success |
-
-**Data Structure:**
-
-```c
-typedef struct {
-    float temp_cpu;
-    float temp_gpu;
-} monitor_sensor_data_t;
-```
-
-#### Internal Helpers (5 functions)
-
-```c
-get_temperature_data()           // HTTP POST /status + parse response
-parse_temperature_data()         // Extract temps from JSON
-extract_device_temperature()     // Get temp from status_history[last].temps[]
-configure_status_request()       // Setup CURL for /status POST
-```
-
-**Temperature Validation:**
-
-```c
-if (temperature < -50.0f || temperature > 150.0f)
-    continue;  // Invalid, skip sensor
-```
-
----
-
-### Module: mods/display.c + dual.c + circle.c (Rendering)
-
-#### Public API
-
-| Function | Purpose | Returns |
-|----------|---------|---------|
-| `draw_display_image(config)` | Dispatch to dual or circle mode | `void` |
-| `draw_dual_image(config)` | Render CPU+GPU simultaneously, upload | `void` |
-| `draw_circle_image(config)` | Render alternating sensor slot, upload | `void` |
-
-#### Internal Helpers
-
-```c
-calculate_scaling_params()       // Compute inscribe factor, margins
-draw_background()                // Fill background color
-draw_temperature_section()       // Render CPU/GPU label+value+bar
-draw_temperature_label()         // Render "CPU"/"GPU" text
-draw_temperature_value()         // Render "45.0°C" text
-draw_temperature_bar()           // Render colored bar with border
-get_bar_color()                  // Select color based on thresholds
-calculate_temp_fill_width()      // Compute bar fill width from temp
-set_cairo_color()                // Convert Color struct to cairo RGB
-cairo_color_convert()            // uint8_t (0-255) → double (0.0-1.0)
-```
-
-**Rendering Workflow:**
-
-```c
-cairo_surface_t *surface = cairo_image_surface_create(CAIRO_FORMAT_ARGB32, width, height);
-cairo_t *cr = cairo_create(surface);
-
-// Draw background
-cairo_set_source_rgb(cr, bg_r, bg_g, bg_b);
-cairo_paint(cr);
-
-// Draw CPU section (top half)
-draw_temperature_section(cr, config, params, data->temp_cpu, "CPU", CPU);
-
-// Draw GPU section (bottom half)
-draw_temperature_section(cr, config, params, data->temp_gpu, "GPU", GPU);
-
-// Save to PNG
-cairo_surface_write_to_png(surface, "/etc/coolercontrol/plugins/coolerdash/coolerdash.png");
-cairo_destroy(cr);
-cairo_surface_destroy(surface);
-```
-
----
-
-## Development Guidelines
-
-### Code Style
-
-- **Standard:** C99 with POSIX.1-2001 extensions
-- **Indentation:** 4 spaces (no tabs)
-- **Line Length:** 120 characters maximum
-- **Naming:**
-  - Functions: `snake_case`
-  - Structs: `PascalCase` (e.g., `Config`, `ScalingParams`)
-  - Constants: `UPPER_SNAKE_CASE`
-  - Static functions: `static` prefix, file-scope only
-
-### Error Handling
-
-**Pattern:** Check every allocation, API call, file operation
-
-```c
-// Example: Safe malloc
-char *buffer = malloc(size);
-if (!buffer) {
-    log_message(LOG_ERROR, "Memory allocation failed");
-    return 0;
-}
-
-// Example: CURL error checking
-CURLcode res = curl_easy_perform(curl);
-if (res != CURLE_OK) {
-    log_message(LOG_ERROR, "CURL failed: %s", curl_easy_strerror(res));
-    return 0;
-}
-
-// Example: File operation
-FILE *fp = fopen(path, "r");
-if (!fp) {
-    log_message(LOG_ERROR, "Cannot open file: %s", path);
-    return 0;
-}
-```
 
-### Memory Safety
+# Debug build
+make clean && make debug
 
-**Rules:**
-
-1. **Always free what you allocate** (RAII pattern)
-2. **Check for NULL before dereferencing**
-3. **Use fixed-size buffers with bounds checking**
-4. **Prefer stack allocation for small objects**
-
-**Example (cleanup pattern):**
-
-```c
-int my_function(void) {
-    char *buffer = malloc(1024);
-    if (!buffer)
-        return 0;
-
-    CURL *curl = curl_easy_init();
-    if (!curl) {
-        free(buffer);
-        return 0;
-    }
-
-    // ... use resources ...
-
-    // Cleanup (always reached)
-    curl_easy_cleanup(curl);
-    free(buffer);
-    return 1;
-}
-```
-
-### Logging Levels
-
-```c
-typedef enum {
-    LOG_INFO,     // Only shown with --verbose flag
-    LOG_STATUS,   // Always shown (important state changes)
-    LOG_WARNING,  // Always shown (non-fatal issues)
-    LOG_ERROR     // Always shown (fatal errors)
-} log_level_t;
-```
-
-**Usage:**
-
-```c
-log_message(LOG_INFO, "Reading config from %s", path);       // Verbose only
-log_message(LOG_STATUS, "Session initialized successfully"); // Always
-log_message(LOG_WARNING, "Using fallback value for %s", key); // Always
-log_message(LOG_ERROR, "Failed to connect to API");          // Always
-```
-
-### Adding New Configuration Options
-
-**Steps:**
-
-1. **Add field to Config struct** (`src/device/config.h`)
-2. **Add default value** (`src/device/config.c` → appropriate `set_*_defaults()`)
-3. **Add JSON parsing** (`src/device/config.c` → `load_*_from_json()` function)
-4. **Update documentation** (`docs/config-guide.md`)
-5. **Update example config** (`/etc/coolercontrol/plugins/coolerdash/config.json`)
-
-**Example 1: Adding Circle Mode Switch Interval (uint16_t with validation)**
-
-```c
-// 1. config.h - Add field to Config struct
-typedef struct {
-    // ...
-    uint16_t circle_switch_interval;  // Circle mode sensor switch interval (1-60s)
-} Config;
-
-// 2. config.c - Set default value
-static void set_display_defaults(Config *config) {
-    if (config->circle_switch_interval == 0)
-        config->circle_switch_interval = 5;
-}
-
-// 3. config.c - Add JSON parsing
-static void load_display_from_json(Config *config, json_t *display) {
-    json_t *val = json_object_get(display, "circle_switch_interval");
-    if (json_is_integer(val)) {
-        long v = json_integer_value(val);
-        if (v >= 1 && v <= 60)
-            config->circle_switch_interval = (uint16_t)v;
-        else
-            log_message(LOG_WARNING, "circle_switch_interval must be 1-60, using default: 5");
-    }
-}
-```
-
-**Example 2: Adding Content Scale Factor (float with validation)**
-
-```c
-// 1. config.h - Add field to Config struct
-typedef struct {
-    // ...
-    float display_content_scale_factor;  // Content scale factor (0.5-1.0)
-} Config;
-
-// 2. config.c - Set default value
-static void set_display_defaults(Config *config) {
-    // ...
-    config->display_content_scale_factor = 0.98f;  // Default: 98% (2% margin)
-}
-
-// 3. config.c - Add JSON parsing
-static void load_display_from_json(Config *config, json_t *display) {
-    json_t *val = json_object_get(display, "content_scale_factor");
-    if (json_is_real(val)) {
-        float f = (float)json_real_value(val);
-        if (f >= 0.5f && f <= 1.0f)
-            config->display_content_scale_factor = f;
-    }
-}
-```
-
-**Example 3: Adding New Color**
-
-```c
-// 1. config.h
-typedef struct {
-    // ...
-    Color color_my_new_element;
-} Config;
-
-// 2. config.c - Set default value
-static void set_color_defaults(Config *config) {
-    // ...
-    config->color_my_new_element = (Color){0, 255, 0};  // Green
-}
-
-// 3. config.c - Add JSON parsing
-static void load_colors_from_json(Config *config, json_t *colors) {
-    json_t *my_obj = json_object_get(colors, "my_new_element");
-    if (json_is_object(my_obj))
-        parse_color_from_json(my_obj, &config->color_my_new_element);
-}
-```
-
-**Configuration Best Practices:**
-- Always provide sensible defaults in `set_*_defaults()`
-- Validate user input with clear error messages using `log_message(LOG_WARNING, ...)`
-- Use appropriate data types (`uint16_t` for small integers, `float` for decimals)
-- Document acceptable ranges in both code comments and `config.json`
-- Log warnings for invalid values and fallback to defaults
-
----
-
-## Testing & Debugging
-
-### Manual Testing
-
-```bash
-# 1. Stop service
-sudo systemctl stop coolerdash.service
-
-# 2. Run manually with verbose logging
+# Manual run
+sudo systemctl stop coolercontrold
 coolerdash --verbose
 
-# 3. Watch for errors/warnings in output
-# Expected: [CoolerDash STATUS] messages every 60s
-
-# 4. Check generated image
-ls -lh /tmp/coolerdash.png
-file /tmp/coolerdash.png  # Should show: PNG image data, 320 x 320, ...
-```
-
-### Debug Build
-
-```bash
-# Compile with debug symbols + AddressSanitizer
-make clean
-make debug
-
-# Run under debugger
-gdb bin/coolerdash
-(gdb) run --verbose
-
-# Check for memory leaks
-# AddressSanitizer will report any leaks on exit
-```
-
-### Service Debugging
-
-```bash
-# Check service status
-systemctl status coolerdash.service
-
-# View recent logs
-journalctl -u coolerdash.service -n 50
-
-# Follow logs in real-time
+# Service logs
 journalctl -xeu coolerdash.service -f
-
-# Restart service
-sudo systemctl restart coolerdash.service
-```
-
-### Common Issues
-
-#### Issue: "Session initialization failed"
-
-**Cause:** CoolerControl not running or wrong credentials
-**Debug:**
-
-```bash
-# Check CoolerControl status
-systemctl status coolercontrold
-
-# Check configured access token
-grep access_token /etc/coolercontrol/plugins/coolerdash/config.json
-```
-
----
-
-#### Issue: "No LCD devices found"
-
-**Cause:** Device not detected or wrong type
-**Debug:**
-
-```bash
-# List devices via API
-curl http://localhost:11987/devices | jq '.devices[] | {uid, name, type}'
-
-# Check for Liquidctl type
-# Expected: "type": "Liquidctl"
-```
-
----
-
-#### Issue: "Display wrong shape (circular/rectangular)"
-
-**Cause:** Incorrect display detection logic
-**Debug:**
-
-```bash
-# Run with verbose logging
-coolerdash --verbose
-
-# Look for log message:
-# [CoolerDash STATUS] Display shape: circular (based on 320x320 Kraken)
-# or
-# [CoolerDash STATUS] Display shape: rectangular (based on 240x240)
-
-# Force circular mode (developer flag)
-coolerdash --develop  # All displays treated as circular
-```
-
----
-
-#### Issue: "Temperature values incorrect"
-
-**Cause:** Wrong sensor selection
-**Debug:**
-
-```bash
-# Check raw API response
-curl -u CCAdmin:coolAdmin -X POST http://localhost:11987/status \
-  -H "Content-Type: application/json" \
-  -d '{"all": false, "since": "1970-01-01T00:00:00.000Z"}' | jq
-
-# Look for temps[] arrays in CPU/GPU devices
-# Verify sensor names match expected patterns:
-#   CPU: "temp1"
-#   GPU: contains "GPU" or "gpu"
-```
-
----
-
-### Profiling
-
-**CPU Usage Monitoring:**
-
-```bash
-# Check daemon resource usage
-ps aux | grep coolerdash
-
-# Expected: ~0.1% CPU (idle most of time, 60s sleep)
-# Memory: ~10-20 MB RSS
-```
-
-**API Call Timing:**
-
-```bash
-# Enable verbose logging
-coolerdash --verbose 2>&1 | grep -E "(Session|Temperature|Upload)"
-
-# Expected timing:
-# Session init: <1s
-# Temperature fetch: <500ms
-# Image render: <200ms
-# LCD upload: <1s
 ```
 
 ---
 
-## Performance Characteristics
-
-### Resource Usage
-
-- **Memory:** ~15 MB RSS (static allocations + Cairo surface)
-- **CPU (idle):** <0.1% (60s sleep between updates)
-- **CPU (active):** ~5-10% (during rendering + upload, <2s every 60s)
-- **Network:** ~50 KB/min (API calls + image uploads)
-- **Disk I/O:** Minimal (one PNG write per update)
-
-### Optimization Strategies
-
-1. **Device Caching:** One-time API call instead of per-frame lookup
-2. **Exponential Buffer Growth:** Reduce realloc() calls for HTTP responses
-3. **Static Session:** Persistent CURL handle + cookie reuse
-4. **Stack Allocation:** Small structs on stack (ScalingParams, etc.)
-5. **Efficient Scaling Math:** Pre-computed inscribe factors
-
----
-
-## Future Development
-
-### Potential Enhancements
-
-- [ ] **Multi-display support:** Handle multiple LCD devices simultaneously
-- [ ] **Plugin system:** External modules for custom visualizations
-- [ ] **GPU utilization:** Show usage % in addition to temperature
-- [ ] **Network stats:** Bandwidth monitoring on display
-- [ ] **Custom images:** User-provided background/overlay images
-- [ ] **Animation support:** GIF/APNG rendering
-- [ ] **Themes:** Predefined color/layout presets
-- [ ] **Web UI:** Browser-based configuration editor
-
-### Contributing
-
-**Repository:** https://github.com/damachine/coolerdash
-**Issues:** https://github.com/damachine/coolerdash/issues
-**Discussions:** https://github.com/damachine/coolerdash/discussions
-
-**Pull Request Checklist:**
-
-- [ ] Code follows C99 standard + style guidelines
-- [ ] No compiler warnings with `-Wall -Wextra`
-- [ ] All allocations have matching frees
-- [ ] Error paths properly handled
-- [ ] Tested with `make debug` (AddressSanitizer)
-- [ ] Documentation updated (if adding features)
-- [ ] CHANGELOG.md entry added
-
----
-
-## License
-
-**MIT License** - See LICENSE file for full text.
-
-**Copyright (c) 2025 damachine (damachin3@proton.me)**
-
----
-
 ## References
 
-### External Documentation
-
-- **CoolerControl API:** https://gitlab.com/coolercontrol/coolercontrol/-/blob/main/openapi-spec.json
-- **Cairo Graphics:** https://www.cairographics.org/manual/
-- **libcurl:** https://curl.se/libcurl/c/
-- **Jansson JSON:** https://jansson.readthedocs.io/
-
-### Project Files
-
-- **Configuration Guide:** `docs/config-guide.md`
-- **Supported Devices:** `docs/devices.md`
-- **Display Detection:** `docs/display-detection.md`
-- **Example Config:** `etc/coolercontrol/plugins/coolerdash/config.json`
-
----
-
-**Document Version:** 2.x
-**Last Updated:** 2026
-**Maintained by:** damachine (damachin3@proton.me)
+- CoolerControl API: https://gitlab.com/coolercontrol/coolercontrol
+- Cairo: https://www.cairographics.org/manual/
+- libcurl: https://curl.se/libcurl/c/
+- Jansson: https://jansson.readthedocs.io/
diff --git a/docs/devices.md b/docs/devices.md
index faf8339..f3862aa 100644
--- a/docs/devices.md
+++ b/docs/devices.md
@@ -1,25 +1,20 @@
-## Supported Devices (Compatibility List)
+## Supported Devices
 
-### This file contains a community-maintained list of devices confirmed to work with **Coolerdash**.  
-### If Coolerdash works or not on your device, please submit a [Device Confirmation Issue](https://github.com/damachine/coolerdash/issues/new?template=device-confirmation.yml).
----
+If CoolerDash works (or not) on your device, submit a [Device Confirmation Issue](https://github.com/damachine/coolerdash/issues/new?template=device-confirmation.yml).
 
 ## Confirmed Devices
 
-| Manufacturer     | Model / Device           | Status        | Tester (GitHub)         | Date       |
-|------------------|--------------------------|---------------|-------------------------|------------|
-| NZXT             | Kraken 2023              | ✅ Working    | @damachine              | 2025-06-08 |
-| NZXT             | Kraken 2023              | ✅ Working    | @Kimloc (discord)       | 2025-08-27 |
-| NZXT             | Kraken 2023              | ✅ Working    | @olivetti80             | 2025-09-12 |
-| NZXT             | Kraken 2023 Elite        | ⚠️ Partially  | @Mondkeks               | 2025-10-09 |
-| NZXT             | Kraken Z63               | ✅ Working    | @SSUPD-Beast            | 2025-11-24 |
-| NZXT             | Kraken Plus 240          | ❌ Not working | @K-Michallik            | 2026-02-23 |
-| ?                | ?                        | ?             | ?                       | ?          |
-|------------------|--------------------------|---------------|-------------------------|------------|
-
----
+| Manufacturer | Model | Status | Tester | Date |
+|-------------|-------|--------|--------|------|
+| NZXT | Kraken 2023 | ✅ Working | @damachine | 2025-06-08 |
+| NZXT | Kraken 2023 | ✅ Working | @Kimloc (discord) | 2025-08-27 |
+| NZXT | Kraken 2023 | ✅ Working | @olivetti80 | 2025-09-12 |
+| NZXT | Kraken 2023 Elite | ⚠️ Partially | @Mondkeks | 2025-10-09 |
+| NZXT | Kraken Z63 | ✅ Working | @SSUPD-Beast | 2025-11-24 |
+| NZXT | Kraken Plus 240 | ❌ Not working | @K-Michallik | 2026-02-23 |
 
 ### Legend
-- ✅ Working  
-- ⚠️ Partially working (with limitations)  
+
+- ✅ Working
+- ⚠️ Partially working
 - ❌ Not working
diff --git a/docs/display-detection.md b/docs/display-detection.md
index 1ecf751..034aa4b 100644
--- a/docs/display-detection.md
+++ b/docs/display-detection.md
@@ -1,364 +1,77 @@
+# Display Shape Detection
 
-# Display Shape Detection System
+Determines whether a display is circular or rectangular. Affects inscribe factor and layout calculations.
 
-## Overview
-
-The system automatically detects whether a display is **circular** (round) or **rectangular** and adjusts calculations accordingly. You can also **manually override** the detection using the `shape` configuration parameter.
-
-## Configuration Override
-
-**Manual control via `config.json`**
+## Config Override
 
 ```json
-{
-  "display": {
+"display": {
     "shape": "auto"
-  }
 }
 ```
 
-> Values: `"auto"` (default), `"rectangular"`, `"circular"`
-
-### Priority System
-
-1. **`shape` config parameter** (highest priority - manual override)
-2. **Automatic detection** (default behavior)
-
-**Examples:**
-```bash
-# Config file controls shape
-coolerdash  # Uses shape from config.json
-```
+Values: `"auto"` (default), `"rectangular"`, `"circular"`
 
-## Automatic Detection
+Priority: `shape` config > auto-detection.
 
-### 1. NZXT Kraken Device Logic (Resolution-Based)
+## Auto-Detection
 
-**Special handling for NZXT Kraken devices - resolution determines shape:**
+### NZXT Kraken (resolution-based)
 
 ```c
-// NZXT Kraken display shape rules:
-// - 240x240 or smaller = RECTANGULAR (no inscribe factor)
-// - Larger than 240x240 (e.g., 320x320) = CIRCULAR (with inscribe factor)
-
-if (is_kraken) {
-    const int is_large_display = (screen_width > 240 || screen_height > 240);
-    return is_large_display ? 1 : 0;  // 1 = circular, 0 = rectangular
-}
+// ≤240×240 → rectangular (inscribe_factor = 1.0)
+// >240×240  → circular   (inscribe_factor = 0.7071)
 ```
 
-**Examples:**
-- NZXT Kraken 2023 (240×240) → **Rectangular** (inscribe factor = 1.0)
-- NZXT Kraken Z (320×320) → **Circular** (inscribe factor = 0.7071)
+### Other Devices
 
-### 2. Device Database for Non-Kraken Devices
+Checked against `circular_devices[]` database in `cc_conf.c`. Unknown devices default to rectangular.
 
-For other brands, the function `is_circular_display_device()` uses a database:
-
-```c
-// Database of non-Kraken devices with CIRCULAR displays
-const char *circular_devices[] = {
-    // Add other brands with circular displays here
-    // Example: "Corsair LCD Circular Model"
-};
-```
+## Inscribe Factor (1/√2)
 
-### 3. Automatic Detection Priority (when shape=auto)
-
-1. **NZXT Kraken devices**: Resolution-based detection (≤240×240 = rectangular, >240×240 = circular)
-2. **Other devices**: Check device name database
-3. **Default**: Rectangular (safer fallback)
-
-**Note:** Manual override via `shape` config parameter takes precedence over all automatic detection methods.
-
-## Math Explanation
-
-### Why 0.7071 (1/√2)?
-
-**Problem**: Prevent clipping on circular displays
+Circular displays need content within an inscribed square to prevent clipping.
 
 ```
-Circular Display (Radius = R)
-┌─────────────────────┐
-│         ╱───╲       │
-│       ╱       ╲     │
-│      │         │    │  ← Circular viewport
-│      │ [TEXT]  │    │  ← Rectangular content must fit inside
-│       ╲       ╱     │
-│         ╰───╯       │
-└─────────────────────┘
+Circle radius = R
+Inscribed square side = R × √2
+Ratio = 1/√2 ≈ 0.7071
 ```
 
-**Solution**: Largest square that fits in a circle
+Configurable via `inscribe_factor` in `config.json` (default: 0.70710678, `0` = auto).
 
-```
-If circle radius = R:
-- Diameter = 2R
-- Inscribed square diagonal = 2R
-- Inscribed square side = 2R / √2 = R√2
-- Safe area ratio = (R√2) / (2R) = √2/2 = 1/√2 ≈ 0.7071
-```
+### Calculation
 
-**Example** (240×240 circular display):
-- Without factor: Bars would be 240px wide → **CLIPPED at edges**
-- With factor: Bars are 240 × 0.7071 = 169.7px wide → **Fully visible**
+| Display | Resolution | Shape | inscribe_factor | safe_area | margin |
+|---------|-----------|-------|-----------------|-----------|--------|
+| Kraken 2023 | 240×240 | rectangular | 1.0 | 240px | ~2px |
+| Kraken Z | 320×320 | circular | 0.7071 | ~226px | ~47px |
 
-## Calculation Examples
+## Adding Devices
 
-### NZXT Kraken 2023 (240×240 - Rectangular)
-
-**Circular Displays:**
-```
-inscribe_factor = 0.7071 (reduced safe area) - NOTE: The `inscribe_factor` is configurable via `display_inscribe_factor` in `config.json`; default is 0.70710678 (0.0 = auto)
-safe_area_width = 240 × 0.7071 = ~170px
-safe_bar_width = 170 × 0.98 = ~167px
-margin = (240 - 170) / 2 = ~35px
-```
-
-**Rectangular Displays:**
-```
-inscribe_factor = 1.0 (no reduction)
-safe_area_width = 240 × 1.0 = 240px
-safe_bar_width = 240 × 0.98 = ~235px
-margin = (240 - 235) / 2 = ~2.5px
-```
+### Circular (non-Kraken)
 
-### NZXT Kraken Z (320×320 - Circular)
-
-**Circular Displays:**
-```
-inscribe_factor = 0.7071 (reduced safe area)
-safe_area_width = 320 × 0.7071 = ~226px
-safe_bar_width = 226 × 0.98 = ~221px
-margin = (320 - 226) / 2 = ~47px
-```
-
-## Adding New Devices
-
-### Adding a Circular Display (Non-Kraken)
-
-Edit `src/srv/cc_conf.c`, function `is_circular_display_device()`:
+Add to `circular_devices[]` in `src/srv/cc_conf.c`:
 
 ```c
 const char *circular_devices[] = {
-    "Corsair LCD Circular",  // Example
-    "Your Device Name",      // Add here
+    "Your Device Name",
 };
 ```
 
-**Important:** The device name only needs to be **contained**, not exactly match!
-- `"Corsair LCD"` matches: "Corsair LCD Circular 240", "Corsair LCD", etc.
-
-### NZXT Kraken Devices
-
-**No database entry needed!** Resolution-based detection:
-- **240×240 or smaller**: Automatically rectangular
-- **Larger than 240×240**: Automatically circular
-
-### Rectangular Display
-
-Rectangular displays do **not** need to be added to the database!
-
-The system treats all unknown devices as **rectangular** (safer fallback).
-
-## Detection Examples
-
-| Device Name           | Resolution | Detection Result | Inscribe Factor | Reason                     |
-|-----------------------|-----------|------------------|-----------------|----------------------------|
-| NZXT Kraken 2023      | 240×240   | **Rectangular**  | 1.0             | Kraken ≤240×240            |
-| NZXT Kraken Z         | 320×320   | **Circular**     | 0.7071          | Kraken >240×240            |
-| Generic Device        | 240×240   | **Rectangular**  | 1.0             | Not in database, default   |
-| Custom Circular LCD   | 240×240   | **Rectangular**  | 1.0             | Needs database entry       |
-
-## Logging
-
-The system logs the detection:
-
-```
-[INFO] Circular display detected (device: NZXT Kraken Z, inscribe factor: 0.7071)
-[INFO] Rectangular display detected (device: NZXT Kraken 2023, inscribe factor: 1.0000)
-```
-
-## Visualization
-
-### Circular Display (240×240) - NZXT Kraken Z
+Name matching uses `strstr` — partial matches work.
 
-```
-┌─────────────────────┐
-│   [invisible]       │
-│  ╭─────────╮       │
-│ ╱           ╲      │
-│ │ CPU  33°  │      │  ← safe_area_width = 170px
-│ │ ████░░░░░ │      │  ← bar_width = 167px
-│ │ GPU  46°  │      │
-│ ╲           ╱      │
-│  ╰─────────╯       │
-│   [invisible]       │
-└─────────────────────┘
-    margin = 37px
-```
-
-### Rectangular Display (240×240) - NZXT Kraken 2023
-
-```
-┌─────────────────────┐
-│ CPU  33°            │
-│ ████████████████░░░ │  ← bar_width = 235px
-│                     │
-│ GPU  46°            │
-│ ████████████████░░░ │
-│                     │
-└─────────────────────┘
-  margin = 2.5px
-```
+### NZXT Kraken
 
-## API Reference
+No database entry needed. Resolution-based detection is automatic.
 
-### Function: `is_circular_display_device()`
+### Rectangular
 
-**Location**: `src/srv/cc_conf.c`
-
-**Signature**:
-```c
-int is_circular_display_device(const char *device_name, int screen_width, int screen_height)
-```
-
-**Parameters**:
-- `device_name`: Device identifier string (e.g., "NZXT Kraken 2023")
-- `screen_width`: Display width in pixels
-- `screen_height`: Display height in pixels
-
-**Returns**:
-- `1` if circular display detected
-- `0` if rectangular display detected
-
-**Logic**:
-1. Check if device name contains "Kraken"
-2. If Kraken: Use resolution-based detection (>240×240 = circular)
-3. If not Kraken: Check device database
-4. Default: Rectangular (safer fallback)
-
-### C Functions
-
-```c
-// In cc_conf.h/c
-int is_circular_display_device(const char *device_name, int screen_width, int screen_height);
-
-// In display.c
-static void calculate_scaling_params(
-    const struct Config *config, 
-    ScalingParams *params, 
-    const char *device_name
-);
-
-void draw_display_image(const struct Config *config);
-```
-
-## Testing
-
-### Manual Test
-
-1. Compile:
-   ```bash
-   make
-   ```
-
-2. Install and restart service:
-   ```bash
-   makepkg -fsi
-   systemctl daemon-reload
-   systemctl restart coolerdash.service
-   ```
-
-3. Check logs:
-   ```bash
-   journalctl -u coolerdash.service -f
-   ```
-
-Expected output for **NZXT Kraken 2023 (240×240)**:
-```
-[INFO] Rectangular display detected (device: NZXT Kraken 2023, inscribe factor: 1.0000)
-[INFO] Sending image to LCD: NZXT Kraken 2023 [abc123...]
-```
-
-Expected output for **NZXT Kraken Z (320×320)**:
-```
-[INFO] Circular display detected (device: NZXT Kraken Z, inscribe factor: 0.7071)
-[INFO] Sending image to LCD: NZXT Kraken Z [abc123...]
-```
+No action needed. Unknown devices default to rectangular.
 
 ## Troubleshooting
 
-### Problem: Clipping on circular display
-
-**Cause**: Device not detected as circular
-
-**Solution Options**:
-1. **Quick fix (recommended)**: Set `shape` to `"circular"` in `config.json`
-2. For NZXT Kraken: Verify resolution is >240×240
-3. For other devices: Add device name to database in `cc_conf.c`
-
-### Problem: Too much padding on rectangular display
-
-**Cause**: Incorrectly detected as circular
-
-**Solution Options**:
-1. **Quick fix (recommended)**: Set `shape` to `"rectangular"` in `config.json`
-2. For NZXT Kraken: Verify resolution is ≤240×240
-3. For other devices: Ensure not in circular device database
-
-### Problem: Unknown device defaults to rectangular
-
-**Cause**: Not in database and not NZXT Kraken
-
-**Solution**: This is intentional (safe default). Set `shape` to `"circular"` in `config.json` if needed.
-
-### Testing Shape Override
-
-```bash
-# Test rectangular layout - set in config.json: "shape": "rectangular"
-sudo systemctl restart coolerdash.service
-
-# Test circular layout - set in config.json: "shape": "circular"
-sudo systemctl restart coolerdash.service
-
-# Check logs for inscribe factor
-journalctl -u coolerdash.service -f | grep "inscribe"
-```
-
-Expected output with manual override:
-```
-[INFO] Display shape forced to rectangular (inscribe factor: 1.0000)
-[INFO] Display shape forced to circular (inscribe factor: 0.7071)
-```
-
-
-### Problem: Display Detected Incorrectly
-
-**Solution for Circular display treated as rectangular:**
-- Add device name to database in `cc_conf.c`
-
-**Solution for Rectangular display treated as circular:**
-1. Check if device name is incorrectly in `circular_devices[]`
-2. Remove from database
-
-## Implementation Details
-
-### Constants
-
-```c
-#define M_SQRT1_2  0.7071067811865476  // 1/√2 (inscribe factor)
-#define CONTENT_SCALE_FACTOR  0.98      // Bars use 98% of safe area
-#define TEMP_EDGE_MARGIN_FACTOR  0.02   // 2% margin for temperature labels
-```
-
-### Scaling Flow
-
-1. **Device Detection**: `is_circular_display_device()` checks device name and resolution
-2. **Inscribe Factor**: Set to 0.7071 (circular) or 1.0 (rectangular)
-3. **Safe Area Calculation**: `safe_width = display_width × inscribe_factor`
-4. **Content Scaling**: `bar_width = safe_width × CONTENT_SCALE_FACTOR`
-
----
-
-**Last Updated**: After resolution-based NZXT Kraken detection implementation
+| Problem | Solution |
+|---------|----------|
+| Clipping on circular display | Set `"shape": "circular"` in config |
+| Too much padding on rectangular | Set `"shape": "rectangular"` in config |
+| Unknown device | Set `shape` manually or add to database |
diff --git a/docs/display-modes.md b/docs/display-modes.md
index c7fcc12..1c9cbd6 100644
--- a/docs/display-modes.md
+++ b/docs/display-modes.md
@@ -1,827 +1,127 @@
-# CoolerDash Display Modes - Developer Guide
+# Display Modes
 
-## Table of Contents
-- [Overview](#overview)
-- [Architecture](#architecture)
-- [Dual Mode](#dual-mode)
-- [Circle Mode](#circle-mode)
-- [Configuration System](#configuration-system)
-- [Rendering Pipeline](#rendering-pipeline)
-- [Display Detection](#display-detection)
-- [Adding New Modes](#adding-new-modes)
+Two modes: **dual** (default) and **circle**.
 
----
-
-## Overview
-
-CoolerDash supports two distinct display modes for rendering temperature information on LCD screens:
-
-- **Dual Mode** (`dual`): Simultaneous display of CPU and GPU temperatures with side-by-side layout
-- **Circle Mode** (`circle`): Alternating single-sensor display optimized for circular high-resolution screens
-
-### Mode Selection
-
-The mode is selected through a two-tier configuration system:
-
-1. **System Default** (`src/device/config.c`): `display_mode = "dual"`
-2. **User Configuration** (`/etc/coolercontrol/plugins/coolerdash/config.json`): `"mode": "dual"|"circle"`
-
----
+Mode selection: `config.json` → `"display": { "mode": "dual" }` or CLI `--dual` / `--circle`.
 
-## Architecture
-
-### File Structure
+## Files
 
 ```
 src/mods/
-├── display.c       # Mode dispatcher
-├── display.h       # Dispatcher API
-├── dual.c          # Dual mode implementation
-├── dual.h          # Dual mode API
-├── circle.c        # Circle mode implementation
-└── circle.h        # Circle mode API
+├── display.c/h    # Mode dispatcher
+├── dual.c/h       # Dual mode
+└── circle.c/h     # Circle mode
 ```
 
-### Mode Dispatcher
-
-The mode dispatcher is located in `src/mods/display.c`:
-
+Dispatcher (`display.c`):
 ```c
-void draw_display_image(const struct Config *config)
-{
-    if (strcmp(config->display_mode, "circle") == 0) {
+void draw_display_image(const struct Config *config) {
+    if (strcmp(config->display_mode, "circle") == 0)
         draw_circle_image(config);
-    } else {
+    else
         draw_dual_image(config);
-    }
 }
 ```
 
-This function is called by the main monitoring loop and routes to the appropriate mode implementation.
-
 ---
 
 ## Dual Mode
 
-### Purpose
-Displays CPU and GPU temperatures simultaneously in a side-by-side layout.
-
-### Implementation File
-`src/mods/dual.c` (602 lines)
-
-### Key Components
-
-#### 1. ScalingParams Structure
-```c
-typedef struct {
-    double scale_x;              // Horizontal scaling factor
-    double scale_y;              // Vertical scaling factor
-    double corner_radius;        // Bar corner radius
-    double inscribe_factor;      // 1.0 (rectangular) or M_SQRT1_2 (circular)
-    int safe_bar_width;          // Safe bar width for circular displays
-    double safe_content_margin;  // Horizontal margin
-    int is_circular;             // Display type flag
-} ScalingParams;
-```
-
-#### 2. Core Functions
-
-##### `calculate_scaling_params()`
-Calculates dynamic scaling based on display dimensions:
-- Base resolution: 240x240px
-- Checks `shape` config override (rectangular/circular/auto)
-- Falls back to device detection for circular displays
-- Applies inscribe factor (1/√2 ≈ 0.7071) for circular displays
-- **Uses configurable `content_scale_factor`** (0.5-1.0, default: 0.98) to determine safe area percentage
-- Calculates safe content area to avoid edge clipping
-
-**Priority system:**
-1. `shape` config parameter (manual override)
-2. `force_display_circular` flag (deprecated)
-3. Automatic device detection (default)
-
-**Content Scale Configuration:**
-```ini
-[display]
-content_scale_factor=0.98  # 0.5-1.0, default: 0.98 (2% margin)
-```
-
-**Scale Factor Impact:**
-- **0.98-1.0:** Minimal margins, maximum screen usage
-- **0.90-0.97:** Comfortable padding, safe text rendering
-- **0.70-0.89:** Extra margins, conservative layout
-- **0.5-0.69:** Large margins, centered content focus
-
-##### `draw_dual_bars()`
-Renders CPU and GPU temperature bars:
-- Left bar: CPU temperature
-- Right bar: GPU temperature
-- Color-coded based on temperature thresholds
-- Rounded corners with configurable radius
-- Border and background colors from config
-
-##### `draw_temperature_labels()`
-Renders temperature values and labels:
-- Displays numeric temperature with degree symbol
-- Draws "CPU" and "GPU" labels
-- Uses configurable fonts and colors
-- Dynamically positions based on scaling parameters
-
-##### `render_dual_display()`
-Main rendering function:
-- Creates Cairo surface and context
-- Draws black background
-- Calls component rendering functions
-- Writes PNG to filesystem
-- Uploads image to LCD device
-
-### Layout Algorithm
+CPU and GPU temperatures side-by-side.
 
 ```
 ┌────────────────────────────┐
-│     CPU: 45°    GPU: 52°   │  ← Temperature values
-│     ┌─────┐     ┌─────┐    │
-│     │█████│     │██████│   │  ← Color-coded bars
-│     └─────┘     └─────┘    │
-│      CPU         GPU        │  ← Labels
+│     CPU: 45°    GPU: 52°   │
+│     ┌─────┐     ┌─────┐   │
+│     │█████│     │██████│   │
+│     └─────┘     └─────┘   │
+│      CPU         GPU       │
 └────────────────────────────┘
 ```
 
-### Circular Display Handling
-
-For circular displays, dual mode applies an inscribe factor:
-- Safe area width = `display_width × M_SQRT1_2 × 0.98`
-- Horizontal centering with margin calculation
-- Prevents content from clipping at display edges
-
----
-
-## Circle Mode
-
-### Purpose
-Alternates between CPU and GPU display every 5 seconds, optimized for high-resolution circular screens where dual mode scaling is not optimal.
-
-### Implementation File
-`src/mods/circle.c` (456 lines)
-
-### Key Components
-
-#### 1. SensorMode
-
-Circle mode cycles through the three sensor slots configured in `config.json`:
-
-```json
-"display": {
-    "sensor_slot_1": "cpu",
-    "sensor_slot_2": "liquid",
-    "sensor_slot_3": "gpu"
-}
-```
-
-The slots are `cpu`, `gpu`, or `liquid`. Each slot is displayed full-screen in turn.
+### ScalingParams
 
-#### 2. Global State Management
 ```c
-static int current_slot = 0;  // cycles 0→1→2→0
-static time_t last_switch_time = 0;
-```
-
-#### 3. Configuration-Based Timing
-
-The sensor switch interval is **configurable** via `config.json`:
-
-```c
-// No longer hardcoded - uses Config parameter
-void update_sensor_mode(const struct Config *config)
-{
-    time_t current_time = time(NULL);
-    
-    // Use circle_switch_interval from config (default: 5 seconds)
-    if (difftime(current_time, last_switch_time) >= config->circle_switch_interval) {
-        current_sensor = (current_sensor == SENSOR_CPU) ? SENSOR_GPU : SENSOR_CPU;
-        last_switch_time = current_time;
-    }
-}
+typedef struct {
+    double scale_x, scale_y;
+    double corner_radius;
+    double inscribe_factor;     // 1.0 (rectangular) or M_SQRT1_2 (circular)
+    int safe_bar_width;
+    double safe_content_margin;
+    int is_circular;
+} ScalingParams;
 ```
 
-**Configuration (`config.json`):**
-```json
-{
-  "display": {
-    "mode": "circle",
-    "circle_switch_interval": 5
-  }
-}
-
-**Use Cases:**
-- **Fast (1-3s):** Quick sensor overview
-- **Moderate (5-8s):** Balanced viewing (default: 5s)
-- **Slow (10-60s):** Focus on individual sensors
-
-#### 4. Core Functions
+Base resolution: 240×240. Scales dynamically.
+Circular displays: `safe_area = display_width × inscribe_factor × content_scale_factor`
 
-##### `update_sensor_mode(const struct Config *config)`
-Manages sensor alternation:
-- Uses `time()` with configurable interval from `config->circle_switch_interval`
-- Toggles between CPU and GPU
-- Logs sensor switches for debugging
+### Rendering Flow
 
-##### `draw_single_sensor()`
-Renders single sensor display:
-- **Bar-Centered Layout**: Uses temperature bar as central reference point
-- **Temperature Positioning**: 55% of display height above bar
-- **Label Positioning**: 5% of display height below bar
-- **Centering Algorithm**: Calculates total width including degree symbol for proper visual balance
+1. `draw_dual_image()` — entry point
+2. `get_cached_lcd_device_data()` — device info
+3. `get_temperature_monitor_data()` — sensor data
+4. Cairo: create surface → draw background → draw bars + labels → write PNG
+5. `send_image_to_lcd()` — upload
 
-##### `calculate_temp_fill_width()`
-Calculates temperature bar fill:
-- Bounds-checked ratio calculation
-- Uses unified `temp_max_scale` from config
-- Returns pixel width for bar fill
-
-##### `get_temperature_bar_color()`
-Determines bar color based on thresholds:
-- `temp_threshold_1`: Lowest (blue/green)
-- `temp_threshold_2`: Medium-low (yellow)
-- `temp_threshold_3`: Medium-high (orange)
-- `temp_threshold_4`: Critical (red)
+---
 
-##### `render_circle_display()`
-Main rendering function:
-- Creates Cairo surface and context
-- Updates sensor mode (checks 5s interval)
-- Renders current sensor
-- Writes PNG and uploads to LCD
+## Circle Mode
 
-### Layout Algorithm
+Alternates between sensor slots, one at a time. Optimized for circular high-res displays.
 
 ```
 ┌────────────────┐
-│                │
-│      45°       │  ← Temperature (55% above bar)
-│                │
-│    ┌──────┐    │  ← Temperature bar (centered)
+│      45°       │
+│    ┌──────┐    │
 │    │██████│    │
 │    └──────┘    │
-│                │
-│      CPU       │  ← Label (5% below bar)
-│                │
+│      CPU       │
 └────────────────┘
 ```
 
-### Centering Algorithm
-
-Temperature centering includes degree symbol width:
-```c
-// Calculate degree symbol width
-cairo_text_extents_t degree_ext;
-cairo_text_extents(cr, "°", &degree_ext);
-
-// Total width = temperature + spacing + degree
-const double total_width = temp_ext.width + 5 + degree_ext.width;
-
-// Center as a unit
-double temp_x = (config->display_width - total_width) / 2.0;
-```
-
-This ensures visual balance by treating "45°" as a single unit rather than centering only the number.
-
-### Timing Implementation
+### Sensor Slots
 
-The sensor switching interval is **configurable** via `config.json` (1-60 seconds, default: 5):
-
-```c
-void update_sensor_mode(const struct Config *config)
-{
-    time_t current_time = time(NULL);
-    
-    // Use configurable interval from config.json
-    if (difftime(current_time, last_switch_time) >= config->circle_switch_interval) {
-        current_sensor = (current_sensor == SENSOR_CPU) ? SENSOR_GPU : SENSOR_CPU;
-        last_switch_time = current_time;
-    }
-}
-```
-
-**Configuration (`config.json`):**
+Configured in `config.json`:
 ```json
-{
-  "display": {
-    "mode": "circle",
-    "circle_switch_interval": 5
-  }
-}
-
-**Note**: For sub-second precision, `nanosleep()` or `clock_gettime()` could be used, but the current implementation provides sufficient accuracy for display purposes.
-
----
-
-## Configuration System
-
-### Config Structure Extension
-
-The `Config` structure in `src/device/config.h` includes:
-```c
-char display_mode[16];  // "dual" or "circle"
-```
-
-### System Defaults (`src/device/config.c`)
-
-```c
-static void set_display_defaults(struct Config *config)
-{
-    // ... other defaults ...
-    cc_safe_strcpy(config->display_mode, sizeof(config->display_mode), "dual");
-}
-```
-
-### JSON Parsing (`src/device/config.c`)
-
-```c
-static void load_display_from_json(Config *config, json_t *display)
-{
-    json_t *val = json_object_get(display, "mode");
-    if (json_is_string(val)) {
-        const char *mode = json_string_value(val);
-        if (strcmp(mode, "dual") == 0 || strcmp(mode, "circle") == 0)
-            SAFE_STRCPY(config->display_mode, mode);
-    }
-}
-
-### CLI Override (`src/main.c`)
-
-```c
-static void parse_arguments(int argc, char *argv[], 
-                           char *display_mode_override, size_t override_size)
-{
-    for (int i = 1; i < argc; i++) {
-        if (strcmp(argv[i], "--dual") == 0) {
-            cc_safe_strcpy(display_mode_override, "dual", override_size);
-        } else if (strcmp(argv[i], "--circle") == 0) {
-            cc_safe_strcpy(display_mode_override, "circle", override_size);
-        }
-    }
-}
-
-int main(int argc, char *argv[])
-{
-    char display_mode_override[16] = {0};
-    parse_arguments(argc, argv, display_mode_override, sizeof(display_mode_override));
-    
-    if (display_mode_override[0] != '\0') {
-        cc_safe_strcpy(config.display_mode, display_mode_override, 
-                      sizeof(config.display_mode));
-    }
-}
-```
-
----
-
-## Rendering Pipeline
-
-### 1. Main Loop (`src/main.c`)
-```c
-while (1) {
-    draw_display_image(&config);  // Mode dispatcher
-    sleep(update_interval);
-}
+"sensor_slot_1": "cpu",
+"sensor_slot_2": "liquid",
+"sensor_slot_3": "gpu"
 ```
 
-### 2. Mode Dispatcher (`src/mods/display.c`)
-```c
-void draw_display_image(const struct Config *config)
-{
-    if (strcmp(config->display_mode, "circle") == 0) {
-        draw_circle_image(config);
-    } else {
-        draw_dual_image(config);
-    }
-}
-```
-
-### 3. Mode-Specific Rendering
-
-#### Dual Mode Flow:
-1. `draw_dual_image()` → Entry point
-2. `get_cached_lcd_device_data()` → Device information
-3. `get_temperature_monitor_data()` → Sensor data
-4. `render_dual_display()` → Cairo rendering
-5. `cairo_surface_write_to_png()` → PNG generation
-6. `send_image_to_lcd()` → LCD upload
+Cycles through slots at `circle_switch_interval` (default: 8s, range: 1–60s).
 
-#### Circle Mode Flow:
-1. `draw_circle_image()` → Entry point
-2. `get_cached_lcd_device_data()` → Device information
-3. `get_temperature_monitor_data()` → Sensor data
-4. `update_sensor_mode()` → Check 5s interval
-5. `render_circle_display()` → Cairo rendering
-6. `cairo_surface_write_to_png()` → PNG generation
-7. `send_image_to_lcd()` → LCD upload
+### State
 
-### 4. Common Cairo Operations
-
-Both modes use identical Cairo workflow:
 ```c
-// 1. Create surface
-cairo_surface_t *surface = cairo_image_surface_create(
-    CAIRO_FORMAT_ARGB32, width, height);
-
-// 2. Create context
-cairo_t *cr = cairo_create(surface);
-
-// 3. Draw content
-cairo_set_source_rgb(cr, 0.0, 0.0, 0.0);  // Black background
-cairo_paint(cr);
-// ... mode-specific rendering ...
-
-// 4. Write PNG
-cairo_surface_write_to_png(surface, path);
-
-// 5. Cleanup
-cairo_destroy(cr);
-cairo_surface_destroy(surface);
-```
-
----
-
-## Display Detection
-
-### Device Name Detection
-
-Both modes use `is_circular_display_device()` to detect circular displays:
-
-```c
-int is_circular = is_circular_display_device(device_name, width, height);
-```
-
-**Known Circular Devices**:
-- NZXT Kraken Elite (240x240)
-- Corsair iCUE LINK (Other models to be added)
-
-### Display Shape Override (New in v1.96)
-
-**Recommended Method:** Manual configuration override in `config.json`:
-```json
-{
-  "display": {
-    "shape": "auto"
-  }
-}
-```
-> Values: `"auto"` (default), `"rectangular"`, `"circular"` — `"circular"` inscribe factor is configurable via `display_inscribe_factor` (default: 0.70710678; 0.0 = auto).
-
-**Priority System:**
-1. `shape` config parameter (highest - manual override)
-2. Automatic device detection (default)
-
-**Use cases:**
-- Testing circular layout on rectangular displays
-- Fixing incorrect auto-detection results
-- Devices not in the detection database
-- Custom/modded hardware
-
-### Inscribe Factor Application
-
-For circular displays:
-```c
-if (is_circular) {
-    // `params->inscribe_factor` is set to either the configured
-    // `display_inscribe_factor` (>0 && <=1) or falls back to the
-    // geometric inscribe factor M_SQRT1_2 (1/√2 ≈ 0.7071)
-    params->inscribe_factor = cfg_inscribe;
-    safe_area_width = display_width * inscribe_factor;
-} else {
-    params->inscribe_factor = 1.0;
-    safe_area_width = display_width;
-}
-```
-
-This ensures content fits within the visible circular area without clipping.
-
----
-
-## Adding New Modes
-
-### Step-by-Step Guide
-
-#### 1. Create Mode Files
-
-Create `src/mods/newmode.c` and `src/mods/newmode.h`:
-
-```c
-// newmode.h
-#ifndef NEWMODE_H
-#define NEWMODE_H
-
-#include "../device/config.h"
-
-void draw_newmode_image(const struct Config *config);
-
-#endif
-```
-
-#### 2. Implement Rendering
-
-```c
-// newmode.c
-#include "newmode.h"
-#include <cairo/cairo.h>
-
-void draw_newmode_image(const struct Config *config)
-{
-    // 1. Get device info
-    char device_uid[128] = {0};
-    char device_name[128] = {0};
-    int screen_width = 0, screen_height = 0;
-    
-    if (!get_cached_lcd_device_data(config, device_uid, sizeof(device_uid),
-                           device_name, sizeof(device_name),
-                           &screen_width, &screen_height)) {
-        return;
-    }
-    
-    // 2. Get sensor data
-    monitor_sensor_data_t data = {0};
-    if (!get_temperature_monitor_data(config, &data)) {
-        return;
-    }
-    
-    // 3. Create Cairo context
-    cairo_surface_t *surface = cairo_image_surface_create(
-        CAIRO_FORMAT_ARGB32, config->display_width, config->display_height);
-    cairo_t *cr = cairo_create(surface);
-    
-    // 4. Draw your custom content
-    cairo_set_source_rgb(cr, 0.0, 0.0, 0.0);
-    cairo_paint(cr);
-    // ... your rendering code ...
-    
-    // 5. Write PNG
-    cairo_surface_write_to_png(surface, config->paths_image_coolerdash);
-    cairo_destroy(cr);
-    cairo_surface_destroy(surface);
-    
-    // 6. Upload to LCD
-    send_image_to_lcd(config, config->paths_image_coolerdash, device_uid);
-}
-```
-
-#### 3. Update Mode Dispatcher
-
-In `src/mods/dual.c`, add your mode:
-
-```c
-#include "newmode.h"
-
-void draw_display_image(const struct Config *config)
-{
-    if (strcmp(config->display_mode, "newmode") == 0) {
-        draw_newmode_image(config);
-    } else if (strcmp(config->display_mode, "circle") == 0) {
-        draw_circle_image(config);
-    } else {
-        draw_dual_image(config);
-    }
-}
-```
-
-#### 4. Update Makefile
-
-```makefile
-SRC_MODULES = src/mods/dual.c src/mods/circle.c src/mods/newmode.c
-HEADERS = ... src/mods/newmode.h
-```
-
-#### 5. Update Configuration
-
-Add validation in `src/device/config.c`:
-
-```c
-if (strcmp(mode, "dual") == 0 || 
-    strcmp(mode, "circle") == 0 ||
-    strcmp(mode, "newmode") == 0) {
-    SAFE_STRCPY(config->display_mode, mode);
-}
-```
-
-#### 6. Add CLI Flag
-
-In `src/main.c`:
-
-```c
-// In parse_arguments()
-else if (strcmp(argv[i], "--newmode") == 0) {
-    cc_safe_strcpy(display_mode_override, "newmode", override_size);
-}
-
-// In show_help()
-printf("  --newmode           Use new display mode\n");
-```
-
-#### 7. Update Documentation
-
-- `README.md`: Add mode description
-- `/etc/coolercontrol/plugins/coolerdash/config.json`: Add example
-- `docs/display-modes.md`: Add technical details
-
----
-
-## Best Practices
-
-### 1. Cairo Resource Management
-
-Always pair creation with destruction:
-```c
-cairo_t *cr = cairo_create(surface);
-// ... use cr ...
-cairo_destroy(cr);  // Must call
-
-cairo_surface_t *surface = cairo_image_surface_create(...);
-// ... use surface ...
-cairo_surface_destroy(surface);  // Must call
-```
-
-### 2. Configuration Validation
-
-Validate all config values before use:
-```c
-if (config->display_width <= 0 || config->display_height <= 0) {
-    log_message(LOG_ERROR, "Invalid display dimensions");
-    return;
-}
-```
-
-### 3. Error Handling
-
-Check all Cairo operations:
-```c
-if (cairo_surface_status(surface) != CAIRO_STATUS_SUCCESS) {
-    log_message(LOG_ERROR, "Surface creation failed");
-    return;
-}
-```
-
-### 4. Logging
-
-Use appropriate log levels:
-- `LOG_ERROR`: Critical failures
-- `LOG_WARNING`: Recoverable issues
-- `LOG_INFO`: Mode switches, state changes
-- `LOG_STATUS`: Successful operations
-- `LOG_DEBUG`: Detailed tracing
-
-### 5. Null Checks
-
-Always validate pointers:
-```c
-if (!cr || !config || !data) {
-    log_message(LOG_ERROR, "Null parameter");
-    return;
-}
-```
-
-### 6. Scaling Calculations
-
-Use dynamic scaling for resolution independence:
-```c
-ScalingParams params = calculate_scaling_params(config);
-
-// Use configurable content_scale_factor (default: 0.98)
-double content_scale = (config->display_content_scale_factor > 0.5 && 
-                       config->display_content_scale_factor <= 1.0) ?
-                       config->display_content_scale_factor : 0.98;
-
-// Apply inscribe factor for circular displays
-double inscribe = params.inscribe_factor;  // 1.0 or M_SQRT1_2 (≈0.7071)
-
-// Calculate safe area
-double safe_width = config->display_width * content_scale * inscribe;
-double safe_height = config->display_height * content_scale * inscribe;
-```
-
-**Configuration:**
-```ini
-[display]
-content_scale_factor=0.98  # 0.5-1.0, controls margin/padding
-```
-```c
-const double scale_avg = (scale_x + scale_y) / 2.0;
-const double corner_radius = 8.0 * scale_avg;
-```
-
----
-
-## Performance Considerations
-
-### 1. Cairo Surface Reuse
-Consider reusing surfaces for reduced memory allocation:
-```c
-static cairo_surface_t *cached_surface = NULL;
-
-if (!cached_surface) {
-    cached_surface = cairo_image_surface_create(...);
-}
-```
-
-### 2. PNG Compression
-Cairo uses default PNG compression. For faster writes:
-```c
-// Trade file size for speed (not currently implemented)
-// Could add custom PNG write with lower compression
-```
-
-### 3. LCD Upload Frequency
-Respect device limits:
-- NZXT Kraken: ~1-2 FPS recommended
-- Adjust `update_interval` based on device
-
-### 4. Circle Mode Timing
-Current implementation uses `time()` for 5s intervals:
-- Granularity: 1 second
-- Suitable for display purposes
-- For sub-second precision, consider `clock_gettime()`
-
----
-
-## Debugging Tips
-
-### 1. Enable Debug Logging
-
-Compile with `-DDEBUG`:
-```bash
-gcc -g -O0 -DDEBUG src/*.c -o coolerdash -lcurl -lcairo -lm -ljansson
-```
-
-### 2. Test PNG Output
-
-Check generated PNG manually:
-```bash
-feh /tmp/coolerdash.png
-```
-
-### 3. Mode Verification
-
-Log current mode on startup:
-```c
-log_message(LOG_INFO, "Display mode: %s", config->display_mode);
-```
-
-### 4. Circle Mode State
-
-Monitor sensor switches:
-```c
-log_message(LOG_INFO, "Circle mode: switched to %s", 
-            current_sensor == SENSOR_CPU ? "CPU" : "GPU");
+static int current_slot = 0;      // 0→1→2→0
+static time_t last_switch_time = 0;
 ```
 
-### 5. Cairo Status
+### Centering
 
-Always check status after operations:
+Temperature + degree symbol centered as a unit:
 ```c
-cairo_status_t status = cairo_status(cr);
-if (status != CAIRO_STATUS_SUCCESS) {
-    log_message(LOG_ERROR, "Cairo error: %s", cairo_status_to_string(status));
-}
+const double total_width = temp_ext.width + 5 + degree_ext.width;
+double temp_x = (display_width - total_width) / 2.0;
 ```
 
----
-
-## Future Enhancements
+### Rendering Flow
 
-### Potential Features
-
-1. **Graph Mode**: Temperature history graphs
-2. **Minimal Mode**: Single temperature value only
-3. **Animation Mode**: Smooth transitions between values
-4. **Custom Layouts**: User-defined positioning via config
-5. **Multi-Sensor**: Support for more than 2 sensors
-6. **Themes**: Predefined color schemes
-
-### Implementation Considerations
-
-- Mode plugin architecture for runtime loading
-- JSON configuration for complex layouts
-- Animation frame buffering
-- Custom font support (TTF loading)
-- Image overlays (logos, backgrounds)
+1. `draw_circle_image()` — entry point
+2. `get_cached_lcd_device_data()` — device info
+3. `get_temperature_monitor_data()` — sensor data
+4. `update_sensor_mode()` — check switch interval
+5. Cairo: create surface → draw single sensor → write PNG
+6. `send_image_to_lcd()` — upload
 
 ---
 
-## Conclusion
-
-CoolerDash's display mode architecture provides a flexible framework for LCD rendering. The dual and circle modes demonstrate different approaches to the same problem, each optimized for specific use cases.
-
-Key takeaways:
-- **Dual Mode**: Best for rectangular displays or when both sensors need simultaneous visibility
-- **Circle Mode**: Optimal for high-resolution circular displays where space is limited
-- **Mode System**: Three-tier configuration with CLI override capability
-- **Cairo Integration**: Consistent rendering pipeline across all modes
-- **Extensibility**: Clear pattern for adding new modes
-
-For questions or contributions, see `CONTRIBUTING.md`.
-
----
+## Adding a New Mode
 
-**Version**: 1.0  
-**Last Updated**: November 6, 2025  
-**Authors**: damachine <christkue79@gmail.com>
+1. Create `src/mods/newmode.c/h`
+2. Implement `draw_newmode_image(const struct Config *config)`
+3. Add dispatch in `display.c`
+4. Add validation in `config.c` (`load_display_from_json`)
+5. Add to Makefile `SRC_MODULES`
+6. Add CLI flag in `main.c` (`parse_arguments`)
+7. Update docs and `config.json`
diff --git a/docs/plugin-integration.md b/docs/plugin-integration.md
index d513a2e..c0aed99 100644
--- a/docs/plugin-integration.md
+++ b/docs/plugin-integration.md
@@ -1,14 +1,10 @@
-# CoolerDash Plugin Integration for CoolerControl
+# Plugin Integration
 
-## Overview
+CoolerDash runs as a CoolerControl plugin managed by `cc-plugin-coolerdash.service`. No separate systemd service needed.
 
-CoolerDash runs as a native CoolerControl plugin managed by `cc-plugin-coolerdash.service`. No separate systemd service or startup delay is needed. CoolerControl handles the plugin lifecycle.
+## Authentication
 
-## CC4 Integration
-
-### Authentication
-
-CC4 uses Bearer Token authentication. Generate a token in CoolerControl UI under **Access Protection** and set it in `config.json`:
+Bearer token auth via CoolerControl Access Protection:
 
 ```json
 "daemon": {
@@ -16,49 +12,30 @@ CC4 uses Bearer Token authentication. Generate a token in CoolerControl UI under
 }
 ```
 
-### Shutdown Image
+Generate token in CoolerControl UI > Access Protection.
+
+## Shutdown Image
 
-CoolerDash registers `shutdown.png` with CC4 once at startup:
+Registered once at startup via CC4 API:
 
 ```
 PUT /devices/{uid}/settings/lcd/lcd/shutdown-image
 ```
 
-CC4 stores the image server-side and displays it when CoolerControl stops. No helper daemon or `ExecStop` workaround needed.
+CC4 stores the image and displays it when CoolerControl stops. No helper daemon needed.
 
 ## Plugin UI
 
-### Theme-Adaptive UI
+Theme-adaptive UI using CoolerControl CSS variables + Tailwind CSS + PrimeIcons.
 
-The plugin UI automatically adapts to the user's CoolerControl theme:
-
-- **Dark/Light Theme Support** - Seamlessly integrates with user preferences
-- **Theme Color Variables** - Uses CoolerControl's native color system
-- **Consistent Design** - Matches CoolerControl's visual language
-
-#### CSS Variables Used
+### CSS Variables
 
 ```css
 --colors-bg-one       /* Primary background */
 --colors-bg-two       /* Secondary background */
 --colors-border-one   /* Border color */
 --colors-text         /* Text color */
---colors-accent       /* Accent/highlight color */
-```
-
-### Tailwind CSS
-
-```html
-<div class="flex flex-col p-4 gap-2">
-  <button class="bg-accent/80 hover:!bg-accent">Save</button>
-</div>
-```
-
-### PrimeIcons
-
-```html
-<i class="pi pi-save"></i>     <!-- Save icon -->
-<i class="pi pi-refresh"></i>  <!-- Refresh icon -->
+--colors-accent       /* Accent color */
 ```
 
 ### Manifest
@@ -68,109 +45,16 @@ version = "{{VERSION}}"
 url = "https://github.com/damachine/coolerdash"
 ```
 
-These fields are displayed on the CoolerControl plugin page, helping users:
-- Check if their plugin is up-to-date
-- Report issues or request features
-- Access documentation
+Displayed on the CoolerControl plugin page.
 
-## Plugin UI Structure
+## Settings UI Sections
 
-### Before (2.x and earlier)
+- Daemon: API address, access token
+- Display: Mode, refresh interval, brightness, orientation
+- Advanced: Display dimensions
 
-- ❌ Hardcoded colors
-- ❌ Separate helperd service for shutdown
-- ❌ Custom CSS only
+## Related
 
-### Current (3.x)
-
-- ✅ Theme-adaptive colors via CSS variables
-- ✅ Tailwind CSS
-- ✅ Shutdown handled natively by CC4
-- ✅ PrimeIcons
-
-## Configuration UI
-
-The plugin settings page includes:
-
-### 🌐 Daemon Settings
-- CoolerControl API Address
-- Access Token
-
-### 🖥️ Display Mode
-- Mode selection (Dual/Circle)
-- Circle switch interval
-
-### 📊 Display Settings
-- Refresh interval
-- Brightness slider (with live preview)
-- Orientation selector
-
-### 🔧 Advanced Settings
-- Display dimensions (width/height)
-
-## Technical Implementation
-
-### Theme Colors Example
-
-```css
-.section-card {
-    background: rgb(var(--colors-bg-one));
-    border: 1px solid rgb(var(--colors-border-one));
-    border-radius: 0.5rem;
-    padding: 1.5rem;
-}
-
-.input-field:focus {
-    border-color: rgb(var(--colors-accent));
-}
-```
-
-### Responsive Design
-
-```html
-<body class="flex flex-col min-h-full text-text-color bg-bg-two p-4">
-  <div class="container mx-auto max-w-4xl">
-    <!-- Content adapts to screen size -->
-  </div>
-</body>
-```
-
-## Benefits
-
-### For Users
-
-1. **Visual Consistency** - Plugin UI matches CoolerControl's appearance
-2. **Theme Support** - Automatically adapts to dark/light themes
-3. **Better UX** - Standard UI patterns and behaviors
-4. **Version Info** - Easy to check if plugin is up-to-date
-
-### For Developers
-
-1. **Rapid Development** - Tailwind CSS speeds up UI work
-2. **Maintainability** - Theme variables reduce hardcoded values
-3. **Documentation** - Clear examples and patterns
-4. **Best Practices** - Following CoolerControl's UI guidelines
-
-## Migration Guide
-
-If you're updating from an older version:
-
-1. **No User Action Required** - UI changes are automatic
-2. **Config Preserved** - Existing settings remain intact
-3. **Theme Applies Immediately** - UI adapts to current theme
-
-## Resources
-
-- [Plugin UI Theming Guide](./plugin-ui-theming.md)
+- [Configuration Guide](config-guide.md)
+- [Plugin UI Theming](plugin-ui-theming.md)
 - [CoolerControl Custom Device Plugin](https://gitlab.com/coolercontrol/cc-plugin-custom-device)
-- [index.html](../etc/coolercontrol/plugins/coolerdash/index.html) - Full implementation
-
-## Acknowledgments
-
-Special thanks to @codifryed (CoolerControl developer) for the custom-device plugin reference and CC4 API design.
-
-## Related Documentation
-
-- [Configuration Guide](./config-guide.md)
-- [Developer Guide](./developer-guide.md)
-- [Display Modes](./display-modes.md)
diff --git a/docs/plugin-ui-theming.md b/docs/plugin-ui-theming.md
index 2b38863..fe3494d 100644
--- a/docs/plugin-ui-theming.md
+++ b/docs/plugin-ui-theming.md
@@ -1,29 +1,19 @@
-# CoolerDash Plugin UI Theming Guide
+# Plugin UI Theming
 
-## Overview
+The plugin UI adapts to CoolerControl's theme (dark/light) via CSS variables.
 
-CoolerDash's plugin UI is designed to seamlessly integrate with CoolerControl's theme system. This document explains how the UI adapts to user themes and the available customization options.
-
-## Theme Integration
-
-### Available CSS Variables
-
-CoolerControl provides the following CSS variables that automatically adapt to the user's selected theme:
-
-#### Color Variables
+## CSS Variables
 
 ```css
-rgb(var(--colors-bg-one))       /* Primary background color */
-rgb(var(--colors-bg-two))       /* Secondary background color */
-rgb(var(--colors-border-one))   /* Border color */
-rgb(var(--colors-text))         /* Primary text color */
-rgb(var(--colors-accent))       /* Accent color (highlights, buttons) */
-rgb(var(--colors-red))          /* Red color (errors, warnings) */
+rgb(var(--colors-bg-one))       /* Primary background */
+rgb(var(--colors-bg-two))       /* Secondary background */
+rgb(var(--colors-border-one))   /* Border */
+rgb(var(--colors-text))         /* Text */
+rgb(var(--colors-accent))       /* Accent / highlights */
+rgb(var(--colors-red))          /* Errors */
 ```
 
-### Usage Examples
-
-#### Basic Container
+## Usage
 
 ```css
 .section-card {
@@ -32,160 +22,71 @@ rgb(var(--colors-red))          /* Red color (errors, warnings) */
     border-radius: 0.5rem;
     padding: 1.5rem;
 }
-```
-
-#### Input Fields
-
-```css
-.input-field {
-    background: rgb(var(--colors-bg-one));
-    border: 1px solid rgb(var(--colors-border-one));
-    color: rgb(var(--colors-text));
-}
 
 .input-field:focus {
     border-color: rgb(var(--colors-accent));
 }
-```
-
-#### Buttons
 
-```css
 .btn-primary {
     background: rgb(var(--colors-accent));
-    color: white;
     opacity: 0.8;
 }
-
 .btn-primary:hover {
     opacity: 1;
 }
 ```
 
-## Tailwind CSS Support
-
-CoolerControl provides Tailwind CSS classes for rapid UI development:
-
-### Layout Classes
-
-- `flex`, `flex-col`, `flex-row` - Flexbox layouts
-- `grid`, `grid-cols-2` - Grid layouts
-- `p-2`, `p-4`, `px-2`, `py-4` - Padding
-- `m-2`, `m-4`, `mx-auto` - Margins
-- `gap-2`, `gap-4` - Gaps in flex/grid
-
-### Typography
-
-- `text-sm`, `text-lg`, `text-2xl` - Font sizes
-- `font-bold`, `font-semibold` - Font weights
-- `opacity-70` - Opacity adjustments
+Always use theme variables instead of hardcoded colors.
 
-### Colors
+## Tailwind CSS
 
-- `bg-bg-one`, `bg-bg-two` - Background colors
-- `text-text-color` - Text color
-- `border-border-one` - Border color
+Available utility classes:
 
-### Responsive Design
+| Class | Role |
+|-------|------|
+| `bg-bg-one` | Base / deepest background layer |
+| `bg-bg-two` | Elevated surface — panels, cards, dialogs |
+| `bg-surface-hover` | Subtle overlay for hover states |
+| `bg-accent` / `text-accent` | Brand / interactive accent color |
+| `text-text-color` | Primary text |
+| `text-text-color-secondary` | Muted / secondary text |
+| `border-border-one` | Standard border color |
+| `bg-success` / `text-success` | Success (green) |
+| `bg-error` / `text-error` | Error / danger (red) |
+| `bg-warning` / `text-warning` | Warning (yellow) |
 
-- `min-h-full` - Minimum height
-- `max-w-4xl` - Maximum width
-- `rounded-lg` - Border radius
+Layout: `flex`, `flex-col`, `grid`, `p-2`, `p-4`, `gap-2`, `text-sm`, `font-bold`, `rounded-lg`.
 
-## PrimeIcons Support
-
-CoolerControl includes PrimeIcons for consistent iconography:
+## PrimeIcons
 
 ```html
-<i class="pi pi-save"></i>      <!-- Save icon -->
-<i class="pi pi-refresh"></i>   <!-- Refresh icon -->
-<i class="pi pi-plus"></i>      <!-- Add icon -->
-<i class="pi pi-trash"></i>     <!-- Delete icon -->
-```
-
-## Best Practices
-
-### 1. Always Use Theme Variables
-
-❌ **Don't:**
-```css
-background: #1a1a2e;
-color: #eaeaea;
-border: 1px solid #2d4263;
+<i class="pi pi-save"></i>
+<i class="pi pi-refresh"></i>
+<i class="pi pi-plus"></i>
+<i class="pi pi-trash"></i>
 ```
 
-✅ **Do:**
-```css
-background: rgb(var(--colors-bg-one));
-color: rgb(var(--colors-text));
-border: 1px solid rgb(var(--colors-border-one));
-```
+## Rendering Context
 
-### 2. Provide Visual Feedback
-
-```css
-.input-field:focus {
-    border-color: rgb(var(--colors-accent));
-}
+Detect how the plugin UI is displayed:
 
-.btn:hover {
-    opacity: 1;
-}
+```js
+const { mode } = await getContext(); // 'modal' | 'full_page'
 ```
 
-### 3. Use Semantic Color Meanings
-
-- `--colors-accent` - Primary actions, highlights
-- `--colors-red` - Errors, destructive actions
-- `--colors-bg-one` - Content containers
-- `--colors-bg-two` - Page background
-
-### 4. Maintain Consistency
+- `modal` — opened as a dialog (e.g. settings shortcut)
+- `full_page` — dedicated plugin page in the sidebar
 
-Use the same spacing, border-radius, and transition patterns throughout:
-
-```css
-border-radius: 0.375rem;  /* For inputs/buttons */
-border-radius: 0.5rem;    /* For containers */
-transition: opacity 0.2s; /* For hover effects */
-```
-
-## Dark/Light Theme Support
-
-The UI automatically adapts to the user's theme (dark/light) through the CSS variables. No additional JavaScript or CSS is needed.
-
-## Testing
-
-To test your UI with different themes:
-
-1. Open CoolerControl settings
-2. Change the theme under Appearance
-3. Navigate to CoolerDash plugin settings
-4. Verify all UI elements adapt correctly
-
-## Example Implementation
-
-See [index.html](../etc/coolercontrol/plugins/coolerdash/index.html) for a complete implementation example.
-
-## Resources
-
-- [CoolerControl Custom Device Plugin](https://gitlab.com/coolercontrol/cc-plugin-custom-device) - Reference implementation
-- [Tailwind CSS Documentation](https://tailwindcss.com/docs)
-- [PrimeIcons](https://primevue.org/icons/) - Icon reference
-
-## Manifest Configuration
-
-Add version and URL to your `manifest.toml`:
-
-```toml
-version = "2.2.x"
-url = "https://github.com/damachine/coolerdash"
-```
+## Semantic Colors
 
-These will be displayed on the plugin page in CoolerControl's UI.
+- `--colors-accent` — primary actions, highlights
+- `--colors-red` — errors, destructive actions
+- `--colors-bg-one` — content containers
+- `--colors-bg-two` — page background
 
-## Changelog
+## Reference
 
-- **3.x** - Token-only CC4 auth, native shutdown image via CC4 API
-- **2.2.x** - Added theme color support and Tailwind CSS integration
-- **2.0.4** - Initial plugin UI implementation
+- Implementation: [index.html](../etc/coolercontrol/plugins/coolerdash/ui/index.html)
+- [CoolerControl Plugin Docs](https://gitlab.com/coolercontrol/cc-plugins)
+- [Tailwind CSS Docs](https://tailwindcss.com/docs)
+- [PrimeIcons](https://primevue.org/icons/)
diff --git a/etc/coolercontrol/plugins/coolerdash/config.json b/etc/coolercontrol/plugins/coolerdash/config.json
index 13eb77c..19a480a 100644
--- a/etc/coolercontrol/plugins/coolerdash/config.json
+++ b/etc/coolercontrol/plugins/coolerdash/config.json
@@ -21,9 +21,9 @@
 
   "display": {
     "mode": "circle",
-    "circle_switch_interval": 6,
+    "circle_switch_interval": 8,
     "circle_show_extra_info": true,
-    "refresh_interval": 2.5,
+    "refresh_interval": 3.5,
     "brightness": 80,
     "orientation": 0,
     "background_image_fit": "cover",
@@ -93,7 +93,7 @@
       "threshold_1": 30.0,
       "threshold_2": 35.0,
       "threshold_3": 40.0,
-      "max_scale": 55.0,
+      "max_scale": 45.0,
       "threshold_1_color": { "r": 0, "g": 255, "b": 0 },
       "threshold_2_color": { "r": 255, "g": 140, "b": 0 },
       "threshold_3_color": { "r": 255, "g": 70, "b": 0 },
diff --git a/etc/coolercontrol/plugins/coolerdash/ui/index.html b/etc/coolercontrol/plugins/coolerdash/ui/index.html
index bff4814..c2dfd47 100644
--- a/etc/coolercontrol/plugins/coolerdash/ui/index.html
+++ b/etc/coolercontrol/plugins/coolerdash/ui/index.html
@@ -1178,9 +1178,9 @@ <h3 class="section-title">System Environment</h3>
             },
             display: {
                 mode: "circle",
-                circle_switch_interval: 6,
+                circle_switch_interval: 8,
                 circle_show_extra_info: true,
-                refresh_interval: 2.5,
+                refresh_interval: 3.5,
                 brightness: 80,
                 orientation: 0,
                 background_image_fit: "cover",
@@ -1254,7 +1254,7 @@ <h3 class="section-title">System Environment</h3>
                     threshold_1: 30.0,
                     threshold_2: 35.0,
                     threshold_3: 40.0,
-                    max_scale: 55.0,
+                    max_scale: 45.0,
                     font_size_temp: 0,
                     label: '',
                     threshold_1_color: { r: 0, g: 255, b: 0 },
@@ -1367,6 +1367,12 @@ <h3 class="section-title">System Environment</h3>
             window.runPluginScript = function(mainFunction) { mainFunction(); };
         }
 
+        if (typeof getContext === 'undefined') {
+            window.getContext = async function() {
+                return { mode: isInCoolerControl ? 'full_page' : 'modal' };
+            };
+        }
+
         // Fallback for getDevices() — used when cc-plugin-lib.js is not loaded (dev/browser mode)
         // Note: cc-plugin-lib defines functions with `const` (not var/window), so typeof check always
         // triggers even when cc-plugin-lib is loaded. We therefore implement postMessage for CC4 context.
@@ -1820,7 +1826,7 @@ <h3 class="section-title">System Environment</h3>
                 defaults.threshold_1 = 30.0;
                 defaults.threshold_2 = 35.0;
                 defaults.threshold_3 = 40.0;
-                defaults.max_scale = 55.0;
+                defaults.max_scale = 45.0;
             } else if (/RPM|rpm/.test(sensorId)) {
                 defaults.threshold_1 = 500;
                 defaults.threshold_2 = 1000;
@@ -2737,6 +2743,12 @@ <h3 class="section-title">System Environment</h3>
         // ===== INITIALIZATION =====
         runPluginScript(async function() {
             try {
+                var ctx = await getContext();
+                if (ctx.mode === 'modal') {
+                    document.body.style.maxWidth = '600px';
+                    document.body.style.margin = '0 auto';
+                }
+
                 await loadDefaultConfig();
                 var config = await getPluginConfig();
 
diff --git a/man/coolerdash.1 b/man/coolerdash.1
index 9ba53ae..ec54459 100644
--- a/man/coolerdash.1
+++ b/man/coolerdash.1
@@ -1,477 +1,183 @@
-.TH COOLERDASH 1 "November 2025" "CoolerDash 1.96" "User Commands"
+.TH COOLERDASH 1 "April 2026" "CoolerDash 3.1.0" "User Commands"
 .SH NAME
-coolerdash \- LCD dashboard renderer for CoolerControl-compatible AIO coolers
+coolerdash \- LCD temperature display for CoolerControl AIO coolers
 .SH SYNOPSIS
 .B coolerdash
 [\fB\-v\fR|\fB\-\-verbose\fR]
 [\fB\-\-dual\fR]
 [\fB\-\-circle\fR]
-[\fB\-\-force\-display\-circular\fR]
+[\fIconfig_path\fR]
 .br
 .B coolerdash
-[\fB\-h\fR|\fB\-\-help\fR]
-[\fB\-\-version\fR]
+\fB\-h\fR|\fB\-\-help\fR
 .SH DESCRIPTION
 .B coolerdash
-generates and uploads real-time sensor images to AIO liquid cooler LCD displays
-using data from the CoolerControl daemon. It extends CoolerControl's LCD
-functionality with multiple display modes, temperature visualization, and
-extensive customization options.
-.PP
-The program supports two display modes:
-.B dual mode
-(simultaneous CPU+GPU display) and
-.B circle mode
-(alternating single-sensor display). Display shape detection automatically
-adjusts layouts for circular and rectangular screens.
-.PP
-.B coolerdash
-runs as a systemd service by default but can be executed manually for testing
-and debugging purposes.
+renders real-time CPU/GPU/liquid temperatures to AIO liquid cooler LCD displays
+via the CoolerControl REST API. Runs as a CoolerControl plugin managed by
+.BR coolercontrold .
+.PP
+Two display modes:
+.B dual
+(CPU+GPU side-by-side) and
+.B circle
+(alternating single sensor). Display shape (circular/rectangular) is
+auto-detected or configurable.
 .SH OPTIONS
 .TP
 .BR \-h ", " \-\-help
-Display usage information and exit.
+Show usage and exit.
 .TP
 .BR \-v ", " \-\-verbose
-Enable verbose logging. Shows detailed information about API calls, device
-detection, rendering operations, and display updates. Useful for debugging
-and troubleshooting.
-.TP
-.B \-\-version
-Display version information and exit.
+Enable verbose logging (API calls, device detection, rendering).
 .TP
 .B \-\-dual
-Force dual display mode (CPU and GPU simultaneously). Overrides config.json setting.
+Force dual display mode. Overrides config.json.
 .TP
 .B \-\-circle
-Force circle display mode (alternating CPU/GPU every 2.5 seconds). Overrides
-config.json setting.
+Force circle display mode. Overrides config.json.
 .TP
-.B \-\-force\-display\-circular
-Force circular display layout (inscribe factor = 0.7071). Overrides automatic
-display shape detection. Deprecated in favor of the \fBshape\fR configuration
-parameter.
+.I config_path
+Optional path to config.json. Default:
+.IR /etc/coolercontrol/plugins/coolerdash/config.json .
 .SH CONFIGURATION
-.B coolerdash
-is configured through
+Config file:
 .IR /etc/coolercontrol/plugins/coolerdash/config.json .
-After modifying the configuration file, restart the CoolerControl service:
 .PP
+Restart to apply changes:
 .RS
 .nf
-.B sudo systemctl restart coolercontrold.service
+.B sudo systemctl restart coolercontrold
 .fi
 .RE
-.SS Important Configuration Sections
+.SS Sections
+.TP
+.B daemon
+API address and Bearer token (\fBaccess_token\fR).
 .TP
-.B [daemon]
-CoolerControl daemon connection settings (address, password).
+.B display
+Mode, dimensions, refresh interval, brightness, orientation, shape override,
+sensor slot assignment.
 .TP
-.B [display]
-Display settings including width, height, refresh rate, brightness, orientation,
-display mode (\fBdual\fR or \fBcircle\fR), and shape override (\fBauto\fR,
-\fBrectangular\fR, or \fBcircular\fR).
+.B layout
+Bar height/width/gap/border, label margins.
 .TP
-.B [layout]
-Visual layout configuration for box dimensions, bar sizes, gaps, and borders.
+.B sensors
+Temperature thresholds and color zones per sensor (cpu/gpu/liquid).
 .TP
-.B [temperature]
-Temperature thresholds and color zones for visual indication.
+.B font
+Font family and sizes.
 .TP
-.B [font]
-Font family, sizes, and colors for temperature values and labels.
+.B colors
+RGB colors for bars, borders, labels.
 .PP
-For detailed configuration options, see
+See
 .I /usr/share/doc/coolerdash/config-guide.md
-or visit the project documentation online.
-.SH DISPLAY MODES
-.SS Dual Mode (default)
-Displays CPU and GPU temperatures simultaneously in a side-by-side layout.
-Recommended for all display sizes and shapes. Provides constant visibility
-of both sensors.
-.SS Circle Mode
-Alternates between CPU and GPU display every 2.5 seconds. Optimized for
-circular high-resolution displays (>240x240px) where larger text and graphics
-provide better visibility.
-.PP
-To enable circle mode, edit
-.I /etc/coolercontrol/plugins/coolerdash/config.json
-and set:
-.PP
-.RS
-.nf
-"display": {
-  "mode": "circle"
-}
-.fi
-.RE
-.PP
-Or use the
-.B \-\-circle
-command-line option to temporarily override the configuration.
+for full reference.
 .SH DISPLAY SHAPE DETECTION
-.B coolerdash
-automatically detects whether your LCD is circular or rectangular and adjusts
-the layout accordingly using an inscribe factor.
-.SS Automatic Detection Rules
-.TP
-.B NZXT Kraken devices
-Resolution-based detection:
-.RS
+Auto-detection based on device and resolution:
 .IP \(bu 3
-≤240×240 pixels → Rectangular (inscribe factor = 1.0)
+NZXT Kraken ≤240×240 → rectangular (inscribe factor 1.0)
 .IP \(bu 3
->240×240 pixels → Circular (inscribe factor = 0.7071)
-.RE
-.TP
-.B Other devices
-Checked against internal device database.
-.TP
-.B Default
-Rectangular (safer fallback for unknown devices).
-.SS Manual Override
-You can manually override automatic detection in
-.IR /etc/coolercontrol/plugins/coolerdash/config.json :
+NZXT Kraken >240×240 → circular (inscribe factor 0.7071)
+.IP \(bu 3
+Unknown devices → rectangular (default)
 .PP
+Override in config.json:
 .RS
 .nf
-[display]
-shape = auto          # Auto-detection (default)
-# shape = rectangular # Force rectangular (inscribe factor = 1.0)
-# shape = circular    # Force circular (inscribe factor = 0.7071)
+"shape": "auto"          // auto-detect (default)
+"shape": "rectangular"   // force inscribe factor 1.0
+"shape": "circular"      // force inscribe factor 0.7071
 .fi
 .RE
-.PP
-Priority: \fBshape\fR config > \fB\-\-force-display-circular\fR flag > auto-detection
-.SH PLUGIN MODE
-.B coolerdash
-runs as a CoolerControl plugin, automatically managed by
-.BR coolercontrold.service .
-No separate service configuration is required.
-.PP
-Arch Linux (recommended):
 .SH INSTALLATION
-.SS Arch Linux (Recommended)
-Using an AUR helper (e.g., yay, paru):
-.PP
+.SS Arch Linux
 .RS
 .nf
 .B yay -S coolerdash-git
-.B sudo systemctl restart coolercontrold.service
+.B sudo systemctl restart coolercontrold
 .fi
 .RE
-.SS All Linux Distributions
-Manual installation from source:
-.PP
+.SS From Source
 .RS
 .nf
 .B git clone https://github.com/damachine/coolerdash.git
 .B cd coolerdash
 .B make install
-.B sudo systemctl restart coolercontrold.service
+.B sudo systemctl restart coolercontrold
 .fi
 .RE
-.PP
-The
-.B make install
-command automatically detects your distribution and installs required
-dependencies.
-.SH SYSTEM REQUIREMENTS
-.TP
-.B Operating System
-Linux (any distribution)
+.SH REQUIREMENTS
 .TP
 .B CoolerControl
-Version ≥2.2.2 (must be installed and running). See
-.UR https://gitlab.com/coolercontrol/coolercontrol
-.UE
-for installation instructions.
-.TP
-.B CPU Architecture
-x86-64-v3 compatible (Intel Haswell+ / AMD Excavator+ or newer)
+Version >=4.x, running.
 .TP
-.B LCD Display
-AIO liquid cooler with LCD display (NZXT Kraken, Corsair iCUE, etc.).
-All devices supported by CoolerControl/liquidctl should work.
+.B Architecture
+x86-64-v3 (Intel Haswell+ / AMD Excavator+)
 .TP
-.B Build Dependencies
-gcc, make, cairo, jansson, curl, inih (automatically installed by
-.BR "make install" )
-.SH COOLERCONTROL SETUP
-Before using
-.BR coolerdash ,
-configure CoolerControl:
-.IP 1. 4
-Open CoolerControl GUI
-.IP 2. 4
-Navigate to
-.B Settings
-→
-.B "Device and Sensor"
-.IP 3. 4
-Select one sensor for
-.B CPU
-(e.g., "CPU Package")
-.IP 4. 4
-Select one sensor for
-.B GPU
-(e.g., "GPU Temperature")
-.IP 5. 4
-Set your LCD display output type to
-.B "Image/gif"
-.IP 6. 4
-Save settings and restart coolerdash service
+.B Dependencies
+cairo, jansson, libcurl-gnutls, ttf-roboto
 .SH EXAMPLES
-.SS Run manually with verbose logging
-The plugin is managed by CoolerControl:
-.PP
-.RS
-.nf
-.B /usr/libexec/coolerdash/coolerdash --verbose
-.fi
-.RE
-.SS Force dual mode temporarily
-.PP
-.RS
-.nf
-.B /usr/libexec/coolerdash/coolerdash --dual --verbose
-.fi
-.RE
-.SS Force circle mode temporarily
-.PP
-.RS
-.nf
-.B /usr/libexec/coolerdash/coolerdash --circle --verbose
-.fi
-.RE
-.SS Check CoolerControl device information
-.PP
-.RS
 .nf
+.B coolerdash --verbose
+.B coolerdash --circle --verbose
+.B coolerdash --dual /path/to/config.json
+.B journalctl -xeu coolercontrold -f
 .B curl http://localhost:11987/devices | jq
 .fi
-.RE
-.SS View recent service logs
-.PP
-.RS
-.nf
-.B journalctl -u coolercontrold.service -n 50
-.fi
-.RE
 .SH TROUBLESHOOTING
-.SS Service won't start
-Check CoolerControl daemon status:
-.PP
-.RS
-.nf
-.B systemctl status coolercontrold
-.fi
-.RE
-.PP
-Ensure coolercontrold is running before starting coolerdash.
-.SS No devices found
-Verify CoolerControl can see your device:
-.PP
-.RS
-.nf
-.B curl http://localhost:11987/devices
-.fi
-.RE
-.PP
-Check that your LCD is set to "Image/gif" mode in CoolerControl GUI.
-.SS Clipping on circular display
-The content appears cut off at the edges. Override display shape detection:
-.PP
-.RS
-.nf
-Edit /etc/coolercontrol/plugins/coolerdash/config.json:
-[display]
-shape = circular
-.fi
-.RE
-.PP
-Then restart the CoolerControl service.
-.SS Too much padding on rectangular display
-Content appears too small with large margins. Override display shape:
-.PP
-.RS
-.nf
-Edit /etc/coolercontrol/plugins/coolerdash/config.json:
-[display]
-shape = rectangular
-.fi
-.RE
-.SS Debug build for detailed information
-.PP
-.RS
-.nf
-.B cd /path/to/coolerdash
-.B make debug
-.B /usr/libexec/coolerdash/coolerdash --verbose
-.fi
-.RE
+.TP
+.B Service won't start
+Check \fBsystemctl status coolercontrold\fR.
+.TP
+.B No devices found
+Check \fBcurl http://localhost:11987/devices\fR.
+.TP
+.B Content clipped on circular display
+Set \fB"shape": "circular"\fR in config.json.
+.TP
+.B Too much padding
+Set \fB"shape": "rectangular"\fR in config.json.
 .SH FILES
 .TP
 .I /etc/coolercontrol/plugins/coolerdash/config.json
-Main configuration file. Contains all settings for daemon connection, display
-properties, layout, colors, fonts, and temperature thresholds.
+Configuration file.
 .TP
 .I /usr/libexec/coolerdash/coolerdash
-Installed plugin binary executable.
-.TP
-.I /etc/coolercontrol/plugins/coolerdash/manifest.toml
-CoolerControl plugin manifest file.
+Plugin binary.
 .TP
 .I /etc/coolercontrol/plugins/coolerdash/shutdown.png
-Shutdown image displayed when the plugin stops.
+Shutdown display image (registered with CC4 at startup).
 .TP
 .I /etc/coolercontrol/plugins/coolerdash/coolerdash.png
-Temporary file for generated display image.
+Generated display image.
 .TP
 .I /tmp/coolerdash.pid
-PID file for the running coolerdash process.
-.TP
-.I /usr/share/man/man1/coolerdash.1.gz
-This manual page (when installed system-wide).
-.TP
-.I /usr/share/doc/coolerdash/
-Documentation directory containing detailed guides:
-.RS
-.IP \(bu 3
-.I config-guide.md
-\- Complete configuration reference
-.IP \(bu 3
-.I display-modes.md
-\- Display modes technical documentation
-.IP \(bu 3
-.I display-detection.md
-\- Display shape detection details
-.IP \(bu 3
-.I coolercontrol-api.md
-\- CoolerControl API integration guide
-.IP \(bu 3
-.I developer-guide.md
-\- Developer documentation
-.IP \(bu 3
-.I devices.md
-\- List of confirmed working devices
-.RE
-.SH ENVIRONMENT
-.B coolerdash
-does not use environment variables. All configuration is managed through
-.IR /etc/coolercontrol/plugins/coolerdash/config.json .
+PID file.
 .SH EXIT STATUS
 .TP
 .B 0
-Successful execution or graceful shutdown.
+Success / graceful shutdown.
 .TP
 .B 1
-General error (configuration error, CoolerControl connection failure, etc.).
-.TP
-.B 2
-Invalid command-line arguments.
-.SH NOTES
-.IP \(bu 3
-When
-.B coolerdash
-stops (during shutdown or reboot), it automatically displays the shutdown.png
-image because sensor data is no longer available.
-.IP \(bu 3
-The CoolerControl service must be restarted after modifying
-.I /etc/coolercontrol/plugins/coolerdash/config.json
-for changes to take effect.
-.IP \(bu 3
-Verbose logging (
-.BR \-\-verbose )
-is recommended when troubleshooting display issues or API communication problems.
-.IP \(bu 3
-Multiple instances of coolerdash cannot run simultaneously. The plugin is
-automatically managed by CoolerControl.
-.IP \(bu 3
-The
-.B \-\-force\-display\-circular
-flag is deprecated. Use the
-.B shape
-configuration parameter instead for better control.
-.SH EXAMPLES
-.RS
-.nf
-.B coolerdash --verbose
-.fi
-.RE
-.PP
-For additional examples, see the
-.B EXAMPLES
-section above.
+Error (config, connection, device).
 .SH SEE ALSO
 .BR systemctl (1),
-.BR journalctl (1),
-.BR curl (1),
-.BR jq (1)
+.BR journalctl (1)
 .PP
-.B CoolerControl
-.RS
-.UR https://gitlab.com/coolercontrol/coolercontrol
-.UE
-.RE
-.PP
-.B CoolerDash GitHub Repository
-.RS
 .UR https://github.com/damachine/coolerdash
+CoolerDash
 .UE
-.RE
 .PP
-.B liquidctl (supported devices)
-.RS
-.UR https://github.com/liquidctl/liquidctl
+.UR https://gitlab.com/coolercontrol/coolercontrol
+CoolerControl
 .UE
-.RE
 .SH AUTHOR
-Written by DAMACHINE.
-.PP
-.MT christkue79@gmail.com
-.ME
+damachine <damachin3@proton.me>
 .SH COPYRIGHT
-Copyright \(co 2024-2025 DAMACHINE.
-.PP
-License: MIT License
-.UR https://opensource.org/licenses/MIT
-.UE
-.PP
-This is free software: you are free to change and redistribute it.
-There is NO WARRANTY, to the extent permitted by law.
+Copyright \(co 2024\-2026 damachine. MIT License.
 .SH BUGS
-.SS Reporting Bugs
-Report bugs and feature requests at:
 .UR https://github.com/damachine/coolerdash/issues
 .UE
 .PP
-When reporting bugs, please include:
-.IP \(bu 3
-Output of
-.B /usr/libexec/coolerdash/coolerdash \-\-verbose
-.IP \(bu 3
-Content of
-.I /etc/coolercontrol/plugins/coolerdash/config.json
-.IP \(bu 3
-Output of
-.B "systemctl status coolercontrold"
-.IP \(bu 3
-Output of
-.B "curl http://localhost:11987/devices"
-.IP \(bu 3
-Your device model and LCD resolution
-.IP \(bu 3
-Linux distribution and kernel version
-.SS Known Issues
-See the GitHub Issues page for current known issues and workarounds.
-.SH HISTORY
-.B coolerdash
-was created to extend CoolerControl's LCD functionality on Linux systems,
-providing features similar to those available on Windows platforms for AIO
-liquid cooler displays.
-.PP
-The project started with basic temperature display and has evolved to include
-multiple display modes, automatic shape detection, extensive customization
-options, and support for various cooler brands.
+Include: \fB\-\-verbose\fR output, config.json, device model, \fBsystemctl status coolercontrold\fR.
diff --git a/src/device/config.c b/src/device/config.c
index acd3fef..c97490d 100644
--- a/src/device/config.c
+++ b/src/device/config.c
@@ -152,7 +152,7 @@ static void set_display_defaults(Config *config)
     try_set_lcd_dimensions(config);
 
     if (config->display_refresh_interval == 0.0f)
-        config->display_refresh_interval = 2.50f;
+        config->display_refresh_interval = 3.50f;
     if (config->lcd_brightness == 0)
         config->lcd_brightness = 80;
     if (!is_valid_orientation(config->lcd_orientation))
@@ -163,7 +163,7 @@ static void set_display_defaults(Config *config)
         cc_safe_strcpy(config->display_background_image_fit,
                        sizeof(config->display_background_image_fit), "cover");
     if (config->circle_switch_interval == 0)
-        config->circle_switch_interval = 6;
+        config->circle_switch_interval = 8;
     if (config->circle_show_extra_info < 0)
         config->circle_show_extra_info = 1; // enabled by default
     if (config->display_content_scale_factor == 0.0f)
@@ -421,7 +421,7 @@ static void set_default_sensor_configs(Config *config)
         if (liquid->threshold_3 == 0.0f)
             liquid->threshold_3 = 40.0f;
         if (liquid->max_scale == 0.0f)
-            liquid->max_scale = 55.0f;
+            liquid->max_scale = 45.0f;
     }
 }
 
diff --git a/src/main.c b/src/main.c
index c5856c3..7a09504 100644
--- a/src/main.c
+++ b/src/main.c
@@ -184,8 +184,7 @@ static void show_help(const char *program_name)
     printf(
         "  --dual            Force dual display mode (CPU+GPU simultaneously)\n");
     printf("  --circle          Force circle mode (alternating CPU/GPU every 2.5 "
-           "seconds)\n");
-    printf("  --develop         Developer mode: enable verbose logging\n\n");
+           "seconds)\n\n");
     printf("DISPLAY MODES:\n");
     printf(
         "  dual              Default mode - shows CPU and GPU simultaneously\n");
@@ -541,10 +540,6 @@ static const char *parse_arguments(int argc, char **argv,
         {
             cc_safe_strcpy(display_mode_override, 16, "circle");
         }
-        else if (strcmp(argv[i], "--develop") == 0)
-        {
-            verbose_logging = 1; // Developer mode implies verbose logging
-        }
         else if (argv[i][0] != '-')
         {
             config_path = argv[i];

From 7be30755216665a2899a2d305fe64f5708c0f299 Mon Sep 17 00:00:00 2001
From: damachin3 <damachin3@proton.me>
Date: Fri, 10 Apr 2026 20:04:55 +0200
Subject: [PATCH 10/10] feat: add update notification

---
 .SRCINFO                                      |   2 +-
 .../plugins/coolerdash/ui/index.html          |  57 ++-
 src/device/config.c                           |  16 +-
 src/device/config.h                           |  54 +--
 src/main.c                                    | 424 ++++++++++++------
 src/mods/display.c                            |   5 +
 src/mods/display.h                            |   3 +
 src/srv/cc_conf.c                             |  43 +-
 src/srv/cc_main.h                             |  66 +--
 src/srv/cc_sensor.c                           |  27 +-
 10 files changed, 366 insertions(+), 331 deletions(-)

diff --git a/.SRCINFO b/.SRCINFO
index 99f944e..3ed6f9b 100644
--- a/.SRCINFO
+++ b/.SRCINFO
@@ -1,6 +1,6 @@
 pkgbase = coolerdash
 	pkgdesc = Plug-in for CoolerControl that extends the LCD functionality with additional features
-	pkgver = 3.1.0
+	pkgver = 2.1.0
 	pkgrel = 1
 	url = https://github.com/damachine/coolerdash
 	install = coolerdash.install
diff --git a/etc/coolercontrol/plugins/coolerdash/ui/index.html b/etc/coolercontrol/plugins/coolerdash/ui/index.html
index c2dfd47..4264cda 100644
--- a/etc/coolercontrol/plugins/coolerdash/ui/index.html
+++ b/etc/coolercontrol/plugins/coolerdash/ui/index.html
@@ -1085,6 +1085,19 @@ <h3 class="section-title">Detected LCD Device</h3>
 
             <!-- Tab 7: Info -->
             <div class="panel">
+                <h3 class="section-title">Version &amp; Update</h3>
+
+                <div class="device-info-card">
+                    <div class="info-item">
+                        <div class="info-item-label">Installed</div>
+                        <div class="info-item-value">CoolerDash v{{VERSION}}</div>
+                    </div>
+                    <div class="info-item">
+                        <div class="info-item-label">Latest Release</div>
+                        <div class="info-item-value" id="update-status">checking&hellip;</div>
+                    </div>
+                </div>
+
                 <h3 class="section-title">About CoolerDash</h3>
 
                 <div class="device-info-card">
@@ -1102,7 +1115,7 @@ <h3 class="section-title">About CoolerDash</h3>
                     </div>
                     <div class="info-item">
                         <div class="info-item-label">Website</div>
-                        <div class="info-item-value"><a href="https://github.com/damachine/coolerdash" target="_blank" rel="noopener" onclick="openExternalUrl('https://github.com/damachine/coolerdash'); return false;">github.com/damachine/coolerdash</a></div>
+                        <div class="info-item-value"><a href="https://github.com/damachine/coolerdash" target="_blank" rel="noopener noreferrer">github.com/damachine/coolerdash</a></div>
                     </div>
                     <div class="info-item">
                         <div class="info-item-label">License</div>
@@ -1119,15 +1132,15 @@ <h3 class="section-title">Community &amp; Feedback</h3>
                 <div class="device-info-card">
                     <div class="info-item">
                         <div class="info-item-label">Bug Reports &amp; Feature Requests</div>
-                        <div class="info-item-value"><a href="https://github.com/damachine/coolerdash/issues" target="_blank" rel="noopener" onclick="openExternalUrl('https://github.com/damachine/coolerdash/issues'); return false;">GitHub Issues</a></div>
+                        <div class="info-item-value"><a href="https://github.com/damachine/coolerdash/issues" target="_blank" rel="noopener noreferrer">GitHub Issues</a></div>
                     </div>
                     <div class="info-item">
                         <div class="info-item-label">Discussions</div>
-                        <div class="info-item-value"><a href="https://github.com/damachine/coolerdash/discussions" target="_blank" rel="noopener" onclick="openExternalUrl('https://github.com/damachine/coolerdash/discussions'); return false;">GitHub Discussions</a></div>
+                        <div class="info-item-value"><a href="https://github.com/damachine/coolerdash/discussions" target="_blank" rel="noopener noreferrer">GitHub Discussions</a></div>
                     </div>
                     <div class="info-item" style="margin-bottom: 0;">
                         <div class="info-item-label">Discord</div>
-                        <div class="info-item-value"><a href="https://discord.com/channels/908873022105079848/1461781766791499981" target="_blank" rel="noopener" onclick="openExternalUrl('https://discord.com/channels/908873022105079848/1461781766791499981'); return false;">CoolerControl Discord &mdash; #coolerdash</a></div>
+                        <div class="info-item-value"><a href="https://discord.com/channels/908873022105079848/1461781766791499981" target="_blank" rel="noopener noreferrer">CoolerControl Discord &mdash; #coolerdash</a></div>
                     </div>
                 </div>
 
@@ -1282,18 +1295,6 @@ <h3 class="section-title">System Environment</h3>
         let discoveredSensors = [];
         let currentSensorConfig = {};
 
-        /**
-         * @brief Open an external URL — works inside CC4's iframe sandbox via postMessage.
-         */
-        function openExternalUrl(url) {
-            // CC4 listens for 'openUrl' postMessage to open links in the host browser
-            if (isInCoolerControl) {
-                window.parent.postMessage({ type: 'openUrl', body: { url: url } }, '*');
-            } else {
-                window.open(url, '_blank', 'noopener,noreferrer');
-            }
-        }
-
         /**
          * @brief Escape HTML special characters to prevent XSS.
          */
@@ -2269,6 +2270,30 @@ <h3 class="section-title">System Environment</h3>
         }
 
         async function fetchSystemInfo(apiAddress, token) {
+            // Update check via GitHub Releases API
+            (async function checkForUpdate() {
+                var el = document.getElementById('update-status');
+                if (!el) return;
+                var current = '{{VERSION}}';
+                try {
+                    var res = await fetch('https://api.github.com/repos/damachine/coolerdash/releases/latest', {
+                        headers: { 'Accept': 'application/vnd.github+json', 'X-GitHub-Api-Version': '2022-11-28' }
+                    });
+                    if (!res.ok) throw new Error('HTTP ' + res.status);
+                    var data = await res.json();
+                    var latest = (data.tag_name || '').replace(/^v/i, '');
+                    var dlUrl = 'https://github.com/damachine/coolerdash/releases/tag/' + (data.tag_name || 'latest');
+                    if (latest && latest !== current) {
+                        el.innerHTML = '<strong style="color:var(--warning,#f0a500)">v' + latest + ' available</strong> &mdash; '
+                            + '<a href="' + escapeHtml(dlUrl) + '" target="_blank" rel="noopener noreferrer">Download</a>';
+                    } else {
+                        el.textContent = 'v' + (latest || current) + ' (up to date)';
+                    }
+                } catch (e) {
+                    el.textContent = 'unavailable (no network?)';
+                }
+            })();
+
             try {
                 lastApiAddress = apiAddress;
                 lastApiToken = token;
diff --git a/src/device/config.c b/src/device/config.c
index c97490d..144055c 100644
--- a/src/device/config.c
+++ b/src/device/config.c
@@ -8,8 +8,7 @@
  */
 
 /**
- * @brief JSON configuration loader with hardcoded defaults.
- * @details Parses config.json, applies defaults for missing values.
+ * @brief JSON configuration loader.
  */
 
 #define _POSIX_C_SOURCE 200112L
@@ -33,9 +32,7 @@
 // Global Logging Implementation
 // ============================================================================
 
-/**
- * @brief Global logging implementation for all modules except main.c.
- */
+/** @brief Global log_message implementation for all modules except main.c. */
 void log_message(log_level_t level, const char *format, ...)
 {
     if (level == LOG_INFO && !verbose_logging)
@@ -284,10 +281,7 @@ static void load_device_detection_from_json(json_t *root, Config *config)
     }
 }
 
-/**
- * @brief Find or create a SensorConfig entry by sensor_id.
- * @return Pointer to entry, or NULL if array is full
- */
+/** @brief Find or create SensorConfig entry by sensor_id. Returns NULL if full. */
 static SensorConfig *ensure_sensor_config(Config *config, const char *sensor_id)
 {
     for (int i = 0; i < config->sensor_config_count; i++)
@@ -303,9 +297,7 @@ static SensorConfig *ensure_sensor_config(Config *config, const char *sensor_id)
     return sc;
 }
 
-/**
- * @brief Initialize a SensorConfig with defaults for a given category.
- */
+/** @brief Init per-sensor entry with category-specific thresholds. */
 void init_default_sensor_config(SensorConfig *sc, const char *sensor_id,
                                 int category)
 {
diff --git a/src/device/config.h b/src/device/config.h
index ba18035..88c3c2e 100644
--- a/src/device/config.h
+++ b/src/device/config.h
@@ -9,7 +9,6 @@
 
 /**
  * @brief JSON configuration loader with hardcoded defaults.
- * @details Config struct, load/save functions, default values.
  */
 
 #ifndef CONFIG_H
@@ -28,11 +27,7 @@
 #define CONFIG_MAX_SENSOR_SLOT_LEN 256
 #define CONFIG_MAX_PATTERN_LIST_LEN 512
 
-/**
- * @brief Simple color structure.
- * @details Represents RGB color values with 8-bit components.
- *          The is_set flag indicates if color was explicitly configured.
- */
+/** @brief RGB color; is_set=0 uses default, is_set=1 uses custom value. */
 typedef struct
 {
     uint8_t r;
@@ -41,11 +36,7 @@ typedef struct
     uint8_t is_set; // 0 = use default, 1 = user-defined (allows all RGB values)
 } Color;
 
-/**
- * @brief Common log levels for all modules.
- * @details Defines standardized logging levels used throughout the application
- * for consistent message categorization.
- */
+/** @brief Log levels: INFO (verbose), STATUS/WARNING/ERROR (always shown). */
 typedef enum
 {
     LOG_INFO,
@@ -61,12 +52,7 @@ typedef enum
 #define MAX_SENSOR_CONFIGS 32
 #define SENSOR_CONFIG_ID_LEN 256
 
-/**
- * @brief Per-sensor display configuration.
- * @details Each configured sensor has its own thresholds, bar colors, and
- * display offsets. Sensor ID format: legacy "cpu"/"gpu"/"liquid" or
- * dynamic "device_uid:sensor_name".
- */
+/** @brief Per-sensor thresholds, colors, label and display offsets. */
 typedef struct
 {
     char sensor_id[SENSOR_CONFIG_ID_LEN]; /**< Sensor identifier */
@@ -86,11 +72,7 @@ typedef struct
     float label_to_bar_gap;               /**< Gap below bar as % of available_height (0 = auto) */
 } SensorConfig;
 
-/**
- * @brief Configuration structure.
- * @details Contains all settings for the CoolerDash system, including paths,
- * display settings, temperature thresholds, and visual styling options.
- */
+/** @brief All CoolerDash settings: daemon, paths, display, theme, sensors. */
 typedef struct Config
 {
     // Daemon configuration
@@ -162,36 +144,24 @@ typedef struct Config
     int sensor_config_count;                         /**< Number of valid entries */
 } Config;
 
-/**
- * @brief Global logging function for all modules except main.c.
- * @details Provides unified log output for info, status, warning and error messages.
- */
+/** @brief Global log function (implemented in config.c, used everywhere). */
 void log_message(log_level_t level, const char *format, ...);
 
-/**
- * @brief Global logging control from main.c.
- * @details External variable controlling verbose logging behavior across all modules.
- */
+/** @brief Verbose logging flag (set by --verbose CLI arg). */
 extern int verbose_logging;
 
 // ============================================================================
 // Helper Macros
 // ============================================================================
 
-/**
- * @brief Safe string copy macro using project's cc_safe_strcpy.
- * @details Automatically uses sizeof(dest) for bounds checking.
- */
+/** @brief Safe strcpy: copies src into dest[dest_size] with null-termination. */
 #define SAFE_STRCPY(dest, src)                       \
     do                                               \
     {                                                \
         cc_safe_strcpy((dest), sizeof(dest), (src)); \
     } while (0)
 
-/**
- * @brief Validate LCD orientation value.
- * @details Checks if orientation is one of: 0°, 90°, 180°, 270°.
- */
+/** @brief Returns 1 if orientation is 0, 90, 180, or 270. */
 static inline int is_valid_orientation(int orientation)
 {
     return (orientation == 0 || orientation == 90 || orientation == 180 ||
@@ -219,13 +189,7 @@ static inline int is_valid_orientation(int orientation)
  */
 int load_plugin_config(Config *config, const char *config_path);
 
-/**
- * @brief Find sensor configuration by sensor ID.
- * @details Searches sensor_configs[] for a matching sensor_id.
- * @param config Configuration struct
- * @param sensor_id Sensor identifier ("cpu", "gpu", "liquid", or "uid:name")
- * @return Pointer to matching SensorConfig, or NULL if not found
- */
+/** @brief Find SensorConfig by sensor_id; returns NULL if not found. */
 const SensorConfig *get_sensor_config(const Config *config, const char *sensor_id);
 
 /**
diff --git a/src/main.c b/src/main.c
index 7a09504..b1c8f25 100644
--- a/src/main.c
+++ b/src/main.c
@@ -8,8 +8,7 @@
  */
 
 /**
- * @brief Main entry point and daemon lifecycle.
- * @details Signal handling, PID management, version loading, main loop.
+ * @brief Daemon entry point: signal handling, version, main loop.
  */
 
 // Define POSIX constants
@@ -18,7 +17,9 @@
 
 // Include necessary headers
 // cppcheck-suppress-begin missingIncludeSystem
+#include <dirent.h>
 #include <errno.h>
+#include <pwd.h>
 #include <signal.h>
 #include <stdarg.h>
 #include <stdio.h>
@@ -26,13 +27,15 @@
 #include <string.h>
 #include <sys/stat.h>
 #include <sys/types.h>
+#include <sys/wait.h>
+#include <curl/curl.h>
+#include <jansson.h>
 #include <time.h>
 #include <unistd.h>
 // cppcheck-suppress-end missingIncludeSystem
 
 // Include project headers
 #include "device/config.h"
-#include "mods/circle.h"
 #include "mods/display.h"
 #include "srv/cc_conf.h"
 #include "srv/cc_main.h"
@@ -41,47 +44,24 @@
 // Security and performance constants
 #define DEFAULT_VERSION "unknown"
 #define VERSION_BUFFER_SIZE 32
+#define CC4_MODE_LOCK "/etc/coolercontrol/plugins/coolerdash/.cc4-mode"
+#define GH_UPDATE_URL "https://api.github.com/repos/damachine/coolerdash/releases/latest"
 
-/**
- * @brief Global variables for daemon management.
- * @details Used for controlling the main daemon loop and shutdown image logic.
- */
-static volatile sig_atomic_t running = 1;       // flag whether daemon is running
-static volatile sig_atomic_t reload_config = 0; // flag for SIGHUP config reload
+static volatile sig_atomic_t running = 1;
+static volatile sig_atomic_t reload_config = 0;
 
-/**
- * @brief File-scope storage for config reload.
- * @details Preserved across reload so reload_daemon_config() can re-read
- * config.json and re-apply CLI overrides.
- */
 static const char *s_config_path = NULL;
 static char s_display_mode_override[16] = {0};
 
-/**
- * @brief Global logging control.
- * @details Controls whether detailed INFO logs are shown (enabled with --log
- * parameter).
- */
-int verbose_logging = 0; // Only ERROR and WARNING by default (exported)
+int verbose_logging = 0;
 
-/**
- * @brief Global pointer to configuration.
- * @details Points to the current configuration used by the daemon. Initialized
- * in main().
- */
 const Config *g_config_ptr = NULL;
 
-/**
- * @brief Validate and sanitize version string.
- * @details Checks version string validity and sets default if invalid.
- */
+/** @brief Strip whitespace and validate version string. Sets default on error. */
 static void validate_version_string(char *version_buffer, size_t buffer_size)
 {
-    // Remove trailing whitespace and newlines
     version_buffer[strcspn(version_buffer, "\n\r \t")] = '\0';
 
-    // Validate version string (manual bounded length calculation to avoid strnlen
-    // portability issues)
     size_t ver_len = 0;
     while (ver_len < 21 && version_buffer[ver_len] != '\0')
     {
@@ -94,29 +74,20 @@ static void validate_version_string(char *version_buffer, size_t buffer_size)
     }
 }
 
-/**
- * @brief Read version string from VERSION file with enhanced security.
- * @details Safely reads version from VERSION file with buffer overflow
- * protection and proper validation. Returns fallback version on error.
- */
+/** @brief Read version from VERSION file; returns cached value on repeat calls. */
 static const char *read_version_from_file(void)
 {
     static char version_buffer[VERSION_BUFFER_SIZE] = {0};
     static int version_loaded = 0;
 
-    // Return cached version if already loaded
     if (version_loaded)
     {
         return version_buffer[0] ? version_buffer : DEFAULT_VERSION;
     }
 
-    // Try to read from VERSION file
     FILE *fp = fopen("VERSION", "r");
     if (!fp)
-    {
-        // Try alternative path for installed version
         fp = fopen("/etc/coolercontrol/plugins/coolerdash/VERSION", "r");
-    }
 
     if (!fp)
     {
@@ -144,9 +115,241 @@ static const char *read_version_from_file(void)
     return version_buffer;
 }
 
+/** @brief Parse "X.Y.Z" semver into integers. Returns 1 on success. */
+static int parse_semver(const char *s, int *major, int *minor, int *patch)
+{
+    if (!s)
+        return 0;
+    if (*s == 'v' || *s == 'V')
+        s++;
+    return sscanf(s, "%d.%d.%d", major, minor, patch) == 3;
+}
+
+/** @brief Returns >0 if b is newer than a, 0 if equal, <0 if older. */
+static int semver_newer(const char *a, const char *b)
+{
+    int ma, mia, pa, mb, mib, pb;
+    if (!parse_semver(a, &ma, &mia, &pa) || !parse_semver(b, &mb, &mib, &pb))
+        return 0;
+    if (mb != ma)
+        return mb > ma ? 1 : -1;
+    if (mib != mia)
+        return mib > mia ? 1 : -1;
+    return pb > pa ? 1 : (pb < pa ? -1 : 0);
+}
+
+/** @brief Send desktop notification for available update; opens browser on click.
+ *  @details Runs as root (systemd service), so we must find the active desktop
+ *           user, set DBUS_SESSION_BUS_ADDRESS / XDG_RUNTIME_DIR, and drop
+ *           privileges before calling notify-send.
+ */
+static void send_update_notification(const char *current, const char *latest)
+{
+    if (access("/usr/bin/notify-send", X_OK) != 0)
+        return;
+
+    char body[128];
+    int n = snprintf(body, sizeof(body), "v%s → %s available", current, latest);
+    if (n < 0 || (size_t)n >= sizeof(body))
+        return;
+
+    char url[128];
+    n = snprintf(url, sizeof(url),
+                 "https://github.com/damachine/coolerdash/releases/tag/%s",
+                 latest);
+    if (n < 0 || (size_t)n >= sizeof(url))
+        return;
+
+    /* ── Find active desktop user via /run/user/<uid>/bus ── */
+    DIR *rundir = opendir("/run/user");
+    if (!rundir)
+        return;
+
+    uid_t target_uid = (uid_t)-1;
+    struct dirent *ent;
+    while ((ent = readdir(rundir)) != NULL)
+    {
+        if (ent->d_name[0] == '.')
+            continue;
+        char bus_path[280];
+        snprintf(bus_path, sizeof(bus_path),
+                 "/run/user/%s/bus", ent->d_name);
+        if (access(bus_path, F_OK) == 0)
+        {
+            target_uid = (uid_t)strtoul(ent->d_name, NULL, 10);
+            break;
+        }
+    }
+    closedir(rundir);
+
+    if (target_uid == (uid_t)-1)
+        return;
+
+    struct passwd *pw = getpwuid(target_uid);
+    if (!pw)
+        return;
+
+    pid_t pid = fork();
+    if (pid < 0)
+        return;
+
+    if (pid == 0)
+    {
+        /* Child: set D-Bus environment and drop to desktop user */
+        char dbus_addr[128];
+        snprintf(dbus_addr, sizeof(dbus_addr),
+                 "unix:path=/run/user/%u/bus", (unsigned)target_uid);
+        setenv("DBUS_SESSION_BUS_ADDRESS", dbus_addr, 1);
+
+        char xdg_dir[64];
+        snprintf(xdg_dir, sizeof(xdg_dir),
+                 "/run/user/%u", (unsigned)target_uid);
+        setenv("XDG_RUNTIME_DIR", xdg_dir, 1);
+        setenv("HOME", pw->pw_dir, 1);
+
+        /* Detect display server: Wayland socket or X11 fallback */
+        char wayland_path[128];
+        snprintf(wayland_path, sizeof(wayland_path),
+                 "/run/user/%u/wayland-0", (unsigned)target_uid);
+        if (access(wayland_path, F_OK) == 0)
+        {
+            setenv("WAYLAND_DISPLAY", "wayland-0", 1);
+        }
+        else
+        {
+            setenv("DISPLAY", ":0", 1);
+        }
+
+        /* Drop privileges to desktop user */
+        if (setgid(pw->pw_gid) != 0 || setuid(target_uid) != 0)
+            _exit(1);
+
+        /* Fork grandchild for notify-send with action pipe */
+        int pfd[2];
+        if (pipe(pfd) != 0)
+            _exit(1);
+
+        pid_t np = fork();
+        if (np < 0)
+            _exit(1);
+
+        if (np == 0)
+        {
+            /* Grandchild: exec notify-send, stdout → pipe */
+            close(pfd[0]);
+            dup2(pfd[1], STDOUT_FILENO);
+            close(pfd[1]);
+            execlp("notify-send", "notify-send",
+                   "--wait",
+                   "-t", "10000",
+                   "-i", "coolerdash",
+                   "-a", "CoolerDash",
+                   "-A", "open=Download",
+                   "CoolerDash Update", body,
+                   (char *)NULL);
+            _exit(1);
+        }
+
+        /* Child: read action from notify-send stdout */
+        close(pfd[1]);
+        char action[32] = {0};
+        ssize_t rd = read(pfd[0], action, sizeof(action) - 1);
+        close(pfd[0]);
+        waitpid(np, NULL, 0);
+
+        if (rd > 0)
+        {
+            action[strcspn(action, "\n")] = '\0';
+            if (strcmp(action, "open") == 0 &&
+                access("/usr/bin/xdg-open", X_OK) == 0)
+            {
+                execlp("xdg-open", "xdg-open", url, (char *)NULL);
+            }
+        }
+        _exit(0);
+    }
+
+    /* Parent: don't block — reap child asynchronously */
+    signal(SIGCHLD, SIG_IGN);
+}
+
+/** @brief Query GitHub Releases API and log if a newer version exists. */
+static void check_for_update(const char *current_version)
+{
+    if (!current_version || current_version[0] == '\0')
+        return;
+
+    CURL *curl = curl_easy_init();
+    if (!curl)
+        return;
+
+    http_response buf = {0};
+    if (!cc_init_response_buffer(&buf, 2048))
+    {
+        curl_easy_cleanup(curl);
+        return;
+    }
+
+    char user_agent[64];
+    snprintf(user_agent, sizeof(user_agent), "CoolerDash/%s", current_version);
+
+    struct curl_slist *headers = NULL;
+    headers = curl_slist_append(headers, "Accept: application/vnd.github+json");
+    headers = curl_slist_append(headers, "X-GitHub-Api-Version: 2022-11-28");
+
+    curl_easy_setopt(curl, CURLOPT_URL, GH_UPDATE_URL);
+    curl_easy_setopt(curl, CURLOPT_USERAGENT, user_agent);
+    curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
+    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, (curl_write_callback)write_callback);
+    curl_easy_setopt(curl, CURLOPT_WRITEDATA, &buf);
+    curl_easy_setopt(curl, CURLOPT_TIMEOUT, 5L);
+    curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 3L);
+    curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
+    curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 1L);
+    curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 2L);
+
+    CURLcode res = curl_easy_perform(curl);
+    long http_code = 0;
+    curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &http_code);
+
+    if (res == CURLE_OK && http_code == 200 && buf.data)
+    {
+        json_error_t jerr;
+        json_t *root = json_loads(buf.data, 0, &jerr);
+        if (root)
+        {
+            const json_t *tag = json_object_get(root, "tag_name");
+            if (json_is_string(tag))
+            {
+                const char *latest = json_string_value(tag);
+                if (semver_newer(current_version, latest) > 0)
+                {
+                    log_message(LOG_STATUS,
+                                "Update available: v%s -> %s  "
+                                "https://github.com/damachine/coolerdash/releases",
+                                current_version, latest);
+                    send_update_notification(current_version, latest);
+                }
+                else
+                    log_message(LOG_STATUS,
+                                "CoolerDash v%s is up to date", current_version);
+            }
+            json_decref(root);
+        }
+    }
+    else
+    {
+        log_message(LOG_INFO, "Update check skipped (no network or API unavailable)");
+    }
+
+    cc_cleanup_response_buffer(&buf);
+    if (headers)
+        curl_slist_free_all(headers);
+    curl_easy_cleanup(curl);
+}
+
 /**
- * @brief Detect if we were started by CoolerControl plugin system.
- * @details Checks INVOCATION_ID environment variable set by systemd/CoolerControl.
+ * @brief Detect if started by CoolerControl plugin system.
  */
 static int is_started_as_plugin(void)
 {
@@ -154,11 +357,7 @@ static int is_started_as_plugin(void)
     return (invocation_id && invocation_id[0]) ? 1 : 0;
 }
 
-/**
- * @brief Enhanced help display with improved formatting and security
- * information.
- * @details Prints comprehensive usage information and security recommendations.
- */
+/** @brief Print usage information and exit hints. */
 static void show_help(const char *program_name)
 {
     if (!program_name)
@@ -229,18 +428,12 @@ static void show_help(const char *program_name)
            "===========\n");
 }
 
-/**
- * @brief Display system information for diagnostics.
- * @details Shows display configuration, API validation results, and refresh
- * interval settings for system diagnostics.
- */
+/** @brief Log display dimensions and refresh interval. */
 static void show_system_diagnostics(const Config *config, int api_width,
                                     int api_height)
 {
     if (!config)
         return;
-
-    // Display configuration with API validation integrated
     if (api_width > 0 && api_height > 0)
     {
         if (api_width != config->display_width ||
@@ -270,13 +463,9 @@ static void show_system_diagnostics(const Config *config, int api_width,
                 config->display_refresh_interval);
 }
 
-/**
- * @brief Enhanced signal handler with atomic operations and secure shutdown.
- * @details Signal-safe implementation using only async-signal-safe functions.
- */
+/** @brief Async-signal-safe shutdown handler. */
 static void handle_shutdown_signal(int signum)
 {
-    // Use only async-signal-safe functions in signal handlers
     static const char term_msg[] =
         "Received SIGTERM - initiating graceful shutdown\n";
     static const char int_msg[] =
@@ -288,7 +477,6 @@ static void handle_shutdown_signal(int signum)
     const char *msg;
     size_t msg_len;
 
-    // Determine appropriate message based on signal
     switch (signum)
     {
     case SIGTERM:
@@ -309,20 +497,12 @@ static void handle_shutdown_signal(int signum)
         break;
     }
 
-    // Write message using async-signal-safe function
     ssize_t written = write(STDERR_FILENO, msg, msg_len);
-    (void)written; // Suppress unused variable warning
-
-    // Signal graceful shutdown atomically
-    // Note: File cleanup (PID, images) is handled in perform_cleanup()
+    (void)written;
     running = 0;
 }
 
-/**
- * @brief Signal handler for SIGHUP (config reload).
- * @details Sets the reload flag so the main loop re-reads config.json.
- * Only uses async-signal-safe functions.
- */
+/** @brief SIGHUP handler — sets reload flag. */
 static void handle_reload_signal(int signum)
 {
     (void)signum;
@@ -332,11 +512,7 @@ static void handle_reload_signal(int signum)
     reload_config = 1;
 }
 
-/**
- * @brief Setup enhanced signal handlers with comprehensive signal management.
- * @details Installs signal handlers for graceful shutdown and blocks unwanted
- * signals.
- */
+/** @brief Install signal handlers for SIGTERM/SIGINT/SIGQUIT/SIGHUP. */
 static void setup_enhanced_signal_handlers(void)
 {
     struct sigaction sa;
@@ -380,9 +556,8 @@ static void setup_enhanced_signal_handlers(void)
                     strerror(errno));
     }
 
-    // Block unwanted signals to prevent interference
     sigemptyset(&block_mask);
-    sigaddset(&block_mask, SIGPIPE); // Prevent broken pipe crashes
+    sigaddset(&block_mask, SIGPIPE);
 
     if (pthread_sigmask(SIG_BLOCK, &block_mask, NULL) != 0)
     {
@@ -390,26 +565,18 @@ static void setup_enhanced_signal_handlers(void)
     }
 }
 
-/**
- * @brief Reload configuration from config.json (SIGHUP handler).
- * @details Resets all module state, re-reads config.json, and re-initializes
- * CoolerControl session and device cache. On failure, logs error but the
- * daemon continues running with the previous configuration values.
- */
+/** @brief Re-read config.json on SIGHUP; re-init session and device cache. */
 static void reload_daemon_config(Config *config)
 {
     log_message(LOG_STATUS, "SIGHUP received — reloading configuration...");
 
-    // 1. Tear down module state (reverse order of init)
     cleanup_sensor_curl_handle();
     reset_coolercontrol_session();
     reset_device_cache();
-    reset_circle_state();
+    reset_display_state();
 
-    // 2. Re-read config.json into the existing struct
     load_plugin_config(config, s_config_path);
 
-    // 3. Re-apply CLI display mode override if it was set at startup
     if (s_display_mode_override[0] != '\0')
     {
         cc_safe_strcpy(config->display_mode, sizeof(config->display_mode),
@@ -434,17 +601,12 @@ static void reload_daemon_config(Config *config)
         return;
     }
 
-    // 6. Update LCD dimensions from device if config has width/height=0
     update_config_from_device(config);
 
     log_message(LOG_STATUS, "Configuration reloaded successfully");
 }
 
-/**
- * @brief Enhanced main daemon loop with improved timing and error handling.
- * @details Runs the main loop with precise timing, optimized sleep, and
- * graceful error recovery. Handles SIGHUP for live config reload.
- */
+/** @brief Main daemon loop: renders display on interval, handles SIGHUP. */
 static int run_daemon(Config *config)
 {
     if (!config)
@@ -453,8 +615,6 @@ static int run_daemon(Config *config)
         return -1;
     }
 
-    // Convert float seconds to timespec (e.g., 2.50 -> tv_sec=2,
-    // tv_nsec=500000000)
     long interval_sec = (long)config->display_refresh_interval;
     long interval_nsec =
         (long)((config->display_refresh_interval - interval_sec) * 1000000000);
@@ -471,13 +631,11 @@ static int run_daemon(Config *config)
 
     while (running)
     {
-        // Check for pending config reload (SIGHUP)
         if (reload_config)
         {
             reload_config = 0;
             reload_daemon_config(config);
 
-            // Recalculate interval from potentially changed refresh_interval
             interval_sec = (long)config->display_refresh_interval;
             interval_nsec = (long)((config->display_refresh_interval -
                                     interval_sec) *
@@ -486,7 +644,6 @@ static int run_daemon(Config *config)
             interval.tv_nsec = interval_nsec;
         }
 
-        // Calculate next execution time with overflow protection
         next_time.tv_sec += interval.tv_sec;
         next_time.tv_nsec += interval.tv_nsec;
         if (next_time.tv_nsec >= 1000000000L)
@@ -495,10 +652,8 @@ static int run_daemon(Config *config)
             next_time.tv_nsec -= 1000000000L;
         }
 
-        // Execute main rendering task
         draw_display_image(config);
 
-        // Sleep until absolute time with error handling
         int sleep_result =
             clock_nanosleep(CLOCK_MONOTONIC, TIMER_ABSTIME, &next_time, NULL);
         if (sleep_result != 0 && sleep_result != EINTR)
@@ -510,15 +665,12 @@ static int run_daemon(Config *config)
     return 0;
 }
 
-/**
- * @brief Parse command line arguments.
- * @details Processes command line options and returns config path.
- */
+/** @brief Parse CLI args; returns config path. */
 static const char *parse_arguments(int argc, char **argv,
                                    char *display_mode_override)
 {
     const char *config_path = "/etc/coolercontrol/plugins/coolerdash/config.json";
-    display_mode_override[0] = '\0'; // Initialize as empty
+    display_mode_override[0] = '\0';
 
     for (int i = 1; i < argc; i++)
     {
@@ -556,10 +708,7 @@ static const char *parse_arguments(int argc, char **argv,
     return config_path;
 }
 
-/**
- * @brief Verify plugin directory write permissions for generated images.
- * @details Ensures the plugin directory is writable by the current user.
- */
+/** @brief Check plugin dir is writable. */
 static int verify_plugin_dir_permissions(const char *plugin_dir)
 {
     if (!plugin_dir || !plugin_dir[0])
@@ -577,17 +726,10 @@ static int verify_plugin_dir_permissions(const char *plugin_dir)
     return 1;
 }
 
-/**
- * @brief Initialize configuration from plugin config.json.
- * @details Loads config using unified plugin.c system:
- *          1. Initialize defaults (hardcoded)
- *          2. Try to load config.json (overrides defaults)
- *          3. Apply remaining defaults for missing fields
- */
+/** @brief Load config.json and check dir permissions. */
 static int initialize_config_and_instance(const char *config_path,
                                           Config *config)
 {
-    // Load configuration from config.json (or defaults if not found)
     int json_loaded = load_plugin_config(config, config_path);
 
     if (!json_loaded)
@@ -599,7 +741,6 @@ static int initialize_config_and_instance(const char *config_path,
     log_message(LOG_INFO, "Running mode: %s",
                 is_plugin_mode ? "CoolerControl plugin" : "standalone");
 
-    // Verify plugin directory write permissions for image generation
     if (!verify_plugin_dir_permissions(config->paths_images))
     {
         log_message(LOG_ERROR, "Failed to verify plugin directory permissions");
@@ -609,10 +750,7 @@ static int initialize_config_and_instance(const char *config_path,
     return 1;
 }
 
-/**
- * @brief Initialize CoolerControl services.
- * @details Initializes session and device cache.
- */
+/** @brief Init CC session and device cache. */
 static int initialize_coolercontrol_services(const Config *config)
 {
     if (!init_coolercontrol_session(config))
@@ -647,10 +785,7 @@ static int initialize_coolercontrol_services(const Config *config)
     return 0;
 }
 
-/**
- * @brief Initialize and validate device information.
- * @details Retrieves device info and validates sensors.
- */
+/** @brief Fetch device info, validate sensors, log system state. */
 static void initialize_device_info(Config *config)
 {
     char device_uid[128] = {0};
@@ -697,39 +832,23 @@ static void initialize_device_info(Config *config)
     show_system_diagnostics(config, api_screen_width, api_screen_height);
 }
 
-/**
- * @brief Perform cleanup operations.
- * @details Closes CoolerControl session and frees resources.
- * The LCD image file is intentionally kept on disk so that CoolerControl
- * can still find it when applying saved settings on next startup
- * (coolerdash is started after CC applies settings).
- * Shutdown image is handled by CC4 natively via register_shutdown_image_with_cc().
- */
+/** @brief Cleanup CURL handles and log shutdown. */
 static void perform_cleanup(const Config *config)
 {
     (void)config;
     log_message(LOG_INFO, "Daemon shutdown initiated");
-
-    // Close CoolerControl session and free resources
     cleanup_coolercontrol_session();
     cleanup_sensor_curl_handle();
-
     running = 0;
     log_message(LOG_INFO, "CoolerDash shutdown complete");
 }
 
-/**
- * @brief Enhanced main entry point for CoolerDash with comprehensive error
- * handling.
- * @details Loads configuration, ensures single instance, initializes all
- * modules, and starts the main daemon loop.
- */
+/** @brief Daemon entry point. */
 int main(int argc, char **argv)
 {
     char display_mode_override[16] = {0};
     const char *config_path = parse_arguments(argc, argv, display_mode_override);
 
-    // Store in file-scope statics for SIGHUP reload
     s_config_path = config_path;
     cc_safe_strcpy(s_display_mode_override, sizeof(s_display_mode_override),
                    display_mode_override);
@@ -763,8 +882,21 @@ int main(int argc, char **argv)
         return EXIT_FAILURE;
     }
 
+    /* CC4 lock file: disable helper service on next boot when token is set */
+    if (config.access_token[0] != '\0')
+    {
+        FILE *lf = fopen(CC4_MODE_LOCK, "w");
+        if (lf)
+            fclose(lf);
+    }
+    else
+    {
+        unlink(CC4_MODE_LOCK);
+    }
+
     log_message(LOG_STATUS, "CoolerDash initializing device cache...\n");
     initialize_device_info(&config);
+    check_for_update(read_version_from_file());
 
     // Render initial image immediately so the PNG exists on disk
     // before CC applies saved LCD settings (avoids startup race condition)
diff --git a/src/mods/display.c b/src/mods/display.c
index 2b0a036..07e5d41 100644
--- a/src/mods/display.c
+++ b/src/mods/display.c
@@ -1020,6 +1020,11 @@ float get_slot_font_size(const struct Config *config, const char *slot_value)
  * logic and mode-specific rendering.
  * @param config Configuration containing display mode and rendering parameters
  */
+void reset_display_state(void)
+{
+    reset_circle_state();
+}
+
 void draw_display_image(const struct Config *config)
 {
     if (!config)
diff --git a/src/mods/display.h b/src/mods/display.h
index 48e24a0..ce787cd 100644
--- a/src/mods/display.h
+++ b/src/mods/display.h
@@ -88,6 +88,9 @@ typedef struct
  */
 void draw_display_image(const struct Config *config);
 
+/** @brief Reset display state on config reload (SIGHUP); delegates to active mode. */
+void reset_display_state(void);
+
 // ============================================================================
 // Shared Cairo Rendering Helpers
 // ============================================================================
diff --git a/src/srv/cc_conf.c b/src/srv/cc_conf.c
index 90f2944..bdc6af7 100644
--- a/src/srv/cc_conf.c
+++ b/src/srv/cc_conf.c
@@ -9,7 +9,6 @@
 
 /**
  * @brief Device cache and display detection.
- * @details Caches device UID, detects LCD type (circular vs rectangular).
  */
 
 // Define POSIX constants
@@ -30,11 +29,7 @@
 #include "cc_conf.h"
 #include "cc_main.h"
 
-/**
- * @brief Secure string copy with bounds checking.
- * @details Performs safe string copying with buffer overflow protection and
- * null termination guarantee.
- */
+/** @brief Safe string copy with null-termination guarantee. */
 int cc_safe_strcpy(char *restrict dest, size_t dest_size,
                    const char *restrict src)
 {
@@ -55,11 +50,7 @@ int cc_safe_strcpy(char *restrict dest, size_t dest_size,
     return 0;
 }
 
-/**
- * @brief Static cache for device information (never changes during runtime).
- * @details Holds the device UID, name, display dimensions, and circular display
- * flag once fetched from the API.
- */
+/** @brief Device UID/name/dimensions cache (populated once at startup). */
 static struct
 {
     int initialized;
@@ -70,10 +61,7 @@ static struct
     int is_circular;
 } device_cache = {0};
 
-/**
- * @brief Cache for all device names and types (populated from /devices).
- * @details Maps device UID to display name and type string.
- */
+/** @brief Name/type cache for all devices (populated from /devices). */
 static struct
 {
     char uid[128];
@@ -82,10 +70,7 @@ static struct
 } device_name_cache[MAX_DEVICE_NAME_CACHE];
 static int device_name_cache_count = 0;
 
-/**
- * @brief Resets device cache for config reload (SIGHUP).
- * @details Clears all cached device data so it will be re-fetched from the API.
- */
+/** @brief Reset device cache for SIGHUP config reload. */
 void reset_device_cache(void)
 {
     memset(&device_cache, 0, sizeof(device_cache));
@@ -93,9 +78,7 @@ void reset_device_cache(void)
     device_name_cache_count = 0;
 }
 
-/**
- * @brief Get device display name by UID.
- */
+/** @brief Look up device display name by UID. */
 const char *get_device_name_by_uid(const char *device_uid)
 {
     if (!device_uid)
@@ -108,9 +91,7 @@ const char *get_device_name_by_uid(const char *device_uid)
     return "";
 }
 
-/**
- * @brief Get device type string by UID.
- */
+/** @brief Look up device type string by UID. */
 const char *get_device_type_by_uid(const char *device_uid)
 {
     if (!device_uid)
@@ -123,11 +104,7 @@ const char *get_device_type_by_uid(const char *device_uid)
     return NULL;
 }
 
-/**
- * @brief Extract device type from JSON device object.
- * @details Common helper function to extract device type string from JSON
- * device object. Checks "type" first (/devices), falls back to "d_type" (/status).
- */
+/** @brief Extract device type from JSON ("type" or fallback "d_type"). */
 const char *extract_device_type_from_json(const json_t *dev)
 {
     if (!dev)
@@ -145,11 +122,7 @@ const char *extract_device_type_from_json(const json_t *dev)
     return json_string_value(type_val);
 }
 
-/**
- * @brief Check if a device has a circular display based on device name/type.
- * @details Returns 1 if the device is known to have a circular/round LCD
- * display.
- */
+/** @brief Returns 1 if device has a circular LCD (Kraken or >240px display). */
 int is_circular_display_device(const char *device_name, int screen_width,
                                int screen_height)
 {
diff --git a/src/srv/cc_main.h b/src/srv/cc_main.h
index 6fae4af..88e55a7 100644
--- a/src/srv/cc_main.h
+++ b/src/srv/cc_main.h
@@ -9,7 +9,6 @@
 
 /**
  * @brief Session management, authentication, LCD image upload.
- * @details HTTP client for CoolerControl REST API.
  */
 
 #ifndef CC_MAIN_H
@@ -36,11 +35,7 @@
 struct Config;
 struct curl_slist;
 
-/**
- * @brief Response buffer for libcurl HTTP operations.
- * @details Structure to hold HTTP response data with dynamic memory management
- * for effiziente Datensammlung.
- */
+/** @brief Dynamic buffer for libcurl HTTP response data. */
 typedef struct http_response
 {
     char *data;
@@ -48,75 +43,36 @@ typedef struct http_response
     size_t capacity;
 } http_response;
 
-/**
- * @brief Initialize HTTP response buffer with specified capacity.
- * @details Allocates memory for HTTP response data with proper initialization.
- */
+/** @brief Init HTTP response buffer. */
 int cc_init_response_buffer(http_response *response, size_t initial_capacity);
 
-/**
- * @brief Cleanup HTTP response buffer and free memory.
- * @details Properly frees allocated memory and resets buffer state.
- */
+/** @brief Free HTTP response buffer. */
 void cc_cleanup_response_buffer(http_response *response);
 
-/**
- * @brief Callback for libcurl to write received data into a buffer.
- * @details This function is used by libcurl to store incoming HTTP response
- * data into a dynamically allocated buffer.
- */
+/** @brief libcurl write callback — appends received data to response buffer. */
 size_t write_callback(const void *contents, size_t size, size_t nmemb,
                       http_response *response);
 
-/**
- * @brief Initializes a CoolerControl session and authenticates with the daemon
- * using configuration.
- * @details Must be called before any other CoolerControl API function. Sets up
- * CURL session and performs authentication.
- */
+/** @brief Init CURL session; authenticates via Bearer token or Basic Auth. */
 int init_coolercontrol_session(const struct Config *config);
 
-/**
- * @brief Returns whether the session is initialized.
- * @details Checks if the session is ready for communication with the
- * CoolerControl daemon.
- */
+/** @brief Returns 1 if session is ready for API calls. */
 int is_session_initialized(void);
 
-/**
- * @brief Cleans up and terminates the CoolerControl session.
- * @details Frees all resources and closes the session.
- */
+/** @brief Free CURL resources and close session. */
 void cleanup_coolercontrol_session(void);
 
-/**
- * @brief Resets the CoolerControl session for config reload (SIGHUP).
- * @details Destroys the CURL handle without global cleanup, allowing
- * re-initialization via init_coolercontrol_session().
- */
+/** @brief Destroy CURL handle for SIGHUP reload; allows re-init. */
 void reset_coolercontrol_session(void);
 
-/**
- * @brief Returns the active Bearer access token (empty string if not set).
- * @details Used by cc_conf and cc_sensor to attach auth headers.
- */
+/** @brief Returns active Bearer token (empty if not set). */
 const char *get_session_access_token(void);
 
-/**
- * @brief Sends an image path to the LCD via JSON settings endpoint.
- * @details Uses PUT /devices/{uid}/settings/lcd/lcd with LcdSettings JSON body
- * containing image_file_processed path. CoolerControl reads the image directly
- * from disk instead of receiving full binary data over HTTP.
- */
+/** @brief Upload image to LCD via JSON (CC4) or multipart (CC3). */
 int send_image_to_lcd(const struct Config *config, const char *image_path,
                       const char *device_uid);
 
-/**
- * @brief Register shutdown image with CC4's persistent LCD shutdown endpoint.
- * @details Called once at daemon startup. CC4 will display the image
- * automatically whenever the coolercontrold daemon stops.
- * Silently skips on 404 when the endpoint is unavailable.
- */
+/** @brief Register shutdown image with CC4; called once at startup. */
 int register_shutdown_image_with_cc(const struct Config *config,
                                     const char *image_path,
                                     const char *device_uid);
diff --git a/src/srv/cc_sensor.c b/src/srv/cc_sensor.c
index a11a7fd..21883aa 100644
--- a/src/srv/cc_sensor.c
+++ b/src/srv/cc_sensor.c
@@ -8,9 +8,7 @@
  */
 
 /**
- * @brief Sensor monitoring via CoolerControl API.
- * @details Reads all sensor data (temps, RPM, duty, watts, freq) from
- * /status endpoint for all device types.
+ * @brief Sensor monitoring via CoolerControl /status endpoint.
  */
 
 // Include necessary headers
@@ -28,13 +26,10 @@
 #include "cc_main.h"
 #include "cc_sensor.h"
 
-/** @brief Cached CURL handle for reuse across polling cycles. */
+/** @brief Cached CURL handle for sensor polling. */
 static CURL *sensor_curl_handle = NULL;
 
-/**
- * @brief Initialize or retrieve cached CURL handle for sensor polling.
- * @return Cached CURL handle, or NULL on failure
- */
+/** @brief Init or return cached CURL handle. */
 static CURL *get_sensor_curl_handle(void)
 {
     if (!sensor_curl_handle)
@@ -46,10 +41,7 @@ static CURL *get_sensor_curl_handle(void)
     return sensor_curl_handle;
 }
 
-/**
- * @brief Cleanup cached sensor CURL handle.
- * @details Called during daemon shutdown to free resources.
- */
+/** @brief Free cached sensor CURL handle at daemon shutdown. */
 void cleanup_sensor_curl_handle(void)
 {
     if (sensor_curl_handle)
@@ -59,11 +51,7 @@ void cleanup_sensor_curl_handle(void)
     }
 }
 
-/**
- * @brief Add a sensor entry to the monitor data collection.
- * @details Helper to append a new sensor entry with bounds checking.
- * @return 1 if added, 0 if array full
- */
+/** @brief Append a sensor entry with bounds check. Returns 1 on success. */
 static int add_sensor_entry(monitor_sensor_data_t *data,
                             const char *name, const char *device_uid,
                             const char *device_type, sensor_category_t category,
@@ -90,10 +78,7 @@ static int add_sensor_entry(monitor_sensor_data_t *data,
     return 1;
 }
 
-/**
- * @brief Collect all temperature sensors from a device's latest status.
- * @details Iterates temps[] array in the last status_history entry.
- */
+/** @brief Collect temperature sensors from latest device status_history entry. */
 static void collect_device_temps(const json_t *device, const char *device_uid,
                                  const char *device_type,
                                  monitor_sensor_data_t *data)