Sublime Terminal

Install Open Source

Shortcuts and menu entries for opening a terminal at the current file, or the current root project folder in Sublime Text 2.

Features

Works On

  • OS X
  • Windows
  • Linux

Screenshots

Installation

Download Package Control and use the Package Control: Install Package command from the command palette. Using Package Control ensures Terminal will stay up to date automatically.

Usage

Open Terminal at File
Press ctrl+shift+t on Windows and Linux, or cmd+shift+t on OS X
Open Terminal at Project Folder
Press ctrl+alt+shift+t on Windows and Linux, or cmd+alt+shift+t on OS X

In addition to the key bindings, terminals can also be opened via the editor context menu and the sidebar context menus.

Package Settings

The default settings can be viewed by accessing the Preferences > Package Settings > Terminal > Settings – Default menu entry. To ensure settings are not lost when the package is upgraded, make sure all edits are saved to Settings – User.

terminal
The terminal to execute, will default to the OS default if blank. OS X users may enter iTerm.sh to launch iTerm if installed.
Default: ""
parameters
The parameters to pass to the terminal. These parameters will be used if no custom parameters are passed via a key binding.
Default: []

Custom Parameters

With the parameters argument to the open_terminal and open_terminal_project_folder commands, it is possible to construct custom terminal environments.

The following is an example of passing the parameters -T 'Custom Window Title' to a terminal. Please note that this example is just an example, and is tailored to the XFCE terminal application. Your terminal may use the -T option for some other features or setting. Custom key bindings such as this would be added to the file opened when accessing the Preferences > Key Bindings – User menu entry (the file name varies by operating system).

{
	"keys": ["ctrl+alt+t"],
	"command": "open_terminal",
	"args": {
		"parameters": ["-T", "Custom Window Title"]
	}
}

A parameter may also contain the %CWD% placeholder, which will be substituted with the current working directory the terminal was opened to.

{
	"keys": ["ctrl+alt+t"],
	"command": "open_terminal",
	"args": {
		"parameters": ["-T", "Working in directory %CWD%"]
	}
}

Changelog

v1.3.1

v1.3.0

v1.2.0

v1.1.1

v1.1.0

v1.0.2

v1.0.1

v1.0.0

License

Sublime Terminal is licensed under the MIT license. Please see the readme.creole file in the package directory for the text of the license.

GitHub

Source

The source code for Sublime Terminal is available on GitHub at https://github.com/wbond/sublime_terminal.