serenity on Grumble

Install

cargo add serenity tokio --features tokio/full

Point it at Grumble

Make a bot in the Developer Portal and copy its token. Then change two settings (marked):

use serenity::{client::ClientBuilder, http::HttpBuilder, prelude::*};

#[tokio::main]
async fn main() {
    let token = std::env::var("GRUMBLE_TOKEN").unwrap();
    let http = HttpBuilder::new(&token)        .proxy("https://grumble.gg")        .ratelimiter_disabled(true)        .build();    let intents = GatewayIntents::GUILD_MESSAGES | GatewayIntents::MESSAGE_CONTENT;
    let mut client = ClientBuilder::new_with_http(http, intents)        .event_handler(Handler)
        .await
        .unwrap();
    client.start().await.unwrap();
}

serenity's proxy setting stands in for Discord's address, and it asks the server for its gateway's. Turn its own rate limiter off: it sends every request to discord.com whatever the proxy says. Grumble limits rates itself, answering 429 with retry_after, which serenity follows.

For your own Grumble server, use its address instead of grumble.gg.

In encrypted servers: through the bridge

Grumble's servers are end-to-end encrypted, and our servers never hold the keys. Talking to Grumble directly, your bot gets their messages, names and what people type in its commands still sealed. The Grumble bridge is a small program you run next to your bot. It holds your bot's keys on your machine and serves your bot this same API on your own computer, with everything opened, and seals what your bot sends: messages, files, embeds, buttons and menus.

npx grumble-bridge --token $GRUMBLE_TOKEN

Then point serenity at the bridge instead of Grumble: .proxy("http://127.0.0.1:3170"). Nothing else changes. The bridge can also stand in for Discord's own addresses (its transparent mode), for a bot you'd rather not change at all.

What we test

Our bot sweep runs a serenity bot through the everyday things bots do, then plays a person in the app: reading its messages, using its command and pressing its button. It runs talking to Grumble directly, and through the bridge in an encrypted server. Last run 13 November 2026, with serenity 0.12.5: 58 of 58 directly, and 60 of 60 through the bridge.

✓ works. – not possible that way: Grumble's direct messages are end-to-end encrypted, so a bot can only send one through the bridge, which seals it.

Something not working? Tell us on the feedback page, with your library's version. serenity belongs to its authors; Grumble isn't affiliated with Discord Inc.