Project

showterm

0.23
No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
Integrates with showterm.io for awesome sharability.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies
 Project Readme

It's showtime for your terminal!

Showterm lets your record a terminal session exactly as you experience it, right down to the syntax highlighting.

Installation instructions (gem install showterm) and usage instructions (showterm program) are available in the showterm. :)

(yes, this is me using showterm inside showterm; it's like inception, but with more syntax highlighting)

Configuration

If you'd like to run your own showterm server, you can export SHOWTERM_SERVER=http://showterm.myorg.local/ to configure your showterm client to talk to it.

TODO

  • Allow embedders to chose colourschemes (at least light vs. dark background).

Bugs

Showterm doesn't preserve enough context for rvm to work correctly. This can cause some ruby programs (e.g. capistrano) to crash when used inside a showterm. To fix this run: rvm use before running any ruby programs:

[~/repo/www] > showterm
Showterm recording. (Exit shell when done.)
[~/repo/www] >  rvm use
Using /Users/jasghar/.rvm/gems/ruby-1.9.3-p286
[~/repo/www] > cap deploy
...

Meta-fu

As usual, bug-reports and pull requests are welcome; everything is MIT licensed (see LICENSE.MIT).

Credit

This would not have been doable without the excellent terminal emulator I borrowed from Christopher Jeffrey's incredible tty.js.

For terminal recording on a mac, this gem bundles Satoru Takabayashi's awesome ttyrec program.