Randibooru is a simple bot which allows users to fetch images from the [Derpibooru](https://derpibooru.org) pony image board.

Information about the bot can be found by using the `help` and `info` commands. All commands should be prefixed with `!rb` or a mention to the bot. A brief summary of some of the features may be found below.

## Users

While the name implies randomness, Randi has evolved beyond simple random image fetching. Currently, Randibooru supports 4 Derpibooru image-fetching commands:

### Commands

- `first`: Fetches the first image uploaded to Derpibooru matching the given query
- `latest`: Fetches the most recent image uploaded to Derpibooru matching the query
- `random`: Fetches a random image matching the given query
- `top`: Fetches the highest-rated image matching the given query

All queries are passed directly to Derpibooru, and use their [search syntax](https://derpibooru.org/search/syntax). Replies are sent as a **rich embed**, which requires link previews to be enabled both in the server settings and on your client.

Commands may be run in servers, or in a DM.

For users, this is all you need to know. However...

## Moderators/Server Owners

Randibooru is configuarable! If you don't like the way she operates, you're free to mess with her settings to your heart's content.

### Filters

Filters are a way to limit the tags users can find images matching. These are another Derpibooru feature which have been directly implemented into the bot. To change the default filters, use the `filter` command.

The structure for the `filter` command is: `filter <key> [<type>]`, where `key` is the numeric ID for the filter (a list of default filters can be obtained [here](https://derpibooru.org/filters)), which can be found after `/filters/` in the URL bar, and `type` is either `SFW` or `NSFW` to denote which filter you want to set.

The `SFW` filter will be used in most channels. By default, this is set to Derpibooru's [Default](https://derpibooru.org/filters/100073) filter, which is suitable for most servers. It hides "non-art" content, and anything that would be considered explicit.

Filters may only be set by the users with the **Manage Channels** permission.

### Blocking

You can block problematic users by using the `block` command. This prevents the bot from acknowledging any Derpibooru image requests, and can be useful for people that spam obscene images. This was mostly useful before filters were implemented, but may still prove useful if someone is overusing the bot.

To unblock a user, use the `unblock` command.

Blocks may only be put in place by users with the **Manage Messages** permission.

Randibooru

Pulls random images from Derpibooru for your Discord server's enjoyment.

التصويت لـRandibooru

هل ترغب في دعمنا؟