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, 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!
- python
- aiohttp (
pip install aiohttp) - chardet (
pip install chardet) - Pillow (
pip install Pillow) optional, for.ascii img - img2irc (patched build, run
./setup.sh) optional, for.ascii img
| Command | Description |
|---|---|
@scroll |
information about scroll |
.ascii [dir/]<name> |
play the <name> art file, optionally from a [dir] |
.ascii dirs |
list of art directories |
.ascii dupe [name] |
play every copy of the next unflagged duplicate name |
.ascii flag <name> <reason> |
flag bad art for review (saved to flagged.txt) |
.ascii help [img] |
list of commands, or every .ascii img option |
.ascii img <url> [options] |
convert an image to art (png, jpeg, gif, webp) |
.ascii list |
list of art filenames |
.ascii random [dir|query] |
play random art, optionally from a [dir] or [query] |
.ascii search <query> |
search art files that match <query> |
.ascii settings [<setting> <option>] |
view or change settings |
.ascii stop |
stop playing art |
.ascii sync |
sync the ascii database to pump the newest art |
NOTE: The flag, sync & settings commands are admin only! admin is a nick!user@host mask defined in scroll.py
| Setting | Type | Description |
|---|---|---|
flood |
int or float | delay between each command |
ignore |
str | directories to ignore in .ascii random (comma seperated list, no spaces) |
imgflood |
int or float | delay between each .ascii img command |
linelen |
int | server line limit in bytes, including the trailing \r\n (art lines are trimmed to fit) |
lines |
int | max lines outside of #scroll |
msg |
int or float | delay between each message sent |
results |
int | max results to return in .ascii search |
.ascii img is optional: without Pillow or the img2irc binary scroll runs fine, the command replies that image support is not enabled & both it & the .ascii help img topic are left out of .ascii help.
.ascii img accepts any img2irc option except --render (always irc) & --scale. The width defaults to & is capped at 80 columns (it shrinks automatically when a line would not fit the server line limit) & the height is capped at the lines setting. Images are downloaded by scroll (public addresses only, max 10 MB & 4096x4096) & validated with Pillow before img2irc ever sees them.
Run setup.sh to build it (needs a rust toolchain):
./setup.shIt clones img2irc at commit 74aa4f6 (v2.0.1-alpha) into ~/src/img2irc (pass a path to use another directory), applies img2irc.patch, runs cargo audit when it is installed & installs the binary to ~/.cargo/bin/img2irc where scroll looks for it.
The patch removes img2irc's own url fetching (reqwest & url, which also drops openssl) so the binary has no network access at all, & fixes two build errors in the no-ocr configuration. Everything is built with --no-default-features, which leaves out the ocr feature (onnx runtime, third party model downloads at runtime, figlet & zip) while keeping the renderer, glyph sets, smoothing & svg support.
Come pump with us in #scroll on irc.supernets.org