ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Sesame

by gerardroche ST3

Add, open, remove, switch, and manage projects and folders, using the command palette and key bindings.

Details

Installs

  • Total 285
  • Win 122
  • OS X 106
  • Linux 57
Dec 18 Dec 17 Dec 16 Dec 15 Dec 14 Dec 13 Dec 12 Dec 11 Dec 10 Dec 9 Dec 8 Dec 7 Dec 6 Dec 5 Dec 4 Dec 3 Dec 2 Dec 1 Nov 30 Nov 29 Nov 28 Nov 27 Nov 26 Nov 25 Nov 24 Nov 23 Nov 22 Nov 21 Nov 20 Nov 19 Nov 18 Nov 17 Nov 16 Nov 15 Nov 14 Nov 13 Nov 12 Nov 11 Nov 10 Nov 9 Nov 8 Nov 7 Nov 6 Nov 5 Nov 4
Windows 0 0 0 0 1 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0
OS X 0 0 0 1 1 0 0 0 0 1 0 0 1 0 0 0 1 0 0 0 1 0 0 0 0 0 0 2 0 0 0 2 0 0 0 0 0 0 0 0 1 0 0 0 0
Linux 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

WHAT SESAME IS

Add, open, remove, and switch, projects or folders, using the Command Palette and Key Bindings.

Author

QUICK START

Set the location of your projects: Menu > Preferences > Settings

{
    "sesame.path": "~/projects"
}

Press Ctrl+Alt+o to open a projects.

INSTALLATION

Package Control installation

The preferred method of installation is Package Control.

Manual installation

Close Sublime Text, then download or clone this repository to a directory named Sesame in the Sublime Text Packages directory for your platform:

  • Linux: git clone https://github.com/gerardroche/sublime-sesame.git ~/.config/sublime-text-3/Packages/Sesame
  • OSX: git clone https://github.com/gerardroche/sublime-sesame.git ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/Sesame
  • Windows: git clone https://github.com/gerardroche/sublime-sesame.git %APPDATA%\Sublime/ Text/ 3/Packages/Sesame

COMMANDS

Command Palette Command Description
Sesame: Add sesame_add Add a project to the current window
Sesame: Open sesame_open Open a project in a new window
Sesame: Remove sesame_remove Remove a folder from the current window
Sesame: Switch sesame_switch Add a project to the current window

KEY BINDINGS

Add your preferred key bindings: Menu > Preferences > Key Bindings

[
    { "keys": ["ctrl+alt+a"], "command": "sesame_add" },
    { "keys": ["ctrl+alt+o"], "command": "sesame_open" },
    { "keys": ["ctrl+alt+r"], "command": "sesame_remove" },
    { "keys": ["ctrl+alt+s"], "command": "sesame_switch" },
]

Defaults:

Windows / Linux OSX Description
Ctrl+Alt+o Super+Alt+o Sesame: Open

Resolving Ubuntu Key Bindings Conflicts:

On Ubuntu you may have conflict issues with key bindings such as ctrl+alt+s that may be mapped to something like the system toggle-shaded window command. You can clear the system keybinding with a command at terminal. If you have issues with key bindings on Ubuntu, ping me on twitter and I'll do my best to help you resolve it.

$ gsettings set org.gnome.desktop.wm.keybindings toggle-shaded "[]"

CONFIGURATION

Key Description Type Default
sesame.depth Number of levels deep to look for projects within projects path. 1 or 2 2
sesame.keymaps Enable default keymaps. boolean true
sesame.path Location of your projects. string The path found in the environment variable PROJECTS_PATH (if it exists).
sesame.vcs Include only version controlled projects e.g. Git, Mercurial, Subversion boolean false

Path

Menu > Preferences > Settings

{
    "sesame.path": "~/projects"
}

Menu > Project > Edit Project

{
    "settings": {
        "sesame.path": "~/projects"
    }
}

Depth

The default depth is 2 which means that projects are listed using the pattern */* e.g. your/project.

If you prefer to organise your projects at a single level, set the depth to 1.

Menu > Preferences > Settings

{
    "sesame.depth": 1
}

Menu > Project > Edit Project

{
    "settings": {
        "sesame.depth": 1
    }
}

Multiple paths

Multiple paths can be set using a PATH separator (':' for POSIX or ';' for Windows) e.g. "~/projects:~/work:~/src".

Environment variables

A PROJECTS_PATH environment variable can be used to set the default path e.g. on Linux edit ~/.profile (requires system restart) with export PROJECTS_PATH=~/projects.

Custom commands

An example.

Setup custom commands for the path ~/vendor:

  1. Add the following to User/Default.sublime-commands:
[
       {
           "caption": "Sesame: Add Vendor",
           "command": "sesame_add",
           "args": { "path": "~/vendor" }
       },
       {
           "caption": "Sesame: Open Vendor",
           "command": "sesame_open",
           "args": { "path": "~/vendor" }
       },
       {
           "caption": "Sesame: Switch Vendor",
           "command": "sesame_switch",
           "args": { "path": "~/vendor" }
       }
   ]
  1. Add your preferred key bindings: Menu > Preferences > Key Bindings
[
       {
           "keys": ["ctrl+alt+v"],
           "command": "sesame_open",
           "args": { "path": "~/vendor" }
       }
   ]

CHANGELOG

See CHANGELOG.md.

LICENSE

Released under the BSD 3-Clause License.