iterm2-tools

iTerm2 tools.


Keywords
image, ipython, iterm2, terminal
License
MIT
Install
pip install iterm2-tools==2.3

Documentation

iTerm2 Tools

iTerm2 tools for Python

Some tools for working with iTerm2's proprietary escape codes.

Supports Python 2.7, 3.4, 3.5, and 3.6.

See http://www.asmeurer.com/iterm2-tools/index.html for the documentation.

Installation

pip install iterm2_tools

or

conda install -c conda-forge iterm2_tools

IPython shell integration

To enable shell integration in IPython, add

try:
    import iterm2_tools.ipython
    c.TerminalIPythonApp.extensions.append('iterm2_tools.ipython')
except ImportError:
    pass

to your IPython configuration file. You can also enable it just once by running

%load_ext iterm2_tools.ipython

Note that the integration requires IPython > 4.0.0, as earlier versions have a bug that miscounts prompt characters, resulting in an indented "Out" prompt (however, aside from this bug, it should work fine).

Example:

Note the arrows to the left of the In prompts. The blue arrow represents a normal input and a red arrow represents an input that raised an exception.

See http://www.asmeurer.com/iterm2-tools/ipython.html for full documentation.

Library functions

iterm2_tools has library functions for displaying images inline in the terminal and for shell integration. See the docs for more information.

License

MIT