Release Notes

Stay updated with the latest features, improvements, and bug fixes in Log4j Analyzer.

Upcoming Features

User-Customizable Toolbar

Planned

Personalize your workspace by rearranging toolbar items to match your workflow.

  • •NSToolbar-based implementation for drag-to-rearrange functionality
  • •Custom toolbar item placement and visibility control
  • •Persistent toolbar configuration across sessions

Version 1.20.0

Major Feature Release
September 3, 2026

Highlights

  • Pro: "Ask AI" log analysis panel with Ollama, Claude API, and Claude CLI backends
  • AI panel commands and free-form tool-calling instructions for the Claude backends
  • Generic CSV logs, Search in Files, resizable Entry Detail pane, and content-classification rules

New Features (Pro)

  • •Ask AI side panel (toolbar or ⌥⌘I) answers questions about patterns, anomalies, error clusters, and likely root causes in the entries you are viewing
  • •Three backends: Ollama (local, free, private), Claude API (your own Anthropic API key, entered in Settings ▸ AI; the Claude option in the Mac App Store build), and Claude CLI (your Claude Pro/Max login; direct-download build only)
  • •Built for huge files: the whole file is summarized once (level breakdown, top loggers, error clusters, a timeline of error spikes) and the raw lines most relevant to your question are selected
  • •Typed commands change the view instantly with no AI call, no cost, and offline: "filter all errors", "last 15 minutes", "only OrderService", "search timeout", "clear filters", "bookmark these"
  • •Free-form instructions with the Claude backends: phrases like "show db timeouts from this morning" let Claude drive filters, search, time range, and bookmarks through a fixed set of tools; questions still go to Q&A
  • •A "How to use" tips popover (? button in the panel header) with click-to-run examples and a backend comparison; shown automatically the first time the panel opens

New Features

  • •Generic CSV logs: any comma-separated file whose first column is a timestamp opens as a structured log, with columns matched by header name (time, stage/logger, detail/message, source/thread, level); other columns are folded into the message
  • •Search in Files (⌘⇧⌥F): BBEdit-style recursive folder search across .log, .txt, .out, .xml, and .csv files; results are grouped by file, and double-clicking a match opens it at that line. Drop a folder on the app icon to start
  • •Entry Detail pane (⌥⌘D): shows the selected row’s full raw text, wrapped, selectable, and copyable; drag its top edge to resize (height is remembered)
  • •HP Indigo ManagedData binary logs (no-sn.file.log and rotations, no-sn.errors.log) and HistoryDB (.dbx) exports are recognized and parsed
  • •Content-classification rules raise the level of lines that carry no level of their own, such as .NET exceptions and stack traces (to ERROR) and connection failures or timeouts (to WARN); rules can be customized in classification-rules.json
  • •The parsing progress window shows the detected format

Bug Fixes

  • •Free version: the 10,000-entry limit is now also enforced for large files, which previously showed every entry
  • •Large text logs keep their [thread] values
  • •AI panel: the input field can be focused and typed into, typing is no longer slow on large files, and the panel no longer flashes content before it slides open
  • •The log table takes keyboard focus when a file opens, so the arrow keys work without clicking first
  • •Fixed the beep when pasting into the search field (see 1.13.1)

Technical Details

  • •All log formats now go through a single plugin-style parser registry; adding a format is one parser file and one registration line
  • •HistoryDB parsing is about twice as fast on very large exports
  • •Combines versions 1.14.0 through 1.19.0 (AI features) and 1.15.3 (generic CSV) into one release

Version 1.13.1

Bug Fix & Enhancement Release
August 21, 2026

Highlights

  • New "Copy Raw Data from Selected Entries" command (⌘⌥R)
  • Fixed search field focus ring bleeding into adjacent toolbar buttons
  • Fixed paste/typing beep in the search field

New Features

  • •Edit → Copy Raw Data from Selected Entries (⌘⌥R) copies the original unparsed raw line for each selected entry
  • •Complements Copy Selected Entries (⌘⌥C), which copies a reformatted tab-separated version for spreadsheets

Bug Fixes

  • •Search field focus ring no longer bleeds into the adjacent recent-searches button; clipped to the field’s own rounded bounds
  • •Fixed system beep when pasting or typing in the search field, caused by the Edit menu overriding standard Cut/Copy/Paste/Select All
  • •Resolved shortcut collision: table-row copy commands moved from ⌘C/⌘⇧C to ⌘⌥C/⌘⌥⇧C so they no longer conflict with standard text Copy

