Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Tools for turning terminal sessions into JSON/HTML.

Project Description

A fairly generic tool that allows you to capture all of the output from
a terminal application (including shells). This output is then rendered in
a pure-python terminal emulator (pyte), and the resulting virtual "screen"
is dumped to either generic JSON or a generic HTML snippet that can then
be used to by other tools or inserted into a webpage.

There are issues with some complex curses applications that use certain
CSI control codes not (yet) supported by pyte. For example, htop will not

This tool was designed specifically to turn zsh themes into a gallery.


echo "ls\\nexit\\n" > omt-py html -- /bin/zsh

omt-py json - Generates a JSON representation of the screen.
omt-py html - Generates a generic HTML snippet or a standalone
omt-py iterm-to-css - Converts an iTerm2 theme into CSS suitable for
usage with the HTML snippets generated by omt.

omt-py json [options] -- <argv>...
omt-py html [options] -- <argv>...
omt-py iterm-to-css [--prefix=<prefix>] <source>

--width=<columns> The number of columns for the pseudo-terminal.
[default: 80]
--height=<lines> The number of lines for the pseudo-terminal.
[default: 24]
--standalone When generating HTML, generate a standalone page
instead of a generic snippet.
--theme=<source> When generating standalone HTML, use this iTerm2
theme for the CSS.
--prefix=<prefix> The prefix to use for CSS selectors.
[default: omt]

Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(4.3 kB) Copy SHA256 Hash SHA256
Source Aug 8, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting