SimpleWindowsTail

Handbuch · Version 1.0.1 · codekunst systems GmbH

1. Überblick

SimpleWindowsTail ist ein Log-Viewer für Windows. Er überwacht eine oder mehrere Textdateien live (wie tail -f), erkennt Log-Stufen automatisch und hebt Zeilen farbig hervor. Die Oberfläche ist deutschsprachig und verwendet ein dunkles Design.

Systemvoraussetzungen: Windows 10/11 (x64). Die Anwendung wird self-contained ausgeliefert, eine separate .NET-Installation ist nicht nötig.

2. Installation

1. SimpleWindowsTail-Setup-1.0.1.exe ausführen und den Assistenten durchlaufen.
2. Alternativ steht eine portable Variante (ZIP) bereit; einfach entpacken und SimpleWindowsTail.exe starten.
3. Deinstallation über Apps & Features bzw. den Uninstaller im Installationsordner.

3. Oberfläche

Bereich	Beschreibung
Ribbon	Reiter Datei, Ansicht, Hervorhebung
Dateiliste (links)	Alle überwachten Dateien, jeweils mit eigener Farbe
Regelliste	Aktive Hervorhebungsregeln
Suchleiste	Volltextsuche über alle Einträge
Log-Tabelle	Spalten Log-Zeit, Datei, #, Eingang, Inhalt, Stufe
Statusleiste	Status (Bereit/Pausiert), Anzahl Dateien und Zeilen

4. Dateien überwachen

Reiter Datei → Dateien:

• Hinzufügen (Strg+O): eine oder mehrere Logdateien auswählen. Neue Zeilen erscheinen sofort in der Tabelle.
• Entfernen: markierte Datei aus der Überwachung nehmen.
• Zuletzt: Liste der zuletzt geöffneten Dateien. Beim Start werden die zuletzt überwachten Dateien wiederhergestellt.

Reiter Datei → Überwachung:

• Pausieren/Fortsetzen (Leertaste): unterbricht die Anzeige neuer Zeilen.
• Leeren (Strg+L): löscht die angezeigten Einträge (die Dateien bleiben unverändert).
• Aktualisieren (F5): liest die Dateien neu ein.

Log-Rotation: Wird eine Datei abgeschnitten oder neu angelegt, erkennt das Programm dies automatisch und liest ab dem Anfang weiter. Es werden maximal 50.000 Einträge vorgehalten; ältere werden verworfen.

5. Ansicht anpassen

Reiter Ansicht:

Funktion	Wirkung
Auto-Scroll	Tabelle folgt automatisch der neuesten Zeile
Umbruch	Lange Zeilen umbrechen
Zeilen-Nr. / Zeit / Datei	Spalten ein- oder ausblenden
Gruppierung	Gruppierungsleiste über der Tabelle ein-/ausblenden (Spalten per Drag & Drop gruppieren)
Größer / Kleiner	Schriftgröße ändern

6. Suchen und Filtern

• Strg+F öffnet das Suchfeld. Die Suche wirkt auf alle sichtbaren Spalten, Treffer werden gelb markiert und nur passende Zeilen angezeigt.

• Spaltenköpfe erlauben Sortieren und Filtern (z. B. nur Stufe Error).
• Über die Gruppierung lassen sich Einträge z. B. nach Datei oder Stufe bündeln.

7. Hervorhebung

Jede Zeile wird per regulärem Ausdruck einer Stufe zugeordnet: Debug, Info, Warning, Error, Exception (sonst Unknown). Die Stufe bestimmt die Farbe der Zeile.

Reiter Hervorhebung → Regeln:

• Regeln verwalten: Regeln anlegen, bearbeiten, löschen und priorisieren. Eine Regel besteht aus einem Muster (Regex) und Farben. Bei mehreren Treffern gewinnt die Regel mit der höchsten Priorität.
• Zurücksetzen: stellt die Standardregeln wieder her.

8. Tastenkürzel

Taste	Funktion
Strg+O	Datei hinzufügen
Strg+F	Suche
Strg+L	Anzeige leeren
F5	Aktualisieren
Leertaste	Pausieren / Fortsetzen

9. Einstellungen und Daten

Fenstergröße/-position, zuletzt geöffnete Dateien, eigene Regeln, Dateifarben und Anzeigeoptionen werden automatisch in settings.json gespeichert:

%AppData%\SimpleWindowsTail\settings.json

Das Löschen dieser Datei setzt die Anwendung auf den Auslieferungszustand zurück. Die überwachten Logdateien werden ausschließlich lesend geöffnet.

10. Fehlerbehebung

Problem	Lösung
Keine neuen Zeilen	Überwachung pausiert? Leertaste drücken oder F5
Datei lässt sich nicht öffnen	Leserechte prüfen; die Datei darf von anderen Programmen geschrieben werden
Anzeige träge bei sehr großen Dateien	Anzeige mit Strg+L leeren, Gruppierung ausschalten
Einstellungen defekt	settings.json löschen (siehe Abschnitt 9)

11. Sicherheit und Komponenten

Die Anwendung verarbeitet ausschließlich lokale Dateien und baut keine Netzwerkverbindungen auf. Eine maschinenlesbare Komponentenliste (CycloneDX-SBOM) liegt unter SimpleWindowsTail.sbom.cdx.json (bzw. docs/sbom/sbom-1.0.1.json). Eingesetzt wird DevExpress WinForms 26.1.5 auf .NET 10.

12. Support

codekunst systems GmbH · support@codekunst-systems.com