CompareHistory

by xalteropsx ST3 New

A powerful file comparison and version history plugin for Sublime Text.

Labels diff, compare, comparison, version-history, side-by-side

Details

Version 1.0.0
Homepage github.com
Issues github.com
Modified 1 day ago
Last Seen 1 hour ago
First Seen 7 hours ago

Installs

Total 0
Win 0
Mac 0
Linux 0

	Jun 18	Jun 17	Jun 16	Jun 15	Jun 14	Jun 13	Jun 12	Jun 11	Jun 10	Jun 9	Jun 8	Jun 7	Jun 6	Jun 5	Jun 4	Jun 3	Jun 2	Jun 1	May 31	May 30	May 29	May 28	May 27	May 26	May 25	May 24	May 23	May 22	May 21	May 20	May 19	May 18	May 17	May 16	May 15	May 14	May 13	May 12	May 11	May 10	May 9	May 8	May 7	May 6	May 5
Windows	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0
Mac	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0
Linux	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0

Readme

Source: raw.githubusercontent.com

📊 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:

Compare​History