Skip to content

asciimoth/aaa

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

aaa

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

Usage

aaa 1.1.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

  • Add the ability to render 3a files from the Internet by URL
  • More human readable errors
  • Printitg only frames delta to save CPU load
  • Add to distro packages repos (currently only nixpkgs but nevertheless)