📝 Text Comparator

📖 Overview

What is Text Comparator?

Text Comparator is a professional tool for comparing two text files line-by-line, highlighting differences with color-coded visual markers. It's perfect for comparing code files, configuration files, log files, documentation, or any plain text content.

Key Features

• Line-by-Line Comparison: Precise difference detection at the line level
• Color-Coded Highlighting: Visual indicators for added, removed, and modified lines
• Side-by-Side View: Compare files with synchronized scrolling
• Search: Find text across both editors with case-sensitive option and Find Next navigation
• Drag & Drop: Easy file loading with drag-and-drop support
• View & Save: Preview files with the View button; save individual file contents to new locations
• Multiple Formats: Supports .txt, .log, .md, .csv, .json, .xml, and more

When to Use Text Comparator

• Compare different versions of source code files
• Review changes in configuration files
• Analyze log file differences
• Compare documentation versions
• Verify data file consistency
• Track changes in any plain text content

🚀 Getting Started

Quick Start Guide

1. Load Your Files
   Use the Browse buttons or drag & drop your text files into the File 1 and File 2 fields.
2. Compare
   Click the "Compare" button to analyze differences between the files.
3. Review Results
   Examine the color-coded differences in the side-by-side editor view.
4. Export (Optional)
   Save the comparison results using the "Export to File" button if needed.

Supported File Formats

Text Comparator works with any plain text file format, including:

• .txt - Plain text files
• .log - Log files
• .md - Markdown files
• .csv - Comma-separated values
• .json - JSON data files
• .xml - XML configuration files
• .ini, .cfg, .conf - Configuration files
• .py, .js, .java, .c, .cpp - Source code files
• And many more! - Any UTF-8 encoded text file

🎨 Interface Guide

Main Window Layout

1. File Selection Area (Top)

• File 1 Field: Path to the first file (original/old version)
• File 2 Field: Path to the second file (modified/new version)
• Browse Buttons: Open file browser to select files
• Drag & Drop Support: Drop files directly into the fields

2. Control Buttons (Middle)

• Compare Files: Run the comparison analysis
• View File 1 / View File 2: Preview files in your default application
• Reset All: Clear both editors and file paths
• Save File 1 / Save File 2: Save edited file contents to a new location
• Search Field + Find Next: Search for text across both editors with case-sensitive option
• Show Line Numbers: Toggle line number display (on by default)
• Highlight Differences: Toggle color-coded highlighting (on by default)

3. Editor View (Main Area)

• Left Editor: Displays File 1 (original) with color-coded differences
• Right Editor: Displays File 2 (modified) with color-coded differences
• Line Numbers: Shows line numbers for easy reference
• Synchronized Scrolling: Both editors scroll together

4. Output Area (Bottom)

• Displays text-based comparison summary
• Lists all detected differences with line numbers
• Shows statistics: lines added, removed, modified

5. Menu Bar

• File: Open files, export results, exit
• Edit: Find, replace, and editor operations
• Help: User guide, What's New, About

🔍 Understanding Differences

Color Coding System

Text Comparator uses three colors to highlight different types of changes:

How Comparison Works

Text Comparator uses a sophisticated line-by-line diff algorithm to identify changes:

1. Line Extraction: Both files are split into individual lines
2. Sequence Matching: Lines are compared to find matching sequences
3. Difference Detection: Non-matching lines are identified as changes
4. Classification: Changes are classified as added, removed, or modified
5. Visual Highlighting: Color codes are applied to the editors

Reading the Output

The output area shows a text summary of all differences:

• Line Numbers: Indicates where changes occur
• Change Type: Shows if line was added, removed, or modified
• Content: Displays the actual text that changed
• Statistics: Summary of total changes detected

⚙️ Features

Search

The inline search field lets you find text across both editors simultaneously.

• Case Sensitive: Toggle case-sensitive matching with the checkbox
• Find Next: Navigate through search results in both editors
• Inline Search Bar: Type directly in the search field in the controls area

Save Files

Save individual file contents after editing:

• Save File 1 / Save File 2: Save the contents of either editor to a new file
• Browse for output location before saving
• Useful for saving manually merged or edited results

Synchronized Scrolling

Both editor panes scroll together automatically, making it easy to compare corresponding sections of your files. When you scroll one editor, the other follows.

Line Numbers

