Wie binde ich ein TRMNL E-Ink-Display ein?

collabDoo liefert die Anzeige eures Haushalts unter einer geheimen Adresse in drei Formen: Webseite, Bild (PNG) und Daten (JSON). Auf dem TRMNL gibt es zwei Wege: das Bild-Plugin für den Vollbild-Betrieb (empfohlen, keine Pflege) und Liquid-Vorlagen, wenn collabDoo neben anderen Plugins auf einem Bildschirm stehen soll. Ein eigener Server wird nicht gebraucht.

Teil 1

Voraussetzungen in der App schaffen

Du brauchst ein TRMNL, das mit der TRMNL-Cloud (trmnl.com) verbunden ist, und ein Konto mit Zugriff auf Private Plugins (Developer-Zugang). In collabDoo richtest du die Anzeige ein und erzeugst die Adresse – als Erwachsener mit Admin-Rolle.

Anzeige einschalten
Pflege → Anzeige (Küchen-Display) → Schalter Öffentliche Anzeige-Adresse aktiv einschalten.
Kalender, Ort, Fotos
Bis zu 6 Kalender per iCal-Adresse (Adresse prüfen zeigt sofort, ob der Link stimmt; bei Apple webcal:// durch https:// ersetzen), einen Ort für das Wetter, Fotos mit Rotation. Wie das geht, steht in der Anleitung zur Anzeige.
Ansicht für E-Ink wählen
Unter Ansicht E-Ink/Bild zwischen Woche und Nur heute wählen. Das ist die Voreinstellung für Bild und Webseite; per Adresse lässt sie sich überschreiben.
Anzeige-Adresse erzeugen
Unter E-Ink / TRMNL auf Anzeige-Adresse erzeugen tippen. Die App zeigt einmalig drei Adressen mit Kopieren-Knopf und QR-Code: Webseite …/d/<token>, Bild …/d/<token>.png, Daten …/d/<token>.json. Für Weg 1 brauchst du die Bild-Adresse, für Weg 2 die Daten-Adresse.

Geheim wie ein Einladungslink

Wer die Adresse kennt, sieht Aufgaben mit Vornamen, Termine und das Foto. Bei beiden Wegen landet sie in der TRMNL-Cloud, weil TRMNL sie abruft. Nicht weitergeben; bei Verlust Neue Adresse erzeugen (die alte stirbt sofort) oder Adresse widerrufen. Der Klartext wird nur im Moment des Erzeugens gezeigt.

Teil 2

Weg 1: Bild-Plugin (Vollbild, empfohlen)

Ein Private Plugin, dessen Markup nur ein Bild ist. Das Ergebnis ist genau das, was der collabDoo-Server rendert: Kachel-Design, Wetter, Foto – für E-Ink entworfen. Kein Liquid, keine Pflege.

Plugin anlegen
Auf trmnl.com: Plugins → Private Plugin → Add new. Name zum Beispiel „collabDoo“.
Strategie
Strategy: Static. Das Markup braucht keine Daten von TRMNL.

Markup einfügen

Edit Markup → Full, dann eine dieser Zeilen einfügen und <token> durch den Teil aus deiner Bild-Adresse ersetzen. Die erste Zeile passt zum TRMNL X, die zweite zum TRMNL OG.

<!-- TRMNL X (1872 × 1404, 16 Graustufen), Wochenansicht -->
<img src="https://team.collabdoo.app/d/<token>.png?w=1872&h=1404&mode=gray16&view=week" style="width:100%;height:100%;object-fit:contain;">

<!-- TRMNL OG (800 × 480, 1 Bit), Tagesansicht -->
<img src="https://team.collabdoo.app/d/<token>.png?w=800&h=480&mode=eink&view=today" style="width:100%;height:100%;object-fit:contain;">

Die Parameter hinter dem ? steuern das Bild – alle sind optional:

Parameter	Werte	Wirkung
`view`	`week` · `today`	Wochenkacheln oder Tagesansicht. Ohne Angabe gilt die App-Einstellung „Ansicht E-Ink/Bild“.
`w`	200 … 2000	Breite in Pixeln – die Auflösung deines Displays.
`h`	200 … 2000	Höhe in Pixeln. Das Layout skaliert über die Höhe (Vorlage 780 px).
`mode`	`eink` · `gray` · `gray16` · `color`	1 Bit gedithert (TRMNL OG) · 4 Graustufen · 16 Graustufen (TRMNL X) · Farbe (Browser, Tablet).
`rotate`	`0` · `90` · `180` · `270`	Drehung in Grad, etwa für ein hochkant montiertes Display.

Speichern und der Playlist zuweisen
Speichern, Vorschau prüfen, Plugin einer Playlist zuweisen. Fertig – das TRMNL holt das Bild in seinem eigenen Rhythmus (Refresh-Rate des Geräts).
Optional: Tag und Woche abwechseln
Ein zweites Plugin mit view=today anlegen. Die Reihenfolge in der Playlist ist der Wechselrhythmus.

Gut zu wissen

Der Server hält ein Bild 5 Minuten je Adresse und Parametern im Cache. Falls der TRMNL-Katalog ein Plugin „Image Display“ (Bild von URL) anbietet, funktioniert es mit derselben Bild-Adresse – das Private Plugin mit <img> geht aber immer und braucht keinen Katalog-Eintrag.

Teil 3

Weg 2: Private Plugin mit Liquid-Vorlagen (Mashups)

Nötig, wenn collabDoo neben anderen Plugins auf einem Bildschirm stehen soll (Half oder Quadrant). TRMNL rendert dann selbst aus den Daten – mit unseren fertigen Vorlagen.

Plugin anlegen
trmnl.com → Plugins → Private Plugin → Add new, Name „collabDoo“.
Strategie Polling
Strategy: Polling, als Polling-URL die Daten-Adresse …/d/<token>.json eintragen, Verb GET, keine Header.
Vorlage einfügen
Edit Markup: je Layout die passende Vorlage von team.collabdoo.app/trmnl/ kopieren und einfügen (Tabelle unten).
Vorschau prüfen
Erscheinen keine Einträge, liegen die Daten unter einem Wurzelknoten (passiert bei mehreren Polling-URLs). Dann in der Vorlage days durch IDX_0.days ersetzen – ebenso today, labels, household, weather, unassigned, title, updated, photo_url.
Playlist oder Mashup
Plugin der Playlist zuweisen. In einem Mashup steht collabDoo zum Beispiel als Viertel neben Wetter oder Nachrichten.

Layout	Vorlage	Zeigt
Full (Woche)	`collabdoo-full.liquid`	Tageskacheln 4×2, rechts Wetter und Foto, bei 7 Tagen achte Kachel „Zu vergeben“
Full (Tag)	`collabdoo-full-today.liquid`	Termine · Aufgaben (zweizeilig, Kreis-Checkbox) · Wetter und Foto
Half Horizontal	`collabdoo-half_horizontal.liquid`	Heute links, nächster Tag rechts
Half Vertical	`collabdoo-half_vertical.liquid`	Heute groß, darunter die nächsten Tage
Quadrant	`collabdoo-quadrant.liquid`	Nur heute, kompakt

Gut zu wissen

Die Full-Vorlagen laden Public Sans und Roboto Condensed von Google Fonts sowie Wettersymbole und Foto vom collabDoo-Server. TRMNL rendert in der Cloud, deshalb sind alle Adressen absolut.

Teil 4

Parameter der Bild-Adresse und Empfehlungen je Gerät

Die Parameter hängst du mit ? und & an die Bild-Adresse. Ohne view gilt die App-Einstellung „Ansicht E-Ink/Bild“.

Parameter	Werte	Bedeutung
`view`	`week` · `today`	Wochenkacheln oder Tagesansicht
`w`, `h`	200 … 2000	Bildgröße in Pixeln; das Layout skaliert über die Höhe (Vorlage 780 px)
`mode`	`eink` · `gray` · `gray16` · `color`	1 Bit gedithert · 4 Graustufen · 16 Graustufen · Farbe
`rotate`	`0` · `90` · `180` · `270`	Drehung

Empfehlungen

TRMNL X (10,3″, 16 Graustufen, 1872 × 1404): ?w=1872&h=1404&mode=gray16&view=week
TRMNL OG (7,5″, 1 Bit, 800 × 480): ?w=800&h=480&mode=eink&view=today – die Tagesansicht ist auf dem kleinen Display lesbarer als die Woche.
Browser oder Tablet: die Webseiten-Adresse …/d/<token> aktualisiert sich selbst, ?view=today ist möglich.

Was auf dem Bild zu sehen ist

Woche: je Tag eine Kachel mit Wochentag, „HEUTE“-Plakette, Datum und den Einträgen in zeitlicher Reihenfolge – Termine mit Zeit und Kalender, Aufgaben mit Zeit und Person („07:00 · Max“, offene als „07:00 · offen“). Rechts oben das Wetter mit Stundenleiste 06–20, rechts unten das Tagesfoto. Tag: links die Termine, in der Mitte die Aufgaben als Liste mit Kreis (leer = offen, gefüllt = erledigt), Zeit und Zuständigkeit, dann „Morgen“, wenn Platz ist. Klares Kachel-Design, für E-Ink entworfen.

Teil 5

Fehlersuche

Symptom	Ursache und Lösung
Bild oder Seite liefert 404	Adresse falsch, widerrufen oder Anzeige ausgeschaltet. In der App eine neue Adresse erzeugen.
Alte Darstellung im Browser	Browser-Cache (60 Sekunden). Mit Umschalttaste neu laden oder einen Parameter ändern.
Bild zu klein oder unscharf auf dem TRMNL X	`w=1872&h=1404&mode=gray16`
Liquid-Vorlage zeigt nichts	Wurzelknoten: `days` → `IDX_0.days` und die anderen Felder ebenso (Teil 3, Schritt 4).
Alle Aufgaben stehen auf „Zu vergeben“ oder „offen“	Die Aufgaben haben keine zugeteilte Person. Zuständigkeit in der App setzen oder übernehmen lassen.
Kalender fehlt	Die iCal-Adresse muss mit `https://` beginnen und öffentlich abrufbar sein; „Adresse prüfen“ in der App nutzen. Aktualisierung alle 15 Minuten.
Ausrufezeichen hinter der Zeit	Die Aufgabe ist überfällig – die Zeit ist heute schon vorbei.

Gut zu wissen

Alle Vorlagen, Symbole und eine Kurzanleitung liegen öffentlich unter team.collabdoo.app/trmnl/.

collabDoo · All for one. Done by all.

Die Woche an der Wand – ohne Strom zu verschwenden.

Ein Private Plugin, eine Zeile Markup, fertig.

Beta testen DemnächstApp Store

iPhone & iPad · iOS 17 oder neuer · Android folgt