labelpi/docs/INSTALL.md

LabelPi – Installationsanleitung (Raspberry Pi + Brother QL)

Kurzfassung und Funktionsübersicht: README. Beispiel hier: Raspberry Pi 2 B + QL-500.

0. Was du brauchst

• Raspberry Pi 2 B, Netzteil (5 V / 2 A), microSD (8 GB+)
• USB-WLAN-Stick (der Pi 2 B hat kein WLAN eingebaut; am besten ein 2,4-GHz-Stick, der unter Raspberry Pi OS ohne Zusatztreiber läuft, z. B. mit Realtek-/MediaTek-Chip)
• Brother QL-500 per USB, 62-mm-Rolle eingelegt

1. SD-Karte vorbereiten

1. Raspberry Pi Imager starten → Gerät: Raspberry Pi 2 → OS: Raspberry Pi OS (other) → Raspberry Pi OS Lite (32-bit).
2. Zahnrad / „Einstellungen bearbeiten“:
   • Hostname: labelpi
   • Benutzer + Passwort festlegen
   • WLAN: SSID und Passwort deines Hotspots (ggf. zusätzlich dein Heim-WLAN), Land DE
   • SSH aktivieren (Passwort oder Schlüssel)
   • Zeitzone Europe/Berlin
3. Schreiben, SD in den Pi, WLAN-Stick einstecken, Strom an. Erster Start dauert 1–2 Minuten.

Hotspot-Tipp (iPhone): Einstellungen → Persönlicher Hotspot → „Kompatibilität maximieren“ einschalten, damit er 2,4 GHz nutzt. Der Hotspot muss beim Einschalten des Pi bereits aktiv sein.

2. Per SSH verbinden

ssh DEIN_BENUTZER@labelpi.local

Klappt .local nicht, die IP in den Geräteinfos des Hotspots nachsehen.

3. Dateien auf den Pi bringen

Variante A (ein Befehl, empfohlen): direkt auf dem Pi

curl -fsSL https://raw.githubusercontent.com/DEIN-USER/labelpi/main/install.sh | bash

Damit sind Schritt 3 und 4 erledigt, weiter mit Schritt 5.

Variante B (manuell): Vom PC aus (Ordner labelpi aus dem ZIP entpackt):

scp -r labelpi DEIN_BENUTZER@labelpi.local:~

4. Installieren

cd ~/labelpi
bash install.sh

Das Skript installiert Python-Pakete in einer venv, legt die USB-Rechte für Brother-Drucker an und richtet den Dienst labelpi ein (startet automatisch beim Booten, Port 80). Die Installation dauert auf dem Pi 2 einige Minuten.

5. Drucker prüfen

QL-500 einschalten, dann:

lsusb | grep 04f9      # sollte "Brother Industries" zeigen
sudo systemctl status labelpi

Falls der Drucker nicht erkannt wird: einmal aus- und wieder einschalten bzw. sudo reboot.

6. Benutzen

Im Browser (PC, iPad, iPhone, gleiches Netz/Hotspot): http://labelpi.local

• Grüner Punkt oben = Drucker gefunden.
• iPhone/iPad: Teilen → „Zum Home-Bildschirm“ für ein App-Symbol.
• Modelle mit Autoschnitt zeigen oben die Option „Autoschnitt“. Der QL-500 schneidet nicht automatisch: nach dem Druck Etikett am Cutter manuell abtrennen. Bei mehreren Kopien kommen die Etiketten hintereinander raus.
• Die Schrift wird auf dem jeweiligen Gerät gerendert (WYSIWYG: gedruckt wird, was du siehst). Auf iPad/PC können Schriftarten leicht abweichen.

Oben rechts gibt es Buttons zum Neustarten und Herunterfahren des Pi. Nach dem Herunterfahren erst Strom trennen, wenn die grüne LED nicht mehr blinkt.

7. Wartung

• Logs: journalctl -u labelpi -f
• Neustart: sudo systemctl restart labelpi
• Backup: Vorlagen und Verlauf liegen in ~/labelpi/labels.db (einfach kopieren).
• Weiteres WLAN hinzufügen: sudo nmcli device wifi connect "SSID" password "PASSWORT"
• Update: neue Dateien drüberkopieren, dann sudo systemctl restart labelpi.

8. Fehlerbehebung

Problem	Lösung
ImportError: libopenjp2.so.7 (Dienst startet nicht)	bash install.sh erneut ausführen (installiert die fehlenden Bibliotheken), Prüfen mit journalctl -u labelpi -n 30
„Drucker nicht gefunden“	Strom/USB prüfen, lsusb, Dienst neu starten
„Resource busy“ / „Access denied“	echo 'blacklist usblp' | sudo tee /etc/modprobe.d/blacklist-usblp.conf, dann sudo reboot
Fehler zur Rollen-/Etikettengröße	Im Designer dieselbe Rolle wählen wie im Drucker eingelegt (QL-500 erkennt sie nicht selbst)
WLAN-Stick verbindet nicht mit Hotspot	nmcli device wifi list (sieht der Stick das Netz?), WLAN-Land DE setzen (sudo raspi-config), Hotspot auf 2,4 GHz und WPA2 stellen (viele Sticks können kein 5 GHz/WPA3)
Seite nicht erreichbar	Hotspot aktiv? Gleiches Netz? Alternativ per IP statt labelpi.local

9. Sicherheit

Optional: Passwortschutz unter Einstellungen. Ohne Passwort gibt es keinen Login. Nutze die Seite nur im eigenen Hotspot/Heimnetz mit starkem WLAN-Passwort, nicht im Firmen-WLAN.