Work in Progress: This wiki is severely lacking & possibly incorrect and still in development. The site is open source — assistance and pull requests are welcome!

Logs

View and manage launcher and game logs for troubleshooting.

Comprehensive logging system with real-time streaming, filtering, search, and export capabilities. Essential for troubleshooting crashes, bugs, and performance issues.

When reporting bugs, always include logs! Use the Export button to save logs as text files for sharing on GitHub or Discord.

Launcher Logs

Monitor Kable Launcher's internal operations, API calls, file operations, and errors.

Real-Time Streaming Logs appear instantly as events occur. Watch downloads, authentications, and file operations happen live.

Log Level Filtering Filter by DEBUG (verbose), INFO (normal), WARN (potential issues), or ERROR (critical problems). Hide noise, see what matters.

Search with Regex Search logs with plain text, regular expressions, or fuzzy matching. Find specific errors or patterns quickly.

Auto-Scroll Toggle Auto-scroll to latest entries (on by default). Disable to read historical logs without jumping to bottom.

Virtual Scrolling Handles thousands of log lines without performance degradation. Smooth scrolling even with 10,000+ entries.

Export Functionality Copy logs to clipboard or save to file (.txt or .log). Includes timestamps and log levels for context.

Enable persistent logging in Settings to save logs to disk. Great for tracking down intermittent issues that don't happen every launch.

Game Logs

Capture and display Minecraft's console output (STDOUT/STDERR) with crash detection and error highlighting.

Feature	Description
Per-Instance Logs	Separate log tabs for each running Minecraft instance. Perfect for testing multiple versions simultaneously
Output Capture	Real-time capture of game console output with line buffering for accuracy
Crash Detection	Automatically identifies crash reports and highlights them with red badges
Error Highlighting	Errors and warnings color-coded for quick visual scanning
Log Parsing	Formatted display of Minecraft log entries with timestamp extraction
Exit Code Display	Shows process exit codes (0 = success, non-zero = crash/error)
Multi-Instance Support	Run and monitor logs from multiple Minecraft instances at once

Minecraft crash logs are also saved to crash-reports/ in your game directory. Kable displays them, but files persist separately.

Log Management

Control how logs are stored, compressed, and cleaned up to save disk space and maintain performance.

Log Compression GZIP compression reduces log file size by 80-90%. Compressed logs remain searchable and readable.

Retention Policies Auto-delete logs older than N days or when size exceeds limit. Configurable in Logging Settings.

Log Deduplication Collapses consecutive duplicate entries (e.g., '100 lines hidden'). Reduces noise from repeated errors.

Memory-Efficient Mode Limits in-memory log buffer to prevent RAM usage from growing indefinitely during long sessions.

Directory Access Open logs folder in file explorer for manual access, archiving, or sharing entire log histories.

Merged View Option Combine launcher and game logs into single chronological view. Perfect for correlating launcher actions with game events.

Set max_memory_logs to 10,000+ if you frequently scroll through long log histories. Lower it to 1,000-2,000 on systems with limited RAM.