5 releases (stable)

1.1.1 Nov 12, 2021
1.1.0 Nov 7, 2021
1.0.1 Oct 28, 2021
1.0.0 Oct 27, 2021
0.1.0 Oct 23, 2021

#2797 in Command line utilities

GPL-3.0 license

23KB
471 lines

aaa

Tui tool for 3a files rendering
Here is 3a format specification.
Here is a collection of 3a animations.
Example of render:
DNA

Usage

aaa 1.0.1

DomesticMoth

CLI tool for work with 3a files

USAGE:
    aaa [OPTIONS] [FILE]

ARGS:
    <FILE>    

OPTIONS:
    -c, --colors <COLORS>        Override colors param
        --colortable             Show table of available art colors
    -d, --delay <DELAY>          Override delay param
        --datacols <DATACOLS>    Override datacols param
        --demo                   Show demo animation
        --get-clear-body         Return source code body, stripped of comments and no display
                                 characters
        --get-escape-comments    Return source code without comments
        --get-header             Return source code header
        --get-param-audio        Get parameter audio value
        --get-param-author       Get parameter author value
        --get-param-colors       Get parameter colors value
        --get-param-datacols     Get parameter watacols value
        --get-param-delay        Get parameter delay value
        --get-param-height       Get parameter height value
        --get-param-loop         Get parameter loop value
        --get-param-preview      Get parameter preview value
        --get-param-title        Get parameter title value
        --get-param-utf8         Get parameter utf8 value
        --get-param-width        Get parameter width value
        --get-pretify-body       Return pretifyed source code body
    -h, --help                   Print help information
    -l, --looped <LOOPED>        Override loop param
    -p, --print                  Print source code instead of rendering it
        --preview <PREVIEW>      Override preview param
        --to-plain-text          Render to plain text instead of animation (render only preview
                                 frame)
    -V, --version                Print version information
    -x <X>                       Left up corner x position
    -y <Y>                       Left up corner y position

Instalation

Download binaries

You can download binaries from the github releases page

With "cargo install"

$ cargo install aaa

Manual compilation from sources

$ git clone https://github.com/DomesticMoth/aaa.git
$ cd aaa
$ cargo build --release

TODO

  • More human readable errors
  • Printitg only frames delta to save CPU load
  • Add to distro packages repos

Dependencies

~6.5MB
~111K SLoC