Cadre

Un cadre photo numérique du commerce (PF1007L, écran 10 pouces 1280 × 800, Android 6) rooté et transformé en écran mural piloté par Home Assistant : musique en cours avec pochette et paroles, diaporama Immich, horloge, horaires de prière, bus, agenda, météo, lampes du salon, et des pages composées librement.

Tout ce que le cadre affiche se règle depuis Home Assistant, sans toucher au cadre. Pour changer la mise en page, voir le guide de mise en page : il s'adresse à quelqu'un qui n'a jamais ouvert ce dépôt, et il est écrit pour pouvoir être donné tel quel à un assistant IA.

Ce qu'il y a ici

Dossier	Contenu
app/	l'application Android native (xyz.az4aaz.cadre), écran d'accueil du cadre. Java, API 23, sans Gradle : VERSION_CODE=N VERSION_NAME=x.y bash build.sh puis adb install -r build/cadre.apk
editeur/	le panneau « Cadre » de Home Assistant (panel_custom, un seul fichier editeur.js) : mise en page à la souris et onglet Réglages
layouts/	des mises en page complètes ou des pages à fusionner, au format décrit dans le guide
outils/	cadre-layout (lire, envoyer, fusionner, vérifier une mise en page depuis un terminal) et des scripts de vérification du panneau
kiosk/	l'ancien kiosque WebView (dérivé de wesbos/photo-frame-dashboard), gardé pour mémoire
site/	l'ancienne page web affichée par ce kiosque, remplacée par l'application

Comment ça tient ensemble

• Le cadre parle à Home Assistant par son API et son WebSocket, avec un jeton stocké sur le cadre seulement.
• La configuration vit dans Home Assistant : un package YAML crée des entités cadre_* (mode, album, luminosité, lecteurs, prière, cours…). Le panneau et l'onglet Réglages de la tablette les pilotent.
• La mise en page est un document JSON rangé dans les données utilisateur du frontend Home Assistant (clé cadre_layout). Le panneau l'édite ; input_button.cadre_layout prévient le cadre qu'il faut la relire.
• Le panneau est servi en /local/cadre/editeur.js?v=N : à chaque nouvelle version, augmenter N dans configuration.yaml et redémarrer Home Assistant, sinon le navigateur garde l'ancienne.

Les règles pour un agent qui travaille dans ce dépôt sont dans AGENTS.md.