CompareHistory
A powerful file comparison and version history plugin for Sublime Text.
By
xalteropsx
Created
Installations minus removals
Upgrades
- 18 installs
Links
Version
1.0.0
(>ST3142)
·
📊 CompareHistory
A powerful file comparison and version history plugin for Sublime Text.
📖 Description
CompareHistory combines side-by-side file comparison with automatic version history tracking. Every time you save a file, a version is stored. You can compare any two versions, see differences highlighted, and navigate through changes easily.
🙏 Thanks
Inspired by Compare Side-By-Side – thanks to kaste!
✨ Key Features
- 📊 Side-by-Side Comparison – Compare files, selections, or versions
- 💾 Automatic Version History – Saves versions on every save (configurable limit)
- 🎨 Color Highlighting – Red = removed, Green = added, with intra-line diff support
- 🔄 Synchronized Scrolling – Both panes scroll together
- 📂 Project-Aware – Versions stored per project folder
- ⚡ Fast Grid View – Compare up to 6 versions simultaneously
⌨️ Key Bindings
| Command | Keybinding |
|---|---|
| Show Version History | Ctrl+Shift+V |
| Clear File History | Ctrl+Shift+Delete |
| Settings | Ctrl+Shift+, |
Existing Commands only Active in Compare View
| Command | Keybinding |
|---|---|
| Next Difference | Ctrl+Shift+N |
| Previous Difference | Ctrl+Shift+P |
🖱️ Context Menu
Right-click anywhere in a file to access:
| Menu Item | Description |
|---|---|
| Compare with Tab | Compare current file with another open tab |
| Compare Selections | Compare two selected text blocks |
| Mark Target Selection | Mark current selection for later comparison |
| Compare with Active View | Compare with view in other group |
| Compare with Last View | Compare with last compared file |
| Next / Previous | Navigate between differences |
| Show Version History | View and compare all saved versions |
| Clear File History | Delete all versions for current file |
| Settings | Configure plugin |
🛠️ Settings
Access via Ctrl+Shift+, or menu: Preferences → Package Settings → CompareHistory
Available Settings
| Setting | Description | Default |
|---|---|---|
versioned_history_base |
Where to store version history | ~/.cache |
versioned_history_limit |
Max versions to keep per file | 10 |
| Setting | Description | Editable |
|---|---|---|
read_only |
Make comparison views read-only | false |
ignore_whitespace |
Ignore spaces when comparing | false |
ignore_case |
Case-insensitive comparison | false |
ignore_pattern |
Regex pattern to ignore | "" |
outlines_only |
Show outlines instead of filled regions | true |
hide_sidebar |
Hide sidebar in comparison window | false |
hide_menu |
Hide menu bar | false |
hide_minimap |
Hide minimap | false |
hide_status_bar |
Hide status bar | false |
hide_tabs |
Hide tabs | false |
display_prefix |
Prefix for view names | "" |
line_count_popup |
Show diff count in popup | false |
How to Enable CompareHistory Key Settings
[
{ "keys": ["ctrl+shift+v"], "command": "ch_show_version_history" }, // Show all saved versions for current file
{ "keys": ["ctrl+shift+delete"], "command": "ch_clear_file_history" }, // Delete all version history for current file
{ "keys": ["ctrl+shift+,"], "command": "ch_versioned_hx_settings" }, // Open CompareHistory settings
{ "keys": ["ctrl+shift+n"], "command": "ch_next_diff" }, // Jump to next difference in compare view
{ "keys": ["ctrl+shift+p"], "command": "ch_prev_diff" }, // Jump to previous difference in compare view
{ "keys": ["ctrl+shift+t"], "command": "ch_compare" }, // Compare with another open tab
{ "keys": ["ctrl+shift+l"], "command": "ch_compare", "args": {"last_selections": true} }, // Compare with last viewed file
{ "keys": [], "command": "ch_compare", "args": {"compare_selections": true} }, // Compare two selected text blocks
{ "keys": [], "command": "ch_mark_sel" }, // Mark current selection for later comparison
{ "keys": [], "command": "ch_compare", "args": {"with_active": true} } // Compare with active view in other group
]
- Open Command Palette (
Ctrl+Shift+P) - Type
Preferences: Key Bindings - Copy the desired line
- Save the file
📁 Storage Location
Versions are stored at: