diff --git a/README.md b/README.md
index ef50a0b..b730c2f 100644
--- a/README.md
+++ b/README.md
@@ -72,17 +72,24 @@ sudo pkg install lcd4linux-ax206
### What gets installed
-**Linux:**
+**Linux (`lcd4linux-ax206`):**
- `/usr/bin/lcd4linux` — the binary
- `/etc/lcd4linux/lcd4linux.conf` — default configuration (320x240 DPF layout)
- `/etc/lcd4linux/examples/` — additional example configs
- `lcd4linux-ax206.service` — systemd service unit
+**Linux (`lcd4linux-ax206-themes`, optional):**
+- `/usr/bin/lcd4linux-theme` — theme management CLI
+- `/usr/share/lcd4linux/themes/` — 39 pre-built themes
+- `/usr/share/lcd4linux/fonts/` — bundled TrueType fonts
+
**FreeBSD:**
- `/usr/local/bin/lcd4linux` — the binary
+- `/usr/local/bin/lcd4linux-theme` — theme management CLI
- `/usr/local/etc/lcd4linux/lcd4linux.conf` — default configuration
- `/usr/local/etc/lcd4linux/examples/` — additional example configs
-- `/usr/local/share/lcd4linux/themes/` — pre-built themes
+- `/usr/local/share/lcd4linux/themes/` — 39 pre-built themes
+- `/usr/local/share/lcd4linux/fonts/` — bundled TrueType fonts
- `/usr/local/etc/rc.d/lcd4linux` — rc.d service script
### Starting the service
@@ -230,10 +237,29 @@ See [AX206 Fork Features](https://github.com/amd989/lcd4linux-ax206/wiki/ax206_f
**[Browse the Theme Gallery →](themes/README.md)**
-To use a theme, point lcd4linux at its config file:
+### Using themes after installation
+
+Install the themes package, then use the `lcd4linux-theme` CLI:
+
+```bash
+sudo apt install lcd4linux-ax206-themes
+
+# List all available themes
+lcd4linux-theme list
+
+# Apply a theme (backs up your current config automatically)
+sudo lcd4linux-theme apply SimpleBlue
+
+# Check what's currently active
+lcd4linux-theme current
+```
+
+### Using themes from source
+
+Point lcd4linux directly at the config file from the repository root:
```bash
-lcd4linux -F -c themes/SimpleWhite/dpf_simplewhite.conf
+./lcd4linux -F -f themes/SimpleWhite/dpf_simplewhite.conf
```
Original theme designs from [turing-smart-screen-python](https://github.com/mathoudebine/turing-smart-screen-python), adapted for lcd4linux. Theme authors: [@takattila](https://github.com/takattila), [@mathoudebine](https://github.com/mathoudebine), [@napobear](https://github.com/napobear), [@amiltonjr](https://github.com/amiltonjr). Licensed under GPL-3.0.
diff --git a/debian/control b/debian/control
index 364982a..9543fea 100644
--- a/debian/control
+++ b/debian/control
@@ -27,3 +27,11 @@ Description: LCD display driver for AX206 USB displays
.
Features include pixel-level brightness control, VNC mirror display support,
TrueType font rendering, and graphical bar widgets with color thresholds.
+
+Package: lcd4linux-ax206-themes
+Architecture: all
+Depends: lcd4linux-ax206, ${misc:Depends}
+Description: Themes and fonts for lcd4linux-ax206
+ Collection of 39 pre-built themes with background images and TrueType fonts
+ for AX206 USB LCD displays. Includes a theme management CLI (lcd4linux-theme)
+ for easy theme switching.
diff --git a/debian/lcd4linux-ax206-themes.install b/debian/lcd4linux-ax206-themes.install
new file mode 100644
index 0000000..a9b7017
--- /dev/null
+++ b/debian/lcd4linux-ax206-themes.install
@@ -0,0 +1,3 @@
+lcd4linux-theme usr/bin
+themes usr/share/lcd4linux
+fonts usr/share/lcd4linux
diff --git a/debian/lcd4linux-ax206.dirs b/debian/lcd4linux-ax206.dirs
new file mode 100644
index 0000000..fb55a98
--- /dev/null
+++ b/debian/lcd4linux-ax206.dirs
@@ -0,0 +1 @@
+usr/share/lcd4linux
diff --git a/debian/lcd4linux-ax206.service b/debian/lcd4linux-ax206.service
index 76c8c04..26e4535 100644
--- a/debian/lcd4linux-ax206.service
+++ b/debian/lcd4linux-ax206.service
@@ -4,7 +4,8 @@ After=network.target
[Service]
Type=simple
-ExecStartPre=/bin/sh -c 'test -f /etc/lcd4linux/lcd4linux.conf || { echo "No config found. Copy an example: sudo cp /etc/lcd4linux/examples/dpf_320x240.conf /etc/lcd4linux/lcd4linux.conf"; exit 1; }'
+WorkingDirectory=/usr/share/lcd4linux
+ExecStartPre=/bin/sh -c 'test -f /etc/lcd4linux/lcd4linux.conf || { echo "No config found. Run: sudo lcd4linux-theme apply SimpleBlue"; exit 1; }'
ExecStart=/usr/bin/lcd4linux -F -f /etc/lcd4linux/lcd4linux.conf
Restart=on-failure
RestartSec=10
diff --git a/debian/rules b/debian/rules
index ff056d5..07d5c7b 100755
--- a/debian/rules
+++ b/debian/rules
@@ -21,6 +21,7 @@ override_dh_auto_install:
override_dh_install:
dh_install
install -D -m 0644 dpf_320x240.conf debian/lcd4linux-ax206/etc/lcd4linux/lcd4linux.conf
+ chmod 0755 debian/lcd4linux-ax206-themes/usr/bin/lcd4linux-theme
override_dh_auto_clean:
[ ! -f Makefile ] || dh_auto_clean
diff --git a/gh-pages/index.html b/gh-pages/index.html
index 6b24125..468503f 100644
--- a/gh-pages/index.html
+++ b/gh-pages/index.html
@@ -93,21 +93,24 @@
lcd4linux-ax206
apt
Debian, Ubuntu, Mint
$ curl -fsSL https://amd989.github.io/lcd4linux-ax206/setup-apt.sh | sudo bash
-$ sudo apt install lcd4linux-ax206
+$ sudo apt install lcd4linux-ax206
+$ sudo apt install lcd4linux-ax206-themes # themes + lcd4linux-theme CLI (optional)
dnf / yum
RHEL, Rocky Linux, Fedora
$ curl -fsSL https://amd989.github.io/lcd4linux-ax206/setup-rpm.sh | sudo bash
-$ sudo dnf install lcd4linux-ax206
+
$ sudo dnf install lcd4linux-ax206
+
$ sudo dnf install lcd4linux-ax206-themes # themes + lcd4linux-theme CLI (optional)
pkg
FreeBSD, OPNSense, pfSense
$ curl -fsSL https://amd989.github.io/lcd4linux-ax206/setup-pkg.sh | sudo sh
-$ sudo pkg install lcd4linux-ax206
+
$ sudo pkg install lcd4linux-ax206
+
$ sudo pkg install lcd4linux-ax206-themes # themes + lcd4linux-theme CLI (optional)