# Réglages complets de config.yaml

## Tous les paramètres expliqués  


---

#### 1. Paramètres requis

- `immich_api_key` : « clé API » du serveur Immich.
- `immich_url` : URL de ton serveur Immich, ex : `"http://192.168.1.10:2283"`.

> **Remarque** : seules ces deux valeurs sont absolument obligatoires pour que le Kiosk fonctionne. <span class="" data-state="closed"><span class="ms-1 inline-flex max-w-full items-center relative top-[-0.094rem] animate-[show_150ms_ease-in]" data-testid="webpage-citation-pill">[<span class="relative start-0 bottom-0 flex h-full w-full items-center"><span class="flex h-4 w-full items-center justify-between overflow-hidden"><span class="max-w-[15ch] grow truncate overflow-hidden text-center">Immich Kiosk</span></span></span>](https://docs.immichkiosk.app/configuration/?utm_source=chatgpt.com)  
> </span></span>

```
nano /root/config/config.yaml
```

---

#### 2. Horloge / Date

<div class="_tableContainer_1rjym_1" id="bkmrk-param%C3%A8tre-valeur-par"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="1122" data-start="757"><thead data-end="804" data-start="757"><tr data-end="804" data-start="757"><th data-col-size="sm" data-end="769" data-start="757">Paramètre</th><th data-col-size="sm" data-end="789" data-start="769">Valeur par défaut</th><th data-col-size="sm" data-end="804" data-start="789">Description</th></tr></thead><tbody data-end="1122" data-start="852"><tr data-end="906" data-start="852"><td data-col-size="sm" data-end="866" data-start="852">`show_time`</td><td data-col-size="sm" data-end="876" data-start="866">`false`</td><td data-col-size="sm" data-end="906" data-start="876">Afficher l’heure à l’écran</td></tr><tr data-end="956" data-start="907"><td data-col-size="sm" data-end="923" data-start="907">`time_format`</td><td data-col-size="sm" data-end="930" data-start="923">`24`</td><td data-col-size="sm" data-end="956" data-start="930">Format 12 ou 24 heures</td></tr><tr data-end="1001" data-start="957"><td data-col-size="sm" data-end="971" data-start="957">`show_date`</td><td data-col-size="sm" data-end="981" data-start="971">`false`</td><td data-col-size="sm" data-end="1001" data-start="981">Afficher la date</td></tr><tr data-end="1054" data-start="1002"><td data-col-size="sm" data-end="1018" data-start="1002">`date_format`</td><td data-col-size="sm" data-end="1033" data-start="1018">`YYYY/MM/DD`</td><td data-col-size="sm" data-end="1054" data-start="1033">Format de la date</td></tr><tr data-end="1122" data-start="1055"><td data-col-size="sm" data-end="1072" data-start="1055">`clock_source`</td><td data-col-size="sm" data-end="1083" data-start="1072">`client`</td><td data-col-size="sm" data-end="1122" data-start="1083">Source de l’heure : client ou autre</td></tr></tbody></table>

</div></div>---

#### 3. Comportement du Kiosk (Kiosk behaviour)

<div class="_tableContainer_1rjym_1" id="bkmrk-param%C3%A8tre-valeur-des"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="1602" data-start="1178"><thead data-end="1214" data-start="1178"><tr data-end="1214" data-start="1178"><th data-col-size="sm" data-end="1190" data-start="1178">Paramètre</th><th data-col-size="sm" data-end="1199" data-start="1190">Valeur</th><th data-col-size="md" data-end="1214" data-start="1199">Description</th></tr></thead><tbody data-end="1602" data-start="1252"><tr data-end="1320" data-start="1252"><td data-col-size="sm" data-end="1265" data-start="1252">`duration`</td><td data-col-size="sm" data-end="1272" data-start="1265">`60`</td><td data-col-size="md" data-end="1320" data-start="1272">Temps d’affichage de chaque image (secondes)</td></tr><tr data-end="1415" data-start="1321"><td data-col-size="sm" data-end="1345" data-start="1321">`disable_screensaver`</td><td data-col-size="sm" data-end="1355" data-start="1345">`false`</td><td data-col-size="md" data-end="1415" data-start="1355">Empêcher l’écran de s’éteindre ou de se mettre en veille</td></tr><tr data-end="1535" data-start="1416"><td data-col-size="sm" data-end="1436" data-start="1416">`optimize_images`</td><td data-col-size="sm" data-end="1446" data-start="1436">`false`</td><td data-col-size="md" data-end="1535" data-start="1446">Redimensionner les images pour correspondre à l’écran pour de meilleures performances</td></tr><tr data-end="1602" data-start="1536"><td data-col-size="sm" data-end="1548" data-start="1536">`use_gpu`</td><td data-col-size="sm" data-end="1557" data-start="1548">`true`</td><td data-col-size="md" data-end="1602" data-start="1557">Utiliser l’accélération GPU si disponible</td></tr></tbody></table>

</div></div>---

#### 4. Sources d’actifs / filtres

<div class="_tableContainer_1rjym_1" id="bkmrk-param%C3%A8tre-descriptio"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="2513" data-start="1645"><thead data-end="1672" data-start="1645"><tr data-end="1672" data-start="1645"><th data-col-size="sm" data-end="1657" data-start="1645">Paramètre</th><th data-col-size="md" data-end="1672" data-start="1657">Description</th></tr></thead><tbody data-end="2513" data-start="1701"><tr data-end="1770" data-start="1701"><td data-col-size="sm" data-end="1719" data-start="1701">`show_archived`</td><td data-col-size="md" data-end="1770" data-start="1719">Autoriser les médias “archivés” à être affichés</td></tr><tr data-end="1821" data-start="1771"><td data-col-size="sm" data-end="1782" data-start="1771">`people`</td><td data-col-size="md" data-end="1821" data-start="1782">Liste d’IDs de personnes à afficher</td></tr><tr data-end="1933" data-start="1822"><td data-col-size="sm" data-end="1845" data-start="1822">`require_all_people`</td><td data-col-size="md" data-end="1933" data-start="1845">Si `true`, n’affiche que les médias qui contiennent **toutes** les personnes listées</td></tr><tr data-end="1990" data-start="1934"><td data-col-size="sm" data-end="1954" data-start="1934">`excluded_people`</td><td data-col-size="md" data-end="1990" data-start="1954">Liste de personnes à **exclure**</td></tr><tr data-end="2037" data-start="1991"><td data-col-size="sm" data-end="2002" data-start="1991">`albums`</td><td data-col-size="md" data-end="2037" data-start="2002">Liste d’IDs d’albums à afficher</td></tr><tr data-end="2108" data-start="2038"><td data-col-size="sm" data-end="2054" data-start="2038">`album_video`</td><td data-col-size="md" data-end="2108" data-start="2054">`false` ou `true` : afficher les vidéos des albums</td></tr><tr data-end="2190" data-start="2109"><td data-col-size="sm" data-end="2125" data-start="2109">`album_order`</td><td data-col-size="md" data-end="2190" data-start="2125">`random`, `newest` ou `oldest` : ordre d’affichage des albums</td></tr><tr data-end="2237" data-start="2191"><td data-col-size="sm" data-end="2211" data-start="2191">`excluded_albums`</td><td data-col-size="md" data-end="2237" data-start="2211">IDs d’albums à exclure</td></tr><tr data-end="2306" data-start="2238"><td data-col-size="sm" data-end="2248" data-start="2238">`dates`</td><td data-col-size="md" data-end="2306" data-start="2248">Plages de dates au format `"YYYY-MM-DD_to_YYYY-MM-DD"`</td></tr><tr data-end="2343" data-start="2307"><td data-col-size="sm" data-end="2316" data-start="2307">`tags`</td><td data-col-size="md" data-end="2343" data-start="2316">Liste de tags à inclure</td></tr><tr data-end="2389" data-start="2344"><td data-col-size="sm" data-end="2362" data-start="2344">`excluded_tags`</td><td data-col-size="md" data-end="2389" data-start="2362">Liste de tags à exclure</td></tr><tr data-end="2444" data-start="2390"><td data-col-size="sm" data-end="2412" data-start="2390">`excluded_partners`</td><td data-col-size="md" data-end="2444" data-start="2412">IDs de partenaires à exclure</td></tr><tr data-end="2513" data-start="2445"><td data-col-size="sm" data-end="2458" data-start="2445">`memories`</td><td data-col-size="md" data-end="2513" data-start="2458">`false` ou `true` : afficher la section “souvenirs”</td></tr></tbody></table>

</div></div>---

#### 5. Interface utilisateur (UI)

<div class="_tableContainer_1rjym_1" id="bkmrk-param%C3%A8tre-valeur-par-1"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="3303" data-start="2556"><thead data-end="2603" data-start="2556"><tr data-end="2603" data-start="2556"><th data-col-size="sm" data-end="2568" data-start="2556">Paramètre</th><th data-col-size="md" data-end="2588" data-start="2568">Valeur par défaut</th><th data-col-size="md" data-end="2603" data-start="2588">Description</th></tr></thead><tbody data-end="3303" data-start="2652"><tr data-end="2725" data-start="2652"><td data-col-size="sm" data-end="2667" data-start="2652">`disable_ui`</td><td data-col-size="md" data-end="2677" data-start="2667">`false`</td><td data-col-size="md" data-end="2725" data-start="2677">Cacher tous les éléments UI (horloge/date/…)</td></tr><tr data-end="2810" data-start="2726"><td data-col-size="sm" data-end="2740" data-start="2726">`frameless`</td><td data-col-size="md" data-end="2750" data-start="2740">`false`</td><td data-col-size="md" data-end="2810" data-start="2750">Enlever les bordures et coins arrondis autour de l’image</td></tr><tr data-end="2895" data-start="2811"><td data-col-size="sm" data-end="2829" data-start="2811">`frame_padding`</td><td data-col-size="md" data-end="2867" data-start="2829">`0` ou `[top, right, bottom, left]`</td><td data-col-size="md" data-end="2895" data-start="2867">Marges autour de l’image</td></tr><tr data-end="2950" data-start="2896"><td data-col-size="sm" data-end="2912" data-start="2896">`hide_cursor`</td><td data-col-size="md" data-end="2922" data-start="2912">`false`</td><td data-col-size="md" data-end="2950" data-start="2922">Cacher le curseur souris</td></tr><tr data-end="3010" data-start="2951"><td data-col-size="sm" data-end="2965" data-start="2951">`font_size`</td><td data-col-size="md" data-end="2973" data-start="2965">`100`</td><td data-col-size="md" data-end="3010" data-start="2973">Taille de police (en pourcentage)</td></tr><tr data-end="3086" data-start="3011"><td data-col-size="sm" data-end="3031" data-start="3011">`background_blur`</td><td data-col-size="md" data-end="3040" data-start="3031">`true`</td><td data-col-size="md" data-end="3086" data-start="3040">Flouter l’arrière-plan de l’image actuelle</td></tr><tr data-end="3142" data-start="3087"><td data-col-size="sm" data-end="3114" data-start="3087">`background_blur_amount`</td><td data-col-size="md" data-end="3121" data-start="3114">`10`</td><td data-col-size="md" data-end="3142" data-start="3121">Intensité du flou</td></tr><tr data-end="3189" data-start="3143"><td data-col-size="sm" data-end="3153" data-start="3143">`theme`</td><td data-col-size="md" data-end="3173" data-start="3153">`fade` ou `solid`</td><td data-col-size="md" data-end="3189" data-start="3173">Thème visuel</td></tr><tr data-end="3303" data-start="3190"><td data-col-size="sm" data-end="3201" data-start="3190">`layout`</td><td data-col-size="md" data-end="3273" data-start="3201">`single`, `splitview`, `splitview-landscape`, `portrait`, `landscape`</td><td data-col-size="md" data-end="3303" data-start="3273">Disposition de l’affichage</td></tr></tbody></table>

</div></div>---

#### 6. Transition &amp; affichage des images

<div class="_tableContainer_1rjym_1" id="bkmrk-param%C3%A8tre-valeur-des-1"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="4021" data-start="3353"><thead data-end="3389" data-start="3353"><tr data-end="3389" data-start="3353"><th data-col-size="sm" data-end="3365" data-start="3353">Paramètre</th><th data-col-size="sm" data-end="3374" data-start="3365">Valeur</th><th data-col-size="md" data-end="3389" data-start="3374">Description</th></tr></thead><tbody data-end="4021" data-start="3427"><tr data-end="3508" data-start="3427"><td data-col-size="sm" data-end="3442" data-start="3427">`transition`</td><td data-col-size="sm" data-end="3473" data-start="3442">`none`, `fade`, `cross-fade`</td><td data-col-size="md" data-end="3508" data-start="3473">Type de transition entre images</td></tr><tr data-end="3569" data-start="3509"><td data-col-size="sm" data-end="3538" data-start="3509">`fade_transition_duration`</td><td data-col-size="sm" data-end="3548" data-start="3538">`1` (s)</td><td data-col-size="md" data-end="3569" data-start="3548">Durée pour `fade`</td></tr><tr data-end="3642" data-start="3570"><td data-col-size="sm" data-end="3605" data-start="3570">`cross_fade_transition_duration`</td><td data-col-size="sm" data-end="3615" data-start="3605">`1` (s)</td><td data-col-size="md" data-end="3642" data-start="3615">Durée pour `cross-fade`</td></tr><tr data-end="3719" data-start="3643"><td data-col-size="sm" data-end="3665" data-start="3643">`show_progress_bar`</td><td data-col-size="sm" data-end="3675" data-start="3665">`false`</td><td data-col-size="md" data-end="3719" data-start="3675">Afficher ou non une barre de progression</td></tr><tr data-end="3798" data-start="3720"><td data-col-size="sm" data-end="3734" data-start="3720">`image_fit`</td><td data-col-size="sm" data-end="3763" data-start="3734">`none`, `contain`, `cover`</td><td data-col-size="md" data-end="3798" data-start="3763">Comment l’image remplit l’écran</td></tr><tr data-end="3882" data-start="3799"><td data-col-size="sm" data-end="3816" data-start="3799">`image_effect`</td><td data-col-size="sm" data-end="3847" data-start="3816">`none`, `zoom`, `smart-zoom`</td><td data-col-size="md" data-end="3882" data-start="3847">Effet visuel appliqué à l’image</td></tr><tr data-end="3939" data-start="3883"><td data-col-size="sm" data-end="3907" data-start="3883">`image_effect_amount`</td><td data-col-size="sm" data-end="3915" data-start="3907">`120`</td><td data-col-size="md" data-end="3939" data-start="3915">Intensité de l’effet</td></tr><tr data-end="4021" data-start="3940"><td data-col-size="sm" data-end="3963" data-start="3940">`use_original_image`</td><td data-col-size="sm" data-end="3973" data-start="3963">`false`</td><td data-col-size="md" data-end="4021" data-start="3973">Utiliser l’image originale sans optimisation</td></tr></tbody></table>

</div></div>---

#### 7. Métadonnées des images

<div class="_tableContainer_1rjym_1" id="bkmrk-param%C3%A8tre-descriptio-1"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="5228" data-start="4060"><thead data-end="4087" data-start="4060"><tr data-end="4087" data-start="4060"><th data-col-size="sm" data-end="4072" data-start="4060">Paramètre</th><th data-col-size="md" data-end="4087" data-start="4072">Description</th></tr></thead><tbody data-end="5228" data-start="4116"><tr data-end="4170" data-start="4116"><td data-col-size="sm" data-end="4131" data-start="4116">`show_owner`</td><td data-col-size="md" data-end="4170" data-start="4131">Afficher le propriétaire de l’image</td></tr><tr data-end="4221" data-start="4171"><td data-col-size="sm" data-end="4191" data-start="4171">`show_album_name`</td><td data-col-size="md" data-end="4221" data-start="4191">Afficher le nom de l’album</td></tr><tr data-end="4288" data-start="4222"><td data-col-size="sm" data-end="4243" data-start="4222">`show_person_name`</td><td data-col-size="md" data-end="4288" data-start="4243">Afficher le nom de la personne identifiée</td></tr><tr data-end="4342" data-start="4289"><td data-col-size="sm" data-end="4309" data-start="4289">`show_person_age`</td><td data-col-size="md" data-end="4342" data-start="4309">Afficher l’âge de la personne</td></tr><tr data-end="4402" data-start="4343"><td data-col-size="sm" data-end="4363" data-start="4343">`show_image_time`</td><td data-col-size="md" data-end="4402" data-start="4363">Afficher l’heure de la prise de vue</td></tr><tr data-end="4448" data-start="4403"><td data-col-size="sm" data-end="4425" data-start="4403">`image_time_format`</td><td data-col-size="md" data-end="4448" data-start="4425">`12` ou `24` heures</td></tr><tr data-end="4498" data-start="4449"><td data-col-size="sm" data-end="4469" data-start="4449">`show_image_date`</td><td data-col-size="md" data-end="4498" data-start="4469">Afficher la date de prise</td></tr><tr data-end="4539" data-start="4499"><td data-col-size="sm" data-end="4521" data-start="4499">`image_date_format`</td><td data-col-size="md" data-end="4539" data-start="4521">Format de date</td></tr><tr data-end="4605" data-start="4540"><td data-col-size="sm" data-end="4567" data-start="4540">`show_image_description`</td><td data-col-size="md" data-end="4605" data-start="4567">Afficher la description de l’image</td></tr><tr data-end="4675" data-start="4606"><td data-col-size="sm" data-end="4626" data-start="4606">`show_image_exif`</td><td data-col-size="md" data-end="4675" data-start="4626">Afficher les données EXIF (focale, ISO, etc.)</td></tr><tr data-end="4729" data-start="4676"><td data-col-size="sm" data-end="4700" data-start="4676">`show_image_location`</td><td data-col-size="md" data-end="4729" data-start="4700">Afficher le lieu de prise</td></tr><tr data-end="4791" data-start="4730"><td data-col-size="sm" data-end="4749" data-start="4730">`hide_countries`</td><td data-col-size="md" data-end="4791" data-start="4749">Liste de pays à exclure de l’affichage</td></tr><tr data-end="4838" data-start="4792"><td data-col-size="sm" data-end="4810" data-start="4792">`show_image_id`</td><td data-col-size="md" data-end="4838" data-start="4810">Afficher l’ID de l’image</td></tr><tr data-end="4908" data-start="4839"><td data-col-size="sm" data-end="4858" data-start="4839">`show_more_info`</td><td data-col-size="md" data-end="4908" data-start="4858">Afficher un overlay “plus d’infos” sur l’image</td></tr><tr data-end="4980" data-start="4909"><td data-col-size="sm" data-end="4939" data-start="4909">`show_more_info_image_link`</td><td data-col-size="md" data-end="4980" data-start="4939">Mettre un lien vers l’image originale</td></tr><tr data-end="5054" data-start="4981"><td data-col-size="sm" data-end="5008" data-start="4981">`show_more_info_qr_code`</td><td data-col-size="md" data-end="5054" data-start="5008">Afficher un QR code vers l’image originale</td></tr><tr data-end="5142" data-start="5055"><td data-col-size="sm" data-end="5078" data-start="5055">`like_button_action`</td><td data-col-size="md" data-end="5142" data-start="5078">Action du bouton “J’aime” : `album`, `favorite`, ou les deux</td></tr><tr data-end="5228" data-start="5143"><td data-col-size="sm" data-end="5166" data-start="5143">`hide_button_action`</td><td data-col-size="md" data-end="5228" data-start="5166">Action du bouton “Masquer” : `tag`, `archive`, ou les deux</td></tr></tbody></table>

</div></div>---

#### 8. Fonction météo (Weather feature)

<div class="_tableContainer_1rjym_1" id="bkmrk-param%C3%A8tre-descriptio-2"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="5564" data-start="5277"><thead data-end="5304" data-start="5277"><tr data-end="5304" data-start="5277"><th data-col-size="sm" data-end="5289" data-start="5277">Paramètre</th><th data-col-size="xl" data-end="5304" data-start="5289">Description</th></tr></thead><tbody data-end="5564" data-start="5333"><tr data-end="5564" data-start="5333"><td data-col-size="sm" data-end="5346" data-start="5333">`weather:`</td><td data-col-size="xl" data-end="5564" data-start="5346">Liste d’objets météo :   
• `name`: nom de la ville   
• `lat`, `lon`: coordonnées   
• `api`: clé API OpenWeatherMap   
• `unit`: `metric` ou `imperial`   
• `lang`: langue   
• `forecast`: `false` ou `true`</td></tr></tbody></table>

</div></div>---

#### 9. Iframes / contenu externe

<div class="_tableContainer_1rjym_1" id="bkmrk-param%C3%A8tre-descriptio-3"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="5787" data-start="5606"><thead data-end="5633" data-start="5606"><tr data-end="5633" data-start="5606"><th data-col-size="sm" data-end="5618" data-start="5606">Paramètre</th><th data-col-size="lg" data-end="5633" data-start="5618">Description</th></tr></thead><tbody data-end="5787" data-start="5662"><tr data-end="5787" data-start="5662"><td data-col-size="sm" data-end="5674" data-start="5662">`iframe:`</td><td data-col-size="lg" data-end="5787" data-start="5674">Liste d’URLs ou de chemins d’accès local à intégrer   
Ex : `- https://example.com/page` ou `- ./local.html`</td></tr></tbody></table>

</div></div>---

#### 10. Multi-utilisateurs / webhooks / mode hors ligne

<div class="_tableContainer_1rjym_1" id="bkmrk-param%C3%A8tre-descriptio-4"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="6523" data-start="5852"><thead data-end="5879" data-start="5852"><tr data-end="5879" data-start="5852"><th data-col-size="sm" data-end="5864" data-start="5852">Paramètre</th><th data-col-size="lg" data-end="5879" data-start="5864">Description</th></tr></thead><tbody data-end="6523" data-start="5908"><tr data-end="5996" data-start="5908"><td data-col-size="sm" data-end="5935" data-start="5908">`immich_users_api_keys:`</td><td data-col-size="lg" data-end="5996" data-start="5935">Map utilisateur → clé API (permet plusieurs utilisateurs)</td></tr><tr data-end="6055" data-start="5997"><td data-col-size="sm" data-end="6011" data-start="5997">`show_user`</td><td data-col-size="lg" data-end="6055" data-start="6011">Afficher le nom de l’utilisateur courant</td></tr><tr data-end="6215" data-start="6056"><td data-col-size="sm" data-end="6074" data-start="6056">`offline_mode:`</td><td data-col-size="lg" data-end="6215" data-start="6074">Objet : `enabled`, `number_of_assets`, `max_size`, `parallel_downloads`, `expiration_hours`   
Permet d’utiliser le Kiosk hors connexion</td></tr><tr data-end="6523" data-start="6216"><td data-col-size="sm" data-end="6227" data-start="6216">`kiosk:`</td><td data-col-size="lg" data-end="6334" data-start="6227">Sous-objet non modifiable via URL :   
• `port` : port d’écoute (ex : 3000)   
• `behind_proxy` : `true</td></tr></tbody></table>

</div></div>---

#### 11. Sleep mode (mode veille)

Le **sleep mode** permet de rendre le cadre photo inactif sur une plage horaire (ex : la nuit). Quand il est actif, l’écran devient noir (et peut afficher une horloge/date très discrète si `show_time` ou `show_date` est activé).

> **Important :** pour activer le mode veille, il faut définir `sleep_start` <u>et</u> `sleep_end`. Le format est en 24h : soit l’heure (`22`, `7`), soit HHmm (`1332`, `1508`). Pour éviter les surprises YAML, tu peux écrire les heures entre guillemets (ex. `"07"`).

<div class="_tableContainer_1rjym_1" id="bkmrk-param%C3%A8tre-valeur-par-2"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)"><thead><tr><th data-col-size="sm">Paramètre</th><th data-col-size="sm">Valeur par défaut</th><th data-col-size="md">Description</th></tr></thead><tbody><tr><td data-col-size="sm">`sleep_start`</td><td data-col-size="sm">`(non défini)`</td><td data-col-size="md">Heure de début du mode veille (24h : `22` ou `1332`).</td></tr><tr><td data-col-size="sm">`sleep_end`</td><td data-col-size="sm">`(non défini)`</td><td data-col-size="md">Heure de fin du mode veille (24h : `7` ou `1508`).</td></tr><tr><td data-col-size="sm">`sleep_icon`</td><td data-col-size="sm">`true`</td><td data-col-size="md">Afficher une icône pendant le mode veille.</td></tr><tr><td data-col-size="sm">`sleep_dim_screen`</td><td data-col-size="sm">`false`</td><td data-col-size="md">Dim l’écran pendant le sleep mode (fonctionne uniquement avec **Fully Kiosk Browser**).</td></tr><tr><td data-col-size="sm">`disable_sleep`</td><td data-col-size="sm">`false`</td><td data-col-size="md">Permet de bypass le sleep mode (pratique pour tester). Peut aussi se faire via l’URL.</td></tr></tbody></table>

</div></div>##### 🧪 Exemple (veille de 22:00 à 07:00)

```yaml
# Sleep mode
sleep_start: "22"
sleep_end: "07"

# Optionnel
sleep_icon: true
sleep_dim_screen: false
disable_sleep: false

```

##### 🧷 Astuce test rapide (bypass via URL)

```
http://{URL_DU_KIOSK}?disable_sleep=true
```

*Note :* `sleep_dim_screen` nécessite Fully Kiosk Browser (version Pro) et l’option “Enable JavaScript Interface”.

#### 📝 Exemple complet minimal  


```yaml
immich_api_key: "TON_API_KEY"
immich_url: "http://192.168.1.10:2283"

# Horloge
show_time: true
time_format: 24
show_date: true
date_format: YYYY/MM/DD

# Kiosk behaviour
duration: 45
disable_screensaver: true
optimize_images: true
use_gpu: true

# Sources d’actifs
albums:
  - "ALBUM_ID_1"
people:
  - "PERSON_ID_1"
tags:
  - "famille"

# UI / image
layout: single
theme: fade
image_fit: cover
hide_cursor: true
frameless: true

# Métadonnées
show_album_name: true
show_person_name: true
show_image_date: true
image_date_format: DD/MM/YYYY

# Kiosk interne
kiosk:
  port: 3000
  cache: true
  prefetch: true

```

<div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary" id="bkmrk--11"><div class="sticky top-9"><div class="absolute end-0 bottom-0 flex h-9 items-center pe-2">  
</div></div><div class="overflow-y-auto p-4" dir="ltr">  
</div></div>---

### ℹ️ Bonnes pratiques

- Garder le fichier `config.yaml` à jour et sauvegardé.
- Pour tester un réglage, relancer le service :
    
    ```
    systemctl restart immich-kiosk
    ```
- Vérifier toujours la page : `curl http://127.0.0.1:3000` pour s’assurer que le backend répond.