Terminal recorder: Record your termial session into HTML
JavaScript HTML CSS
Clone or download
cortezcristian Merge pull request #2 from elopio/patch-1
Fixed typo on the warning.
Latest commit f1cea41 Sep 5, 2016
Failed to load latest commit information.
pics Updating help Dec 21, 2014
template Adding dark bg May 6, 2015
terminal-recorder-html Adding new demo Dec 21, 2014
.gitignore Initial commit Dec 18, 2014
LICENSE Initial commit Dec 18, 2014
README.md Updating docs and fixing #4 Apr 2, 2016
package.json Update version Apr 2, 2016
terminal-recorder.js Fixed typo on the warning. Jul 1, 2015


terminal-recorder Dependency Status


Terminal recorder allows you to record your bash session, and export it to html so then you can share it with your friends.



$ [sudo] npm install -g terminal-recorder


$ terminal-recorder --help

  Usage: terminal-recorder [options]


    -h, --help            output usage information
    -V, --version         output the version number
    -o, --outpath [path]  Add the specified [path] to place the folder
                            that will contain the recorded html files

# Start recording
$ terminal-recorder

# recording...
[type your stuff and then hit Ctrl+c]

# Notice a new folder was created

$ tree terminal-recorder-html/ -L 1
├── bower_components
├── bower.json
├── css
├── index.html
└── js

# Just open the index.html with your favourite browser
$ firefox terminal-recorder-html/index.html &

# See the magic ;)

Final output looks like this Demo Pic


  • Records all keystrokes sent to stdin
  • Saves stdout in a log file logs.txt
  • Export actions to html
  • Timeline indicator
  • Rollback actions

Comming soon

  • More templates
  • Define starting cmd (Other than bash)
  • Add param for picking cancelling key (Ctrl+c, Ctrl+d)
  • Specify terminal size


Open a terminal:

$ tail -f logs.txt

Open a second terminal:

$ terminal-recorder

Start typing in the second console, and look how the first one is mimicking your moves.

Known issues

  • Record all keys, including passwords. So be careful with that.

Cool Stuff

Cool things that you can do:

$ filget awesomeness # Impress your friends
$ nethack # Play nethack
$ vim # Teach your friends with vim
$ htop # Show server state
$ tmux # Open the terminal multiplexor
$ cmatrix # feel like neo :)