This gem will display art and some system information.
Homepage Repository Rubygems Documentation Download
gem install arTTY -v 0.4.1
Art for your TTY.
Open a terminal and run the following:
$ go get -ldflags "-s -w" -u gitlab.com/mjwhitta/artty/cmd/arTTY
Or install from source:
$ git clone https://gitlab.com/mjwhitta/artty.git
$ cd artty
$ make install
Note: make install
will install to $HOME/.local/bin
.
I typically add something like the following to the end of my bash/zsh configs:
[[ -z $(command -v arTTY) ]] || arTTY
Then I create an arTTY config using something like one of the following commands:
$ arTTY -c -f --fit -r -p -s --save
$ arTTY -c -e "emerald|III|shiny" --fit -m pokemon -p -r -s --save
$ arTTY -c -f --fit -m "megaman-battle-network" -p -r -s --save
$ arTTY -c --fit -m portal -p -r -s --save
$ arTTY -c -f -p -s --save linux-arch
$ arTTY -c --fit -p -s --save legend-of-zelda-majoras-mask
$ arTTY -c --fit -m "street-fighter-3" -p -r -s --save
Use the --ls
flags to see all included images. Occasionally you may
want to run arTTY --update
to download any new art.
Additionally, the system info portion is configurable.
You can add one of the below to your $HOME/.bashrc
or $HOME/.zshrc
to get tab completion.
if [[ -n $(command -v arTTY) ]]; then
_arTTY_complete() {
mapfile -t COMPREPLY < <(arTTY --ls -m "^$2" -p)
}
complete -F _arTTY_complete arTTY
fi
if [[ -n $(command -v arTTY) ]]; then
compdef _gnu_generic art artty arTTY
_arTTY_complete() { reply=($(arTTY --ls -p)); }
compctl -K _arTTY_complete arTTY
fi
ArTTY can generate source code from images too. It will automatically
determine the size, but you can specify a size manually by appending
_WIDTHxHEIGHT
to the filename. It uses the filename to name the art
unless you manually specify one. It will then cache any json files in
the $HOME/.config/arTTY/arTTY_images
directory.
$ arTTY -g my-art-name.png \
>"$HOME/.config/arTTY/arTTY_images/my-art-name.json"
$ arTTY -g my-art-name_WIDTHxHEIGHT.png \
>"$HOME/.config/arTTY/arTTY_images/my-art-name.json"
$ arTTY -g some_image.png my-art-name \
>"$HOME/.config/arTTY/arTTY_images/my-art-name.json"
This will traverse a WIDTH
by HEIGHT
grid and sample the color
inside each cell. It will then generate a json file. This works best
with sprites, however, it can parse any image this way.
Note: Make sure to run arTTY --cache
after generating new art.