{"id":13448206,"url":"https://github.com/vishr/local-history","last_synced_at":"2025-05-07T04:06:56.319Z","repository":{"id":2984782,"uuid":"4000821","full_name":"vishr/local-history","owner":"vishr","description":"A Sublime Text 2/3 plugin for maintaining local history of files. [backup | open | compare | incremental diff]","archived":false,"fork":false,"pushed_at":"2017-10-27T23:28:19.000Z","size":297,"stargazers_count":228,"open_issues_count":18,"forks_count":21,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-05-07T04:06:49.762Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://vishr.com/local-history","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"memamdie/StudyIt","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vishr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-04-12T03:02:36.000Z","updated_at":"2025-01-26T23:20:06.000Z","dependencies_parsed_at":"2022-08-20T10:20:43.853Z","dependency_job_id":null,"html_url":"https://github.com/vishr/local-history","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vishr%2Flocal-history","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vishr%2Flocal-history/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vishr%2Flocal-history/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vishr%2Flocal-history/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vishr","download_url":"https://codeload.github.com/vishr/local-history/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252810273,"owners_count":21807759,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T05:01:38.810Z","updated_at":"2025-05-07T04:06:56.285Z","avatar_url":"https://github.com/vishr.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Local History\n\n[![GitHub license](https://img.shields.io/github/license/vishr/local-history.svg?style=flat-square)](https://github.com/vishr/local-history/tree/master/LICENSE.md)\n[![Total downloads via Package Control](https://img.shields.io/packagecontrol/dt/Local%20History.svg?style=flat-square)](https://packagecontrol.io/packages/Local%20History)\n[![Monthly downloads via Package Control](https://img.shields.io/packagecontrol/dm/Local%20History.svg?style=flat-square)](https://packagecontrol.io/packages/Local%20History)\n\n\nA [Sublime Text](https://www.sublimetext.com) package for maintaining a local history of files.\n\n## Benefits\n\n* Every time you modify a file, a copy of the old contents is kept in the local history when you:\n  * open the file.\n  * close the file.\n  * and/or loose focus.\n* Available functions are:\n  * file comparison of the open file and any of its older versions from the history.\n  * incremental diff view.\n* Functions are available via:\n  * the right-click context menu.\n  * the `Local History: ...` commands from the command palette.\n* `Local History` helps you out when you change or delete a file by accident.\n* `Local History` can help you out when your workspace has a catastrophic problem or if you get disk errors that corrupt your workspace files.\n* File revisions are stored in separate files (with full path):\n\t* see the [Local History path](#local-history-path) section below\n\n## Installation\n\n* Via [Package Control](https://www.packagecontrol.io):\n  * [Install Package Control](https://www.packagecontrol.io/installation)\n  * Open the command palette (\u003ckbd\u003eCtrl\u003c/kbd\u003e\u003ckbd\u003eShift ⇧\u003c/kbd\u003e\u003ckbd\u003eP\u003c/kbd\u003e)\n  * Choose `Package Control: Install Package`\n  * Search for `Local History` and select to install.\n* Clone the repo: `git clone git://github.com/vishr/local-history.git \"Local History\"` into your [Sublime Text](https://www.sublimetext.com) Packages directory.\n  * via HTTPS: `https://github.com/vishr/local-history.git`\n  * via SSH: `git@github.com:vishr/local-history.git`\n* current snapshot of master\n  * [current snapshot of master as *.zip](https://github.com/vishr/local-history/archive/master.zip)\n    * Download the zip-file, unpack it and then re-zip the contents of the `Local History` subdirectory. Rename `Local History.zip` to `Local History.sublime-package` and move it to your `Installed Packages` subdirectory of your [Sublime Text](https://www.sublimetext.com) installation. On Linux this is `~/.config/sublime-text-2/` or `~/.config/sublime-text-3/`.\n  * [current snapshot of master as *.tar.gz](https://github.com/vishr/local-history/archive/master.tar.gz)\n\n### Settings\n\n#### Default settings\n\n```js\n    \"history_retention\": 0, // number of days to keep files, 0 to disable deletion\n    \"format_timestamp\": \"%Y%m%d%H%M%S\", // file_name-XXXXXXXX.file_extension\n    \"history_on_close\": true, // only save LocalHistory after closing a file, not when original was saved\n    \"history_on_focus_lost\": false,\n    \"history_on_load\": true,\n//  \"history_path\": \"\",\n    \"portable\": true,\n    \"file_size_limit\": 4194304 // 4 MB\n```\n\n#### Local History path\n\n[Local History](https://github.com/vishr/local-history)'s target directory for file revisions can be set as follows:\n\n* For `\"portable\": true`, [Local History](https://github.com/vishr/local-history) will save to `Sublime Text/Data/.sublime/Local History/...` wherever [Sublime Text](https://www.sublimetext.com) is installed.\n* Setting `\"portable\": false` will change the target folder to the `~/.sublime/Local History/...` subfolder of your user directory.\n  * If `\"portable\": false` changing `\"history_path\": \"...\"` will give you the option to change the target directory to a custom path.\n\n## Usage\n\n\u003cimg src=\"https://raw.githubusercontent.com/vishr/local-history/master/docs/context-menu.png\" alt=\"Context Menu\" width=\"350\" height=\"300\"\u003e\n\n* Functions are available via:\n  * the right-click context menu.\n  * the `Local History: ...` commands from the command palette.\n\n\u003cimg src=\"https://raw.githubusercontent.com/vishr/local-history/master/docs/tools-menu.png\" alt=\"Tools Menu\" width=\"400\" height=\"320\"\u003e\n\n* To permanently delete all history files, choose `Tools \u003e Local History \u003e Delete Local History \u003e Permanently delete all`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvishr%2Flocal-history","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvishr%2Flocal-history","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvishr%2Flocal-history/lists"}