clawdie/clawdie-iso
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update builder instructions with xkb flag + clock format (Sam & Codex)

Browse source
This commit is contained in:
Clawdie Operator 2026-06-04 06:50:43 +00:00
parent 0ae0549c92
commit 0c59b1dca3
1 changed files with 43 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

48
docs/BUILDER-INSTRUCTIONS.md
View file

@ -188,6 +188,42 @@ These modules cause ~50 lines of `AE_AML_BUFFER_LIMIT` ACPI errors per boot
on the operator laptop. Removing them eliminates the spam with no functional
loss (fn-keys continue to work via the standard acpi_video module).
### 3g. xkb keyboard plugin — show flag instead of text label
**File:** `live/operator-session/panel-skel/.config/xfce4/xfconf/xfce-perchannel-xml/xfce4-panel.xml`
The xkb plugin (plugin-10) was showing the language code "si" as text.
Change `display-type` from 1 (text label) to 0 (image/flag only):
```diff
- <property name="display-type" type="uint" value="1"/>
+ <property name="display-type" type="uint" value="0"/>
```
### 3h. Clock format — 2-digit year
**File:** `live/operator-session/panel-skel/.config/xfce4/xfconf/xfce-perchannel-xml/xfce4-panel.xml`
Truncate the 4-digit year (`2026`) to 2 digits (`26`):
```diff
- <property name="digital-format" type="string" value="%H:%M %d.%b.%Y"/>
+ <property name="digital-format" type="string" value="%H:%M %d.%b.%y"/>
```
### 3i. Icon cache note
After build, all icon caches regenerate automatically via the package
post-install scripts. On the live system, if icons appear dotted/broken
after updating icon files, run:
```sh
for theme in Papirus Papirus-Dark Papirus-Light hicolor Adwaita; do
gtk-update-icon-cache -f /usr/local/share/icons/$theme
done
pkill xfce4-panel; DISPLAY=:0 xfce4-panel &
```
---
## Verification checklist (post-build boot)
@ -200,10 +236,12 @@ loss (fn-keys continue to work via the standard acpi_video module).
| 4 | Panel on laptop display | taskbar on eDP, not HDMI |
| 5 | Wallpaper on both monitors | clawdie-operator-bg.png on laptop + TV |
| 6 | HDMI rotation | 270° (vertical) |
| 7 | Clawdie-start icon | isn't fuzzy/misplaced |
| 8 | Visuals guard | absent (`/usr/local/bin/clawdie-xfce-visuals-guard.sh` → no such file) |
| 9 | No-blank guard | runs (check `~/.clawdie-noblank-guard.log`) |
| 10 | `xfconf-query -c xfce4-desktop -p /backdrop/screen0 -lv` | All `image-path`/`last-image` values are **scalars** (no `[...]` brackets) |
| 7 | Clawdie-start icon | clearly rendered, not fuzzy/misplaced |
| 8 | xkb plugin | shows flag icon, not "si" text |
| 9 | Clock format | shows 2-digit year (e.g., `06:23 04.Jun.26`) |
| 10 | Visuals guard | absent (`/usr/local/bin/clawdie-xfce-visuals-guard.sh` → no such file) |
| 11 | No-blank guard | runs (check `~/.clawdie-noblank-guard.log`) |
| 12 | `xfconf-query -c xfce4-desktop -p /backdrop/screen0 -lv` | All `image-path`/`last-image` values are **scalars** (no `[...]` brackets) |
---
@ -215,7 +253,7 @@ Files to create:
Files to modify:
build.sh (hostname, kld_list, displays.xml loop)
live/operator-session/panel-skel/.config/xfce4/xfconf/xfce-perchannel-xml/xfce4-panel.xml (+output-name)
live/operator-session/panel-skel/.config/xfce4/xfconf/xfce-perchannel-xml/xfce4-panel.xml (+output-name, xkb flag, 2-digit year)
live/operator-session/panel-skel/.config/xfce4/xfconf/xfce-perchannel-xml/xfce4-desktop.xml (+monitorHDMI-A-0 block)
Already on branches: