Casey
b2f43307ff
* Added `testbuild` target. Used in development to test common compilers, as well as check for possible issues via OCLint. * `__{blk,bra}_*` now use state to get palette & other options. TODO: optimize number of ANSI color codes when fg==bg |
||
---|---|---|
obj | ||
src | ||
thirdparty | ||
.gitignore | ||
.gitmodules | ||
.oclint | ||
LICENSE | ||
Makefile | ||
README.md |
README.md
YAITAA - Yet Another Image To A(NSI) Art (converter)
Yes, very original. Old name is asciify-reborn
for reasons stated bellow
Reasons for reimplementation
Everything is already described in hatkidchan/asciify, but just as recap:
- I'm not happy with old project structure
- Some new features may be pain in the ass to add
- Spaghetti code
- Literally dublication
- Separate binaries for each mode
- Git submodules. Yay.
Build instructions
1. Make sure that you have C compiler and make
cc --version && make --version && echo 'ok'
Both of commands should succeed.
2. Clone repo
git clone --recursive https://github.com/hatkidchan/yaitaa
cd yaitaa
2. Build it
make
3. Run it
./yaitaa -M braille -S 256 -W 80 -H 24 ~/images/kitty.png
Build end notes
1. It is preferred to use clang
as your compiler
Main reason being that it is more strict, so any issues I've missed may be reported on that step. Feel free to send them to me!
CC=clang make
2. Strip binary to reduce size (saves ~100KiB)
strip ./yaitaa
3. Installation
It's not really designed to be installed system-wide, but if you really want to do so, do the following
# as root (using sudo/doas/etc.)
cp ./yaitaa /usr/local/bin/yaitaa
Alternatively, you can install it to your local directory, if it's in your
$PATH
:
cp ./yaitaa ~/.local/bin/yaitaa
License
yaitaa - Yet Another Image To A(NSI) Art (converter)
Copyright (C) 2022 hatkidchan <hatkidchan at gmail dot com>
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.