Asciinema is the simplest way to record your terminal and share the recordings with your fellow geeks. Simply record and upload your terminal session with single command, and Asciinema will play it back in your browser.
This is the source code of asciinema.org (formerly ascii.io) website and JS player. If you're looking for asciinema terminal recorder go here: sickill/asciinema
Below you'll find setup instructions in case you want to contribute, play with it on your local machine or setup your own instance for your organization.
asciinema.org site is a Ruby on Rails application. You need to have following dependencies installed:
-
Ruby 1.9.3+ (Ruby 2.0.0-p247 is recommended)
-
bundler gem
gem install bundler
-
PostgreSQL 8+ with libpq development headers
sudo apt-get install postgresql libpq-dev
on Debian/Ubuntu -
libtsm
See here for installation instructions. If you don't install it now the setup script (point 4 below) will try to install it for you anyway.
Clone git repository:
$ git clone git://github.com/sickill/asciinema.org.git
$ cd asciinema.org
Copy config/database.yml.example to config/database.yml. Then set database/user/password to whatever you prefer.
If database specified in database.yml doesn't exist then the following setup task will create it (make sure database user is allowed to create new databases).
Following script will install gem dependencies and setup database:
$ ./script/setup
$ bundle exec rails server
The background job processor is needed for thumbnail generation.
$ bundle exec sidekiq
If you want to contribute to this project check out Contributing page.
Developed with passion by Marcin Kulik and great open source contributors
Copyright © 2011-2013 Marcin Kulik. See LICENSE.txt for details.