🌉 A cord to connect your Revolt and Discord servers

🔗 A bridge for Discord and Revolt with easy setup through commands, written in TypeScript using revolt.js.

Features | Setup | Configuration | Troubleshooting

• Bridge messages between platforms
• Bridge categories automatically
  • Creating categories
  • Moving channels to categories
• Bridge channels automatically ¹
  • Automatically create channel (Discord <-> Revolt)
  • Automatically update channel (Discord <-> Revolt) ²
  • Automatically disconnect channel on delete (Discord <-> Revolt)
• Bridge roles automatically (acts as a label only, permissions aren't synced!)
  • Create role
  • Update role
  • Delete role
  • Assign role
  • Unassign role
• Bridge attachments
  • Automatically reupload attachments to Revolt
• Bridge replies
• Bridge message edit and delete
• Bridge embeds
  • Include attachments
• Bridge emoji ³
  • Automatically import emoji
  • Mapping Discord emoji to Revolt variants
• Seamlessly display user information
• Initial import of channels & roles

1. Create a bot in Discord (Guide)

2. Important! Make sure to select the following permissions in URL Generator when making an invite for your bot (Your bot in Discord Developers -> OAuth2 -> URL Generator) (or if you're lazy, just select Administrator) Note applications.commands!

3. Enable the Message Content Intent under Bot -> Privileged Gateway Intents. If you forget to do this, the bot will crash with a Used disallowed intents message.

4. Create a bot in Revolt (Open user settings -> My Bots -> Create a bot)
5. Important! make sure to add the bot to a role that has the Masquerade permission!

7. Invite the bot to to a Revolt and Discord server.
8. Install & Start the bot using docker or node.

To help you get started creating a container from this image you can either use docker-compose or the docker cli.

services:
  revcord:
    image: ghcr.io/meme-bros/revcord:latest
    volumes:
      - /path/to/revcord.sqlite:/app/revcord.sqlite:rw
    environment:
      - DISCORD_TOKEN="INSERT_DISCORD_TOKEN_HERE"
      - REVOLT_TOKEN="INSERT_DISCORD_TOKEN_HERE"
    restart: unless-stopped

then run with docker compose up -d

docker run -d \
  --name revcord \
  -v "/path/to/revcord.sqlite:/app/revcord.sqlite:rw" \
  -e DISCORD_TOKEN="INSERT_DISCORD_TOKEN_HERE" \
  -e REVOLT_TOKEN="INSERT_DISCORD_TOKEN_HERE" \
  --restart unless-stopped \
  ghcr.io/meme-bros/revcord:latest

1. Clone this repository, install dependencies and build

git clone https://github.com/Meme-Bros/revcord.git
cd revcord
npm install
npm run build

2. Place the relevant tokens in environment variables. The easiest way is to copy .env.example file and fill in the following information

DISCORD_TOKEN = ...
REVOLT_TOKEN = ...

Of course, replace ... with tokens.

If you are running a self-hosted instance of Revolt, additionally set the API_URL and REVOLT_ATTACHMENT_URL variable to your own host:

API_URL = https://example.com/api
REVOLT_ATTACHMENT_URL = https://example.com/autumn

3. Start the bot using npm start

You can use either slash commands on Discord or rc! prefix on Revolt (use rc!help to show all commands)

To use the commands, you need the Administrator permission on Discord. On Revolt, only the server owner can run them (for now).

From Discord:

/connect <Revolt channel name or ID>

From Revolt:

rc!connect <Discord channel name or ID>

For example:

# From Discord
/connect lounge
/connect 01AB23BC34CD56DE78ZX90WWDB

# From Revolt
rc!connect general
rc!connect 591234567890123456

✔️ Send a message to see if it works. Try editing and deleting it.

From Discord:

/disconnect

From Revolt:

rc!disconnect

You don't have to specify any channel. It will disconnect the channel the command is sent in.

From Discord:

/connections

From Revolt:

rc!connections

You can toggle whether messages sent by bots should be forwarded. It's enabled by default (it's requied for NQN to work properly).

Use either rc!bots or /bots

This is an issue with node-sqlite3 being a native module, but has no prebuilt binaries for 32-bit arm architectures available, therefore falling back to building from source.

However, a Raspberry Pi is usually too low powered to finish compiling it.

So, the only solution would be to use a more powerful device to cross-compile it to arm. For convenience, a prebuilt binary for armv7l architecture was provided here

You have to place it in node_modules/sqlite3/lib/binding/napi-v6-linux-glibc-arm/node_sqlite3.node.

Alternatively, if your device supports it (Raspberry Pi 3 does), you can install a 64-bit distribution.

As in setup step 5, you need to enable the Message Content Intent in Discord bot settings. If this doesn't work, make sure the bot has permissions to read the messages in a channel.

Aside from server-wide permissions, there are also channel-specific permissions. This message means that at some point, the bot's permission to manage webhooks is being overridden on the channel level. The easiest fix is to change the override to allow it. Alternatively, you can grant the bot the Administrator permission which overrides all channel-specific permissions.

In channel settings -> Permissions: