Localization Comparison Tool v2.0.0

2.0.0 - 2026-01-09

🌍 Complete Localization

• 15 languages supported — English, Spanish, French, German, Italian, Portuguese (Brazil), Turkish, Japanese, Korean, Russian, Chinese (Simplified), Arabic, Hindi
• Auto-detect language — App automatically uses your system language

🎨 Major UI/UX Overhaul

Advanced Diff View

• Side-by-side diff viewer with synchronized scrolling
• Character-level diff highlighting showing exact changes within lines
• Filter badges for Added/Removed/Modified with click-to-toggle
• Minimap overview bar for quick navigation in large diffs
• Reviewed row visual feedback — dimmed styling for reviewed entries
• Inline editing — Edit translations directly in the table
• Translation Memory integration — Add entries to TM from diff view

User Onboarding

• Interactive checklist guiding new users through key features
• Step-by-step progress with visual feedback
• Sample data loading for quick exploration

Git Comparison

• Enhanced visual hierarchy with branch/repo icons on selectors
• Prominent file status indicators with color-coded strips
• Consistent styling matching the Directory Comparison view

Settings & Polish

• Collapsible sections for dense settings areas
• Contextual tooltips explaining settings like Auto-Backup and Protocol Handler
• Status indicators showing last backup time and registration status
• Section header icons for faster scanning
• Live preview for diff color customization

Empty States

• Rich empty states for all comparison pages with helpful guidance
• Recent comparisons section on empty views
• File type chips showing supported formats
• Gradient icon styling with dynamic accent colors

History View

• Distinct icons for Git vs Directory comparisons
• Relative timestamps ("2 hours ago" format)
• Enhanced metadata display with repository names and branches

🖥️ Windows Integration

• Professional installer — Inno Setup with multi-language support
• Portable version — No installation required
• File associations — .arb, .xliff, .tmx files open in app
• Protocol handler — localizer:// URLs supported
• Updated branding — "Localization Comparison Tool" by Alp Yalay
• New app icon — Modern side-by-side comparison design
• Windows metadata — Proper file properties and Task Manager display

🤖 AI Translation

• Multiple providers — Google Translate, DeepL, OpenAI, Gemini
• Batch translation — Translate multiple entries at once
• Translation suggestions — AI-powered suggestions for empty entries
• Rephrase feature — Get alternative phrasings for existing translations
• Context awareness — Include surrounding strings for better translations
• Usage tracking — Monitor API usage and estimated costs

🔧 Technical Improvements

• Unified terminology — Consistent "Source/Target" naming throughout
• Search bar repositioning — Moved to left sidebar for discoverability
• Visual noise reduction — Subtle status bars instead of loud badges
• Micro-interactions — Hover states and subtle animations
• Performance optimizations — Faster file loading and comparison

🐛 Bug Fixes

• Fixed history not displaying after Git/Directory comparisons
• Fixed Git history navigation from Recent section
• Fixed overflow issues in Advanced Diff grid columns
• Resolved comparison details modal scannability issues
• Fixed settings widget parameter issues
• Fixed translation key generation for all languages

---

1.0.0 - 2025-06-26

🚀 Initial Flutter Release

Complete rewrite from Python/Flet to Flutter for native desktop performance.

Core Features

• 10x performance improvement over Python version
• Native Windows compilation with AOT
• Material Design 3 interface
• Light/Dark/AMOLED themes with custom accent colors

Comparison Engine

• File comparison with Added/Removed/Modified detection
• Directory comparison with smart file matching
• Similarity analysis for modified strings
• Real-time search and filtering

File Format Support

• JSON, ARB, XML, XLIFF, TMX, CSV, YAML, Properties, RESX

Productivity Features

• Drag & drop file support
• Auto-reload file watching
• Comparison history with session tracking
• CSV export for documentation

Desktop Integration

• Single instance enforcement
• Window position/size persistence
• Custom title bar
• Mica/Acrylic effects (Windows 11)

---

Localization Comparison Tool v1.0.0 - Official Release

🎉 Localization Comparison Tool v1.0.0 - Official Release

🚀 Complete Flutter Rewrite - Native Desktop Performance

