Faux is a chatbot bridge between urbit and discord. Whenever a member posts in your discord group, a bot will echo their message in your urbit group, and vice versa.

git clone https://github.com/midsum-salrux/faux

cd faux

pip3 install .

If you get TypeError: unsupported operand type(s) for +: 'NoneType' and 'str', it means that you haven't set these correctly. You can read about how to set environment variables here

Wherever your urbit bot is hosted. This will often be http://localhost:8080

Your urbit bot ship name, with no ~. For example, botdys-dozzod-tomdys

The +code of your urbit bot

You need to create a discord bot to self-host Faux. Here are some instructions

This environment variable is the API token of your discord bot. You can find it here:

When you create your OAuth2 URL, be sure to check these boxes

This file specifies where posts will be echoed between. Here's a sample:

[{"urbit_ship": "zod",
  "discord_group_id": 214365879012435876,
  "channels": [
      { "discord_channel_id": 123456789012345678,
        "urbit_channel": "general-1234" }]}]

The name of the ship hosting your chat (ordinarily the same as the ship hosting your group, but if they're separate, you want the chat ship).

No ~

The internal id of your discord group. You can find it from the URL

A list of channels you want to sync

The name and number of your urbit channel. You can find it from the URL

The internal id of your discord channel. You can find it from the URL

Invite your urbit bot to your urbit group, and your discord bot to your discord group, then run:

python3 faux/faux.py

Join ~tomdys/the-faux-shore on urbit

The bot will not trigger on its own messages, and the bot will not work in chats that it hosts itself. It's best to use a separate moon for your bot.