Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ratfink/asciiplayback

Play animations from ASCIImator.net
https://github.com/ratfink/asciiplayback

Last synced: 26 days ago
JSON representation

Play animations from ASCIImator.net

Awesome Lists containing this project

README

        

# ASCIIPlayback

yo waddup |
/ |/ |
\O- \ / ='_ O- o o.o |
%\ X # /! /|' /A\ / a >|
/ \ /@\ "|"|" |> / \ "|"|" /| |
"""""""""""""""""""""""""""""""""""""""""""

ASCIIPlayback is a program which plays files from
[ASCIImator](http://asciimator.net/). ASCIIPlayback is licensed under the MIT
license; see `LICENSE` for details.

## Dependencies

### `download_asciimation.py`

* Python 3 (3.5+ should be fine)

### Pygame Player

* Python 2 (tested with 2.7.7)
* Pygame (tested with 1.9.1)

### GTK Player

* Python 3 (tested with 3.4.1)
* PyGObject (tested with 3.12.2)

## Usage

### `download_asciimation.py`

ASCIImations are currently downloaded by download\_asciimation.py, which is
used as follows:

$ ./download_asciimation.py URL

where URL is the URL of the page you'd view in order to watch the ASCIImation
in your web browser. For instance, to download
[Intelligence (1)](http://asciimator.net/asciimation/7676), the command would
be this:

$ ./download_asciimation.py http://asciimator.net/asciimation/7676

The default filename is the number of the ASCIImation, but this can be changed
using the -o option.

### Pygame Player

Once an ASCIImation has been downloaded, it can be played using ASCIIPlayback.
This is done as follows:

$ src/asciiplaybackpygame.py FILE

where FILE is the name of the file downloaded by download\_asciimation.py.
Following our example above, this would be something like:

$ src/asciiplaybackpygame.py 7676.json

A window should appear with the ASCIImation playing. The player can be
controlled as described in the Controls section below.

#### Controls

* **Left mouse**: restart ASCIImation
* **Esc**, **Q**: quit
* **Space**: pause/play
* **PgUp**: rewind (3 levels, x2, x4, and x8)
* **PgDn**: fast-forward (3 levels, x2, x4, and x8)

### GTK Player

The GTK player can be started the same as the Pygame player, but the filename
is optional. ASCIImation files can be loaded from within the GUI at any time,
and the controls are all clickable buttons at the bottom of the window.

## Notes

Only the new JSON format is supported. This shouldn't be a problem since all
ASCIImations have been converted to this new format on ASCIImator, but any old
format files need to be re-downloaded.