# Mediahub: Schnittstelle für externe Werkzeuge und Anmeldung – Vorschlag zur Diskussion

**URL:** <https://forum.espuino.de/t/mediahub-schnittstelle-fuer-externe-werkzeuge-und-anmeldung-vorschlag-zur-diskussion/4935>\
**Category:** Feature Request\
**Created:** [6. November 2026 um 12:50 UTC](https://forum.espuino.de/t/mediahub-schnittstelle-fuer-externe-werkzeuge-und-anmeldung-vorschlag-zur-diskussion/4935 "2026-11-06T12:50:10Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Author:** ![jlach-dev](https://forum.espuino.de/user_avatar/forum.espuino.de/jlach-dev/32/5964_2.png) [@jlach-dev](https://forum.espuino.de/u/jlach-dev)\
**Post date:** [6. November 2026 um 12:50 UTC](https://forum.espuino.de/t/mediahub-schnittstelle-fuer-externe-werkzeuge-und-anmeldung-vorschlag-zur-diskussion/4935/1 "2026-11-06T12:50:11Z")

</div>

Hallo zusammen,

ich habe kürzlich, zunächst für den eigenen Gebrauch, ein Programm zum Gestalten von Kartencovern entwickelt: [Tonuino-Studio](https://github.com/jlach-dev/Tonuino-Studio), kostenlos und Open Source (GPLv3). Ursprünglich war es auf den TonUINO gemünzt. Inzwischen bin ich aber auch ESPuino-Fan und würde das Programm gern der Community hier zur Verfügung stellen. Ein erster ESPuino-Modus liest schon die Karten aus dem Mediahub.

Dazu hatte ich mich mit Torsten ausgetauscht, und wir waren uns einig, dass es Sinn macht, das Ganze direkt größer zu denken: eine Schnittstelle, an die auch andere Werkzeuge andocken können, und dazu passend die Anmeldung am ESPuino. Hier meine Idee, ich bin gespannt auf eure Meinung.

## Wie es heute ist

- Der ESPuino holt Manifest und Dateien ohne Anmeldung vom Hub. Das ist gewollt, Geräte können sich nicht einloggen.
- Die Weboberfläche des Hubs hat ein optionales Passwort.
- Der ESPuino selbst hat keine Anmeldung: Weboberfläche und REST-Schnittstelle sind für jeden im WLAN offen.
- Beim sicheren Löschen ruft der Hub `DELETE /rfid` am ESPuino auf.
- Externe Werkzeuge können heute nur die `db.json` lesen oder die Weboberfläche fernsteuern.

## Vorschlag 1: Eine kleine JSON-Schnittstelle im Hub

Unter `/api/` lesend:

- `GET /api/info`: Version der Schnittstelle, ob eine Anmeldung nötig ist
- `GET /api/devices`: Geräte mit Alias und zuletzt aufgelegter Karte
- `GET /api/cards`: Karten, filterbar nach Gerät und Status

Schreibend:

- `POST /api/cards/<esp>/<karte>`: Karte zuweisen, mit derselben Prüfung wie das Formular in der Weboberfläche
- `POST /api/cards/<esp>/<karte>/verify`: Größe und Prüfsumme der Dateien neu prüfen, z. B. nachdem ein Werkzeug Tags geändert hat

Typischer Ablauf: Karte auf den ESPuino legen, sie landet als neue Karte im Hub, am PC wählt man im Werkzeug das Album und weist zu. Extra-Hardware braucht man dafür nicht.

Der Gedanke dahinter: Zusatzfunktionen wie Cover, Druck, Import aus anderen Programmen oder Statistiken können als eigene Werkzeuge neben dem Hub entstehen und über diese Schnittstelle andocken. Der Hub selbst bleibt schlank, und Torsten muss nicht jede Idee in den Kern übernehmen und pflegen. Dafür muss die Schnittstelle stabil bleiben, deshalb gibt es von Anfang an eine Versionsnummer.

Für die Anmeldung würde ich ein eigenes **API-Token** vorschlagen, das man in den Hub-Einstellungen erzeugt und jederzeit widerrufen kann, nicht das Web-Passwort. Ist kein Hub-Passwort gesetzt, ist auch die Schnittstelle offen, wie der Rest des Hubs.

Bezug zu [PR #4](https://github.com/biologist79/ESPuino-Mediahub/pull/4) von @tbaumann: Der PR zeigt schön, was mit dem Hub möglich ist, er baut den Kartendruck direkt in den Hub ein. Mit einer offenen Schnittstelle könnten solche Erweiterungen auch als eigenes Modul neben dem Hub laufen. Das hätte Vorteile für beide Seiten: Der Hub bleibt kleiner und leichter zu pflegen, und ein Modul kann sich in seinem eigenen Tempo weiterentwickeln, ohne auf einen Merge zu warten. Dafür müsste die Schnittstelle auch das können, was der Druckablauf braucht, z. B. Karten, die noch keine UID haben und erst später einer echten Karte zugeordnet werden. Deshalb würde ich die Schnittstelle gern zusammen mit Tilman zuschneiden. Die Prüfung einer Zuweisung, die er in `_read_assignment` auslagert, würde ich dafür direkt mitbenutzen, damit überall dieselben Regeln gelten.

## Vorschlag 2: Optionale Anmeldung am ESPuino

- Standard bleibt **aus** , damit bestehende Geräte unverändert weiterlaufen.
- Wer ein Passwort setzt, schützt damit Weboberfläche und REST-Schnittstelle.
- Der Hub braucht dann für das sichere Löschen einen Zugang zum Gerät, z. B. ein Geräte-Token, das man im Hub beim Gerät hinterlegt.
- Abruf von Manifest und Dateien durch den ESPuino bleibt wie heute.

## Passwort vergessen, ohne den NVS zu löschen

Ein paar Ideen, alle mit dem Grundsatz „wer das Gerät in der Hand hat, darf zurücksetzen“:

1. **Datei auf der SD-Karte** : Liegt beim Start z. B. `reset-password.txt` auf der Karte, löscht der ESPuino nur das Passwort und dann die Datei. Einfach, braucht aber Zugang zur SD-Karte (bei manchen Gehäusen umständlich).
2. **Tastenkombination beim Einschalten** : öffnet ein paar Minuten lang ein Fenster, in dem man ohne altes Passwort ein neues setzen kann. Ohne Werkzeug, aber die Kombination muss zu allen Tasten-Varianten passen.
3. **Admin-Karte** : eine RFID-Karte, die man beim Einrichten festlegt. Aufgelegt erlaubt sie das Neusetzen. Passt gut zum ESPuino, hilft aber nicht, wenn die Karte weg ist.

Die Wege lassen sich auch kombinieren, z. B. Admin-Karte für den Alltag und die Datei auf der SD-Karte als Rückfallebene. Nach dem Motto: Wer seine Admin-Karte verschlampert, muss zur Strafe das Gehäuse aufschrauben. 😉

Für den Hub ist das weniger kritisch: Er läuft im Container, das Passwort kann man zurücksetzen, indem man in der `db.json` den Eintrag `password_hash` löscht.

## Fragen an euch

- Braucht ihr die Schnittstelle überhaupt, und fehlt euch darin etwas?
- Token für die Schnittstelle: einverstanden, oder lieber anders?
- Welche Art des Zurücksetzens oder welche Kombination passt am besten zu euren Boxen?
- @tbaumann: Wäre so eine Schnittstelle für deinen Druckablauf eine Option, und was müsste sie dafür können?
- Wer hätte Lust, mitzutesten?

Viele Grüße  
Jochen

---

<div class="post-metadata">

**Author:** ![tbaumann](https://forum.espuino.de/user_avatar/forum.espuino.de/tbaumann/32/5732_2.png) [@tbaumann](https://forum.espuino.de/u/tbaumann)\
**Post date:** [6. November 2026 um 14:03 UTC](https://forum.espuino.de/t/mediahub-schnittstelle-fuer-externe-werkzeuge-und-anmeldung-vorschlag-zur-diskussion/4935/2 "2026-11-06T14:03:09Z")

</div>

ich fände es super. Mir war unwohl dabei mich so in die codebase einzunisten. Aber man müsste sich mindestens irgendwie in das Hauptmenü und vielleicht die Tabs noch eintragen können.

Ob es als ganz getrennter sidecar wirklich sinnvoll ist, ist noch die Frage. Eine Plugin Schnittstelle im Code wäre sicher auch okay finde ich. Muss ja nicht wirklich alles ein Microservice sein heutzutage.

Als API Token kann man einfach ein shared key nehmen. Einfach beiden Instanzen das selbe secret ins Environment geben. Da muss man auf jeden Fall nicht gleich ein OAuth Fass aufmachen.

espuino zu hub ohne passwort finde ich weiterhin sinnvoll. Und wenn dann per so eine Art Binding-Prozess. ESPuino macht ein binding request an den Hub mit einem proposed secret, der Hub fragt den user ob er es zulassen will.

Meine Kartendruck-Option war natürlich mein Fokus. Aber allgemein wäre das nützlich als Schnittstelle. Ich habe hier irgendwo z.B. auch noch ein python script das Bildchen auf HAMA 5028 Etiketten druckt.

---

<div class="post-metadata">

**Author:** ![tbaumann](https://forum.espuino.de/user_avatar/forum.espuino.de/tbaumann/32/5732_2.png) [@tbaumann](https://forum.espuino.de/u/tbaumann)\
**Post date:** [6. November 2026 um 14:08 UTC](https://forum.espuino.de/t/mediahub-schnittstelle-fuer-externe-werkzeuge-und-anmeldung-vorschlag-zur-diskussion/4935/3 "2026-11-06T14:08:54Z")

</div>

PS: Ich hatte nachgedacht über eine Mediahub-Cluoud. Für jeden user eine Instanz hinter einem langen nicht erratbaren hostnamen.  
[http://i0vu3ekwahae9oeiio6ee.espuina-mediahub.cloud](http://i0vu3ekwahae9oeiio6ee.espuina-mediahub.cloud) beispielsweise. (UI natürlich trotzdem nur mit Passwort)

Denn self-hosting ist schon eine ziemliche Hürde für viele denke ich. Anderer Leute Raubkopien zu hosten ist nicht ganz ohne Risiko, aber lässt sich denke ich machen. Aber kosten und Aufwand sollten sich auch in Grenzen halten…

---

<div class="post-metadata">

**Author:** ![jlach-dev](https://forum.espuino.de/user_avatar/forum.espuino.de/jlach-dev/32/5964_2.png) [@jlach-dev](https://forum.espuino.de/u/jlach-dev)\
**Post date:** [6. November 2026 um 14:38 UTC](https://forum.espuino.de/t/mediahub-schnittstelle-fuer-externe-werkzeuge-und-anmeldung-vorschlag-zur-diskussion/4935/4 "2026-11-06T14:38:18Z")

</div>

Hallo Tilman,

danke für die schnelle Rückmeldung, freut mich, dass du das ähnlich siehst!

Mein Vorschlag beschränkt sich bewusst auf die Schnittstelle selbst. Werkzeuge, die daran andocken, ob Kartendruck, Etiketten oder Cover, bleiben eigene Projekte ihrer Autoren. So muss im Hub nichts davon gepflegt werden, und jeder kann sein Werkzeug in seinem Tempo weiterentwickeln.

**Token:** Einverstanden, ein gemeinsamer Schlüssel per Umgebungsvariable reicht völlig. Kein OAuth, keine Verwaltung im Hub. Ist weder ein Schlüssel noch ein Hub-Passwort gesetzt, bleibt die Schnittstelle offen wie heute der Rest des Hubs.

**ESPuino zum Hub:** Sehe ich auch so, ohne Passwort ist im Heimnetz sinnvoll. Deine Idee mit der Kopplung (ESPuino schlägt ein Geheimnis vor, der Nutzer bestätigt im Hub) finde ich gut für den Fall, dass man es doch absichern will.

**Menü und Tabs:** Torsten hat klar gesagt, dass er möglichst wenig Pflegeaufwand im Hub haben möchte. Deshalb fände ich einen einfachen Link sinnvoll: In den Einstellungen trägt man Name und Adresse eines Werkzeugs ein, und der Hub zeigt dafür einen Eintrag im Menü. Für den Nutzer fühlt sich das fast so an, als gehöre das Werkzeug zum Hub, und im Hub kostet es nur ein paar Zeilen. Wäre das für dich denkbar? Falls du für den Kartendruck mehr brauchst, etwa eigene Tabs im Hub, sollten wir Torsten dazuholen und ihm die Entscheidung überlassen, es ist ja sein Projekt.

**Cloud:** Gerade wenn ein Hub einmal im Internet steht, ist das Token wichtig. Ein schwer erratbarer Hostname allein schützt nicht lange.

Wenn das für alle passt, würde ich einen Entwurf der Schnittstelle als PR vorbereiten, damit man etwas Konkretes zum Ausprobieren hat.

Viele Grüße  
Jochen

---

<div class="post-metadata">

**Author:** ![biologist](https://forum.espuino.de/user_avatar/forum.espuino.de/biologist/32/66_2.png) [@biologist](https://forum.espuino.de/u/biologist)\
**Post date:** [6. November 2026 um 16:23 UTC](https://forum.espuino.de/t/mediahub-schnittstelle-fuer-externe-werkzeuge-und-anmeldung-vorschlag-zur-diskussion/4935/5 "2026-11-06T16:23:59Z")

</div>

> [@jlach-dev](#):
>
> **Menü und Tabs:** Torsten hat klar gesagt, dass er möglichst wenig Pflegeaufwand im Hub haben möchte

Dazu stehe ich auch ganz klar. Ich hab das als kleines Nebenprojekt gestartet ohne jeglichen Nutzen für mich selbst (was ok ist). Aber wer da die ganz große Runde drehen möchte, der muss es halt forken und hier vorstellen. Ich selbst hab keine Ressourcen mehr, mir das ständig alles anzuschauen. Muss ich wirklich so sagen. Ich hab ja NIE Urlaub vor dem Ganzen hier.

Ein REST-Api ist ein guter Kompromiss: Mediahub bleibt schlank, ich habe wenig Arbeit und andere Projekte, wie es jetzt angedacht ist, docken an.

> [@tbaumann](#):
>
> Muss ja nicht wirklich alles ein Microservice sein heutzutage.

Also hier bietet sich das mehr als an.

> [@tbaumann](#):
>
> Denn self-hosting ist schon eine ziemliche Hürde für viele denke ich. Anderer Leute Raubkopien zu hosten ist nicht ganz ohne Risiko, aber lässt sich denke ich machen. Aber kosten und Aufwand sollten sich auch in Grenzen halten…

Das liegt einerseits nahe. Andererseits möchte ich mich davon deutlich distanzieren. Ich werde einen solchen Dienst auf keinen Fall anbieten. Speicherplatz ist inzwischen auch ganz schön teuer geworden. Also wenn du das anbieten willst, dann kannst nen Link dazu hier lassen, aber bewerben musst du das woanders. Das ist mir zu heikel.

> [@jlach-dev](#):
>
> Passwort vergessen, ohne den NVS zu löschen

Glaub die beste der drei Varianten ist die erste, weil die sicher überall funktioniert. Variante 2 ist aus meiner Seite kritisch, weil Kinder auch mal wild auf der Kiste rumdrücken können. Ist auch schwierig einen Default vorzugeben, da ESPuinos ziemlich heterogen sind. Und bei 3 besteht die Gefahr, dass die Karte dann „weg“ ist, wenn man sie braucht.

---

<div class="post-metadata">

**Author:** ![biologist](https://forum.espuino.de/user_avatar/forum.espuino.de/biologist/32/66_2.png) [@biologist](https://forum.espuino.de/u/biologist)\
**Post date:** [7. November 2026 um 09:52 UTC](https://forum.espuino.de/t/mediahub-schnittstelle-fuer-externe-werkzeuge-und-anmeldung-vorschlag-zur-diskussion/4935/6 "2026-11-07T09:52:15Z")

</div>

@tbaumann Ich möchte an der Stelle nochmal betonen, dass ich deinen Kartendruckdienst absolut befürworte und unterstütze. Ich will hier keinem Sichtbarkeit oder dergleichen nehmen - mir geht’s einfach nur darum, dass mein Arbeitsaufwand in Bezug auf ESPuino sinken muss. Und da ist aus meiner Sicht der API-Zugriff ein geeignetes Mittel. Da bist du in der Gestaltung deiner Sachen komplett frei und auch ich muss nur schauen, dass ich den API-Zugriff nicht kaputtmache.

Wie viel der Mediahub tatsächlich benutzt wird, das kann ich nicht sagen. Hier mal ein kleiner Einblick:

 ![Traffic von Github (Mediahub)](https://forum.espuino.de/uploads/default/original/2X/f/f3dd86e7432ade3511a2a24b5e99d0eda75afe48.png)

Bei ESPuino sieht es so aus:

 ![Traffic von Github (ESPuino)](https://forum.espuino.de/uploads/default/original/2X/d/d34d4115c10fc4121b116c3694384f37307410fb.png)

Gefühlt würde ich sagen, dass der Mediahub gar nicht so arg viel Relevanz hat (bisher). Einerseits bestimmt, weil er technische Hürden hat. Andererseits, weil die meisten Leute eh nur einen ESPuino haben und wahrscheinlich keinen Vorteil für sich erkennen (oder es nicht überblicken).

Also von mir aus gibt’s im Mediahub ne Unterseite, wo solche Projekte wie eure aufgelistet und beworben werden - in welcher Form auch genau immer. Ne weitere Möglichkeit ist natürlich auch ESPuino-Docs, wo man das erwähnen kann.

Und nochmal zum Cloud-Service: Du kannst das ja gerne machen. Ich schließe das nur für mich aus. Ich halte das wie gesagt auf der Copyright-Right für schwierig und im Zuge des „KI-Gedöns“ ist Plattenplatz echt teuer geworden. Bei meinem Webserver (Hetzner), auf dem auch hier das Forum läuft, kann ich froh sein, dass ich den schon lange besitze. Das wäre richtig wichtig teuer, wenn ich das so heute neu mieten müsste. Ingesamt wurde der Mediahub, aber ist halt dennoch ein Corner Case.

---

<div class="post-metadata">

**Author:** ![joker](https://forum.espuino.de/letter_avatar_proxy/v4/letter/j/5f9b8f/32.png) [@joker](https://forum.espuino.de/u/joker)\
**Post date:** [7. November 2026 um 21:24 UTC](https://forum.espuino.de/t/mediahub-schnittstelle-fuer-externe-werkzeuge-und-anmeldung-vorschlag-zur-diskussion/4935/7 "2026-11-07T21:24:09Z")

</div>

> [@biologist](#):
>
> Andererseits, weil die meisten Leute eh nur einen ESPuino haben und wahrscheinlich keinen Vorteil für sich erkennen (oder es nicht überblicken).

So ist es auch bei mir. Die Kids teilen sich einen ESPUINO und da sehe ich kein gutes Aufwand/Nutzen Verhältnis.

---

<div class="post-metadata">

**Author:** ![tbaumann](https://forum.espuino.de/user_avatar/forum.espuino.de/tbaumann/32/5732_2.png) [@tbaumann](https://forum.espuino.de/u/tbaumann)\
**Post date:** [8. November 2026 um 11:00 UTC](https://forum.espuino.de/t/mediahub-schnittstelle-fuer-externe-werkzeuge-und-anmeldung-vorschlag-zur-diskussion/4935/8 "2026-11-08T11:00:41Z")

</div>

Kein Problem. Ich verstehe das voll. Ich wollte es erst mal „vollintegriert“ versuchen. Aber gut war mir dabei auch nicht.  
Ich baue mal an einer Lösung die getrennt läuft. (Annahme wäre dann, dass die media files an die selbe Stelle gemountet sind) API-mässig bräuchte ich dann wirklich nur Zugriff auf die RFID Zuordnungen. (Wird dann in Mediahub gesynced wenn die Karten gedruckt sind)

Theoretisch kann ich das dann auch so bauen, dass es mit dem espuino direkt redet. Der kann ja sogar schon cover art extrahieren.

Ich bin gerade wieder etwas mehr unter Wasser, kann etwas länger dauern.

Mein Mega-Vorteil für den Mediahub ist, dass ich für die Kleine Karten vorbereiten kann, ohne dass das Gerät angeschaltet ist oder ich es mir ausleihen muss. Und der Hub läuft da wo auch der Rest meiner Mediendateien liegen.

Weihnachten bekommt sie vielleicht einen zweiten Player. Dann ist der Vorteil superklar. (Dann habe ich wieder ein Testbett an dem ich längerfristig arbeiten kann. Vielleicht bekomme ich LPCD doch noch zum Laufen…)

PS: Cloud Service ist erst mal nur ein Gedanke. Ich kann da finanziell, nachdem ich den Drucker-Quatsch erst mal gebootstrapped habe, eh erst mal nicht in Vorleistung treten.
