infoscreen-dev/TODO.md

Project TODOs

This file tracks higher-level todos and design notes for the infoscreen client.

Video playback (Raspberry Pi)

• Remove taskbar / window decorations in VLC window

  • Goal: show video truly fullscreen without window title bar or OS panel/taskbar overlapping.
  • Ideas / approaches:
    • Use libVLC options from python-vlc: --no-video-deco, --no-video-title-show, --video-on-top, and call player.set_fullscreen(True) after playback starts.
    • Run the Display Manager in a dedicated kiosk X session (no panel/desktop environment) or minimal window manager (openbox/matchbox) to avoid taskbar.
    • Use wmctrl as a fallback to force fullscreen/above: wmctrl -r <title> -b add,fullscreen,above.
    • Add an env var toggle, e.g. VLC_KIOSK=1, to enable these options from runtime.
  • Acceptance criteria:
    • Video occupies the full display area with no visible window controls or panels on top.
    • Behaviour toggleable via env var.

• Add possibility to adjust sound level by HDMI-CEC using Python

  • Goal: allow remote/automatic volume control over HDMI using CEC-capable hardware.
  • Ideas / approaches:
    • Use libcec bindings (e.g. pycec / cec packages) or call cec-client from shell to send volume commands to the TV/AVR.
    • Map event volume (0.0-1.0) to CEC volume commands (some devices support absolute volume or key presses like VOLUME_UP/VOLUME_DOWN).
    • Provide a small adapter module src/hdmi_cec.py that exposes set_volume(level: float) and volume_step(up: bool) used by display_manager.py when starting/stopping videos or on explicit volume events.
  • Acceptance criteria:
    • set_volume() issues appropriate CEC commands and returns success/failure.
    • Document any platform limitations (some TVs don't support absolute volume via CEC).

Next-high-level items

• Add environment-controlled libVLC hw-accel toggle (VLC_HW_ACCEL=1|0) to display_manager.py so software decode can be forced when necessary.
• Add automated tests for video start/stop lifecycle (mock python-vlc) to ensure resources are released on event end.

Notes

• Keep all changes backward-compatible: external vlc binary fallback should still work.
• Document any new env vars in README.md and .github/copilot-instructions.md if added.

---

Generated: 2025-10-25