Flexible and generic plugin to hook onto sublime's file state events
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
Hookblime.py Fix vulnerability when replacing file names. Thanks @paulp Jul 14, 2012
README.md Fix typo in readme Jul 14, 2012



Hookblime lets you easily add hooks to execute your own scripts on file events.

Hook scripts are executed by the user's default shell*, giving you the possibity of using shell-scripting oneliners.

Supported events

These are the currently supported events:

  • on_new: Executed when a new file tab created.
  • on_load: Executed when an existing file is opened.
  • on_close: Executed when a tab is closed.
  • on_pre_save: Executed before a file is saved.
  • on_post_save: Executed after a file is saved.


Hookblime can be configured at any level of the Sublime's settings hierachy, both in global and scoped ways.

All configuration must be set in an entry called "hookblime", containing a dict for each global hook and scope. Each scope must contain its desired hooks.

Each hook dict must have a "cmd" string value with the script to execute, and can have an optional boolean entry called "replace_filename" which if true, makes the plugin replace the string "%(file_name)" with the current file's path. Note that on_new and on_close hooks can be triggered by non-saved files, in which cases an empty path will appended.

If both global and scoped hooks are matched, only the later would be executed.

Sample configuration:

"hookblime" : {
    "source.python" : {
        "on_post_save" : {
            "cmd": "python_saved %(file_name)",
            "replace_filename": true
    "on_new" : {
        "cmd": "global_hook_new_tab"

* The working directory of the scripts is always the user's home.