Bandbreite, automatische Laenge, Rand und Ausrichtung
frei positionierbare Objekte auf einem Etiketten-Canvas
Textfelder, Symbole, Rahmen/Formen, Linien und Tabellen
Bildimport mit Schwarz/Weiss-Konvertierung
QR-Code und Code128-Barcode
Layout speichern/laden im Browser
serverseitige Vorschau und Druck ueber ptouch-print
Band-Erkennung mit Breite, bedruckbarer Pixelbreite, Bandtyp, Hintergrundfarbe und Schriftfarbe
einfache Text-only Mobile-Webansicht unter /mobile
Schnittmodi: normal, Kettendruck/Streifen, Schnittmarke und Streifen mit Schnittmarke

Wichtig fuer den PT-P700

Der PT-P700 muss im normalen Druckermodus laufen, nicht im "Editor Lite" Massenspeicher-Modus. Falls er im Host als USB-Laufwerk erscheint, Editor Lite am Geraet deaktivieren bzw. das Laufwerk auswerfen und den Drucker neu verbinden.

Wenn lsusb so etwas zeigt, ist der Drucker noch im falschen Modus:

Brother Industries, Ltd PT-P700 P-touch Label Printer RemovableDisk

Dann am PT-P700 die Editor Lite-Taste druecken, bis die Editor-Lite-LED aus ist. Danach USB kurz abziehen und wieder einstecken. Erst wenn der Drucker nicht mehr als RemovableDisk erscheint, kann ptouch-print drucken.

Der Container braucht Zugriff auf USB. In Unraid geht das am einfachsten mit:

/dev/bus/usb:/dev/bus/usb
privileged: true

Start lokal

docker compose up --build

Danach: http://localhost:8080

Mobile Ansicht: http://localhost:8080/mobile

Beim Dockerfile-Image startet der Container ueber /usr/local/bin/ptouch-web-start. Bei der Unraid-GUI-Variante ohne eigenes Image wird stattdessen sh /srv/ptouch-web/start.sh als Container-Befehl gesetzt.

Unraid Docker-GUI ohne eigenes Image

Diese Variante nutzt ein fertiges Alpine/Python-Basisimage und mountet dieses Projekt in den Container. start.sh installiert beim Start Flask, Pillow und baut ptouch-print.

Nachteil: Beim ersten Start braucht der Container Internet und der Start dauert laenger. Nach einem Container-Neuerstellen kann das erneut passieren.

Dateien auf Unraid ablegen:

/mnt/user/appdata/ptouch-web/app
/mnt/user/appdata/ptouch-web/start.sh
/mnt/user/appdata/ptouch-web/requirements.txt
/mnt/user/appdata/ptouch-web/labels

In Unraid: Docker -> Add Container.

Name: ptouch-web
Repository: python:3.12-alpine
Network Type: bridge
Privileged: On
Post Arguments: sh /srv/ptouch-web/start.sh
Console shell command ist egal
Bei Command oder Entrypoint, falls sichtbar:
- Command: leer lassen, wenn Post Arguments gesetzt ist
- Entrypoint: leer
Port hinzufuegen:
- Container Port: 8080
- Host Port: 8080
- Protocol: TCP
Path hinzufuegen fuer die App:
- Container Path: /srv/ptouch-web
- Host Path: /mnt/user/appdata/ptouch-web
- Access Mode: Read/Write
Path hinzufuegen:

Container Path: /data/labels
Host Path: /mnt/user/appdata/ptouch-web/labels
Access Mode: Read/Write

Path hinzufuegen fuer USB:

Container Path: /dev/bus/usb
Host Path: /dev/bus/usb
Access Mode: Read/Write

Variablen hinzufuegen:

APP_DIR=/srv/ptouch-web
FLASK_APP=app.app
PRINT_ENABLED=1
PRINT_COMMAND=ptouch-print --image {image}
LABEL_DIR=/data/labels
LABEL_DPI=180

Wichtig: /srv/ptouch-web muss den Inhalt dieses Projektordners enthalten, also direkt app/, start.sh und requirements.txt.

