Skip to content

MitchellAW/FlandersBOT

Repository files navigation

Flanders

Flanders

Python Versions Discord Support Server FlandersBOT License MIT

A bot for sharing your favourite references!

A discord bot with commands surrounding The Simpsons, Futurama, Rick and Morty and more!

Flanders provides commands for sharing gifs and comics from The Simpsons, Futurama and Rick and Morty. Flanders uses Frinkiac, Morbotron and Master of All Science to share the requested Simpsons, Futurama and Rick and Morty images/gifs with their subtitles.

Add Flanders to your Discord Server

To view Flanders in Discord's application directory and more easily add Flanders to your own servers, click here. To invite Flanders to your own discord server and start using it now, click here

Usage

To share references from The Simpsons, Futurama, or Rick and Morty, you can use the /simpsons, /futurama, and /rickandmorty commands, followed by the quote that you'd like to search.

For example:

/simpsons nothing at all

/futurama shut up and take my money

/rickandmorty you pass butter

Then press the Send Gif or Send Comic button to share the reference in the channel!

Tip

You can also edit the captions used in the gif/comic before sending by using the Edit Captions button!

Preview

Support Server

If you need any help with Flanders, would like to provide feedback, suggestions or have any other questions regarding Flanders, join the Flanders Support Server on discord:

Flanders Support

Requirements

I'd prefer that instead of running an instance of Flanders yourself you'd just Invite Flanders to your own server. Or go ahead anyway.

Dependencies

Requires Python 3.13+ and uv

Utilises the latest version of discord.py Depends upon CompuGlobal

Requires PostgreSQL 17

Building and running with docker recommended:

docker compose build
docker compose up -d

Config

Copy example.env file and fill it with required credentials.

cp example.env .env

Database Setup

Create Database

sudo -u postgres psql
CREATE ROLE ned WITH LOGIN PASSWORD '<password>';
CREATE DATABASE flandersdb OWNER ned;

Create Tables

$ psql -h 127.0.0.1 -d flandersdb -U ned -f bot.sql

Credits

Creators of Frinkiac, Morbotron, Master of All Science, GoodGod Lemon and Capital Beat Us:

Paul Kehrer Sean Schulte Allie Young Source of the higher quality Adventures of Ned Flanders image /u/nmcfaden