defnotgustavom/ascii-matrix repository overview

• Running:

docker run -it --rm --log-driver none --cap-drop=ALL --read-only --net none --security-opt=no-new-privileges --name ascii-matrix -v /ascii/files/directory:/a/ defnotgustavom/ascii-matrix ascii-matrix -f /a/ascii.txt -o -t -h -e -r -f -l -a -g -s

Run "docker run -it --rm --log-driver none --cap-drop=ALL --read-only --net none --security-opt=no-new-privileges --name ascii-matrix defnotgustavom/ascii-matrix" for a perfect cmatrix clone + ascii elmo.

---

• HOW TO CREATE SUITABLE ASCII-ART txt FILES

This program renders ascii-art txt files that are contain these characters: " (white space), 1,2,3). In order to produce this kind of txt files, the program jp2a is used (https://github.com/cslarsen/jp2a⁠).

To install this program in Debian-base OSs:

apt-get install jp2a

To generate an ascii-art txt file from a png image, in order to use it with ascii-matrix, run the following command:

jp2a path/to/image.png --chars=" 123" --height=20>path/to/output.txt

• FLAGS

The user can either use the short or the long flag version (i.e. ascii-matrix -h and ascii-matrix --help are the same).

-f

--file

Defines the path to the ascii txt file to render in the center of the matrix window.

If this flag isn't used, the command will still render a matrix screen with no ascii art.

-s

--speed

Defines the speed of the matrix falling digits. Acceptable values 0-9 (default: 5).

-d

--dense

Defines the density of the matrix lines. Acceptable values 0-9 (default: 5).

-m1

--matrix-color1

Defines the color of first matrix digits (default: yellow).

-m2

--matrix-color2

Defines the color of matrix digits (default: green).

-c1

--ascii-color1

The first color of the ascii art (default: blue).

-c2

--ascii-color2

The second color of the ascii art (default: red).

-c3

--ascii-color3

The third color of the ascii art (default: white).

Acceptable color values: black, maroon, green, olive, navy, purple, teal, silver, grey, red, lime, yellow, blue, fuchsia, aqua and white. These colors are defined by the color profile of your terminal.

-i

--invert

Inverts the colors of the ascii art (background-foreground).

-a1

--ascii1

Defines the characters for the first category of the ascii art (default: L).

-a2

--ascii2

Defines the characters for the second category of the ascii art (default: L).

-a3

--ascii3

Defines the characters for the third category of the ascii art (default: L).

Acceptable -a1 -a2 -a3 values :

L Random uppercase letters [A-Z]

l Random lowercase letters [a-z]

n Random numbers [0-9]

s Space (best used in combination with -i or -d 9)

X the letter X

p Random punctuation marks '()*+,-./

You can download a few ascii samples and check some examples @ its official repo, https://gitlab.com/christosangel/ascii-matrix/-/tree/main/⁠.