oddluck-limnoria-plugins

History

Gordon Shumway 52ef689d1f update command help text		2019-04-15 07:19:16 -04:00
..
tmp	Update .gitignore	2019-03-14 07:15:25 -04:00
README.md	Update README.md	2019-04-15 01:29:01 -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	update command help text	2019-04-15 07:19:16 -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) 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/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.)