Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A Sublime Text 2 plugin that keeps track of files which have been recently closed, as well as files that have been recently accessed.

README.md

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 example1

The popup for the global history with text example1

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
  • use_monospace_font - Should a monospace be used in the quick panel?
    • default value is false
  • debug - Print out the debug text to the console?
    • default value is false
Something went wrong with that request. Please try again.