• This repository has been archived on 17/Sep/2018
  • Stars
    star
    517
  • Rank 85,558 (Top 2 %)
  • Language
    JavaScript
  • Created almost 10 years ago
  • Updated almost 8 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Generate animated GIFs from asciinema terminal recordings

asciinema2gif

Generate animated GIFs from asciinema terminal recordings.

Demo

Motivation

The asciinema tool is a wonderful way to record and share terminal sessions. Unfortunately, it's not currently possible to embed the output in places like README files on GitHub repos. This tool provides a solution for that.

Usage

asciinema2gif [options] <asciinema_id|asciinema_api_url>

  options:
    -s <size>, --size <size>      One of 'small', 'medium', 'big'
    -p <speed>, --speed <speed>   Any integer (whole number) to multiply regular speed by
    -t <theme>, --theme <theme>   One of 'asciinema', 'tango', 'solarized-dark', 'solarized-light', 'monokai'
    -o <file>, --output <file>    File to write to (defaults to 'asciicast.gif' in current directory)
    -h, --help                    Show this help.

Examples:

$ asciinema2gif --size small --speed 2 --theme solarized-dark 8332

An asciicast.gif file will then be generated for you to embed and share.

$ asciinema2gif --theme solarized-light -o "${HOME}/Desktop/another.gif" https://asciinema.org/api/asciicasts/8332

In this case an another.gif file will be generated on your Desktop. Using the full URL is useful if you want to get an asciicast not from the official website.

URL Format

asciinema2gif works by visiting the given webpage, starting the asciicast, screenshotting it repeatedly, and finally stitching it together. The /api/asciicasts/ format of an asciinema website (e.g. https://asciinema.org/api/asciicasts/8332), as opposed to the main /a/ format (e.g. https://asciinema.org/a/8332), makes this operation easier (see usage), hence why it is a requirement.

Requirements

OS X

# Requires Homebrew installed. Find it at http://brew.sh/.
# This command will install asciinema2gif and all dependencies.
brew install asciinema2gif

Ubuntu

apt-get install imagemagick gifsicle npm
npm install --global phantomjs2

Credits

License

Public domain.

β€” Enjoy, tav <[email protected]>

More Repositories

1

tweetapp

Framework for creating Twitter apps on App Engine
Python
219
star
2

pylibs

A collection of Python packages for use in other projects
Python
113
star
3

nodelint

DEPRECATED: Please use an alternative like ESLint instead: https://github.com/eslint/eslint. Thanks.
JavaScript
88
star
4

assetgen

Asset generator for modern web app development
Python
82
star
5

go

A Git mirror of the Go repository
Go
81
star
6

wikihouse-plugin

SketchUp extension for WikiHouse, an open source construction set that allows anyone to download, modify and print their own house
Ruby
53
star
7

scripts

Bunch of random scripts
Python
34
star
8

bolt-python

Multi-server automation and deployment toolkit
Python
33
star
9

golly

Go library for use in modern app development
Go
27
star
10

gitfund

[PROJECT ON HOLD] Crowdfunding platform for open source projects
Python
26
star
11

plexnet

An Open Web Platform
Python
21
star
12

git-review

A git-based code review, build and testing toolkit
Python
9
star
13

togethr

The togethr action platform
Go
8
star
14

bolt

Multi-server automation and deployment toolkit
Go
7
star
15

tavutil

A package of various Python modules I've written or put together over the years
C
7
star
16

wikifactory

A Wikipedia for 3D Designs
Python
6
star
17

gstore

An approximation of the App Engine datastore written on top of Amazon DynamoDB
Go
5
star
18

pypy-lang

OBSOLETE
Python
5
star
19

oldblog

Tav's Blog
CSS
4
star
20

jsutil

A collection of JavaScript libraries for use in other projects
JavaScript
4
star
21

tav.github.io

Tav's Github Home
4
star
22

yatiblog

Static site generator for blogs and source code documentation
Python
4
star
23

gecko-table

Platform for running multi-touch apps on top of Gecko/XULRunner
4
star
24

dynamodb

A high-performance DynamoDB client library written in Go
Go
3
star
25

planfile-app

A web app for managing Project Planfiles stored within GitHub repositories
Go
3
star
26

espians-planfile

Espian Planfile
3
star
27

redpill

A cross-plaform package management framework
3
star
28

confluence

A Mediawiki-powered social networking and collaboration platform
PHP
3
star
29

keyspace

Keyspace is a strongly consistent, replicated key-value datastore
C++
3
star
30

govuk-component-kit

Component Kit for creating GOV.UK frontend services
TypeScript
2
star
31

naaga

A modern, high-level, sexy programming language
2
star
32

mu

Β΅: the JavaScript microframework
CoffeeScript
2
star
33

oldproto

Proto implementation of the Espra Social Collaboration Platform
Go
2
star
34

gauge

Benchmark and performance test your JavaScript apps from the command line
JavaScript
2
star
35

misc-static

Misc static files
Python
2
star
36

static

Some CSS and Javascript files
JavaScript
2
star
37

blog

1
star
38

open-map

Map of open projects around the world
Python
1
star
39

pivotal-web

Web interface and command line tools for Pivotal Tracker
CoffeeScript
1
star
40

tweets.trustmaps.com

Trustmap Powered Twitter Stream
JavaScript
1
star
41

wifistat

Go
1
star
42

emacs-tav

Tav's Emacs Setup
Emacs Lisp
1
star
43

campaign-tweets

Campaign Tweets Tool for communicating effectively with your Twitter followers
Python
1
star
44

appreciation-modeler

Simulation models for the Appreciation Economy
Python
1
star
45

jshint-pretty

A minimalist pretty reporter for JSHint
JavaScript
1
star
46

rusty

A tool for managing Rust source code
Rust
1
star
47

sciencequestions

A Hackers-News clone for Scientific Questions
Arc
1
star
48

cajoleit

Cajoleit API Server for securing CoffeeScript and JavaScript with Caja
Java
1
star
49

babel-plugin-transform-auto-export

Babel plugin to auto export top-level declarations with a capitalized identifier
JavaScript
1
star
50

validate-rosetta

Validator for Rosetta API implementations
Go
1
star