Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Console screencasting tool

Merge pull request #16 from ipoval/master

rm unused require libraries in player.rb
latest commit 62361a2044
Antono Vasiljev authored
Failed to load latest commit information.
bin no 1.9 hashes
contrib moved bash completion file to contrib
features shelr dump
spec fix rubocop codestyle warnings
.gitignore ignore gems.tags
.rspec Initial commit to shellcast.
.rvmrc rvmrc
.travis.yml Do not run specs on edge ruby versions
Gemfile add shelr stop (some users expect it) try not to use pry on CI
Guardfile Guardfile
LICENSE.txt Rebranded to shelr, mentioned :) README update
Rakefile add shelr stop (some users expect it) modified:
shelr.1 Fix lintian warning manpage-has-errors-from-man shelr.1.gz 48: warnin…
shelr.1.ronn Fix lintian warning manpage-has-errors-from-man shelr.1.gz 48: warnin…
shelr.gemspec gemspec up. 0.13.2

Shelr -- tool for terminal screencasting.

Build Status

shelr allows you to record/replay and publish your terminal on Code for service is also available on github.


From gem

You'll need ruby and rubygems installed.

[sudo] gem install shelr

On ubuntu older than precise or debian older than wheezy you should also add following to your .bashrc or .zshrc

export PATH=/var/lib/gems/1.8/bin:$PATH

Watch asciicast for details :)

From packages

Watching other's records in your terminal

shelr play

You can watch them online at

Recording your terminal

shelr record

Recording started. Do what you whant to record... To finish recording type 'exit' or just Ctrl+D.

Publishing your record

shelr push last

When you have some asciicasts at your machine you can pick one:

shelr list
<select id of your record>
shelr push <ID>

There is alias for last record:

If you want private record, provide --private switch:

shelr push last --private

Such record will be accessible by secret URL with access_key.



You need script tool from linux-utils. It's already installed if You use Linux. Note that old school BSD script will not work.


Unfortunally BSD and OSX ship old script wich lack timing support. If You use this systems - install ttyrec via ports macprots or homebrew and setup it as recording backend.

 brew install ttyrec      # OSX
 sudo port install ttyrec # BSD / OSX
 shelr backend ttyrec     # BSD / OSX


(Э) 2010, 2011, 2012 Antono Vasiljev and contributors.

See LICENSE.txt for details.

Something went wrong with that request. Please try again.