Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Sublime Text 2 plugin for keyboard driven file navigation

branch: master
README.md

Sublime Files

A keyboard driven file navigation/opening plugin for Sublime Text 2/3.

Plugin in action

Sublime Files works entirely through the command palette. By running the Sublime Files Navigator, you can "cd" around directories similar to how you would on a command line in order to open up files. New files will open up in new tabs.

Because Sublime Files actually navigates the file system by changing directories, the navigator remembers and starts from last visited directory on subsequent uses. To open the navigator, you can either just invoke the Command Palette... command or use the keybinding:

  • OSX: ctrl + cmd + n
  • Windows/Linux: ctrl + alt + n

Installation

Sublime Files can be installed through Sublime Package Control.

Usage

Sublime files an be activated with the Command Palette... command: Sublime Files: Open Navigator, or with the key command ctrl + cmd + n (or ctrl + alt + n for Windows / Linux). The first option will always show the current directory. Selecting another directory will navigate to that directory and selecting a file will open that file.

There are a few notable options:

  • Selecting Directory actions will pop up a small list of actions that can be applied onto the current directory. Mainly, a user can create new files, add the directory to the current project, and open a terminal at the directory.
  • Selecting ~/ navigates to the home directory.
  • Selecting ../ navigates to the parent directory.
  • Selecting To current view navigates to the directory of the current file being edited.

Configuration

Default configuration is stored in SublimeFiles.sublime-settings accessible from Preferences->Package Settings->Sublime Files->Settings - Default. When changing any of the settings below it's suggested to use the user settings: Preferences->Package Settings->Sublime Files->Settings - User as the file will remain untouched when updating plugin.

Ignore file types

Sublime Files by default will ignore *.pyc files and *.class files. You can modify the list of ignored files by changing the ignore_list. For example:

{
    "ignore_list": ["*.pyc", "*.class", "*.o"]
}

Open Terminal

For OS X/Linux systems, Sublime Files can open up a terminal at the current directory navigated to. In order for this feature to work properly, you will have to modify the term_command. As a default, it is set to open up Terminal.app for OS X systems.

For example, Gnome Terminal and iTerm2 users respectively will want to change term_command to:

{
    "term_command": "gnome-terminal --working-directory="
}

and

{
    "term_command" : "open -a iTerm\ 2 "
}

Start directory

If you always want to start navigation from a given directory for example ~ just update the start_directory setting:

{
    "start_directory": "~"
}

Default configuration comes with this setting turned off (set to null).

Something went wrong with that request. Please try again.