Skip to content web app
Ruby HTML CSS C JavaScript Shell
Find file
Failed to load latest commit information.
app Allow specifying warden strategies per controller
bin Refactor PNG generation
config Rails' code reloading is crap ¯\_(ツ)_/¯
db Upgrade Foreigner to workaround breaking changes in Rails 4.1.11
lib Allow specifying warden strategies per controller
public Improved left/right margin for guru meditation
script Install libtsm from asciinema's fork
spec Revert to direct asciicast JSON URL because Safari is the new IE
src Remove empty line
vendor Upgrade player
.dockerignore Adding Dockerfile and start_sidekiq.rb needed to create Docker Image …
.env.example Unicorn with girl_friday on Heroku
.gitignore Use flat config files
.rspec.example Example .rspec config file
.ruby-version Use ruby 2.1 in development
.travis.yml Fix travis config
Dockerfile Adding Dockerfile and start_sidekiq.rb needed to create Docker Image …
Gemfile Upgrade Rails gems
Gemfile.lock Upgrade Rails gems
Guardfile Upgrate to Rails 4.1.5
LICENSE Change license to AGPL v3
Procfile Make foreman start sidekiq with proper config file path Install libtsm from asciinema's fork
Rakefile Upgrate to Rails 4.1.5 Load unicorn worker killer only in production Add rake task for starting sidekiq web panel
start_sidekiq.rb Adding Dockerfile and start_sidekiq.rb needed to create Docker Image …

Build Status Code Climate Coverage Status

Record and share your terminal sessions, the right way.

asciinema is a free and open source solution for recording terminal sessions and sharing them on the web.

This is the source code of website. You can find asciinema's terminal recorder at asciinema/asciinema and asciinema player at asciinema/asciinema-player.

Setup instructions

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 private use or for your organization.

Using Docker

$ docker run -d -p 5432:5432 -e POSTGRES_PASSWORD=mypass --name=postgres postgres
$ docker run -d -p 6379:6379 --name=redis redis
$ docker run --rm --link postgres:postgres -e DATABASE_URL="postgresql://postgres:mypass@postgres/asciinema" asciinema/ bundle exec rake db:setup
# starting sidekiq using the provided start_sidekiq.rb file will also start sendmail service if you don't want to use SMTP
# otherwise start sidekiq by starting: bundle exec sidekiq
$ docker run -d --link postgres:postgres -e DATABASE_URL="postgresql://postgres:mypass@postgres/asciinema" asciinema/ ruby  start_sidekiq.rb
$ docker run -d --link postgres:postgres -e DATABASE_URL="postgresql://postgres:mypass@postgres/asciinema" -p 3000:3000 asciinema/

You can override the address/port that is sent in email with login token by passing HOST="host:port" environment variable when starting the web server.

Assuming you are running Docker Toolbox and VirtualBox: go to and enjoy.

Manual setup

1. Install dependencies site is a Ruby on Rails application. You need to have following dependencies installed:

  • Ruby 2.0+ (Ruby 2.1 is recommended)

  • bundler gem
    gem install bundler

  • PostgreSQL 8+ with libpq development headers
    sudo apt-get install postgresql libpq-dev on Debian/Ubuntu

  • asciinema's libtsm fork (asciinema branch)
    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.

  • phantomjs 2.0+
    sudo add-apt-repository ppa:tanguy-patte/phantomjs && sudo apt-get update && sudo apt-get install phantomjs

2. Get the source code

Clone git repository:

$ git clone git://
$ cd

3. Prepare database config file

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

4. Setup the app

Following script will install gem dependencies and setup database:

$ ./script/setup

5. Run Rails server

$ bundle exec rails server

6. Run the background job processor

The background job processor is needed for asciicast pre-processing and 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-2015 Marcin Kulik. See LICENSE.txt for details.

Something went wrong with that request. Please try again.