deonspengler/akp02d

Launch the README's theme editor (akp02d-edit) headless via Qt offscreen; it stays running with a live preview and needs no hardware. Confirmed the Qt window loads and the process stays alive until stopped.

cd <host-path> && ls -la && cat README.md 2>/dev/null | head -200
cd <host-path> && git log -1 --oneline 2>/dev/null; ls .github/workflows 2>/dev/null; ls <host-path> 2>/dev/null; echo "CDP=$CDP_URL $<env-var>"
cd <host-path> && python3 --version; which pipx uv cava playerctl pactl 2>&1; cat pyproject.toml | head -40; ls akp02d; ls docs; grep -n "run:" -A3 .github/workflows/release.yml | head -40; ls <host-path>; grep -n "akp02d\|--check\|ctl" <host-path> | head -30
(sudo apt-get update -qq && apt-cache policy python3.13 python3.13-venv | head -8) 2>&1 | tail -15
apt-cache policy python3.13 2>&1 | head; apt-cache search --names-only '^python3.13' 2>&1 | head; which uv pip3 2>&1; python3 -m pip --version 2>&1
sudo apt-get install -y -qq python3-pip python3-venv >/tmp/apt.log 2>&1; echo rc=$?; python3 -m pip install -q --break-system-packages uv 2>&1 | tail -3; which uv || ls ~/.local/bin; (~/.local/bin/uv python install 3.13 2>&1 || uv python install 3.13 2>&1) | tail -5
export PATH=$HOME/.local/bin:$PATH; export NODE_USE_ENV_PROXY=1; cd /tmp && uv venv -q --python 3.13 /tmp/akp-venv && uv pip install -q --python /tmp/akp-venv/bin/python "<host-path>" 2>&1 | tail -5; echo rc=$?; ls /tmp/akp-venv/bin | grep akp; /tmp/akp-venv/bin/akp02d --help 2>&1 | head -30
cd /tmp && A=/tmp/akp-venv/bin/akp02d; $A --version; timeout 20 $A ctl themes; echo rc=$?; timeout 20 $A ctl status; echo rc=$?; timeout 30 $A --check; echo rc=$?; ls ~/.config/akp02d/themes 2>&1
sudo apt-get install -y -qq cava playerctl pulseaudio-utils >/tmp/apt2.log 2>&1; echo rc=$?; which cava playerctl pactl; cd /tmp && timeout 30 /tmp/akp-venv/bin/akp02d --check 2>&1 | grep -v "WARNING font" | tail -8; echo rc=${PIPESTATUS[0]}
cd /tmp && export QT_QPA_PLATFORM=offscreen; timeout 25 /tmp/akp-venv/bin/akp02d-edit 2>&1 | tail -15; echo rc=${PIPESTATUS[0]}
sudo apt-get install -y -qq libegl1 libgl1 libopengl0 libxkbcommon0 libfontconfig1 libdbus-1-3 fonts-dejavu-core fonts-liberation >/tmp/apt3.log 2>&1; echo rc=$?; cd /tmp && export QT_QPA_PLATFORM=offscreen; timeout 25 /tmp/akp-venv/bin/akp02d-edit 2>&1 | tail -15; echo rc=${PIPESTATUS[0]}
cd /tmp && timeout 15 /tmp/akp-venv/bin/akp02d 2>&1 | tail -8; echo rc=${PIPESTATUS[0]}; cat ~/.config/akp02d/akp02d.toml | head -30
cd /tmp && export QT_QPA_PLATFORM=offscreen; for i in 1 2; do timeout 15 /tmp/akp-venv/bin/akp02d-edit 2>&1 | tail -3; echo rc=${PIPESTATUS[0]}; done; pgrep -fa akp02d; ls -la <host-path> 2>&1; cat <host-path> | head -60
cd <host-path> && mkdir -p .coldpass && python3 -I - <<'EOF'
import json
probe = {
  "kind": "cli",
  "argv": ["/tmp/akp-venv/bin/akp02d-edit"],
  "cwd": "<host-path>",
  "env": {"QT_QPA_PLATFORM": "offscreen"},
  "stays_running": True,
  "expected_text": "propagateSizeHints",
}
report = {
  "outcome": "working",
  "operation": "Launch the README's theme editor (akp02d-edit) headless via Qt offscreen; it stays running with a live preview and needs no hardware. Confirmed the Qt window loads and the process stays alive until stopped.",
  "operation_scope": "Editor only. Panel operations (akp02d daemon, akp02d ctl status/themes/theme/brightness) need the Ajazz AKP02 USB panel, which is absent: the daemon exits 3 with 'no HID device 0300:3017 found', and ctl reports 'akp02d is not running'. Not exercised: live panel push, ctl commands. The expected_text 'propagateSizeHints' is a Qt plugin message, the only output seen on load; it is weak evidence of a loaded window.",
  "steps": [
    "pip install uv (guest pip, --break-system-packages) and uv python install 3.13 (README requires Python >= 3.13; guest had 3.12.3)",
    "uv venv --python 3.13 /tmp/akp-venv",
    "uv pip install \"<host-path>\" (README: pipx install 'akp02d[editor]', built from the pinned checkout)",
    "akp02d --version -> akp02d 1.1.0",
    "akp02d --check (README Troubleshooting) after installing cava, playerctl, pulseaudio-utils",
    "akp02d-edit with QT_QPA_PLATFORM=offscreen (README Edit themes) -> loads, stays running until timeout"
  ],
  "deviations": [
    "README requires Python >= 3.13 but guest default was 3.12.3: installed uv and Python 3.13.16 via uv instead",
    "README Install says 'install cava, playerctl and pactl from your distro': apt-get install cava playerctl pulseaudio-utils (needed for akp02d --check, which failed with 'cava is not installed or not on PATH')",
    "akp02d-edit failed: libGL.so.1 missing. Installed the CI workflow's system libs via apt (libegl1 libgl1 libopengl0 libxkbcommon0 libfontconfig1 libdbus-1-3 fonts-dejavu-core fonts-liberation)",
    "Used a venv in /tmp instead of pipx; did not run the udev/systemd setup (needs sudo and hardware)",
    "Did not run the test suite or lint (per task instructions)"
  ],
  "stuck_step": None,
  "main_blocker": None,
  "suggested_fix": "For full panel verification, attach an Ajazz AKP02 panel and install the udev rule (akp02d --udev-rule), then run akp02d ctl status."
}
json.dump(probe, open(".coldpass/probe.json","w"), indent=2)
json.dump(report, open(".coldpass/report.json","w"), indent=2)
print("written")
EOF
<env-var>=<host-path> python3 -I <host-path> --validate