☢️ THIS PROJECT IS NO LONGER MAINTAINED. USE TERM3 ☢️
Run shell sessions within Atom Editor using term2
package.
Run Vim, Emacs, Htop, etc. in Atom.
It's based on pty.js
as shell spawner, and term.js
as xterm, with the power
of Atom Package environment.
It's a fork and rebuilt version of "Term" package.
This fork adds a 'ShellOverride' configuration option which allows to override the shell Term2 is using (your default shell).
If your default shell is zsh you see that it's not yet fully compatible with Term2 (scrolling might not work): setting ShellOverride to i.e. 'bash' let you use Term2 with another (working) shell without messing up with your default shell configuration.
The fork was focused on this option in the first place but evolved a lot since.
To install Term2 easily into your Atom:
$ apm install term2
key binding | event | action |
---|---|---|
ctrl + alt + t |
term2:open |
Opens new terminal tab pane |
ctrl + alt + up |
term2:open-split-up |
Opens new terminal tab pane in up split |
ctrl + alt + right |
term2:open-split-right |
Opens new terminal tab pane in right split |
ctrl + alt + down |
term2:open-split-down |
Opens new terminal tab pane in down split |
ctrl + alt + left |
term2:open-split-left |
Opens new terminal tab pane in left split |
ctrl + k, t, t |
term2:open |
Opens new terminal tab pane |
ctrl + k, t, up |
term2:open-split-up |
Opens new terminal tab pane in up split |
ctrl + k, t, right |
term2:open-split-right |
Opens new terminal tab pane in right split |
ctrl + k, t, down |
term2:open-split-down |
Opens new terminal tab pane in down split |
ctrl + k, t, left |
term2:open-split-left |
Opens new terminal tab pane in left split |
cmd + k, t, t |
term2:open |
Opens new terminal tab pane |
cmd + k, t, up |
term2:open-split-up |
Opens new terminal tab pane in up split |
cmd + k, t, right |
term2:open-split-right |
Opens new terminal tab pane in right split |
cmd + k, t, down |
term2:open-split-down |
Opens new terminal tab pane in down split |
cmd + k, t, left |
term2:open-split-left |
Opens new terminal tab pane in left split |
ctrl + insert |
term2:copy |
Copy text (if ctrl + c is not working) |
shift + insert |
term2:paste |
Paste text (if ctrl + v is not working) |
You can customize Title with using some variables. These are the current variables you can use:
title variable | value |
---|---|
bashName |
Current Shell's name, (e.g. bash, zsh) |
hostName |
OS's host name |
platform |
Platform name, (e.g. darwin, linux) |
home |
Home path of current user |
Default version of title template is
Terminal ({{ bashName }})
- Run a defined command automatically when shell session starts.
- You can customize font-family or font-size (default to Atom settings values)
- You can define Terminal Colors in
config.cson
. - Turn on or off blinking cursor
- Change scrollback limit
- Start shell sessions with additional parameters.
- You can pipe the text and paths to the Terminal sessions.
- Paste from clipboard
Currently, you will need to adjust the colors in config.cson
(then you should be able to edit them in the package settings view).
You can add something like (please note the 2 examples of color format):
term2:
colors:
normalBlack: #000
normalRed:
red: 255
blue: 0
green: 0
alpha: 1
normalGreen: ...
normalYellow: ...
normalBlue: ...
normalPurple: ...
normalCyan: ...
normalWhite: ...
brightBlack: ...
brightRed: ...
brightGreen: ...
brightYellow: ...
brightBlue: ...
brightPurple: ...
brightCyan: ...
brightWhite: ...
background: ...
foreground: ...
- Colors are not taken from the Atom theme.
- alpha channel are not used for now.
- The background color is for now the only exception and is not used. The background is transparent so you benefit of Atom app background color.
It's a known $PATH
issue.
You are probably an OS X user (if not, let us know).
GUI app doesn't get /etc/paths
(and might come from /usr/local/bin
).
There is some workaround for OS X 10.9-, but OS X 10.10+ doesn't execute
/etc/launchd.conf
anymore.
So, in order to get the right PATH in atom-term2 context, you have this
solutions:
-
In your
.(bash|zsh|*)rc
, addexport PATH=$(cat /etc/paths | xargs | tr " " :) # or just hardcode your path like this export PATH=/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin
-
You can automatically call a command when you open a terminal to
login
by editing your Atom config:term2: autoRunCommand: 'login -f `whoami`'