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.