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.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.