# Shelr -- [tool for terminal screencasting][TV].

[![Build Status](https://secure.travis-ci.org/antono/shelr.png?branch=master)](http://travis-ci.org/antono/shelr)

`shelr` allows you to record/replay and publish your terminal on [http://shelr.tv](http://shelr.tv).
[Code for Shelr.tv](https://github.com/shelr/shelr.tv) service is also available on github.


## Installation

### 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](http://shelr.tv/records/4f49ea4ae557800001000004) for details :)

### From packages

- [PPA](https://launchpad.net/~antono/+archive/shelr) for Ubuntu
- [PKGBUILD](https://aur.archlinux.org/packages.php?ID=56945) for Arch Linux
- [EBUILD](http://overlays.gentoo.org/proj/sunrise/browser/app-misc/shelr) for Gentoo Linux
- [deb](http://mentors.debian.net/package/shelr) for Debian (Mentor Wanted)

## Watching other's records in your terminal

    shelr play http://shelr.tv/records/4f4ca2a43cd1090001000002.json

You can watch them online at [http://shelr.tv/][TV]

## 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.

## Dependencies

### Linux/Hurd

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

### BSD/OSX

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

To enable sound recordings, you need to install `sox`.

     brew install sox          # OSX
     sudo port install sox     # BSD / OSX
     sudo apt-get install sox  # Ubuntu / Debian

## Copyright

(Э) 2010, 2011, 2012 Antono Vasiljev and
[contributors](https://github.com/shelr/shelr/contributors).

See LICENSE.txt for details.

[TV]: http://shelr.tv/ "Asciicasts from unix ninjas"