I'm excited to announce the official release of the Localization Comparison Tool v1.0.0! This is a complete ground-up rewrite from Python/Flet to Flutter, delivering native desktop performance and a modern Material Design 3 interface.

---

📦 Download Options

🏆 Recommended: Professional Installer

LocalizerApp 1.0.0 Setup.exe (10.61 MB)

• ✅ Professional Windows installer with wizard interface
• ✅ Start Menu shortcuts and optional Desktop icon
• ✅ File associations for all supported localization formats
• ✅ Proper Windows integration and easy uninstall
• ✅ Perfect for end users and professional environments

💼 Portable Package

LocalizerApp 1.0.0 Portable (0.06 MB)

• ✅ No installation required - extract and run
• ✅ Self-contained with all dependencies included
• ✅ USB drive compatible for on-the-go usage
• ✅ Perfect for testing and temporary usage

---

✨ What's New in v1.0.0

🔥 10x Performance Improvement

• Native Desktop Compilation: Flutter AOT compilation delivers dramatically faster performance than the previous Python version
• Background Processing: Large file operations no longer block the UI
• Memory Optimized: Efficient data structures handle massive datasets smoothly
• Instant Startup: Lightning-fast application launch and file loading

🎨 Modern Material Design 3 Interface

• Beautiful UI: Clean, professional interface following latest design guidelines
• Advanced Theming: Light, Dark, and Amoled modes with customizable accent colors
• Responsive Design: Optimized for different screen sizes and resolutions
• Smooth Animations: 60fps performance with professional visual feedback

🚀 Revolutionary Features

Drag & Drop File Support

• Simply drag localization files from your desktop directly into the application
• Instant file validation and format detection
• Visual feedback for supported and unsupported file types

Auto-Reload File Watching

• Monitors source files for changes in real-time
• Automatically recompares files when they're modified on disk
• Perfect for active development workflows
• Visual indicators show when files are being watched

Enhanced File Format Support

• JSON - Standard JSON localization files
• XML - Android strings.xml and generic XML
• XLIFF (.xliff, .xlf) - Translation industry standard
• TMX - Translation Memory eXchange format
• CSV - Comma-separated values
• YAML (.yaml, .yml) - Configuration files
• Properties - Java properties files
• RESX - .NET resource files
• TXT - Plain text files
• DOCX - Microsoft Word documents
• LANG - Android language files

📊 Advanced Comparison Engine

Intelligent Diff Detection

• Smart algorithm identifies Added, Removed, and Modified entries
• Similarity analysis shows how much modified strings have changed
• Advanced filtering by change type and similarity levels
• Real-time search within comparison results

Large Dataset Support

• Handle files with 10,000+ keys without performance degradation
• Smart pagination system for smooth navigation
• Background processing prevents UI freezing
• Memory-efficient data structures

Professional Export Capabilities

• Export comparison results to CSV for documentation
• Maintain full comparison metadata
• Perfect for team collaboration and reporting

🏢 Enterprise-Ready Features

Comparison History

• Automatic session tracking with full metadata
• Revisit previous comparisons instantly
• Export and document comparison workflows
• Perfect for audit trails and team collaboration

---

🚀 Quick Start Guide

Installation (Recommended)

1. Download Localization Comparison Tool Setup
2. Run the installer as Administrator
3. Follow the installation wizard
4. Launch from Start Menu → "Localization Comparison Tool"

Portable Usage

1. Download Localization Comparison Tool Portable
2. Extract to any folder
3. Run LocalizerApp.exe

First Comparison

1. Select Files: Use Browse buttons or drag & drop your source and target files
2. Compare: Click "Compare Files" to analyze differences
3. Explore Results: Use Basic view for overview, Advanced view for detailed analysis
4. Filter Results: Use Added/Removed/Modified filters to focus on specific changes

---

🔧 Advanced Features

Auto-Reload Workflow

Perfect for active development:

1. Enable "Auto-reload" in Settings
2. Select your localization files
3. Edit files in your preferred editor
4. Watch automatic recomparison as you save changes

Large File Optimization

For files with thousands of entries:

