Plumeria, the Discord bot

Plumeria is madness distilled into a Discord bot. Sure, you can do things like search YouTube for a video, look up osu! stats, and do all those things, but

...you can feed the output of one command into another!

1. You like a YouTube video? .yt waterparks stupid
2. Want to write on it? .last | mb i like
3. Really like it? Let's make it black and white! .last | bw
4. Make it an emoji? .last | add emoji :waterparks:

What a terrible emoji. Let's make a new composition just with just Discord:

1. .render <b style="background: red; color: white">=')</b>
2. Oh yeah... make it an emoji! .last | add emoji :imhappy:

Let's make it personal! Let's say you have a private Spotify playlist named 70's classics and you want to show everyone a random song from it:

1. .spotify connect (first, connect your account to Spotify -- a one time thing)
2. .spotify pick 70's classics
3. Whoa... that's a list... let's play one of those songs on YouTube: .last | first | stripurl | yt

Discord rocks! .mt https://www.discordapp.com Discord | mb ROCKS!

There's very flexible support for command prefixes: .mt works, but so does . mt (helpful on mobile keyboards), but also . Mt or /mt, !mt, and so on.

Plumeria is written in Python 3. Plumeria is designed to work on Windows, Mac OS X, and Linux.

For Da Nerds

Cool stuff for plugin authors:

• Everything is a plugin! Everything! Even Discord support :smile:
• Support for command names with spaces in them
• Embedded web server that you can hook into
• Built-in OAuth support (i.e. used by the Spotify plugin so people can link their accounts)
• Support for images is implicit... you just call read_image() and it could have been a user-uploaded image, a linked image, or an OpenGraph image embedded on a webpage
• Built-in basic protection against SSRF and DNS rebinding attacks (but only if you use Plumeria's HTTP library(!))

Installation

To run Plumeria, see the documentation.

Command List

Alias

• alias
• alias delete
• alias get
• alias export

Configuration

• set
• set channel
• unset
• unset channel
• config get
• config info
• config list
• config defaults

Development

• unicode escape
• unicode name
• unicode code
• random user
• pypi
• packagist
• rubygems

Electronics

• resistors

Fun

• figlet
• 8ball
• roll
• choice
• coin
• group prob

Games

• minecraft status
• minecraft uuid
• minecraft body
• minecraft head
• minecraft face
• minecraft skin
• minecraft cape
• osu sig
• osu stats
• minesweeper start
• minesweeper
• minesweeper flag
• minesweeper cheat
• hangman start
• hangman

Graphing

• pie
• bar
• histogram
• graph
• digraph

Image

• drawtext
• blur
• edge enhance
• emboss
• find edges
• sharpen
• bw
• square
• bg
• make spray
• fetch image
• tex
• memetext
• memetext2
• qrcode

Inspection

• avatar
• user
• icon
• server

Management

• icon set
• emoji create
• emoji delete

Music

• events
• soundcloud
• artist charts
• charts
• lyrics
• lastfm
• lastfm tag
• lastfm artist
• spotify artist
• spotify track
• spotify album
• spotify discog
• spotify top
• spotify playlists
• spotify pick

Operations

• push
• pop
• put
• get
• argparse

Search

• stats
• politifact
• cheapshark
• bible
• similar music
• similar movies
• similar shows
• similar books
• similar authors
• similar games
• woot
• wikipedia
• image
• recipes
• abstract
• ore
• wolfram
• cve
• giphy
• sticker
• haveibeenpwned
• translate
• earthquakes
• subreddit
• reddit
• tumblr tag
• tumblr blog
• youtube
• latlng
• directions
• map
• beer
• strawpoll
• strawpoll results
• gravatar
• imdb
• anime
• manga
• wallhaven
• xkcd
• urban

Servers

• a2squery

Services

• connect

Statistics

• mean
• median
• median low
• median high
• median grouped
• mode
• pstdev
• pvariance
• stdev
• variance

Steam

• steam id
• steam profile
• steam avatar
• steam id64
• steam id32
• steam status

String

• upper
• lower
• rot13
• idna
• punycode
• base64
• base64dec
• md5
• sha1
• sha224
• sha256
• urlescape
• unurlescape
• length
• findurl
• stripurl
• strip
• extract
• first
• end
• key
• uuid
• dashuuid
• hexuuid

User Preferences

• pref set
• pref unset
• pref get
• pref list
• pref defaults

Utility

• ifttt
• join
• set avatar
• echo
• last text
• last image
• last url
• screenshot
• screenshot mobile
• render crop
• render full
• update
• shutdown
• uptime
• help
• commands dump
• timestamp
• changelog

License

The project is licensed under the MIT license.