TYPO3 Log Viewer

15. Mai 2026

Wer viel mit TYPO3-Projekten arbeitet, kennt das: Ein Fehler tritt auf, man öffnet var/log/….log — und blickt auf eine endlose Wand aus Zeilen, JSON-Blöcken, Stacktraces usw. tail -f zeigt zwar Bewegung, aber wirklich übersichtlich ist das nicht. Ganz im Gegenteil. Und viel Glück dabei einen kniffligen API-Call über mehrere Requests hinweg zu debuggen.

Und weil mich seit geraumer Zeit stört, dass es kein guten Viewer für Typo3 Logdateien gibt, habe ich einen geschrieben. Vorhang auf für den…

TYPO3 Log Viewer

TYPO3 Log Viewer auf github

Es ist ein Kommandozeilen-Tool, das eine TYPO3-Logdatei öffnet und in einer aufgeräumten, farbcodierten Listenansicht darstellt. Man navigiert mit den Pfeiltasten durch die Einträge, öffnet bei Bedarf die Detailansicht mit vollständiger Nachricht und formatiertem JSON — und kann nach Log-Level, Datum, Request-ID oder Freitext filtern. Neue Einträge erscheinen automatisch, und auf Wunsch lassen sich einzelne Zeilen oder ganze Bereiche direkt aus der Datei entfernen. Besonders praktisch im Deprecation-Log, wenn man aufräumen will.

Mehr macht es nicht und genau das ist der Punkt: eine einzelnes, kampaktes Binary, das auf macOS, Linux und auch auf den meisten Shared-Hosting-Umgebungen läuft.

Installation

Die Installation unter macOS ist am einfachsten via Homebrew:

brew tap rolf-thomas/tools
brew install typo3-log-viewer

macOS Gatekeeper

Das Binary ist nur ad-hoc signiert (nicht über einen Apple Developer Account notarisiert). Beim ersten Start blockiert macOS die Ausführung mit “kann nicht geöffnet werden, da der Entwickler nicht verifiziert werden kann”. Einmalig das Quarantäne-Attribut entfernen:

xattr -d com.apple.quarantine /pfad/zu/typo3-log-viewer

Alternativ in den Systemeinstellungen unter Datenschutz & Sicherheit auf “Trotzdem öffnen” klicken, nachdem die Warnung erschienen ist.

Dann das Tool mit der Logdatei als Paramter (optional) starten:

typo3-log-viewer
# oder 
typo3-log-viewer var/log/typo3.log

Alle weiteren Details, Binaries für andere Plattformen und der Quellcode unter github.com/rolf-thomas/typo3-log-viewer (MIT-Lizenz).

Gerne Feedback, Feature-Requests und Bug-Reports.