Version 1.13.0

Feature Release
August 17, 2026

Highlights

  • CSV log format support for press-event style logs
  • Automatic column mapping onto the existing LogEntry model
  • Full feature parity: filtering, search, sorting, export, and multi-file sync

New Features

  • •CSVLogParser auto-detects CSV format (header with RecordNumber and Time columns)
  • •Column mapping: Time → timestamp, EventType → level, Name → logger, ProcessName → thread
  • •EventType mapped to log levels: WARNING → WARN, NOTICE → INFO, ERROR → ERROR, others → INFO
  • •Remaining columns (ServiceCategory, SubsystemId, NodeName, PressState, Origin) folded into the message field
  • •Full original CSV row preserved as raw text for raw content view and export
  • •.csv added to readable content types and document type registration (Free and Pro)

Integration

  • •CSV files work identically to Log4j text/XML: level filtering, text/regex search, column-specific search
  • •Sorting, date range filtering, bookmarks, and export (CSV/JSON/TXT) all supported
  • •Multi-file timestamp synchronization works across CSV and Log4j files
  • •Large CSV files stream through the existing LargeFileParser async pipeline

Technical Details

  • •New CSVLogParser service
  • •Unit tests added in CSVParsingTests.swift

Version 1.12.0

Major Update
October 17, 2025

Highlights

  • Recent File Groups (Sessions) for multi-file workspace management
  • Professional SwiftUI Table-based session management UI
  • Auto-save sessions on quit with window position restoration

New Features

  • •Save current session with all open files and window positions
  • •File → "Save Current Session..." menu command (⌘⌥⇧S)
  • •File → "Open Recent" menu displays both groups (with 📁 icon) and individual files
  • •Maximum 5 groups with automatic trimming
  • •Persistent storage using UserDefaults with JSON encoding
  • •File existence validation with user-friendly error dialogs
  • •Auto-save on app quit when 2+ documents are open with sync enabled

User Interface

  • •Settings → Sessions tab with professional SwiftUI Table
  • •Sortable columns: Session Name, Files count, Last Opened date
  • •Context menu: Rename, Open Session, Delete
  • •Multi-selection support for batch operations
  • •Toolbar with Rename, Delete, and Clear All buttons
  • •Empty state with helpful guidance and icon
  • •Session groups displayed with folder icon (📁) in Recent menu

Integration

  • •Window position restoration when opening saved sessions
  • •Seamless integration with Window Docking System
  • •Works with existing Timestamp Sync feature
  • •Window frame storage per file URL in session groups
  • •Animated window transitions on session restore

Technical Details

  • •Created AppDelegate for application lifecycle management
  • •Extended RecentFilesManager with group management methods
  • •Added RecentFileGroup model with Hashable conformance
  • •Named sessions with descriptive titles
  • •Batch delete support for multiple selections

Version 1.11.0

Feature Release
October 15, 2025

Highlights

  • Bookmark UI enhancements with centered column header
  • Improved bookmark color rendering in context menus
  • Enhanced visual consistency for bookmark indicators

User Interface

  • •Centered bookmark icon in column header with manual offset positioning
  • •Reduced header icon size to 9pt for better visual balance
  • •Fixed bookmark column header icon alignment issue
  • •Bookmark context menu icons now display in their respective colors
  • •Used SF Symbols with .foregroundStyle() for proper color rendering
  • •Improved visual feedback when selecting bookmark colors

Bug Fixes

  • •Fixed issue where header icon was bound to top-left corner
  • •Improved visual consistency between header and row bookmark icons
  • •Context menu colors now render properly in macOS menu system

Version 1.10.0

Major Update
October 13, 2025

Highlights

  • Window Docking System with magnetic snapping
  • Automatic window arrangement commands
  • Multi-file analysis workspace optimization

New Features

  • •Magnetic window snapping with 20pt proximity threshold
  • •Automatic edge detection for horizontal and vertical alignment
  • •Window arrangement commands: Tile Horizontally/Vertically/Grid
  • •Dock positioning: Left/Right/Top/Bottom with keyboard shortcuts
  • •Settings toggle for enabling/disabling magnetic snapping
  • •Real-time window position monitoring during drag operations
  • •Screen-aware positioning with animated transitions
  • •Multi-monitor support with screen bounds validation

