oddluck-limnoria-plugins/ASCII
Gordon Shumway df86fa370b
Update README.md
2019-04-15 01:20:52 -04:00
..
tmp Update .gitignore 2019-03-14 07:15:25 -04:00
README.md Update README.md 2019-04-15 01:20:52 -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 paste.ee api. ansii2irc command. 16 color option 2019-04-15 00:39:27 -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

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)
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) is very fast. The following presets each get progressively slower)

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/Playback of ansi art .ans files from the web. Requires A2M https://github.com/tat3r/a2m)