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)