https://github.com/deltachat-bot/chatmail2mastodon
Mastodon ↔️ Chatmail bridge
https://github.com/deltachat-bot/chatmail2mastodon
bridge chatmail deltachat fediverse mastodon
Last synced: 7 months ago
JSON representation
Mastodon ↔️ Chatmail bridge
- Host: GitHub
- URL: https://github.com/deltachat-bot/chatmail2mastodon
- Owner: deltachat-bot
- License: mpl-2.0
- Created: 2021-08-06T17:44:45.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2025-10-28T00:38:30.000Z (7 months ago)
- Last Synced: 2025-10-28T00:44:19.084Z (7 months ago)
- Topics: bridge, chatmail, deltachat, fediverse, mastodon
- Language: Python
- Homepage:
- Size: 208 KB
- Stars: 21
- Watchers: 0
- Forks: 0
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Mastodon Bridge
[](https://pypi.org/project/chatmail2mastodon)
[](https://github.com/deltachat-bot/chatmail2mastodon/actions/workflows/python-ci.yml)
[](https://github.com/psf/black)
A Mastodon ↔️ Chatmail bridge.
## Install
To install run:
```
pip install chatmail2mastodon
```
## Configuration
To configure the bot:
```sh
chatmail2mastodon init DCACCOUNT:https://nine.testrun.org/new
```
**(Optional)** To customize the bot name, avatar and status/signature:
```sh
chatmail2mastodon config selfavatar "/path/to/avatar.png"
chatmail2mastodon config displayname "My Bot"
chatmail2mastodon config selfstatus "Hi, I am a bot!"
```
Finally you can start the bot with:
```sh
chatmail2mastodon serve
```
To see the available options, run in the command line:
```
chatmail2mastodon --help
```
## User Guide
To log in with OAuth, send a message to the bot:
```
/login mastodon.social
```
replace "mastodon.social" with your instance, the bot will reply with an URL that you should open to grant access to your account, copy the code you will receive and send it to the bot.
To log in with your user and password directly(not recommended):
```
/login mastodon.social me@example.com myPassw0rd
```
Once you log in, A "Home" and "Notifications" chats will appear, in the Home chat you will receive your Home timeline and any message you send there will be published on Mastodon. In the Notifications chat you will receive all the notifications for your account.
If someone sends you a direct message in a private 1:1 conversation, it will be shown as a new chat where you can chat in private with that person, to start a private chat with some Mastodon user, send:
```
/dm friend@example.com
```
and the chat with "friend@example.com" will pop up.
To logout from your account:
```
/logout
```
For more info and all the available commands(follow, block, mute, etc), send this message to the bot:
```
/help
```