• Automatic pagination prevents UI lag
• Background processing keeps interface responsive
• Smart memory management handles massive datasets
• Progress indicators show processing status

Professional Export

Generate reports for teams:

• Export to CSV with full metadata
• Include similarity scores for modified entries
• Perfect for project documentation
• Share results with stakeholders

---

🆚 Migration from Previous Version

Performance Improvements

• Startup Time: 3.2s → 0.8s (4x faster)
• File Parsing: 2.1s → 0.3s (7x faster) for 1000-key files
• UI Responsiveness: No more freezing, smooth 60fps
• Memory Usage: 150MB → 45MB (3x more efficient)
• Large File Handling: 5000+ keys smooth (previously caused crashes)

New Capabilities

• ✅ Drag & drop file selection
• ✅ Auto-reload file watching
• ✅ Advanced theming system
• ✅ Professional Windows integration
• ✅ Large dataset pagination
• ✅ Background processing
• ✅ Smooth animations throughout

Maintained Features

• ✅ All previous file format support
• ✅ Comparison algorithms (improved)
• ✅ Export capabilities (enhanced)
• ✅ History tracking (redesigned)
• ✅ Settings management (expanded)

---

🛡️ Security & Quality

Clean Build

• ✅ Fresh build with no development artifacts
• ✅ No embedded comparison history
• ✅ Optimized for end-user distribution
• ✅ Clean database initialization

Code Quality

• ✅ Professional BLoC state management architecture
• ✅ Comprehensive error handling
• ✅ Type-safe Dart implementation
• ✅ Extensive testing coverage
• ✅ Clean, maintainable codebase

Distribution

• ✅ All dependencies included
• ✅ No external runtime requirements
• ✅ Professional installer with metadata

---

📞 Support & Community

Getting Help

• Issues: GitHub Issues
• Documentation: Complete README.md with examples
• Discussions: GitHub Discussions

Contributing

• Source Code: Open source under MIT License
• Bug Reports: Always welcome with reproduction steps
• Feature Requests: Share your localization workflow needs
• Pull Requests: Code contributions encouraged

---

📋 Technical Details

• Version: 1.0.0
• Build Date: June 26, 2025
• Framework: Flutter 3.32.1
• Language: Dart 3.8.0
• Platform: Windows x64
• Installer: Inno Setup 6.4.1
• License: MIT License
• Repository: GitHub

Localization Comparison Tool v0.5.0

Patch Notes

Overview

---

Public-Facing Features & Improvements

User Interface Improvements

• Flet GUI Enhancements:
  • Updated the graphical interface in GUI/flet_gui.py with new imports and rearranged components for improved clarity.
• Theming and Dialog Updates:
  • Refined theming support with dynamic mode selection (system, dark, light, AMOLED) and updated color schemes.
  • Added improved snack bar notifications.
• Updated Settings Page:
  • Redesigned settings page with a modern look and enhanced usability.
• New Comparison History Page:
  • Introduced a comparison history page featuring:
    • Enhanced statistics.
    • A view details feature that supports simple comparison.
    • Raw output along with dates and times for better traceability.
• Improved Localization Comparison:
  • Modernized file input components and results views for comparing localization files.
  • Features include file previews, line numbers, and grouping by namespace.
  • Clear visual indicators for added, removed, or modified translation strings.

---

Technical Changes & Internal Refactoring

Project Structure & Import Refactoring

• Code Reorganization:
  Moved constants, configuration, and theme definitions into a new core/ module. Updated imports in files such as GUI/flet_gui.py and logic.py for better maintainability.

GitHub Actions & Workflow Updates

• Workflow Enhancements:
  • Renamed “Python application” workflow to “Test”.
  • Upgraded checkout and setup actions (from v2/v3 to v4).
  • Added a dedicated tests.yml for multi-version testing and coverage uploads.
• Gitignore Update:
  Introduced a new .gitignore file to exclude build artifacts, caches, and temporary files.

Code Cleanup and Optimizations

• Removed Deprecated Files:
  • Eliminated old files like launch.json, __pycache__ binaries, and GUI/xml_parser.py.
• Performance Improvements:
  • Integrated asynchronous file operations through a caching service to enhance responsiveness.
  • Updated error handling, progress reporting, and UI refresh procedures during file comparisons.

