scroll/README.md

scroll

Scroll is full-featured IRC bot that carries a PENIS PUMP & will brighten up all the mundane chats in your lame IRC channels with some colorful IRC artwork! Designed to be extremely stable, this bot is sure to stay rock hard & handle itself quite well!

All of the IRC art is loaded directly from the ircart central repository using the Github API, which means that anytime the repository is updated with new art, you can simply .ascii sync & then be able to pump the latest art packs!

Designed to be portable, there is no API key needed, no local art files needed, & no reason to not setup scroll in your channel(s) today!

Dependencies

• python
• chardet (pip install chardet)
• pillow (pip install pillow)

Commands

Command	Description
@scroll	information about scroll
.ascii <name>	play the <name> art file
.ascii dirs	list of art directories
.ascii img <ur>	convert image <ur> to art (experimental, beta status)
.ascii list	list of art filenames
.ascii play <url>	play the contents of <url> (must be a raw pastebin url)
.ascii random [dir]	play random art, optionally from the [dir] directory only
.ascii search <query>	search art files that match <query>
.ascii settings	view settings
.ascii settings <setting> <option>	change <setting> to <option>
.ascii stop	stop playing art
.ascii sync	sync the ascii database to pump the newest art

NOTE: You can do .ascii help to play the help.txt file in your channel.

NOTE: The sync & settings commands are admin only! admin is a nick!user@host mask defined in scroll.py

Settings

Setting	Type	Description
flood	int or float	delay between each command
ignore	str	directories to ignore in .ascii random (comma seperated list, no spaces)
lines	int	max lines outside of #scroll
msg	int or float	delay between each message sent
paste	boolean	enable or disable .ascii play
png_brightness	int or float	increase or decrease brightness for .ascii img output
png_contrast	int or float	increase or decrease contrast for .ascii img output
png_effect	str	change the effect for .ascii img output (blackwhite, blue, greyscale, invert, or smooth)
png_palette	str	palette option for .ascii img output (RGB99 or RGB88)
png_width	int	maximum width for .ascii img output
results	int	max results to return in .ascii search

NOTE: Setting 0 to png_brightness, png_contrast, or png_effect will disable the setting.

Preview

Come pump with us in #scroll on irc.supernets.org

Todo

• git integration to git clone the ircart repository & git pull on .ascii sync (Load art files into RAM for faster pumping)
• .ascii scroll command to loop playing random art files (Stopped with .ascii stop)
• Add arguments to .ascii img for contrast, brightness, * effects (Take them out of self.settings)
• Setting to auto convert any image link to IRC art (Emulate link previews like on Discord LOL)
• .ascii record to record lines from the senders nick for uploads (Stopped with .ascii stop)
• Improve randomness with .ascii random
• Fall back to non-utf8 encoding on decoding failure (Reference: 'bytes' object has no attribute 'encode' on .ascii putfall)
• Convert all art to PNG files for an online gallery & local previews directory
• Possibly add art metadata (author, tags, etc) for credits & improved search

---

Mirrors

acid.vegas • GitHub • GitLab • SourceHut • SuperNETs