Keyboard Shortcuts

  • •⌘⌥⇧H - Tile Horizontally (stack all log windows vertically)
  • •⌘⌥⇧V - Tile Vertically (arrange all log windows side-by-side)
  • •⌘⌥⇧G - Tile Grid (optimal grid layout 2x2, 2x3, etc.)
  • •⌘⌥← - Dock Left (move window to left half of screen)
  • •⌘⌥→ - Dock Right (move window to right half of screen)
  • •⌘⌥↑ - Dock Top (move window to top half of screen)
  • •⌘⌥↓ - Dock Bottom (move window to bottom half of screen)

Performance

  • •NSWindowDelegate integration for window move event tracking
  • •Real-time proximity detection during window drag operations
  • •Persistent user preference for magnetic snapping behavior
  • •Grid layout algorithm for optimal window arrangement
  • •Seamless integration with timestamp sync for complete workflow

Version 1.9.1

Feature Release
October 10, 2025

Highlights

  • Recent Files feature with File → Open Recent menu
  • Dynamic line number column width optimization
  • Date picker overlap fix in full screen mode

New Features

  • •Recent Files: File → Open Recent submenu with up to 10 recent files
  • •Persistent tracking across app restarts using UserDefaults
  • •Automatic file existence validation and cleanup
  • •"Clear Menu" option to remove all recent files
  • •Smart timestamp tracking (newest files first)
  • •User-friendly error handling for missing files
  • •Native macOS menu integration

Bug Fixes

  • •Dynamic line number column width: auto-calculates based on file size
  • •Optimal width formula: baseWidth (30pt) + (digitCount × 8pt)
  • •Date picker overlap fix: added 8pt top padding in full screen mode
  • •Performance optimized using visible entries only

User Interface

  • •Line number column now scales with file size (50-100pt range)
  • •Date picker no longer overlaps first table row
  • •Improved workflow with quick recent file access

Version 1.9.0

Feature Release
October 2025

Highlights

  • Column-specific search with persistent column selection
  • Search within selected columns for precise filtering
  • Visual feedback and improved search performance

New Features

  • •Column-specific search: choose which columns to search in (message, logger, level, timestamp, thread)
  • •Multi-column support: search across multiple columns simultaneously
  • •Persistent preferences: column selection saved across app sessions
  • •Visual feedback: badge indicator shows number of active search columns
  • •Smart defaults: prevents deselection of all columns (minimum 1 required)
  • •Universal compatibility: works with both text and regex search modes

User Interface

  • •Column selector menu button with checkboxes in search bar
  • •Badge number indicator showing active column count
  • •Clean visual integration with existing search UI
  • •Contextual help for column selection

Performance

  • •Improved search performance by limiting search scope to selected columns
  • •Optimized filtering logic for large log files
  • •Reduced search time for targeted column queries

Version 1.8.7

Feature Release
October 2025

Highlights

  • Clickable regex examples in help window
  • Clean Edit menu with only implemented commands
  • Improved user experience and workflow

New Features

  • •Clickable regex pattern examples in help window
  • •One-click copy to search field with automatic regex mode activation
  • •Visual feedback with clipboard icon indicator
  • •Hover cursor change for better UX
  • •Seamless workflow for trying out regex patterns

User Interface

  • •Clean Edit menu without grayed-out items
  • •Removed unused Undo, Redo, Cut, Copy, Paste menu items
  • •Professional appearance with only functional commands
  • •Edit menu now shows: Copy Selected Entries (⌘C), Copy All Filtered Entries (⌘⇧C)

Version 1.8.6

Feature Release
October 2025

Highlights

  • Date range filtering with From/To date pickers
  • Compressed file support (ZIP, GZIP, TAR.GZ)
  • Appearance mode switcher (Automatic/Light/Dark themes)
  • Search field enhancement with Enter-to-search mode

New Features

  • •Date range filtering with From/To date pickers for precise time-based filtering
  • •Automatic population of date range from log file timestamps
  • •Hour and minute precision for filtering with clear filter button
  • •Compressed file support: ZIP, GZIP, TAR.GZ archive extraction
  • •Automatic archive detection and extraction with ArchiveService
  • •Search field enhancement: dual modes (live search vs Enter-to-search)
  • •Toggle setting for search trigger preference with visual feedback
  • •Appearance mode switcher: Automatic, Light, or Dark theme selection

User Interface

  • •Calendar toggle button in toolbar for date filtering
  • •Collapsible date picker UI with time support
  • •Clear button (X) to reset date range filters
  • •Visual feedback for active/inactive date filtering state
  • •Search field visual indicators for current mode
  • •Theme picker in Settings with segmented control
  • •Improved Settings window layout with theme options

