2013-10-03 17:22:09 +00:00
|
|
|
# asciinema.org
|
2012-04-03 10:03:31 +00:00
|
|
|
|
2013-12-09 16:42:11 +00:00
|
|
|
Record and share your terminal sessions, the right way.
|
|
|
|
|
|
|
|
|
|
Asciinema is a free and open source solution for recording the terminal
|
|
|
|
|
sessions and sharing them on the web.
|
2012-04-09 11:44:38 +00:00
|
|
|
|
2013-09-22 12:07:42 +00:00
|
|
|
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](https://github.com/sickill/asciinema)
|
2012-04-09 11:44:38 +00:00
|
|
|
|
2012-10-12 19:46:40 +00:00
|
|
|
## 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 your organization.
|
2012-05-06 00:02:36 +00:00
|
|
|
|
2012-10-12 20:14:01 +00:00
|
|
|
### 1. Install dependencies
|
2012-04-09 11:44:38 +00:00
|
|
|
|
2013-09-22 12:07:42 +00:00
|
|
|
asciinema.org site is a Ruby on Rails application. You need to have following
|
2012-10-12 20:29:31 +00:00
|
|
|
dependencies installed:
|
2012-04-09 11:44:38 +00:00
|
|
|
|
2013-08-25 15:34:00 +00:00
|
|
|
* Ruby 1.9.3+ (Ruby 2.0.0-p247 is recommended)
|
2012-10-12 20:29:31 +00:00
|
|
|
|
2012-10-12 20:34:27 +00:00
|
|
|
* bundler gem
|
2012-10-12 19:46:40 +00:00
|
|
|
`gem install bundler`
|
2012-10-12 20:29:31 +00:00
|
|
|
|
2012-10-12 20:34:27 +00:00
|
|
|
* PostgreSQL 8+ with libpq development headers
|
2012-10-12 19:46:40 +00:00
|
|
|
`sudo apt-get install postgresql libpq-dev` on Debian/Ubuntu
|
2012-04-09 11:44:38 +00:00
|
|
|
|
2013-08-25 15:34:00 +00:00
|
|
|
* libtsm
|
|
|
|
|
See [here](https://github.com/dvdhrm/libtsm) for installation instructions.
|
|
|
|
|
If you don't install it now the setup script (point 4 below) will try to
|
|
|
|
|
install it for you anyway.
|
2012-04-09 11:44:38 +00:00
|
|
|
|
2012-10-12 20:14:01 +00:00
|
|
|
### 2. Get the source code
|
|
|
|
|
|
|
|
|
|
Clone git repository:
|
2012-04-09 11:44:38 +00:00
|
|
|
|
2013-09-22 12:07:42 +00:00
|
|
|
$ git clone git://github.com/sickill/asciinema.org.git
|
|
|
|
|
$ cd asciinema.org
|
2012-04-09 11:44:38 +00:00
|
|
|
|
2012-10-12 20:14:01 +00:00
|
|
|
### 3. Prepare database config file
|
2012-05-06 00:02:36 +00:00
|
|
|
|
2012-10-12 19:46:40 +00:00
|
|
|
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).
|
2012-04-09 11:44:38 +00:00
|
|
|
|
2012-10-12 20:14:01 +00:00
|
|
|
### 4. Setup the app
|
2012-04-09 11:44:38 +00:00
|
|
|
|
2012-10-12 20:14:01 +00:00
|
|
|
Following script will install gem dependencies and setup database:
|
2012-04-09 11:44:38 +00:00
|
|
|
|
2012-10-12 20:14:01 +00:00
|
|
|
$ ./script/setup
|
2012-04-09 11:44:38 +00:00
|
|
|
|
2012-10-12 20:14:01 +00:00
|
|
|
### 5. Run Rails server
|
2012-04-09 11:44:38 +00:00
|
|
|
|
2013-08-25 15:34:00 +00:00
|
|
|
$ bundle exec rails server
|
|
|
|
|
|
|
|
|
|
### 6. Run the background job processor
|
|
|
|
|
|
|
|
|
|
The background job processor is needed for thumbnail generation.
|
|
|
|
|
|
|
|
|
|
$ bundle exec sidekiq
|
2012-04-09 11:44:38 +00:00
|
|
|
|
2013-12-03 19:09:18 +00:00
|
|
|
## Contributing
|
|
|
|
|
|
|
|
|
|
If you want to contribute to this project check out
|
|
|
|
|
[Contributing](http://asciinema.org/contributing) page.
|
|
|
|
|
|
2012-04-09 11:44:38 +00:00
|
|
|
## Authors
|
|
|
|
|
|
2013-10-06 11:02:37 +00:00
|
|
|
Developed with passion by [Marcin Kulik](http://ku1ik.com) and great open
|
|
|
|
|
source [contributors](https://github.com/sickill/asciinema.org/contributors)
|
|
|
|
|
|
|
|
|
|
## Copyright
|
|
|
|
|
|
|
|
|
|
Copyright © 2011-2013 Marcin Kulik. See LICENSE.txt for details.
|