Konfiguration

Umgebungsvariablen:

PRINT_ENABLED=1 druckt wirklich. Mit 0 wird nur ein PNG erzeugt.
PRINT_COMMAND=ptouch-print --image {image} ist das Druckkommando.
LABEL_DPI=180 passt zum PT-P700.
LABEL_DIR=/data/labels speichert erzeugte PNG-Dateien.
PRINT_QUEUE_ENABLED=1 legt Druckauftraege zuerst in eine Warteschlange und druckt sie, sobald der Drucker erreichbar ist.
PRINT_QUEUE_RETRY_SECONDS=30 legt fest, wie oft wartende Jobs erneut versucht werden.

Wenn ptouch-print auf deinem Setup andere Optionen braucht, nur PRINT_COMMAND anpassen. Der Platzhalter {image} wird von der App ersetzt. Fuer Schnittoptionen kannst du optional {cut_args} im Kommando platzieren; ohne Platzhalter haengt die App die Schnittargumente automatisch an.

Die Druckwarteschlange liegt unter /data/labels/queue. Deshalb muss /data/labels persistent gemountet sein, wenn Jobs einen Container-Neustart ueberleben sollen.

Hinweis: Der PT-P700 unterstuetzt laut Brother Auto Cut und Kettendruck, aber keinen Halbschnitt. Die Option Kettendruck / Streifen rendert mehrere Kopien als ein langes Druckbild, damit keine Vollschnitte zwischen den Labels entstehen.

Die automatische Laenge entfernt leeres Band am Ende des Etiketts. Links bzw. oben bleibt das Layout unveraendert, damit die Positionen im Editor nachvollziehbar bleiben.

USB testen

Im laufenden Container:

ptouch-print --info

Wenn kein Drucker gefunden wird, zuerst pruefen:

Ist Editor Lite deaktiviert?
Sieht Unraid den Drucker unter USB?
Ist /dev/bus/usb im Container sichtbar?
Laeuft der Container privilegiert?

Wenn ptouch-print meldet:

PT-P700 (PLite Mode) found

ist Editor Lite noch aktiv. Das ist kein Containerproblem, sondern der USB-Modus des Druckers.

Wenn ptouch-print meldet:

PT-P700 found on USB bus ..., device ...
libusb_open error :LIBUSB_ERROR_IO

sieht der Container den Drucker, kann ihn aber nicht oeffnen. Dann pruefen:

Container in Unraid wirklich mit Privileged: On starten.
/dev/bus/usb als Pfad Read/Write nach /dev/bus/usb mounten.
Keine zusaetzliche Device-Zeile nur fuer /dev/usb/lp0 verwenden.
Auf dem Unraid-Host pruefen, ob usblp geladen ist: lsmod | grep usblp
Falls usblp geladen ist, testweise entladen: modprobe -r usblp
USB-Kabel danach kurz abziehen und wieder einstecken.

Wenn das Entladen von usblp hilft, sollte usblp auf dem Host dauerhaft fuer diesen Drucker deaktiviert werden, weil ptouch-print direkt ueber libusb druckt.

Wenn usblp entladen ist und LIBUSB_ERROR_IO trotzdem bleibt:

Im Container-Terminal pruefen:
```
lsusb
ls -l /dev/bus/usb/001/020
ptouch-print --info
```
Die Bus-/Device-Nummer muss zur Ausgabe von lsusb passen.

Auf dem Unraid-Host pruefen, ob ein Prozess das USB-Device offen hat:

fuser -v /dev/bus/usb/001/020
lsof /dev/bus/usb/001/020 2>/dev/null

Unraid-Container-Konfiguration pruefen:
- Privileged: On
- /dev/bus/usb als Path, nicht nur als Datei, nach /dev/bus/usb
- Access Mode Read/Write
- keine extra /dev/usb/lp0-Device-Zuordnung
Wenn die Device-Nummer nach USB-Neustecken anders ist, die Befehle mit der neuen Nummer wiederholen.