CompareHistory

by xalteropsx ST3

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 4 months ago
Last Seen 2 hours ago
First Seen 4 months ago

Installs

Total 88
Win 59
Mac 17
Linux 12

	Oct 4	Oct 3	Oct 2	Oct 1	Sep 30	Sep 29	Sep 28	Sep 27	Sep 26	Sep 25	Sep 24	Sep 23	Sep 22	Sep 21	Sep 20	Sep 19	Sep 18	Sep 17	Sep 16	Sep 15	Sep 14	Sep 13	Sep 12	Sep 11	Sep 10	Sep 9	Sep 8	Sep 7	Sep 6	Sep 5	Sep 4	Sep 3	Sep 2	Sep 1	Aug 31	Aug 30	Aug 29	Aug 28	Aug 27	Aug 26	Aug 25	Aug 24	Aug 23	Aug 22	Aug 21	Aug 20
Windows	0	0	2	1	1	0	1	0	1	2	0	1	1	1	0	0	0	0	2	0	0	4	0	0	2	1	0	4	1	0	1	1	3	0	0	0	0	1	0	0	0	0	1	0	0	0
Mac	0	0	1	0	0	0	1	0	0	1	1	0	1	0	0	0	0	0	0	0	0	0	0	1	0	0	0	0	0	0	0	0	0	1	1	1	0	0	1	0	0	0	0	0	0	1
Linux	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	1	0	0	0	0	0	0	0	0	1	0	0	2	0	0	0	0	1	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