GraphTerm is a browser-based graphical terminal interface, that
aims to seamlessly blend the command line and graphical user
interfaces. The goal is to provide a fully backwards-compatible terminal
xterm. You should be able to use it just like a regular terminal
interface, accessing additional graphical features only as needed. GraphTerm builds
upon two earlier projects,
which implemented a terminal using the Mozilla framework and
which is an AJAX/Python terminal implementation. (Another recent
project along these lines is TermKit.)
A GraphTerm terminal window is just a web page served from the GraphTerm server program. Multiple users can connect simultaneously to the web server to share terminal sessions. Multiple hosts can also connect to the server (on a different port), allowing a single user to access all of them via the browser. The GraphTerm server acts as a router, sending input from browser windows for different users to the appropriate terminal (pseudo-tty) sessions running on different hosts, and transmitting the terminal output back to the browser windows.
This flexible, networked implementation allows for several possible applications for GraphTerm, such as:
- an enhanced terminal that combines the command line with basic GUI operations like navigating folders, file drag-and-drop, displaying images etc.
- an inline data visualization tool to view output from plotting libraries like
- a notebook interface for data analysis and documentation (like the Mathematica or iPython Notebook interface, but at the shell level).
- a collaborative terminal that can be remotely accessed by multiple users simultaneously, to run programs, edit files etc.
- a detachable terminal multiplexer, sort of like GNU
The interface is designed to be touch-friendly for use with tablets, with tappable links and command re-use to minimize the need for a keyboard. It preserves history for all commands, whether entered by typing, clicking, or tapping. It is also themable using CSS.
Images of GraphTerm in action can be found in screenshots
and in this YouTube Video.
Here is a sample screenshot showing the output of the
command, which embeds six smaller terminals within the main terminal, running
six different commands from the GraphTerm toolchain: (i) live twitter stream output using
gtweet, (ii) weather info using
(ii) slideshow from markdown file using
greveal and reveal.js,
(iv) word cloud using
d3cloud and d3.js, (v) inline graphics using
and (vi) notebook mode using the standard python interpreter.
GraphTerm, you need to have Python 2.6+ and the Bash
shell on your Mac/Linux/Unix computer. For a quick install, if the python
setuptools module is already installed on your system,
use the following two commands:
sudo easy_install graphterm sudo gterm_setup # Sets up the command toolchain
setuptools is not installed, consider installing it using
apt-get install -y python-setuptools on Debian Linux systems
or its equivalent on other systems.)
For a manual install procedure, download the release tarball from the
Python Package Index, untar,
and execute the following command in the
python setup.py install
For the manual install, you will also need to install the
web server, which can be downloaded from
You can also try out
GraphTerm without installing it, after
untarring the source tarball (or checking out the source from
github). You can
run the server as
./gtermserver.py in the
subdirectory of the distribution, after you have installed the
in your system (or in the
You can browse the
GraphTerm source code, and download the development
version, at Github.
To start the
GraphTerm server, use the command:
gtermserver --auth_code=none --terminal
Once the server is running, you can open GraphTerm terminal windows using a browser that supports websockets, such as Google Chrome, Firefox, Safari, or IE10 (Chrome works best), and entering the following URL:
Once you have a terminal, try out the following commands:
gls <directory> gvi <text-filename>
These are commands in the GraphTerm toolchain that imitate
basic features of the standard
See Getting Started with GraphTerm
Using Graphical Features
tutorials for more info on using GraphTerm.
You can also use the following command:
glandslide -o graphterm-talk1.md | gframe -f
to view a slideshow about GraphTerm within GraphTerm (type
q to quit)..
To report bugs and other issues, use the Github Issue Tracker.
Reliability: This software has not been subject to extensive testing. Use at your own risk.
GraphTermclient should work on most recent browsers that support Websockets, such as Google Chrome, Firefox, and Safari. The
GraphTermserver is pure-python, but with some OS-specific calls for file, shell, and terminal-related operations. It has been tested only on Linux and Mac OS X so far.
- Current limitations:
- Support for
xtermescape sequences is incomplete.
- Most features of GraphTerm only work with the bash shell, not with C-shell, due the need for PROMPT_COMMAND to keep track of the current working directory.
- At the moment, you cannot customize the shell prompt. (You should be able to so in the future.)
GraphTerm is inspired by two earlier projects that implement the
terminal interface within the browser,
It borrows many of the ideas from XMLTerm and re-uses chunks of code from
AjaxTerm. The server uses the asynchronous Tornado web framework and the client uses jQuery.
The 3D perspective mode was inspired by Sean Slinsky's Star Wars Opening Crawl with CSS3.
Other packaged open source components include:
GraphTerm was developed as part of the Mindmeldr project, which is aimed at improving classroom interaction.
GraphTerm is distributed as open source under the BSD-license.