So installierst du den Druck-Agent in der Küche

Was dieses kleine Programm an der Arbeitsfläche macht

Der Druck-Agent ist ein leichtes Programm, das im Restaurant läuft und die Brücke zwischen qmen.us in der Cloud und dem Thermodrucker in deinem lokalen Netz schlägt. Die Cloud erreicht den Drucker hinter dem Router nicht. Also verbindet sich der Agent nach außen, fragt von Zeit zu Zeit, ob ein neuer Bon da ist, druckt ihn und bestätigt. Du musst keinen Port im Router öffnen.

Es gibt eine Version für drei Geräte: Linux (eine einzige AppImage-Datei), Windows (eine einzige .exe-Datei) und Android (eine App des Projekts, mit Drucker per Bluetooth oder Netzwerk). Bei allen dreien ist die Konfiguration dieselbe Kombination: die Adresse der Küche und der Token, den dir das Dashboard gibt. qmen.us läuft weiter im Browser, ohne App aus dem Store; installiert wird nur der Agent, und nur auf diesem einen Gerät in der Küche.

Warum es sich lohnt, den Bon auf Papier zu haben

• Der Bon kommt von allein, ohne dass jemand klickt. Der Kellner sendet vom Tisch aus, qmen.us erstellt den Druckauftrag, und das Programm holt ihn beim nächsten Abruf, standardmäßig alle 3 Sekunden.
• Ein doppelter Bon ist besser als eine verlorene Bestellung. Drucker ohne Papier, ausgeschaltet oder wackelndes Internet: Der Fehler wird gemeldet und der Auftrag kommt zurück in die Warteschlange. Der Server bietet ihn nach einer Minute ohne Bestätigung erneut an und versucht es bis zu zehnmal, bevor er aufgibt.
• Jede Station druckt nur das Ihre. Adresse und Token gelten pro Küche, also bekommt der Grill nicht den Nachtisch. Ein Haus mit zwei Arbeitsflächen und zwei Thermodruckern lässt zwei Agents laufen, jeder mit eigener Konfiguration.
• Dasselbe Gerät kann drucken und den Monitor zeigen. Ist der Monitor in der Konfiguration eingeschaltet, öffnet sich beim Start die Küchenansicht im Browser. Willst du nur den Bildschirm, brauchst du das gar nicht: Öffne einfach den Monitor-Link.

So installierst du den Druck-Agent in 7 Schritten

Es sind sieben Schritte, vom Button im Dashboard bis zum Programm, das beim Einschalten des Geräts von allein startet.

1. Schalte den Druck der Station im Dashboard ein

   Öffne im Dashboard Küchen. Jede Station ist eine Karte, und darauf findest du den Block Druck mit dem Button Einrichten. Es öffnet sich das Fenster Küchendruck: Schalte Bestellungen drucken ein, wähle die Papierbreite (80 mm oder 58 mm), wie viele Kopien du möchtest (von 1 bis 5) und tippe auf Speichern. Die Karte zeigt jetzt An, mit Breite und Kopien daneben.

2. Kopiere Adresse und Token

   Im selben Fenster stehen unter Daten für die Druck-App zwei Zeilen: die Adresse der Küche und der Token, hinter Punkten versteckt. Das Auge zeigt ihn an, der Button daneben kopiert. Steht dort (wird beim Speichern erstellt), hast du noch nicht gespeichert. Bewahre den Token gut auf: Er gilt als Passwort für den Druck. Der Link Neuen Token erstellen macht den vorherigen sofort ungültig.

3. Lade die Version für dein Gerät herunter

   Lade auf dem Gerät in der Küche die Datei für dein System herunter: unter Windows eine .exe-Datei (ab Windows 7), unter Linux ein AppImage, das auf jeder Distribution läuft. Es ist eine einzige Datei in einem Ordner. Auf dem Raspberry Pi und anderen ARM-Geräten erzeugst du das AppImage auf dem Gerät selbst oder startest direkt aus dem Quellcode, mit Python 3.9 oder neuer.

4. Füge Adresse, Token und Drucker ein

   Neben dem Programm liegt eine config.json mit base (die Adresse), token, printer (der Drucker) und poll (in welchem Abstand in Sekunden er nachfragt). Unter Windows liegt die Datei im selben Ordner wie die .exe; unter Linux in ~/.config/pedis-agent/config.json. Der Wert für printer hängt vom Anschluss ab: network:192.168.0.50 für einen Netzwerkdrucker, windows: für die Standard-Druckerwarteschlange von Windows, file:/dev/usb/lp0 für USB unter Linux, serial:/dev/ttyUSB0 für seriell.

   Tipp: Installiere den Thermodrucker unter Windows als Warteschlange Generic / Text Only: Ein Treiber, der die Seite zeichnet, verwürfelt die Befehle, und es kommt Papier voller Zeichensalat heraus. Wenn unter Linux /dev/usb/lp0 „Zugriff verweigert“ meldet, führe sudo usermod -aG lp $USER aus und melde dich neu an.

5. Mach vor dem Service einen Test

   Bevor du dich auf das Mittagsgeschäft verlässt, lass einen Durchlauf nur mit dem Drucker dummy laufen: Der Bon erscheint auf dem Bildschirm, ohne Papier zu verbrauchen. Schick dann eine Testbestellung über den Tisch und sieh zu, wie das Papier kommt: Kopfzeile mit dem Haus, Tisch, Bestellnummer, Kellner, Station und Uhrzeit, und jeder Artikel in großer Schrift, mit Zusatz und Anmerkung darunter.

6. Lass ihn von allein starten

   Die Küche hat keine Zeit, ans Öffnen von Programmen zu denken. Mit pedis-agent --install legt Windows eine Aufgabe an, die beim Login startet, und Linux einen Benutzerdienst, der sich bei einem Absturz von allein neu startet. Auf einem Gerät, an dem niemand angemeldet ist, etwa einem Raspberry Pi hinter dem Fernseher, führst du außerdem sudo loginctl enable-linger aus. Zum Rückgängigmachen gibt es pedis-agent --uninstall.

7. Auf dem Android-Tablet ist der Weg derselbe

   Nutzt die Küche ein Tablet, erledigt die Android-App (ab 5.0) dieselbe Arbeit und zeigt zusätzlich die Küchenansicht. Auf dem Startbildschirm füllst du Adresse, Token und Drucker aus — bt: und die MAC-Adresse des bereits gekoppelten Bluetooth-Thermodruckers, oder net: und die IP des Netzwerkdruckers — und tippst auf Speichern und starten. Erteile die Bluetooth-Berechtigung und nimm die App aus der Akkuoptimierung, sonst stoppt der Druck, sobald der Bildschirm ausgeht.

Häufige Fragen

Glossar

Druck-Agent

Das kleine Programm, das auf dem Gerät in der Küche läuft, die Bons von qmen.us holt, auf dem Thermodrucker ausgibt und bestätigt.

Druck-Token

Das Passwort für den Druck einer Küche. Es kommt aus dem Dashboard, geht in die Konfiguration des Agenten und kann jederzeit ausgetauscht werden.

Küche

Der Monitor, auf dem die Bestellungen erscheinen und von In Zubereitung bis FERTIG weiterwandern.

ESC/POS

Die Sprache, die Thermodrucker für Bons verstehen. Das erzeugt der Agent für jeden Bon.

Passende Anleitungen