SublimeText - File History

Sublime Text 2 and 3 plugin to provide access to the history of accessed files - project-wise or globally. Stores data in a JSON file. The most recently closed file can be instantly re-opened with a keyboard shortcut or the user can search through the entire file history within the quick panel (including file preview and the ability to open multiple files).

Features

Keeps a history of the files that you have accessed in SublimeText (on both a per-project and global level). The most recently closed file can be instantly re-opened with a keyboard shortcut or the user can search through the entire file history in the quick panel.

Overview of features:

• Settings file to customize the functionality.
  • Important: You will need to restart Sublime Text after editing the settings file (because the settings are cached by the Sublime Text API).
• When re-opening a file from the history, choose the position to open it in: the first tab, the last tab, the next tab or in the position that it was when it was closed
• Display a preview of the file while looking through the file history in the quick panel (only Sublime Text 3)
• Choose target location where the file history should be saved
• Optionally remove any non-existent files while looking through the file history (when previewed or opened)
• Optionally clean up the history on start-up
• Optionally display the quick panel entries with a monospaced font
• Open multiple history entries from the quick panel with the right key

Originally obtained from a gist by Josh Bjornson.

Installation

With Package Control: Once installed, bring up the Command Palette (Command-Shift-P on OS X, Ctrl-Shift-P on Linux/Windows). Select Package Control: Install Package and then select File History when the list appears. Package Control will automagically keep the plugin up to date with the latest version.

Without Git: Download the latest source from GitHub (.zip) and copy the folder to your Sublime Text "Packages" directory (you might want to rename it to "File History" before).

With Git: Clone the repository in a subfolder "File History" in your Sublime Text "Packages" directory:

git clone git://github.com/FichteFoll/sublimetext-filehistory.git

The "Packages" directory (for ST2) is located at:

• Linux: ~/.config/sublime-text-2/Packages/
• OS X: ~/Library/Application Support/Sublime Text 2/Packages/
• Windows: %APPDATA%/Sublime Text 2/Packages/

Or enter

print(sublime.packages_path())

into the console (Ctrl-`).

Usage

To use the plugin, open the Command Palette and search for File History:.

For default keymap definitions, see Default.sublime-keymap (OSX).

For the default settings, see FileHistory.sublime-settings.

Images

The popup for the current project only

The popup for the global history with text

Commands

open_recently_closed_file (Window)

Opens a popup with recently closed files or reopens the lastly closed view if show_quick_panel == False.

Parameters

• show_quick_panel (bool) - Default: True

• current_project_only (bool) - Default: True

cleanup_file_history (Window)

Checks the current project or the whole history for non-existent files and removes them from the history kept.

Parameters

• current_project_only (bool) - Default: True

Customization via settings file

The following functionality can be customized in the settings file:

• history_file - Path to store the history entries in (relative to the sublime packages path)
  • default value is "User/FileHistory.json"
• global_max_entries - Maximum number of history entries we should keep (older entries truncated)
  • default value is 100
• project_max_entries - Maximum number of history entries we should keep (older entries truncated)
  • default value is 50
• use_saved_position - If we should try to use the saved position of the file or blindly use the "new_tab_position" setting
  • default value is true
• new_tab_position - Which position to open a file at when the saved index in no longer valid (or use_saved_position is set to false)
  • default value is "next"
  • available options are "next", "first" and "last"
• show_file_preview - Should we show a preview of the history entries?
  • default value is true
• remove_non_existent_files_on_preview - Remove any non-existent files from the history (when previewed or opened)
  • default value is false
• cleanup_on_startup - Should the history be cleaned on startup?
  • default value is true
• monospace_font - Should a monospace be used in the quick panel?
  • default value is false
• display_timestamps - should the last access timestamp be shown in the qiuck panel
  • default value is true
• timestamp_format - the format of the timestamp
  • default value is %Y-%m-%d @ %H:%M:%S
• timestamp_mode - Which timestamp to display? ("history_access" - last opened/closed timestamp, "filesystem" - the file's last modified timestamp)
  • default value is filesystem
• prettify_history - should the file history be saved as nicely formatted json?
  • default value is false
• debug - Print out the debug text to the console?
  • default value is false