Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/soda480/ascii-animator
A simple ASCII text animator
https://github.com/soda480/ascii-animator
animation ascii ascii-art pybuilder
Last synced: about 1 month ago
JSON representation
A simple ASCII text animator
- Host: GitHub
- URL: https://github.com/soda480/ascii-animator
- Owner: soda480
- License: apache-2.0
- Created: 2022-08-27T01:43:31.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-02T19:06:28.000Z (3 months ago)
- Last Synced: 2024-09-02T19:21:45.812Z (3 months ago)
- Topics: animation, ascii, ascii-art, pybuilder
- Language: Python
- Homepage:
- Size: 92.9 MB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ascii-animator
[](https://github.com/soda480/ascii-animator/actions/workflows/main.yml)
[](https://radon.readthedocs.io/en/latest/api.html#module-radon.complexity)
[](https://pypi.org/project/bandit/)
[](https://badge.fury.io/py/ascii-animator)
[](https://www.python.org/downloads/)
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](https://pypi.org/project/ascii-magic/), then display each frame to the terminal using [list2term](https://pypi.org/project/list2term/).
### Installation
```bash
pip install ascii_animator
```
### Usage
```
usage: ascii-art-animator [-h] [-s SPEED] [-f FILE] [-d] [-a] [-m MAX_LOOPS] [-c COLUMNS]
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
-a, --show_axis display the grid axis
-m MAX_LOOPS, --max_loops MAX_LOOPS
maximum number of loops, set to 0 to loop through image until keyboard interrupt (default 1)
-c COLUMNS, --columns COLUMNS
the number of characters per row (default 150)
```
### Examples
#### ASCII Art Animator
Use `ascii-art-animator` to convert the following GIF image to an ascii animation and demonstrate the use of the optional arguments.
* show x and y axis
* loop through the image 3 times
* set columns to 100 characters
```bash
ascii-art-animator -f docs/images/marcovich.gif -a -m 3 -c 100
```
**input**
**output**
### `Animation` class
Use the Animation class to create your own animations.
#### [Binary Search Animation](https://github.com/soda480/ascii-animator/blob/main/examples/example5.py)
A binary search is a search algorithm that finds a specific value in a sorted array by repeatedly dividing the search interval in half.
#### [Selection Sort Animation](https://github.com/soda480/ascii-animator/blob/main/examples/example4.py)
A selection sort search is a simple and efficient sorting algorithm that works by repeatedly selecting the smallest (or largest) element from the unsorted portion of the list and moving it to the sorted portion of the list.
Here is another [example](https://github.com/soda480/ascii-animator/blob/main/examples/example6.py) of a selection sort animation this time using vertical bars.
#### [Equalizer Bars Animation](https://github.com/soda480/ascii-animator/blob/main/examples/example2.py)
An animation for symmetrical equalizer bars.
#### [Matrix Animation](https://github.com/soda480/ascii-animator/blob/main/examples/example3.py)
A Matrix animation.
#### [Game-Of-Life](https://github.com/soda480/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:
```bash
docker image build \
-t ascii-animator:latest .
```
Run the Docker container:
```bash
docker container run \
--rm \
-it \
-v $PWD:/code \
ascii-animator:latest \
bash
```
Execute the build:
```sh
pyb -X
```