Skip to main content

A simple ASCII art animator

Project description

ascii-animator

build complexity vulnerabilities PyPI version python

A simple ASCII text animator.

The ascii-art-animator CLI will take as input a GIF image, extract all the frames from it, convert each frame to ASCII art using ascii-magic, then display each frame to the terminal using l2term.

Installation

pip install ascii_animator

Usage

ascii-art-animator --help
usage: ascii-art-animator [-h] [-s SPEED] [-f FILE] [-d]

Ascii Art Animator from GIF

optional arguments:
  -h, --help            show this help message and exit
  -s SPEED, --speed SPEED
                        speed of the animation: very_slow, slow, normal, fast (default normal)
  -f FILE, --file FILE  the path to a gif file
  -d, --debug           display debug messages to stdout

Examples

ASCII conversion and animation of GIF images

Convert the following GIF image

ascii-art-animator -f docs/images/marcovich.gif

example

Convert the following GIF image

ascii-art-animator -f docs/images/afuera.gif -s fast

example

Game-Of-Life

A Conway Game-Of-Life implementation that uses ascii_animator to display the game to the terminal.

Development

Clone the repository and ensure the latest version of Docker is installed on your development server.

Build the Docker image:

docker image build \
-t \
ascii-animator:latest .

Run the Docker container:

docker container run \
--rm \
-it \
-v $PWD:/code \
ascii-animator:latest \
bash

Execute the build:

pyb -X

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ascii-animator-0.1.2.tar.gz (4.6 kB view hashes)

Uploaded Source

Built Distribution

ascii_animator-0.1.2-py3-none-any.whl (5.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page