falso
/
oddluck-limnoria-plugins
mirror of https://github.com/oddluck/limnoria-plugins.git
1
0
Fork 0
Code Issues Releases Wiki Activity
oddluck-limnoria-plugins/ASCII
History
Gordon Shumway c2dc09affc
add p2u. various other tweaks 		2019-04-16 20:33:44 -04:00
..
tmp Update .gitignore 2019-03-14 07:15:25 -04:00
README.md Update README.md 2019-04-15 22:01:48 -04:00
__init__.py Add files via upload 2019-03-14 06:42:48 -04:00
config.py add paste.ee api configs 2019-04-15 00:23:37 -04:00
plugin.py add p2u. various other tweaks 2019-04-16 20:33:44 -04:00
requirements.txt Update requirements.txt 2019-04-15 01:13:17 -04:00
test.py Add files via upload 2019-03-14 06:42:48 -04:00

README.md

#ASCII Art Plugin

Requires Limnoria https://github.com/ProgVal/Limnoria and Python3

pip install -r requirements.txt

Convert text to ASCII art or image URLs to ASCII/ANSI art. Support for the Paste.ee API to save art conversions for later use. Get an API key from https://paste.ee/account/api (FREE. Not required to use plugin, disabled by default).

config plugins.ascii.pasteAPI <PASTE.EE_API_KEY_HERE> (set paste.ee API key)
config channel plugins.ascii.pasteEnable <True/False> (enable/disable paste.ee links)

Text-to-ASCII Art (split lines with | ex. ascii|art for large fonts):

ascii <text> (convert <text> to ascii art)
ascii --font <font> <text> (to use chosen <font>)
ascii --color <color> <text> (to set a foreground <color>)
ascii --color <color1,color2> <text> (to set a foreground/background <color>)
fontlist (get list of availble <fonts>)

Image URL to ASCII/ANSI Art:

img <url> (convert an image <url> to ascii art using euclidian color distance and 99 color palette)
img --16 <url> (convert image to ascii art using euclidian color distance and 16 color palette)
img --invert <url> (invert the ascii luminance character palette)

ansi <url> (convert an <url> to ansi block art using euclidian color distance and 99 color palette)
ansi --16 <url> (convert <url> to ansi block art using euclidian color distance and 16 color palette)

Speed Presets. Euclidian (the default, no --speed preset) is very fast. The following presets each get progressively slower but color choice should improve with slower presets.

img/ansi --fast <url> (use cie1976 color difference algorithm)
img/ansi --slow <url> (use cie1994 color difference algorithm)
img/ansi --slower <url> (use cieCMC color difference algorithm)
img/ansi --slowest <url> (use cie2000 color difference algorithm)

Scroll ASCII/ANSI Art .TXT or .ANS Files from URL

scroll <url> (playback of ansi/ascii art .txt files from the web)
ansi2irc <url> (conversion and playback of ansi art .ans files from the web.)

ascii2irc command requires A2M https://github.com/tat3r/a2m (optional. disable command if not installing a2m.)