Expanded CLI and UI Components

• CLI Modularization:
  Moved CLI-related code into the cli/ folder with updated import paths.
• New UI Components:
  Added components such as HistoryDialogComponent and OnboardingTutorial with improved styling and animations.

Configuration and Themability

• Settings Dialog Overhaul:
  • Refactored the settings dialog in components/settings_dialog.py to include modern tab-based navigation, progress indicators, and quick theme-change buttons.
  • Enhanced configuration management via the ConfigManager to ensure a consistent look and feel across the application.

Enhanced CI/CD and Testing

• Revamped GitHub Actions Workflows:
  • Upgraded to the latest versions (e.g. checkout v4, setup-python v4).
  • Integrated new linting jobs using flake8 and pylint.
  • Introduced multi-version testing and a dedicated tests workflow with automated coverage reports.

---

Download Options

• Installer:
  You can download the installer for a seamless setup.

• Executable ZIP:
  Alternatively, download the executable ZIP file which contains the main executable and an _internal file.
  Note: After downloading, you'll need to create a shortcut manually to launch the application (deleting _internal breaks the .exe).

Localization Comparison Tool v0.4

Full Changelog: https://github.com/KhazP/LocalizerAppMain/commits/v0.4

Created an Installer for Localization Comparison Tool.

Localization Comparison Tool v0.3.1

Fixed errors with app compiling, and added a new requirement inside readme.md.

Please install Git before launching the application.

Localization Comparison Tool v0.3

v0.3 - Feature Expansion & Core Improvements

What's New:
🎨 Enhanced Theme System

• Added custom theme presets (AMOLED, High Contrast, Minimalist, Earth Tones, Pastel)
• Improved theme management and persistence
• Added theme preview in settings

⚙️ Configuration System

• Introduced ConfigManager for persistent user settings
• Added support for custom ignore patterns
• Implemented configuration auto-save

🔍 Parser Improvements

• Enhanced XML/CSV format detection
• Added better support for mixed content files
• Improved error handling and reporting

📊 Results Display

• Added expand/collapse functionality for results
• Improved results organization and readability
• Enhanced copy functionality

🎯 Accessibility Features

• Added keyboard navigation support
• Improved high contrast mode
• Added font size scaling options

🛠️ Technical Improvements

• Optimized file loading performance
• Reduced memory usage
• Improved error logging system
• Clean build system for executable creation

🐛 Bug Fixes

• Fixed center alignment of main title
• Resolved file drag & drop issues
• Fixed console window appearing with executable

Localization Comparison Tool v0.2

v0.2 - UI Modernization & Themes

What's New

• 🎨 Modernized UI with Flet framework

  • Cleaner layout
  • Fixed header alignment issue

• 🌓 Theme System

  • Added Light/Dark mode themes.
  • Improved color consistency across UI elements

• 🔧 Settings Dialog

  • New dedicated settings panel
  • Added format preferences
  • Improved ignore pattern configuration
  • Better organization of comparison options

• 📊 Enhanced File Handling

  • More reliable XML/CSV auto-detection
  • Better error handling for different file formats
  • Added support for mixed format comparisons

Installation

Download the latest executable from the releases page or compile from source following the README instructions.

Localization Comparison Tool v0.1

v0.1

First Release of Localization Comparison Tool

This initial release introduces a modern, user-friendly tool for comparing localization files. Built with Flet, the app offers a responsive interface and robust features to help you manage and compare CSV, .lang, and .txt files with ease.

Key Features

• Modern UI with Flet
  Enjoy a clean, responsive interface with support for dark/light mode.

• File Comparison
  Compare source and target localization files with detailed results and syntax highlighting for added and removed entries.

• Customizable Themes
  Easily switch between dark, light, and system themes using the settings dialog.

Improvements & Fixes

• Centered header title to ensure the "Localization Comparison Tool" text is displayed prominently.
• Enhanced file parsing logic to better handle CSV and XML content.
• Refined settings dialog for a smoother theme customization experience.

Enjoy using the Localization Comparison Tool! Your feedback and contributions are welcome.