Line numbers are displayed on the left side of each editor, making it easy to:

• Reference specific lines in discussions
• Navigate to exact locations
• Understand file structure
• Track changes precisely

📋 Common Workflows

Workflow 1: Compare Code Changes

1. Load your original source code file as File 1
2. Load the modified version as File 2
3. Click Compare to see all code changes
4. Review green (added) and red (removed) lines
5. Export results to document changes

Workflow 2: Review Configuration Changes

1. Load production config file as File 1
2. Load updated config file as File 2
3. Run comparison
4. Verify all configuration changes are intentional
5. Use Find to search for specific settings

Workflow 3: Compare Log Files

1. Load log file from first time period as File 1
2. Load log file from second time period as File 2
3. Compare to identify new errors or warnings
4. Look for green lines showing new log entries
5. Export differences for troubleshooting

Workflow 4: Merge Changes

1. Load both versions of your file
2. Run comparison to see differences
3. Use Find & Replace to update specific sections
4. Copy desired content between editors manually
5. Save your merged result from the editor

💡 Tips & Best Practices

File Preparation

• Use UTF-8 Encoding: Ensure files are saved in UTF-8 for best compatibility
• Consistent Line Endings: Use same line ending style (LF or CRLF) in both files
• Remove Unnecessary Whitespace: Trailing spaces can cause false differences
• Backup Important Files: Always keep backups before making changes

Efficient Comparison

• Start with Small Files: Test with smaller files first to understand output
• Use Descriptive Names: Name your files clearly (e.g., config_old.txt, config_new.txt)
• Review Line by Line: Don't rush through differences—examine each change
• Export Important Comparisons: Save results for documentation purposes

Working with Large Files

Understanding False Differences

Some apparent differences may not be meaningful:

• Whitespace Variations: Spaces vs. tabs, or trailing whitespace
• Line Endings: Windows (CRLF) vs. Unix (LF) line endings
• Encoding Issues: Different character encodings can cause problems
• Invisible Characters: BOM markers or other non-visible characters

🔧 Troubleshooting

Common Issues & Solutions

Q: File won't load or shows error

A: Check that:

• File exists at the specified path
• File is a plain text format (not binary)
• You have read permissions for the file
• File is not locked by another application
• File path doesn't contain special characters

Q: Text appears garbled or has strange characters

A: This is likely an encoding issue:

• File may not be UTF-8 encoded
• Try opening file in a text editor and saving as UTF-8
• Check if file contains binary content (images, executables)
• Some character encodings are not fully supported

Q: Comparison shows too many differences

A: Possible causes:

• Files have different line endings (CRLF vs LF)
• One file has extra whitespace at line ends
• Files are fundamentally different versions
• Check if you selected the correct files

Q: Application is slow or unresponsive

A: For large files:

• Close other applications to free up memory
• Consider splitting very large files
• Ensure you have sufficient disk space
• Wait for comparison to complete—it may take time

Q: Can't see all differences

A: Try these solutions:

• Scroll through both editors carefully
• Check the output area for complete list of changes
• Use Find feature to search for specific content
• Export results to review in external editor

Q: Export doesn't work

A: Verify that:

• You have write permissions for the output location
• Output path is valid and accessible
• Disk has sufficient free space
• Output file isn't open in another application

⌨️ Keyboard Shortcuts

Essential Shortcuts

Navigation

• ↑ ↓ - Navigate through text line by line
• Page Up Page Down - Scroll one page at a time
• Home - Move to start of line
• End - Move to end of line
• Ctrl+Home - Move to start of file
• Ctrl+End - Move to end of file

⚠️ Limitations

What Text Comparator Can Do

• ✅ Compare any plain text files
• ✅ Detect line-level differences
• ✅ Handle files with different line endings
• ✅ Support UTF-8 encoded text
• ✅ Work with code, logs, configs, and more

What Text Comparator Cannot Do

• ❌ Compare binary files (executables, images, etc.)
• ❌ Detect character-level differences within lines
• ❌ Merge files automatically
• ❌ Understand semantic meaning of code
• ❌ Resolve conflicts automatically
• ❌ Handle all possible character encodings

For Other File Types

If you need to compare other types of files, consider these FileForge tools:

• Excel Comparator - For spreadsheet files (.xlsx, .csv)
• PDF Comparator - For PDF documents
• Image Comparator - For image files