Trinos Sporenmesser — Fehlerhilfe für Linux
Passend zum Qt-Prototyp 1.14.1026.1 · Stand 07.10.2026

Zuerst prüfen: Das ZIP muss vollständig entpackt sein. Terminalbefehle
zum Einrichten und Starten im entpackten Programmordner eingeben.
Bei einem Passwort werden im Terminal keine Zeichen angezeigt. Das ist normal.

BEREITS BEIM ERSTEN LINUX-TEST AUFGETRETEN

1. „Ich finde Trinos-Sporenmesser.desktop nicht.“

   Der Starter entsteht erst bei der Einrichtung:
   bash Einrichten-Linux.sh

   Anschließend den Ordner mit F5 aktualisieren. Der Dateimanager kann
   den Starter als „Trinos Sporenmesser“ anzeigen und .desktop ausblenden.
   Genau diese Datei ist gemeint. Das Ausblenden ist kein Programmfehler.

2. Doppelklick auf den Starter bewirkt nichts.

   Zur Diagnose im Terminal starten:
   bash Start-Linux.sh

   So werden Startmeldungen sichtbar. Beim ersten Test war eine fehlende
   Qt-Systembibliothek die Ursache. Ob der Doppelklick danach funktioniert,
   muss zusätzlich geprüft werden. „Start erlauben“ gibt es nicht in jedem
   Dateimanager. Wenn der Terminalstart klappt, der Doppelklick aber nicht,
   bitte den verwendeten Dateimanager und dessen Meldung nennen.

3. Meldung zu „xcb“, „xcb-cursor0“ oder „libxcb-cursor0“.

   Qt kann seine grafische Oberfläche nicht initialisieren. Die Meldung
   kann auf eine fehlende Systembibliothek hinweisen. Bei unserem ersten
   Linux-Mint-Test half das Nachinstallieren der genannten Bibliothek:

   sudo apt install libxcb-cursor0

   Danach erneut:
   bash Start-Linux.sh

   Wichtig: xcb enthält ein b. Am Ende von cursor0 steht die Ziffer Null.
   Falls der Fehler trotz erfolgreicher Installation bleibt, den neuen
   vollständigen Meldungstext senden; weitere Abhängigkeiten können fehlen.

4. „Paket libxcd-cursor0 kann nicht gefunden werden.“

   Hier wurde versehentlich ein d statt b eingegeben. Richtig lautet es:
   sudo apt install libxcb-cursor0

   Wenn der Name genau stimmt und das Paket trotzdem nicht gefunden wird,
   zunächst die Paketlisten aktualisieren:
   sudo apt update

   Danach die Installation erneut versuchen. Bleibt das Problem bestehen,
   den genauen Text und die Linux-Version melden. Keine fremden Paketquellen
   auf Verdacht hinzufügen.

WEITERE MÖGLICHE PROBLEME

5. „Start-Linux.sh: Datei oder Verzeichnis nicht gefunden“.

   Meist ist das Terminal im falschen Ordner oder das Paket noch nicht
   vollständig entpackt. Den Ordner mit app.py und Start-Linux.sh öffnen,
   dort rechtsklicken → „Im Terminal öffnen“, dann:
   bash Start-Linux.sh

6. „Python 3 fehlt“, „venv“ oder „ensurepip is not available“.

   Unter Linux Mint / Ubuntu die nötigen Python-Pakete installieren:
   sudo apt install python3 python3-venv

   Danach die Einrichtung erneut ausführen:
   bash Einrichten-Linux.sh

   Unterstützt wird in diesem Prototyp Python 3.9 bis 3.13.
   Die Programmeinrichtung selbst ohne sudo starten.

7. „No module named PySide6“ oder „Bitte zuerst einrichten“.

   Die Einrichtung wurde noch nicht erfolgreich abgeschlossen, oder
   app.py wurde mit dem falschen Python gestartet. Im Programmordner:
   bash Einrichten-Linux.sh

   Anschließend den erzeugten Starter oder bash Start-Linux.sh verwenden.
   Nicht einfach app.py doppelt anklicken.

8. Downloadfehler bei der Einrichtung.

   Für das erstmalige Herunterladen von Qt wird Internet benötigt.
   Verbindung prüfen und bash Einrichten-Linux.sh erneut ausführen.
   Bei Zertifikatsfehlern auch Datum/Uhrzeit prüfen und den Meldungstext
   weitergeben. Die Zertifikatsprüfung nicht abschalten.

9. Nach dem Verschieben des Programmordners startet die Anwendung nicht.

   Der Desktop-Starter enthält den ursprünglichen Pfad. Auch die lokale
   Python-Umgebung ist nicht allgemein verschiebbar. Am einfachsten das
   Original-ZIP frisch in den gewünschten Zielordner entpacken und dort
   bash Einrichten-Linux.sh ausführen. Eigene Messdateien separat behalten.
   Den neuen Starter verwenden; nicht den alten aus dem vorherigen Ordner.

10. Beim Schließen des Terminals schließt auch das Programm.

    Das kann beim Start über bash Start-Linux.sh passieren. Für den normalen
    Betrieb den erzeugten Desktop-Starter „Trinos Sporenmesser“ verwenden.
    Er startet das Programm ohne dauerhaft geöffnetes Terminal.

