scroll

- irc bot to play ascii art
git clone git://git.acid.vegas/scroll.git
Log | Files | Refs | Archive | README | LICENSE

README.md (4554B)

      1 # scroll
      2 
      3 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!
      4 
      5 All of the IRC art is loaded directly from the [ircart](https://github.com/ircart/ircart) central repository using the [Github API](https://docs.github.com/en/rest), 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!
      6 
      7 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!
      8 
      9 ## Dependencies
     10 * [python](https://www.python.org/)
     11 * [chardet](https://pypi.org/project/chardet/) *(`pip install chardet`)*
     12 * [numpy](https://pypi.org/project/numpy/) *(`pip install numpy`)*
     13 * [opencv-python](https://pypi.org/project/opencv-python/) *(`pip install opencv-python`)*
     14 
     15 ## Commands
     16 | Command                                | Description                                                |
     17 | -------------------------------------- | ---------------------------------------------------------- |
     18 | `@scroll`                              | information about scroll                                   |
     19 | `.ascii <name>`                        | play the \<name> art file                                  |
     20 | `.ascii dirs`                          | list of art directories                                    |
     21 | `.ascii img <ur>`                      | convert image \<ur> to art *(experimental, beta status)*   |
     22 | `.ascii list`                          | list of art filenames                                      |
     23 | `.ascii play <url>`                    | play the contents of \<url> *(must be a raw pastebin url)* |
     24 | `.ascii random [dir|query]`            | play random art, optionally from a [dir] or [query]        |
     25 | `.ascii search <query>`                | search art files that match \<query>                       |
     26 | `.ascii settings [<setting> <option>]` | view or change settings                                    |
     27 | `.ascii stop`                          | stop playing art                                           |
     28 | `.ascii sync`                          | sync the ascii database to pump the newest art             |
     29 
     30 **NOTE**: You can do `.ascii help` to play the [help.txt](https://github.com/ircart/ircart/blob/master/ircart/doc/help.txt) file in your channel.
     31 
     32 **NOTE**: The sync & settings commands are admin only! `admin` is a *nick!user@host* mask defined in [scroll.py](https://github.com/ircart/scroll/blob/master/scroll.py)
     33 
     34 ## Settings
     35 | Setting               | Type         | Description                                                                                  |
     36 | --------------------- | ------------ | -------------------------------------------------------------------------------------------- |
     37 | `flood`               | int or float | delay between each command                                                                   |
     38 | `ignore`              | str          | directories to ignore in `.ascii random` *(comma seperated list, no spaces)*                 |
     39 | `lines`               | int          | max lines outside of #scroll                                                                 |
     40 | `msg`                 | int or float | delay between each message sent                                                              |
     41 | `paste`               | boolean      | enable or disable `.ascii play`                                                              |
     42 | `png_quantize_colors` | int          | quantize color option for `.ascii img` output                                                |
     43 | `png_palette`         | str          | palette option for `.ascii img` output *(RGB99 or RGB88)*                                    |
     44 | `png_width`           | int          | maximum width for `.ascii img` output                                                        |
     45 | `results`             | int          | max results to return in `.ascii search`                                                     |
     46 
     47 ## Preview
     48 
     49 ![](.screens/preview1.png)
     50 
     51 ![](.screens/preview2.png)
     52 
     53 Come pump with us in **#scroll** on [irc.supernets.org](ircs://irc.supernets.org)
     54 
     55 ___
     56 
     57 ###### Mirrors
     58 [acid.vegas](https://git.acid.vegas/scroll) • [GitHub](https://github.com/ircart/scroll) • [GitLab](https://gitlab.com/ircart/scroll) • [SuperNETs](https://git.supernets.org/ircart/scroll)