aaa

Tui tool for 3a files rendering
Here is 3a format specification.
Here is a collection of 3a animations.
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

Installation

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

• playing
  • setting terminal title to art's title line
  • show art metadata under animation
• conversion
  • ansi frames
  • svg
  • asciicast
  • json
  • to png/jpg/bmp/etc
  • to gif
  • to video?
  • to webp??
• editing
  • set cell
  • colors
    • search or add color mapping
    • remove color mapping
      • replace unmapped color in art with _
    • remove whole palette
    • force disable/enable colors
  • frames
    • remove frame
    • dup frame
    • make sure frame exists
    • slice
    • swap two frames
    • reverse frames
    • dedup frames
    • rotate back / forth
  • pinning
    • text
    • colors
  • crop (shift + resize)
  • fill (whole art / single frame)
  • fill area (whole art / single frame)
  • clean (whole art / single frame)
  • print text
  • filters
  • tags
    • add tag
    • remove tag
    • remove all tags
  • delay
    • set global/per-frame delay
    • unset delays to default
  • header
    • set title
    • set authors
    • set orig authors
    • set src
    • set editor
    • set license
    • set loop
    • set preview
• art generation
• fetch
• ability to get 3a files by URL
• comments stripping
• art optimisation
• shell autocompletion
• MIME DB files
• Man pages
• usage examples
  • complex jq queries
  • editing