11. Messwerte stehen in px statt µm oder eine gemeinsame Auswertung fehlt.

    Ohne Referenz sind Pixelmaße richtig. Über „µm kalibrieren“ den bekannten
    Maßstabsbalken ausmessen oder eine passende gespeicherte Referenz laden.
    In einer Messreihe müssen alle gemessenen Fotos kalibriert sein, bevor
    Pixel- und µm-Werte gemeinsam ausgewertet werden können.
    Gleiche Pixelgröße allein reicht für einen identischen Maßstab nicht:
    Aufnahme- und Skalierungseinstellungen müssen ebenfalls gleich sein.

12. Eine ältere Messdatei mit Stacheln wird nicht geöffnet.

    Stachelmessungen sind in diesem ersten Qt-Prototyp noch nicht enthalten.
    Die Datei mit der bisherigen Windows-/Wine-Version öffnen. Die Meldung
    verhindert, dass Stacheldaten beim Laden unbemerkt verloren gehen.

13. Bilder fehlen in der Dateiauswahl „Bild öffnen“.

    Unterstriche im Dateinamen sind erlaubt und kein Grund zum Umbenennen.
    Zuerst oben den Ordnerpfad prüfen: Ist wirklich der Bilderordner geöffnet?
    Seit Version 1.14.1026.1 merkt sich „Bild öffnen“ diesen Ordner separat.
    Bei entfernten USB-Laufwerken das Laufwerk zuerst wieder anschließen
    und den passenden Ordner auswählen.

    Unten bei „Dateityp“ auf „Alle Dateien (*)“ wechseln. Die neue Version
    berücksichtigt außerdem Endungen wie .JPG / .jpg und .PNG / .png.
    Dateinamen mit Unterstrichen wie Foto_07_10_2026.JPG wurden mitgeprüft.
    Unter Linux wird für Bilder eine eigene Qt-Dateiauswahl verwendet,
    damit Einstellungen anderer Dateidialoge den Filter nicht beeinflussen.

    Bleiben die Dateien unsichtbar, ein Foto des geöffneten Dialogs senden
    und den vollständigen Namen eines betroffenen Bildes nennen. Erscheint
    die Datei zwar in der Liste, lässt sich aber nicht laden, stattdessen
    die dabei angezeigte Fehlermeldung weitergeben.

WENN DIE LÖSUNG NICHT HILFT

Bitte den genauen Meldungstext oder ein Bildschirmfoto senden, zusammen mit:
• Linux-Distribution und Version
• dem gerade ausgeführten Arbeitsschritt
• bei Startproblemen: Ausgabe von bash Start-Linux.sh

Keine Passwörter oder andere Zugangsdaten mitsenden. Das Programm schreibt
keine eigenen automatischen Fehlerprotokolle.

PRÜFSTAND

Mario berichtet am 07.10.2026 nach dem Nachinstallieren von libxcb-cursor0,
dass die Anwendung jetzt offenbar startet. Ein vollständiger Linux-Test
aller Messfunktionen und des Doppelklick-Starters ist damit noch nicht belegt.
Die weiteren Fälle sind Hilfestellungen, keine bereits bestätigten Fehler.

TECHNISCHE QUELLEN

Qt-Systembibliotheken:
https://doc.qt.io/qt-6.8/linux-requirements.html
Ubuntu-Paket libxcb-cursor0:
https://packages.ubuntu.com/noble/libxcb-cursor0
Python-Umgebungen und Ordnerwechsel:
https://docs.python.org/3/library/venv.html
Paketverwaltung apt:
https://manpages.ubuntu.com/manpages/noble/man8/apt.8.html


14. BILDER LASSEN SICH NICHT HINEINZIEHEN
Lokale Bilddateien aus dem Dateimanager auf das geöffnete Programm ziehen,
nicht aus einem Archiv, einer Internetseite oder einen Ordner ziehen.
Die aktuelle Messung erst abschließen oder mit Esc abbrechen. Mehrere gültige
Fotos können gleichzeitig hinzugefügt werden. Bei defekten/zu großen Bildern
wird nichts teilweise hinzugefügt. Alternativ Bild öffnen verwenden.
Falls unter Linux weiterhin kein Ablegen möglich ist: Distribution, Desktop
und X11/Wayland sowie die genaue Reaktion nennen. Der echte Dateimanager-Drop
wurde hier mangels Linux-System noch nicht geprüft.

15. MANUELLER MASSSTAB LIEFERT FALSCHE GRÖSSEN
Der Wert ist Pixel PRO µm. Bei 1 µm = 10 Pixel gilt 1 Pixel = 0,1 µm.
Nicht versehentlich µm pro Pixel eingeben. Der Dialog zeigt den Kehrwert an.
Nur den Maßstab verwenden, der zur tatsächlichen Aufnahme und Skalierung passt.

16. SPRACHE ODER NEUE FUNKTIONEN FEHLEN NACH AKTUALISIERUNG
app.py, model.py, i18n.py, qt-translations.json und Sprachen gemeinsam aus dem
neuen Paket übernehmen. Alte .venv und eigene Messdateien behalten.
Unter Info muss 1.14.1026.1 stehen. Optionen erneut öffnen, Sprache wählen.
Die Windows-PDF-Anleitungen gelten nicht für diese Qt-Oberfläche.

17. VORLÄUFIGE TXT KONNTE NICHT GESPEICHERT WERDEN
Die Meldung sagt ausdrücklich, wenn die Messdatei selbst bereits gespeichert
ist. Prüfen, ob die TXT-Datei schreibgeschützt oder in einem anderen Programm
gesperrt ist. Einen beschreibbaren Zielordner wählen und erneut speichern.
