sopel-boorus

Image board (booru) plugins for Sopel IRC bots.

Installing

Releases are hosted on PyPI, so after installing Sopel, all you need is pip:

$ pip install sopel-boorus

Depending on your Sopel bot's configuration, you might need to enable or disable the specific booru plugins (see below) that you want your bot to use. You can do so with the sopel-plugins command, e.g.:

$ sopel-plugins enable gelbooru

Booru plugins in this collection

• danbooru: Supports Danbooru (https://danbooru.donmai.us) links & searches
• gelbooru: Supports Gelbooru (https://gelbooru.com) links & searches

Installation requirements

The sopel-boorus package is written with Python 3 and Sopel 8.0+ in mind. Installation on Python 2, or usage with Sopel 7.x, is not supported.

Using

danbooru

Note: Danbooru strictly limits search capabilities for anonymous users, making this plugin more useful for link handling than searching, though it will be able to handle a tag or two just fine if you want a random pic.

Commands: .danb or .danbooru to search for a random post by tag(s)

Links: Handles post links, e.g. https://danbooru.donmai.us/posts/<post_id>

gelbooru

Commands: .gelb or .gelbooru to search for a random post by tag(s)

Links: Handles post links, e.g. https://gelbooru.com/index.php?page=post&s=view&id=<post_id>

Changelog

0.1.6

Changed:

• Provide a custom user-agent when calling booru APIs (#20)

0.1.5

Added:

• Post ID number in danbooru/gelbooru output (#15)

Changed:

• Don't append rating:general to md5: queries (#16)
• Cleaned up search_tags() abstraction (#11)

0.1.4

Fixed:

• Danbooru search handling was broken (#10)

0.1.3

Fixed:

• URL pattern for danbooru became too strict (#9)

0.1.2

Changed:

• URL patterns are stricter (#8)

Fixed:

• Unescape HTML entities in tag names (#7)
• Corrected post rating colors (#3)

0.1.1

Fixed:

• Handle more error cases (#1)

0.1.0

First release of sopel-boorus plugin collection.

Launch plugins are danbooru and gelbooru.