mirror of https://github.com/eitch/LumineLog.git synced 2026-05-01 10:10:31 +02:00

LumineLog is a modern, cross-platform log viewer application built with JavaFX. It provides a real-time "tail -f" experience with powerful highlighting and multi-file support.

logs tail

Java 98.4%
Shell 1.3%
Smarty 0.3%

Find a file

Robert von Burg 8f37dfdd4d [Project] Add releasing instructions to README Documented the release process using JReleaser in the README. Included a dry run example to guide maintainers in performing releases effectively.		2026-04-22 21:47:23 +02:00
.idea	[Project] Initial commit	2026-02-27 13:32:32 +01:00
src	[New] Add file replacement detection in LogFileModel	2026-04-22 11:04:25 +02:00
.gitignore	[Project] Initial commit	2026-02-27 13:32:32 +01:00
CHANGELOG.md	[Project] Update changelog for version 0.4.0	2026-03-26 15:57:38 +01:00
LICENSE	[Project] Transition LumineLog to GNU GPL v2 license	2026-03-13 13:20:35 +01:00
pom.xml	[Project] Update dependency scopes and JReleaser plugin version	2026-04-22 21:46:36 +02:00
README.md	[Project] Add releasing instructions to README	2026-04-22 21:47:23 +02:00

README.md

LumineLog

LumineLog is a modern, cross-platform log viewer application built with JavaFX. It provides a real-time "tail -f" experience with powerful highlighting and multi-file support.

Features

Real-time Tailing: Automatically follows the end of log files as they grow.
Virtualized Log List: Efficiently handles large log files by loading only visible lines, supported by an LRU cache.
Powerful Highlighting:
- Define Highlight Groups for different log formats (e.g., Slf4j, standard).
- Use Regex or plain text rules to colorize log lines.
- Interactive highlights bar: see occurrence counts and jump to specific matches.
Multi-tab Interface: Open and monitor multiple log files simultaneously in separate tabs. Supports closing tabs and confirmation on exit.
Drag-and-Drop: Easily open log files by dragging them onto the application window.
Font Size Customization: Adjust the log display font size on the fly with a dedicated UI control.
Copy to Clipboard: Quickly copy log lines to your clipboard via the context menu.
Application Icon & About Dialog: Professional look with a custom icon and an informative About dialog.
Customizable: Add, rename, or delete highlight groups and rules on the fly.
Cross-platform Configuration: Automatically saves your preferences (last opened file, highlights) in standard OS locations:
- Linux: ~/.config/LumineLog/ (respects XDG_CONFIG_HOME)
- Windows: %APPDATA%\LumineLog\
- macOS: ~/Library/Application Support/LumineLog/

Technology Stack

Java 25
JavaFX 23 (Controls, FXML)
Maven for build management
Gson for configuration persistence
SLF4J / Logback for internal logging
JUnit 5 for testing

Getting Started

Prerequisites

Java Development Kit (JDK) 25 or newer.

Building from source

mvn clean install

Running the application

mvn javafx:run

Building a package

# Clean:
mvn clean
# Provision JDKS:
mvn -Pjdks
# Copy JARs:
mvn -Pjars
# Assemble Jlink distributions
mvn -Passemble

Releasing

mvn jreleaser:full-release -Djreleaser.dryRun=true

License

This project is licensed under the GNU General Public License v2.0. See the LICENSE file for details.