Performance

  • •Precise timestamp-based date filtering (not just day-based)
  • •Integration with existing filter cache system
  • •Preference persistence across app restarts
  • •Immediate theme switching without app restart
  • •Efficient archive extraction with progress tracking

File Format Support

  • •ZIP archive support with multiple file extraction
  • •GZIP compressed file support (.gz)
  • •TAR.GZ archive support (.tar.gz, .tgz)
  • •Automatic decompression with format detection
  • •Support for compressed log files of any size

Version 1.8.4

Feature Release
October 2025

Highlights

  • Configurable pagination with adjustable rows per page
  • Enhanced date filtering capabilities
  • Theme customization support

New Features

  • •Configurable pagination: adjust rows per page from 1,000 to 10,000
  • •Date range filter in toolbar with date and time selection
  • •Auto-population of date range from first/last log entry timestamps
  • •Date range validation: "To" date cannot be before "From" date
  • •Smart auto-adjustment when changing start date
  • •Appearance mode switcher: choose Automatic, Light, or Dark theme

User Interface

  • •Settings panel for pagination preferences with live preview
  • •Calendar toggle button in toolbar for date filtering
  • •Collapsible date picker UI (From/To) with time support
  • •Clear button to reset date range
  • •Visual feedback with active/inactive states
  • •Theme picker in Settings with segmented control
  • •Improved Settings window layout with better spacing
  • •Larger Settings window for better content visibility

Performance

  • •Live reload for all open windows when changing pagination settings
  • •Precise timestamp-based filtering (not just day-based)
  • •Preference persistence across app restarts
  • •Integration with existing filter cache system
  • •Immediate theme switching without app restart

Version 1.8.3

Bug Fix
October 2025

Highlights

  • Fixed App Sandbox entitlements for Mac App Store submission
  • Removed unnecessary network entitlements
  • Improved App Store compliance

Bug Fixes

  • •Removed network client and server entitlements for offline operation
  • •Fixed entitlements configuration for Mac App Store requirements

Version 1.8.2

Initial Release
October 2025

Highlights

  • Mac App Store initial release
  • Complete feature set for professional log analysis
  • Universal Binary for Apple Silicon and Intel

Core Features

  • •Multi-file timestamp synchronization
  • •Real-time log monitoring with live tail
  • •Advanced regex search with highlighting
  • •Unlimited file size support with 60fps performance
  • •Export to CSV, JSON, and TXT formats

User Interface

  • •SwiftUI-optimized pagination for large datasets
  • •Dynamic column width management
  • •Sortable table columns with persistence
  • •20+ keyboard shortcuts
  • •Professional macOS design language

Search & Filtering

  • •Regex pattern search with validation
  • •Search history with smart suggestions
  • •Multi-column search highlighting
  • •Log level filtering
  • •Logger name filtering

Performance

  • •Handles files of any size without performance degradation
  • •Pagination limits rendered rows to 1000 for responsive UI
  • •Async parsing prevents UI blocking
  • •Background file monitoring for live tail

File Format Support

  • •Log4j XML format parsing
  • •Log4j text format parsing
  • •Plain text fallback for unsupported formats
  • •Automatic format detection

Security & Privacy

  • •Completely offline operation
  • •No data collection or transmission
  • •All processing happens locally on your Mac
  • •App Sandbox enabled for security

Version 1.6.0

Major Update
September 2025

Highlights

  • Performance revolution with pagination optimization
  • SwiftUI-optimized solution for large datasets
  • Maintains full UI responsiveness regardless of file size

Performance

  • •Replaced chunked data processing with SwiftUI-optimized pagination
  • •Limits rendered rows to 1000 at a time for responsive UI
  • •Instant page switching without blocking UI thread
  • •Maintains full responsiveness for filtering and search operations

Version 1.4.2

Feature Release
August 2025

Highlights

  • Live tail functionality for real-time monitoring
  • Comprehensive unit testing framework
  • Enhanced reliability and stability

New Features

  • •Real-time file monitoring using GCD dispatch sources
  • •Automatic detection of file changes and new entries
  • •Background parsing of new log entries

Quality Assurance

  • •Comprehensive regex search functionality tests
  • •Search history management tests
  • •Performance testing for large datasets

Stay Updated

Log4j Analyzer is regularly updated with new features, performance improvements, and bug fixes. Updates are delivered automatically through the Mac App Store.

Download Latest VersionSend Feedback