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!

Logging Settings

Control log storage, display, and retention.

Logging settings determine how Kable saves, displays, and manages diagnostic logs. Essential for troubleshooting crashes or reporting bugs to developers.

SettingTypeDefaultDescription
show_logs_page_in_navBooleantrueShow the Logs page in sidebar navigation. Hide to declutter if you rarely use logs.
enable_persistent_loggingBooleanfalseSave logs to disk for later review. Stored in launcher data directory.
enable_log_compressionBooleantrueGZIP-compress old log files to save disk space. Compressed logs remain readable.
log_file_size_limit_mbNumber | "disabled"10Maximum log file size in MB before rotation. Set to "disabled" for unlimited.
log_retention_daysNumber | "disabled"30Auto-delete logs older than this many days. "disabled" keeps logs forever.
merge_log_tabsBooleanfalseCombine launcher and game logs into single view instead of separate tabs.
default_log_levelsArray<String>["error"]Visible log levels: debug, info, warn, error. Example: ["info", "warn", "error"]
max_memory_logsNumber5000Maximum log entries kept in RAM. Higher = scroll further back but use more memory.
enable_dedupeBooleantrueRemove consecutive duplicate log messages. Reduces spam from repeated errors.
dedupe_window_sizeNumber50Number of recent log entries to check for duplicates. Higher catches more but uses slightly more CPU.

Unlimited log retention can fill your disk over time! Set reasonable limits or periodically clean the logs folder manually.