Ditch sidebar and browse your files in a normal tab with keyboard, like a pro!

You can also use it as a sidebar that you can put on right or left side

You can install via Sublime Package Control Or you can clone this repo into your SublimeText Packages directory and rename it to FileBrowser

This plugin does not add any keybindings for opening a new tab in Browse Mode. Although, the commands to do that are available in Command Palette but it is recommended to bind F1 to open the current file directory in Browse Mode with this piece of code (that you can add to your Key Bindings - User file):

{
  "keys": ["f1"],
  "command": "dired",
  "args": { "immediate": true }
}

You also can use optional arguments to tweak behavior:

• "single_pane": true — always use a single File Browser view, i.e. prefer to reuse existing one rather than create a new.
• "other_group": "left" (or "right) — open FileBrowser in other group, i.e. like sidebar; if you use "left" then all other tabs from left group will be moved into the right one.
• "project": true — always prefer project's directory(s) rather than path of current view.

You can mix these arguments as you like (perhaps, even bind several shortcuts for different cases); e.g. to completely mimic sidebar, it would be:

{
  "keys": ["f1"],
  "command": "dired",
  "args": {
    "immediate": true,
    "single_pane": true,
    "other_group": "left",
    "project": true
  }
}

If you prefer to open file(s) on Mac in default app instead of Quicklook, add the following code in your user key bindings file:

{
  "keys": [" "],
  "command": "dired_quick_look", "args": { "preview": false},
  "context": [
    { "key": "selector", "operator": "equal", "operand": "text.dired" },
    { "key": "setting.dired_rename_mode", "operand": false }
  ]
}

NOTE: All these keyboard shortcuts can be customized in your own key-binding file. Open the default key-bindings file (Preferences → Package Settings → FileBrowser → Keybinding — Default) and copy the ones you want to change to your Keybinding — User file.

You can select files and/or directories by marking them with m, or Shift + ↑/↓ or just use SublimeText multiple cursor feature and extend your cursor to the line that has those files/directories.

You can expand or collapse a directory (or multiple directories using marking or multiple cursors) by pressing o. l or → will also expand directories inline and h or ← will collapse.

Besides incremental search available by /, you also may use build-in "Goto Symbol…" (⌘+r or ctrl + r) for fuzzy search.

Press s to summon "Find in Files…" panel — if you've marked some files they will fill Where field, otherwise it will be filled by current directory path.

The rename command puts the view into rename mode. The view is made editable so files can be renamed directly in the view using all of your SublimeText tools: multiple cursors, search and replace, etc.

After you are done with editing press enter to commit your changes or escape to cancel them.

You can move and copy files/folders. Shortcuts are quite standard: x, c, v with ⌘ or ctrl.

You can copy and/or cut as many items and from many locations as you like — status-bar will show amounts of copied and cut items.
If you change your mind — ⌘+z or ctrl+z will clear both lists. Note, those lists are stored in FileBrowser settings file, so you can edit it by hand if need.

As soon as you paste, each item will be either copied or moved into folder under cursor.
If you want to alter the destination path without moving cursor, you may do so with ⌘+shift+v or ctrl+shift+v to open prompt; you may use prompt without copy/cut before, i.e. if those lists in settings file are empty then prompt will take marked or selected item(s) and suggest copying them.

On Windows all operations will be done via system API with all its features (renaming semantics, interactive overwrite, progress-bar, pause/cancel, and so on).

On other OSes all operations will be done via Python API, which is not that cool, but you will see a vague progress in status-bar and can choose what to do in case of conflicts (overwrite, duplicate, skip), however, there are some restrictions, e.g. folders cannot be overwritten or merged.

Selecting a couple of files and/or directories (either by marking them or using the normal multiple cursor feature of SublimeText) and pressing w will open them in a new window.

Add the following code in your user key bindings file:

{
  "keys": ["enter"],
  "command": "dired_select", "args": {"and_close": true},
  "context": [
    { "key": "selector", "operator": "equal", "operand": "text.dired" },
    { "key": "setting.dired_rename_mode", "operand": false }
  ]
}

While in Browse Mode, you can press P(Shift + p) to add the current directory to your Jump List, we call it a Jump Point. It's like Bookmarks or Favorites in other file managers.

There are several ways to view your Jump list:

While in Browse Mode, you can press p to view the Jump List in a Sublime quick panel.

NOTE: This command does NOT create a new window or project. it lets you jump quickly to a particular location.

Bring up Command Palette and search for Browse Mode: Jump List Quick Panel (typing bmq should find it for you). If you want to save some key stokes you can add the following code in your user key bindings file:

{
  "keys": ["f3"],
  "command": "dired_jump",
  "args": { "new_window": true }
}

You can change f3 in the above code to your custom keyboard shortcut.

NOTE: This command creates a new window and open that directory in Sublime with a Browse Mode view. The view opens as a left sidebar by default. To change it add dired_open_on_jump to your user settings file (Preferences → Package Settings → FileBrowser → Settings — User). Set it to "right" to open the view as sidebar on the right side of the window or to true to fill all space. A value of false will prevent any view to open when jumping.
To open the directory in the same window call the command with false. To keep the current window if it is empty call the command with "auto" and edit your user settings with "dired_smart_jump": true.

Bring up Command Palette and search for Browse Mode: Jump List (typing bmj should find it for you). This command will open a Jump List View that looks like this:

If you want to save some key stokes you can add the following code in your user key bindings file:

{ "keys": ["f3"], "command": "dired_jump_list" }

You can change f3 in the above code to your custom keyboard shortcut. Jump List View can be browsed using the up/down or j/k. Pressing enter on a jump point will open it in a new window with a Browse Mode view as sidebar or what was configured with dired_open_on_jump. Empty windows will be reused if dired_smart_jump is set to true in your user settings.

You can also configure FileBrower to automatically open Jump List View in new empty windows. That is when you run the new_window command (through menu or using shortcuts) or when SublimeText starts and there's no previous windows open. To do this you need to add the code below to your user settings file (Preferences → Package Settings → FileBrowser → Settings — User)

{ "dired_hijack_new_window": "jump_list" }

When you are in Jump List View pressing P (Shift + p) allow you to rename or delete (by clearing the name) the jump point that is currently highlighted.

When a jump point is opened in Browse Mode pressing P will also do the same.

NOTE: When a jump point is opened in Browse Mode the path in the header is prefixed with name of the jump point.

By default, FileBrowser shows all files in the browsed directory. Pressing h toggles the display of hidden files. For all platforms, any file that starts with a . is considered hidden; additionally, on Windows, files that have the hidden attribute set are also considered hidden.

To set FileBrowser to hide hidden files by default, add the following to your settings:

{ "dired_show_hidden_files": false }

You can also customize the patterns used to determine if a file should be hidden with the dired_hidden_files_patterns setting, which should be either a single pattern string or a list of such patterns:

{ "dired_hidden_files_patterns": [".*", "__pycache__", "*.pyc"] }

In case git status(or hg status) returns a colorable output in current directory, the modified and untracked files will be designated by orange and green icons respectively. You can use setting "vcs_color_blind": true — untracked files will get vertical line on left side of their icons, modified files will get horizontal line under their icons. If Git (or HG) is not presented in your PATH you may set git_path (resp hg_path) setting (see example in default settings file).

FileBrowser can hijack new empty windows and show you a Browse Mode or Jump List View. That is when you run the new_window command (through menu or using shortcuts) or when SublimeText starts and there's no previous windows open.

This feature is only available for ST3 and is disabled by default. You can activate it by setting dired_hijack_new_window to "jump_list" or "dired" in your user settings file (Preferences → Package Settings → FileBrowser → Settings — User).

To disable this feature set it back to false or remove if from your user settings file.

{ "dired_hijack_new_window": "jump_list"}

We believe keeping your hands on keyboard and not moving them away to reach the mouse or track-pad will increase your productivity. Despite this, there might be situations where using a mouse to click on a file is easier or you might be in transition to becoming a keyboard ninja and still prefer the mouse by habit. For these situations, you can just double click a file or directory to open them. Although we stand firm with our belief, we're liberals! :)

If you don't like ⠤ symbol and want to hide it (then you should use keyboard binding backspace to go to parent directory) you can do it in your user settings file (Preferences → Package Settings → FileBrowser → Settings — User) and paste the code below:

{ "dired_show_parent": false }

If you want to see header (underlined full path) on top of file list:

{ "dired_header": true }

If you want to see full path in tab title and thus in window title if tab is focused:

{ "dired_show_full_path": true }

If you don't like colors used in FileBrowser just copy this file to your User directory, change colors and paste the code below in your user settings file:

{ "color_scheme": "Path to your custom color scheme file. e.g. Packages/User/custom_dired.hidden-tmTheme" }

Changing the font of sidebar in SublimeText is not that easy! not if you're using FileBrowser as your sidebar. Since it is just a normal Sublime view with a special syntax, you can change the font to whatever font that's available on your system.

To do that, add the code below (don't forget to change the font name!) to user settings file (Preferences → Package Settings → FileBrowser → Settings — User).

{ "font_face": "comic sans" }

Normally you want the FileBrowser to use a smaller font compared to your normal views. It helps you see more content and also prevents any font size changes when you make your normal view font bigger or smaller.

You can change the font size by adding the code below to user settings file (Preferences → Package Settings → FileBrowser → Settings — User).

{ "font_size": 13 }

The amount of indentation for nested directories is controlled by tab_size. By default FileBrowser is using a tab_size of 3 but you can customize it in your user settings file (Preferences → Package Settings → FileBrowser → Settings — User).

{ "dired_confirm_send2trash": false }

The value can be either float as fraction of window width which is 1.0 — so default value 0.3 means that FileBrowser will take slightly less than a third part of window width;
or int as the exact amount of pixels, however, if value will be more than current window width (e.g. 1920) then it will fallback to 0.9.

{ "dired_width": 250 }  // approximately 250 pixels

or

{ "dired_width": 0.2 }  // fifth part of window

note it is Vintageous setting, if it does not work you should report into appropriate repository

{ "__vi_external_disable": false }

DirectWrite rendering gives better Unicode support and better font appearance overall, to enable it add following setting into Preferences → Settings — User:

{ "font_options": ["directwrite"] }

This is a fork of the awesome dired plugin by Michael Kleehammer

See the LICENSE file