Ich habe mir überlegt, wie ich die Toniebox, wenn sie schon in Home Assistant hängt, in der Adventszeit mit einer kleinen Überraschung versorgen kann. Herausgekommen ist ein Adventskalender für den Kreativ-Tonie: An jedem der vier Adventssonntage landet automatisch eine neue Folge auf dem Tonie. Die Folgen werden gesammelt, am 1. Advent liegt also Folge 1 drauf und am 2. Advent kommt Folge 2 dazu. So geht es weiter, gelöscht wird nichts. Dafür habe ich mein eigenes Hörspiel „Klilli und die vier Adventslichter“ gebaut, aber du kannst jede beliebige Audiodatei verwenden. Der Kalender läuft als ein einziges Package in Home Assistant und nutzt die Integration HA-Toniebox. Das ist eine Community-Integration, die über den Marketplace (früher HACS) kommt und mit der Tonie Cloud spricht.
Eigene Geschichte statt gekaufter Folgen
Ein Preisargument ist das übrigens nicht. tonies verkauft selbst digitale Adventskalender-Inhalte für den Kreativ-Tonie (5,99 Euro je Titel). Der Unterschied hier ist die eigene Geschichte und die Automatik. Die Folgen kommen von allein, verpasste Sonntage werden nachgeholt und eine Folge landet nie doppelt auf dem Tonie.
Jeden Adventssonntag um 6 Uhr kommt die nächste Folge auf den Tonie, ohne dass du dafür wach sein musst. Setzt dein Kind den Kreativ-Tonie danach neu auf die Box, ist die neue Folge da. Dazu kommt ein Adventsmoment: Stellst du den Tonie am Adventssonntag auf die Box, gehen die Lichter im Haus warm an.
Die Geschichte in vier Teilen
Das Hörspiel dauert zusammen etwa 12 Minuten. Ich habe es mit KI erzeugen lassen und in vier Teile geschnitten, weil es vier Adventssonntage gibt. Die erste Folge ist knapp 5 Minuten lang.
| Folge | Titel auf dem Tonie | Worum es geht |
|---|---|---|
| 1 | 1. Advent · Das erste Licht | Der kleine grüne Drache Klilli trifft in der Dorfbäckerei das Mädchen Juna und ihre Oma, lernt, was Advent bedeutet. Dann zündet er die erste Kerze an |
| 2 | 2. Advent · Ein Drachenstern | Warten, Plätzchen backen, ein Stern, der aussieht wie eine Kartoffel mit Ohren. Dazu ein Besuch bei Herrn Winter mit verstauchtem Fuß |
| 3 | 3. Advent · Schnee bis zum Briefkasten | Klilli schaufelt Herrn Winters Weg frei, kommt zu spät an. Sie haben auf ihn gewartet |
| 4 | 4. Advent · Das Licht weitergeben | Klilli hat Schnupfen und kein Feuer. Er gibt das Licht mit einer langen dünnen Kerze weiter |
Dieser Artikel baut auf meinem Beitrag Toniebox in Home Assistant auf. Die Installation der Integration fasse ich hier deshalb nur kurz zusammen.
Was du brauchst
Die Liste ist eigentlich ziemlich überschaubar.
- Home Assistant mit Marketplace und der Integration HA-Toniebox (ich nutze Version 4.1.0)
- Ein Tonies-Konto (die Integration meldet sich mit E-Mail-Adresse und Passwort an der Tonie Cloud an)
- Einen Kreativ-Tonie, er fasst 90 Minuten Audio
- Irgendeine Toniebox. Der Kalender ändert nur den Inhalt des Kreativ-Tonies in der Cloud, deshalb geht er mit jeder Toniebox. Der Sprung zur neuen Folge im Adventsmoment klappt nur mit der Toniebox 2, die Lichter gehen mit jeder Box
- Vier Audiodateien, bei mir MP3. Ich nenne sie
klilli-1.mp3bisklilli-4.mp3 - Die Möglichkeit, in der
configuration.yamlPackages einzubinden (Schritt 3) - Für den Adventsmoment: Lampen oder Schalter in Home Assistant, die du später mit einem Label versiehst (Schritt 4)
- Die Beispiele nutzen meine Namen: Kreativ-Tonie
media_player.kreativ_tonie_rubie, Tonieboxmedia_player.toniebox
Schritt 1: Integration installieren
Die Integration kommt über ein benutzerdefiniertes Repository. Dafür braucht der Marketplace eine Verbindung zu GitHub.
- In Einstellungen → Marketplace das Repository
https://github.com/git4sim/HA-Tonieboxhinzufügen, Toniebox suchen und auf Installieren klicken. Bis Home Assistant 2026.10: In HACS über das Drei-Punkte-Menü Benutzerdefinierte Repositories das Repository als Integration eintragen und herunterladen. - Home Assistant neu starten.
- Einstellungen → Geräte & Dienste → Integration hinzufügen, nach Toniebox suchen und mit dem Tonies-Konto anmelden.
Oder direkt: Toniebox-Integration einrichten. Die ausführliche Einrichtung habe ich in meinem Beitrag zur Toniebox beschrieben.
Danach gibt es für deinen Kreativ-Tonie einen Mediaplayer (bei mir media_player.kreativ_tonie_rubie). Er trägt das Attribut chapters, eine Liste mit id und title je Kapitel, dazu kommt duration_seconds. Genau diese Liste liest der Kalender. Dazu gibt es den Sensor Freie Zeit (in Minuten) und den Knopf Aktualisieren, der die Daten sofort aus der Cloud holt.
Für die Toniebox selbst legt die Integration unter anderem den Sensor Aktuelle Figur ID an. Er zeigt, welcher Tonie gerade auf der Box steht. Den braucht der Adventsmoment.
Deine echten Entitäts-IDs findest du unter Einstellungen → Geräte & Dienste → Toniebox beim Gerät deines Kreativ-Tonies und deiner Box.
Schritt 2: Audiodateien in die Medien legen
- In Medien den Ordner My media öffnen und dort einen Ordner
tonie-adventskalenderanlegen. - Die vier Dateien dort hineinladen:
klilli-1.mp3,klilli-2.mp3,klilli-3.mp3,klilli-4.mp3.
Im Dateisystem von Home Assistant liegen sie danach unter /media/tonie-adventskalender/. Die Aktion toniebox.upload_audio liest nur aus erlaubten Ordnern, /media ist unter Home Assistant OS standardmäßig freigegeben.
Schritt 3: Package anlegen und anpassen
Packages müssen in der configuration.yaml eingebunden sein. Gibt es dort schon homeassistant:, ergänzt du nur die Zeile packages::
homeassistant:
packages: !include_dir_named packagesDen Block unten speicherst du als /config/packages/tonie_adventskalender.yaml. Angepasst wird an zwei Stellen, sonst nirgends.
Die erste Stelle ist der Block plan ganz oben unter variables: &plan. Dort steht alles, was zu dir gehört. Die anderen Abschnitte des Packages lesen ihn mit.
Eintrag in plan | Bedeutung |
|---|---|
tonie | dein Kreativ-Tonie |
refresh_button | dessen Knopf Aktualisieren |
box | deine Toniebox (der Sprung zur Folge geht nur mit der Toniebox 2) |
upload_time | Uhrzeit am Adventssonntag, ab der hochgeladen wird (bei mir "06:00") |
light_label | Label der Lampen und Schalter für den Adventsmoment (bei mir advent) |
notify_action | z. B. notify.mobile_app_dein_handy für eine Nachricht aufs Handy. Leer lassen: nur Meldung in Home Assistant |
episodes | deine vier Folgen mit n und title, dazu file |
Die zweite Stelle sind die zwei Zeilen mit # ADAPT. Das ist zum einen die Entität media_player.kreativ_tonie_rubie im ersten Trigger (dein Kreativ-Tonie). Zum anderen ist es sensor.toniebox_aktuelle_figur_id im Trigger der Automation „Toniebox: Adventsmoment“ (der Sensor Aktuelle Figur ID deiner Box). Ein Trigger kann den plan nicht lesen, deshalb stehen diese beiden IDs noch einmal wörtlich da.
Jeder Titel unter episodes muss mit <n>. Advent beginnen, denn daran erkennt der Kalender, welche Folge schon auf dem Tonie liegt. Der Rest des Titels ist frei.
Danach Einstellungen → Werkzeuge → YAML → Konfiguration prüfen und neu starten.
1# =====================================================================
2# Tonie advent calendar: one episode per Advent Sunday onto a Creative Tonie.
3# File: /config/packages/tonie_adventskalender.yaml
4# Needs: HA-Toniebox (git4sim/HA-Toniebox, HACS / Marketplace) and in
5# configuration.yaml: homeassistant: packages: !include_dir_named packages
6#
7# Episodes are collected: on the 1st Advent episode 1 is added, on the
8# 2nd Advent episode 2 joins it, and so on. Nothing is deleted.
9# The four Advent Sundays are computed every year (4th Advent = the last
10# Sunday on or before 24 December), so the package contains no dates.
11#
12# Due time, not clock time: the upload automation runs at HA start and
13# every 15 minutes. An episode is uploaded once its Sunday and upload time
14# have passed and its chapter is not on the Tonie yet. A Sunday missed
15# while HA, the Tonie Cloud or the network was down is made up at the
16# next run, one episode per run, in order.
17# An episode counts as present when a chapter title starts with
18# "<n>. Advent", so a manual upload in the Tonies app is recognised too.
19# The chapter list is refreshed from the cloud before every upload, so a
20# stale state never leads to a second copy. toniebox.upload_audio only
21# logs a failure (except for a missing file), so success is judged by the
22# chapter list afterwards.
23#
24# Advent moment (optional, switch input_boolean on): when the Creative
25# Tonie is placed on the box on an Advent Sunday, lights and switches with
26# the label "advent" glow warm and a Toniebox 2 jumps straight to the new
27# episode. Classic boxes ignore the jump, the lights still work.
28#
29# Everything you adapt is in the block "plan" below, plus two entity IDs
30# that triggers need literally (marked ADAPT).
31# Files go to Medien > My media (folder tonie-adventskalender).
32#
33# Test or film without waiting for Sunday: press
34# input_button.tonie_adventskalender_naechste_folge, it uploads the next
35# missing episode at once and arms the Advent moment for 30 minutes.
36# script.tonie_adventskalender_zuruecksetzen removes all Advent chapters
37# again (other chapters stay).
38# =====================================================================
39
40template:
41 - triggers:
42 - trigger: homeassistant
43 event: start
44 - trigger: event
45 event_type: event_template_reloaded
46 - trigger: time_pattern
47 minutes: "/1"
48 - trigger: state
49 entity_id: media_player.kreativ_tonie_rubie # ADAPT: your Creative Tonie
50 attribute: chapters
51 variables: &plan
52 # ── adapt here ──────────────────────────────────────────────────
53 tonie: media_player.kreativ_tonie_rubie # your Creative Tonie
54 refresh_button: button.kreativ_tonie_rubie_aktualisieren # its "Aktualisieren" button
55 box: media_player.toniebox # your Toniebox (jump to chapter: Toniebox 2 only)
56 upload_time: "06:00" # upload on Advent Sunday at this time
57 light_label: advent # lights and switches with this label glow at the Advent moment
58 notify_action: "" # e.g. notify.mobile_app_dein_handy, empty = HA notification only
59 episodes:
60 - { n: 1, title: "1. Advent · Das erste Licht", file: "/media/tonie-adventskalender/klilli-1.mp3" }
61 - { n: 2, title: "2. Advent · Ein Drachenstern", file: "/media/tonie-adventskalender/klilli-2.mp3" }
62 - { n: 3, title: "3. Advent · Schnee bis zum Briefkasten", file: "/media/tonie-adventskalender/klilli-3.mp3" }
63 - { n: 4, title: "4. Advent · Das Licht weitergeben", file: "/media/tonie-adventskalender/klilli-4.mp3" }
64 # ── computed, nothing to change below ───────────────────────────
65 # Advent Sundays as ISO dates; 4th Advent = Sunday on or before 24 December
66 advent_days: >-
67 {%- set d24 = strptime(now().year ~ '-12-24', '%Y-%m-%d').date() -%}
68 {%- set a4 = d24 - timedelta(days=d24.isoweekday() % 7) -%}
69 {{ [(a4 - timedelta(days=21)).isoformat(), (a4 - timedelta(days=14)).isoformat(),
70 (a4 - timedelta(days=7)).isoformat(), a4.isoformat()] }}
71 titles: "{{ (state_attr(tonie, 'chapters') or []) | map(attribute='title') | list }}"
72 # numbers of the episodes already on the Tonie
73 present: >-
74 {%- set ns = namespace(p=[]) -%}
75 {%- for e in episodes -%}
76 {%- if titles | select('match', e.n ~ '[.] Advent') | list | count > 0 -%}
77 {%- set ns.p = ns.p + [e.n] -%}
78 {%- endif -%}
79 {%- endfor -%}
80 {{ ns.p }}
81 # 1 to 4 on an Advent Sunday, otherwise 0
82 today_n: "{{ advent_days.index(now().date().isoformat()) + 1 if now().date().isoformat() in advent_days else 0 }}"
83 sensor:
84 - name: "Tonie-Adventskalender"
85 unique_id: tonie_adventskalender_lichter
86 icon: mdi:candle
87 unit_of_measurement: "von 4"
88 availability: "{{ has_value(tonie) }}"
89 state: "{{ present | count }}"
90 attributes:
91 adventssonntage: "{{ advent_days }}"
92 heute_advent: "{{ today_n }}"
93 folgen: "{{ episodes | selectattr('n', 'in', present) | map(attribute='title') | list }}"
94 naechste_folge: "{{ (episodes | rejectattr('n', 'in', present) | map(attribute='title') | list + [''])[0] }}"
95 - name: "Tonie-Adventskalender nächste Folge"
96 unique_id: tonie_adventskalender_naechste_folge
97 icon: mdi:gift-outline
98 device_class: timestamp
99 availability: "{{ has_value(tonie) }}"
100 state: >-
101 {%- set missing = episodes | rejectattr('n', 'in', present) | list -%}
102 {%- if missing -%}
103 {%- set day = strptime(advent_days[missing[0].n - 1], '%Y-%m-%d').date() -%}
104 {{ (today_at(upload_time) + timedelta(days=(day - now().date()).days)).isoformat() }}
105 {%- else -%}
106 {{ none }}
107 {%- endif -%}
108 attributes:
109 titel: "{{ (episodes | rejectattr('n', 'in', present) | map(attribute='title') | list + [''])[0] }}"
110 binary_sensor:
111 - name: "Tonie-Adventskalender 1. Licht"
112 unique_id: tonie_adventskalender_licht_1
113 icon: mdi:candle
114 availability: "{{ has_value(tonie) }}"
115 state: "{{ 1 in present }}"
116 attributes:
117 datum: "{{ strptime(advent_days[0], '%Y-%m-%d').strftime('%d.%m.') }}"
118 titel: "{{ episodes[0].title }}"
119 - name: "Tonie-Adventskalender 2. Licht"
120 unique_id: tonie_adventskalender_licht_2
121 icon: mdi:candle
122 availability: "{{ has_value(tonie) }}"
123 state: "{{ 2 in present }}"
124 attributes:
125 datum: "{{ strptime(advent_days[1], '%Y-%m-%d').strftime('%d.%m.') }}"
126 titel: "{{ episodes[1].title }}"
127 - name: "Tonie-Adventskalender 3. Licht"
128 unique_id: tonie_adventskalender_licht_3
129 icon: mdi:candle
130 availability: "{{ has_value(tonie) }}"
131 state: "{{ 3 in present }}"
132 attributes:
133 datum: "{{ strptime(advent_days[2], '%Y-%m-%d').strftime('%d.%m.') }}"
134 titel: "{{ episodes[2].title }}"
135 - name: "Tonie-Adventskalender 4. Licht"
136 unique_id: tonie_adventskalender_licht_4
137 icon: mdi:candle
138 availability: "{{ has_value(tonie) }}"
139 state: "{{ 4 in present }}"
140 attributes:
141 datum: "{{ strptime(advent_days[3], '%Y-%m-%d').strftime('%d.%m.') }}"
142 titel: "{{ episodes[3].title }}"
143
144input_button:
145 tonie_adventskalender_naechste_folge:
146 name: "Tonie-Adventskalender: nächste Folge jetzt"
147 icon: mdi:gift-open-outline
148
149input_boolean:
150 tonie_adventskalender_adventsmoment:
151 name: "Tonie-Adventskalender: Adventsmoment"
152 icon: mdi:candelabra-fire
153
154input_text:
155 tonie_adventskalender_meldungen:
156 name: "Tonie-Adventskalender: gesendete Meldungen"
157 max: 255
158 icon: mdi:message-badge-outline
159
160automation:
161 - id: tonie_adventskalender_upload
162 alias: "Toniebox: Adventskalender hochladen"
163 description: >-
164 Lädt an jedem Adventssonntag die passende Folge auf den Kreativ-Tonie. Läuft beim Start und alle
165 15 Minuten, holt verpasste Sonntage nach und prüft danach, ob das Kapitel wirklich auf dem Tonie
166 liegt. Der Knopf „nächste Folge jetzt“ lädt sofort die nächste fehlende Folge, zum Testen.
167 mode: single
168 max_exceeded: silent
169 triggers:
170 - trigger: homeassistant
171 event: start
172 - trigger: time_pattern
173 minutes: "/15"
174 - trigger: state
175 entity_id: input_button.tonie_adventskalender_naechste_folge
176 # not "unknown": a button that was never pressed is unknown, its first press must count
177 not_from: unavailable
178 id: demo
179 variables:
180 <<: *plan
181 demo: "{{ trigger.id == 'demo' }}"
182 # index of the first due episode that is not on the Tonie yet, -1 if none
183 next_i: >-
184 {%- set ns = namespace(i=-1) -%}
185 {%- for e in episodes -%}
186 {%- set day = strptime(advent_days[e.n - 1], '%Y-%m-%d').date() -%}
187 {%- set due = now().date() > day or (now().date() == day and now().strftime('%H:%M') >= upload_time) -%}
188 {%- if ns.i < 0 and (due or demo) and e.n not in present -%}
189 {%- set ns.i = loop.index0 -%}
190 {%- endif -%}
191 {%- endfor -%}
192 {{ ns.i }}
193 conditions:
194 - condition: template
195 value_template: "{{ has_value(tonie) and next_i | int(-1) >= 0 }}"
196 actions:
197 - variables:
198 ep: "{{ episodes[next_i | int] }}"
199 # Fresh chapter list from the cloud before deciding to upload.
200 - action: button.press
201 continue_on_error: true
202 target:
203 entity_id: "{{ refresh_button }}"
204 - delay: "00:00:20"
205 - condition: template
206 value_template: >-
207 {{ (state_attr(tonie, 'chapters') or []) | map(attribute='title')
208 | select('match', ep.n ~ '[.] Advent') | list | count == 0 }}
209 - action: toniebox.upload_audio
210 continue_on_error: true
211 data:
212 entity_id: "{{ tonie }}"
213 file_path: "{{ ep.file }}"
214 title: "{{ ep.title }}"
215 - delay: "00:00:30"
216 - action: button.press
217 continue_on_error: true
218 target:
219 entity_id: "{{ refresh_button }}"
220 - delay: "00:00:20"
221 - variables:
222 ok: >-
223 {{ (state_attr(tonie, 'chapters') or []) | map(attribute='title')
224 | select('match', ep.n ~ '[.] Advent') | list | count > 0 }}
225 sent_now: "{{ states('input_text.tonie_adventskalender_meldungen').split(',') if has_value('input_text.tonie_adventskalender_meldungen') else [] }}"
226 - if:
227 - condition: template
228 value_template: "{{ ok }}"
229 then:
230 - action: notify.persistent_notification
231 data:
232 title: "Tonie-Adventskalender"
233 message: "{{ ep.title }} liegt jetzt auf dem Kreativ-Tonie."
234 - if:
235 - condition: template
236 value_template: "{{ notify_action != '' }}"
237 then:
238 - action: "{{ notify_action }}"
239 continue_on_error: true
240 data:
241 title: "Tonie-Adventskalender"
242 message: "{{ ep.title }} liegt bereit. Einfach den Tonie auf die Box stellen."
243 else:
244 # One notice per episode, HA retries every 15 minutes anyway.
245 - if:
246 - condition: template
247 value_template: "{{ ('fehler' ~ ep.n) not in sent_now }}"
248 then:
249 - action: notify.persistent_notification
250 data:
251 title: "Tonie-Adventskalender"
252 message: >-
253 {{ ep.title }} ließ sich nicht hochladen. Frei auf dem Tonie:
254 {{ states('sensor.kreativ_tonie_rubie_freie_zeit') }} Minuten. Datei: {{ ep.file }}.
255 HA versucht es alle 15 Minuten wieder.
256 - action: input_text.set_value
257 target:
258 entity_id: input_text.tonie_adventskalender_meldungen
259 data:
260 value: "{{ (sent_now + ['fehler' ~ ep.n]) | join(',') }}"
261
262 - id: tonie_adventskalender_adventsmoment
263 alias: "Toniebox: Adventsmoment"
264 description: >-
265 Kommt der Kreativ-Tonie an einem Adventssonntag auf die Box und liegt die Folge des Tages schon
266 darauf, gehen alle Lichter und Schalter mit dem Label „advent“ warm an und eine Toniebox 2 springt
267 direkt zur neuen Folge. Einmal pro Tag. Nach „nächste Folge jetzt“ gilt das 30 Minuten lang für die
268 neueste Folge, zum Testen und Filmen.
269 mode: single
270 max_exceeded: silent
271 triggers:
272 - trigger: state
273 entity_id: sensor.toniebox_aktuelle_figur_id # ADAPT: "Aktuelle Figur ID" of your box
274 variables:
275 <<: *plan
276 demo_armed: >-
277 {%- set pressed = as_datetime(states('input_button.tonie_adventskalender_naechste_folge'), none) -%}
278 {{ pressed is not none and (now() - pressed).total_seconds() < 1800 }}
279 moment_n: "{{ today_n if today_n > 0 else (present | max if demo_armed and present else 0) }}"
280 moment_title: "{{ (episodes | selectattr('n', 'eq', moment_n) | map(attribute='title') | list + [''])[0] }}"
281 conditions:
282 - condition: state
283 entity_id: input_boolean.tonie_adventskalender_adventsmoment
284 state: "on"
285 - condition: template
286 value_template: "{{ trigger.to_state.state == state_attr(tonie, 'tonie_id') }}"
287 - condition: template
288 value_template: "{{ moment_n > 0 and moment_n in present }}"
289 - condition: template
290 value_template: >-
291 {{ demo_armed or this.attributes.last_triggered is none
292 or (this.attributes.last_triggered | as_local).date() != now().date() }}
293 actions:
294 - action: light.turn_on
295 continue_on_error: true
296 target:
297 label_id: "{{ light_label }}"
298 data:
299 color_temp_kelvin: 2200
300 brightness_pct: 40
301 transition: 5
302 - action: switch.turn_on
303 continue_on_error: true
304 target:
305 label_id: "{{ light_label }}"
306 # Toniebox 2: wait until the box knows the new chapter, then jump to it (0-based index).
307 - wait_template: >-
308 {{ moment_title in ((state_attr(box, 'playback_info') or {}).get('chapters') or [])
309 | map(attribute='title') | list }}
310 timeout: "00:01:30"
311 continue_on_timeout: false
312 - action: media_player.play_media
313 continue_on_error: true
314 target:
315 entity_id: "{{ box }}"
316 data:
317 media_content_type: music
318 media_content_id: >-
319 {%- set ns = namespace(i=-1) -%}
320 {%- for c in (state_attr(box, 'playback_info') or {}).get('chapters') or [] -%}
321 {%- if ns.i < 0 and c.title == moment_title -%}{%- set ns.i = loop.index0 -%}{%- endif -%}
322 {%- endfor -%}
323 chapter:{{ ns.i }}
324
325script:
326 tonie_adventskalender_zuruecksetzen:
327 alias: "Tonie-Adventskalender: Folgen entfernen"
328 icon: mdi:backup-restore
329 description: Entfernt alle Advent-Kapitel vom Kreativ-Tonie. Andere Kapitel bleiben.
330 mode: single
331 sequence:
332 - variables: *plan
333 - action: button.press
334 continue_on_error: true
335 target:
336 entity_id: "{{ refresh_button }}"
337 - delay: "00:00:20"
338 - repeat:
339 for_each: >-
340 {{ (state_attr(tonie, 'chapters') or []) | selectattr('title', 'match', '[1-4][.] Advent')
341 | map(attribute='id') | list }}
342 sequence:
343 - action: toniebox.remove_chapter
344 continue_on_error: true
345 data:
346 entity_id: "{{ tonie }}"
347 chapter_id: "{{ repeat.item }}"
348 - action: input_text.set_value
349 target:
350 entity_id: input_text.tonie_adventskalender_meldungen
351 data:
352 value: ""Schritt 4: Adventsmoment einrichten
Der Adventsmoment ist ein Extra und standardmäßig aus.
- Gib allen Lampen und Schaltern, die leuchten sollen, das Label
advent. Heißt dein Label anders, trägst du es unterlight_labelimplanein. - Schalte den Helfer
input_boolean.tonie_adventskalender_adventsmoment(„Tonie-Adventskalender: Adventsmoment“) ein.
Stellst du an einem Adventssonntag den Kreativ-Tonie auf die Box und liegt die Folge des Tages schon darauf, gehen alle Lichter und Schalter mit dem Label advent warm an (2200 Kelvin, 40 Prozent Helligkeit). Auf einer Toniebox 2 springt die Box außerdem direkt zur neuen Folge. Die klassische Toniebox ignoriert den Sprung, die Lichter funktionieren trotzdem. Der Adventsmoment löst pro Tag einmal aus.
Der Sprung läuft über media_player.play_media mit chapter:<index>, der Index zählt ab 0. Die Automation wartet bis zu anderthalb Minuten, bis die Box das neue Kapitel kennt.
Ich habe Upload, Sensoren, Demo-Knopf und Zurücksetzen auf meiner Installation von Anfang bis Ende getestet. Der Adventsmoment (Auslöser, Kapitelsprung auf der Toniebox 2, Licht über das Label) ist noch nicht an echter Hardware erprobt. Schau also beim ersten Mal selbst zu.
Wie es funktioniert
Die Adventssonntage rechnet das Package selbst aus. Der 4. Advent ist der letzte Sonntag am oder vor dem 24. Dezember, davon geht es in Wochenschritten zurück. 2026 sind das der 29. November, der 6., 13. und 20. Dezember. Du musst nie ein Datum eintragen, das Package funktioniert jedes Jahr.
Statt auf eine feste Uhrzeit zu setzen, arbeitet die Automation „Toniebox: Adventskalender hochladen“ mit Fälligkeit. Sie läuft beim Start von Home Assistant und alle 15 Minuten. Eine Folge ist fällig, sobald ihr Sonntag und die Upload-Zeit (upload_time) erreicht sind und ihr Kapitel noch nicht auf dem Tonie liegt. Fällt Home Assistant, die Tonie Cloud oder das Netz am Sonntagmorgen aus, passiert nichts Schlimmes: Beim nächsten Lauf wird die Folge nachgeholt. Pro Lauf kommt höchstens eine Folge, immer in der richtigen Reihenfolge.
Doppelt landet keine Folge auf dem Tonie, denn der Schutz läuft über die Kapiteltitel. Eine Folge gilt als vorhanden, wenn ein Kapitel mit <n>. Advent beginnt. Das erkennt auch eine Folge, die du per Hand in der Tonies-App hochgeladen hast. Vor jedem Upload drückt die Automation den Knopf Aktualisieren, wartet 20 Sekunden und prüft die frische Kapitelliste noch einmal. Ein veralteter Zustand führt so nie zu einer zweiten Kopie.
Ob der Upload geklappt hat, prüft die Automation selbst. toniebox.upload_audio meldet Fehler nur im Protokoll und wirft keine Ausnahme (nur eine fehlende Datei löst einen Fehler aus). Deshalb wartet die Automation nach dem Upload 30 Sekunden, drückt wieder Aktualisieren, wartet 20 Sekunden und sieht dann nach, ob das Kapitel in der Liste steht.
Klappt es, erscheint die Meldung „1. Advent · Das erste Licht liegt jetzt auf dem Kreativ-Tonie.“ als persistente Benachrichtigung. Hast du notify_action eingetragen, bekommst du zusätzlich eine Nachricht aufs Handy. Klappt es nicht, kommt genau eine Fehlermeldung je Folge, mit freier Zeit auf dem Tonie und dem Dateipfad. Dass sie nur einmal kommt, merkt sich der Helfer input_text.tonie_adventskalender_meldungen. Die Automation versucht es trotzdem alle 15 Minuten weiter.
Zwei Absicherungen gibt es auch noch. Läuft die Automation schon (ein Durchlauf dauert gut eine Minute wegen der Wartezeiten), wird ein zweiter Start still verworfen (mode: single, max_exceeded: silent). Dazu startet sie nur, wenn der Kreativ-Tonie einen gültigen Zustand hat.
Für Dashboards und Automationen legt das Package ein paar Sensoren an. sensor.tonie_adventskalender zählt die Folgen auf dem Tonie (Einheit „von 4“) und trägt als Attribute adventssonntage und heute_advent, dazu folgen und naechste_folge. sensor.tonie_adventskalender_nachste_folge zeigt als Zeitstempel, wann die nächste Folge hochgeladen wird. Dazu gibt es binary_sensor.tonie_adventskalender_1_licht bis binary_sensor.tonie_adventskalender_4_licht, die an sind, sobald die Folge auf dem Tonie liegt.
Mit dem Demo-Knopf testen
Zum Testen oder Filmen musst du nicht bis Sonntag warten. Das Package legt den Helfer input_button.tonie_adventskalender_naechste_folge an (Name: „Tonie-Adventskalender: nächste Folge jetzt“). Ein Druck lädt sofort die nächste fehlende Folge hoch, egal welches Datum ist. Jeder weitere Druck bringt die nächste.
Dazu schaltet der Druck den Adventsmoment für 30 Minuten scharf. Stellst du in dieser Zeit den Tonie auf die Box, gehen die Lichter an, auch wenn kein Sonntag ist (der Helfer input_boolean.tonie_adventskalender_adventsmoment muss dafür an sein).
Zurücksetzen
Zum Zurücksetzen gibt es das Skript script.tonie_adventskalender_zuruecksetzen (Name: „Tonie-Adventskalender: Folgen entfernen“). Es drückt Aktualisieren und entfernt per toniebox.remove_chapter alle Kapitel, die mit 1. Advent bis 4. Advent beginnen. Danach leert es die gemerkten Fehlermeldungen. Andere Kapitel auf dem Tonie bleiben stehen.
Teste am besten vor dem 1. Advent. Nach dem ersten Adventssonntag holt die Automation entfernte Folgen beim nächsten Lauf sofort wieder nach, denn dann sind sie ja fällig.
Neue Inhalte lädt die Toniebox, wenn der Kreativ-Tonie auf der eingeschalteten, mit dem WLAN verbundenen Box steht. Bei der ersten Toniebox hältst du laut tonies nach einem Cloud-Update 3 Sekunden ein Ohr gedrückt, damit sie das Update lädt.
Optional: Dashboard mit Standardkarten
Bei mir läuft ein eigenes Toniebox-Dashboard. Oben stehen Status, Sleeptimer (15, 30, 45 oder 60 Minuten), Play und Pause, Akkustand und die maximale Lautstärke für Lautsprecher und Kopfhörer. Darunter gibt es eine Detailansicht des aufgelegten Kreativ-Tonies mit Kapiteln, freier Zeit und Hörstatistik. Dazu kommen die Einstellungen der Box wie Kippen zum Spulen, Helligkeit des Leuchtrings und Altersmodus. Für den Kalender habe ich eine eigene Übersicht mit Kerzen gebaut. Das ist mein eigenes Design mit eigenen Karten und steht nicht zum Download.
Eine einfache Übersicht baust du dir mit Standardkarten. Im Dashboard Karte hinzufügen, Manuell, dann:
1type: entities
2title: Tonie-Adventskalender
3entities:
4 - entity: sensor.tonie_adventskalender
5 - entity: sensor.tonie_adventskalender_nachste_folge
6 - entity: binary_sensor.tonie_adventskalender_1_licht
7 - entity: binary_sensor.tonie_adventskalender_2_licht
8 - entity: binary_sensor.tonie_adventskalender_3_licht
9 - entity: binary_sensor.tonie_adventskalender_4_licht
10 - entity: input_boolean.tonie_adventskalender_adventsmoment
11 - entity: input_button.tonie_adventskalender_naechste_folge
12 - entity: script.tonie_adventskalender_zuruecksetzenGrenzen
- Der Upload passiert ab der Upload-Zeit am Adventssonntag, bei einem Ausfall später. Wie lange die Tonie Cloud danach zum Verarbeiten braucht, kann ich dir nicht als Zahl nennen.
- Richtest du das Package erst am 2. oder 3. Advent ein, holt es alle bis dahin fälligen Folgen nach, eine pro Lauf. Das dauert dann je 15 Minuten.
- Fehlt eine Datei, löst
toniebox.upload_audioeinen Fehler aus. Andere Fehler stehen nur im Protokoll, den Hinweis dazu bekommst du über die Fehlermeldung des Kalenders. - Das Package bedient nur einen Kreativ-Tonie.
- Der Kapitelsprung geht nur mit der Toniebox 2. Die klassische Toniebox spielt nach dem Auflegen, was sie spielt. Die Lichter gehen trotzdem an.
- Die Integration ist eine inoffizielle Community-Schnittstelle zur Tonie Cloud. Ändert tonies die Cloud, kann der Upload ausfallen. Dafür gibt es die Fehlermeldung.
Der Advent ist übrigens nur der Aufhänger. Die Aktion toniebox.upload_audio ist nicht an den Advent gebunden, du kannst damit also auch sonst regelmäßig Inhalte auf einem Kreativ-Tonie austauschen.
Nach Weihnachten
Die Folgen bleiben auf dem Tonie liegen, bis du sie entfernst. Nichts wird automatisch gelöscht. Das hat eine Folge für das nächste Jahr: Die Kapitel „1. Advent …“ bis „4. Advent …“ vom letzten Jahr gelten dann als vorhanden. Das Package lädt deshalb nichts hoch.
So startest du das nächste Jahr:
- Führe das Skript
script.tonie_adventskalender_zuruecksetzenam 1. Januar oder später aus, aber vor dem 1. Advent. Alternativ löschst du die Kapitel in der Tonies-App. - Mehr ist nicht nötig. Die Adventssonntage des neuen Jahres rechnet das Package selbst aus. Die Folgen kommen wieder von allein.
Setz nicht zwischen dem 25. und 31. Dezember zurück. Die vier Folgen sind in diesem Jahr noch fällig und fehlen dann auf dem Tonie. Das Package lädt sie deshalb gleich wieder hoch, alle 15 Minuten eine.
Willst du im nächsten Jahr eine andere Geschichte, tauschst du die vier Dateien aus und passt zusätzlich die Titel in episodes an. Sie müssen weiter mit <n>. Advent beginnen. Räume vorher die alten Kapitel ab, wie oben beschrieben.
Tipps & Troubleshooting
- Passiert am Sonntag nichts, prüfst du, ob die Automation „Toniebox: Adventskalender hochladen“ aktiv ist und ob der Kreativ-Tonie einen Zustand hat (nicht
unavailable). Ohne gültigen Zustand startet sie nicht. - Tut sich im nächsten Jahr nichts, liegen die Kapitel vom Vorjahr noch auf dem Tonie. Führe
script.tonie_adventskalender_zuruecksetzenaus, siehe „Nach Weihnachten“. - Kommt die Fehlermeldung „ließ sich nicht hochladen“, prüfst du, ob die Datei unter dem genannten Pfad liegt und ob auf dem Tonie genug Zeit frei ist (90 Minuten insgesamt). Home Assistant versucht es alle 15 Minuten wieder.
- Steht in der Meldung bei der freien Zeit „unknown“, ist der Sensor Freie Zeit deaktiviert oder hat keinen Wert. Aktiviere ihn unter Einstellungen → Geräte & Dienste → Toniebox bei deinem Kreativ-Tonie. Die Fehlermeldung funktioniert auch ohne ihn. Hat dein Tonie einen anderen Namen als
kreativ_tonie_rubie, passe außerdem die Sensor-ID in der Fehlermeldung der Upload-Automation an. - Fehlt eine Folge, obwohl die Meldung „liegt jetzt auf dem Kreativ-Tonie“ kam, drückst du Aktualisieren am Tonie und siehst in das Attribut
chapters. Steht dort der Titel, liegt die Folge in der Cloud. Dann muss die Toniebox sie noch laden. - Liegt die Folge doppelt auf dem Tonie, sollte das durch die Titelprüfung eigentlich nicht passieren. Hast du einen eigenen Titel vergeben, muss er mit
<n>. Adventbeginnen. - Gehen die Lichter beim Auflegen nicht an, geh ein paar Punkte durch. Ist der Helfer
input_boolean.tonie_adventskalender_adventsmomentan? Ist heute ein Adventssonntag, oder hast du den Demo-Knopf in den letzten 30 Minuten gedrückt? Liegt die Folge des Tages schon auf dem Tonie? Haben die Lampen und Schalter das Label auslight_label? Und steht im zweiten# ADAPTwirklich der Sensor Aktuelle Figur ID deiner Box? Der Adventsmoment löst pro Tag nur einmal aus, außer nach dem Demo-Knopf. - Springt die Box nicht zur neuen Folge, brauchst du eine Toniebox 2 und musst
boximplanauf deine Box setzen. Die klassische Toniebox ignoriert den Sprung. - Für einen anderen Titel änderst du in
episodesden Eintragtitle. Der Anfang<n>. Adventbleibt, der Rest ist frei. - Zur Fehlersuche aktivierst du in der Integration das Debug-Protokoll, drückst den Demo-Knopf und siehst unter Einstellungen → System → Protokolle nach. Dort steht auch ein fehlgeschlagener Upload.
Hast du selbst schon etwas mit Kreativ-Tonies und Home Assistant gebaut? Schreib mir gern in die Kommentare, was bei dir läuft.
