Skip to content
Whapp Web <-> Deltachat bridge
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
botcommands Add general "Accepts" method to BridgeContext and s/WhappBridge/TextM… Feb 17, 2020
bridge Add general "Accepts" method to BridgeContext and s/WhappBridge/TextM… Feb 17, 2020
whappdc Only use contact name when it's not an empty string Feb 4, 2020
.gitignore Initial commit: working echo command + config boilerplate Jan 3, 2020 Add README and example config Jan 8, 2020
config.yml.example Correct spelling Feb 15, 2020


Whapp-Deltachat is a bridge between WhatsApp and Deltachat. It uses go-whatsapp and go-deltachat respectively to map verified deltachat groups to whatsapp conversations. It is currently not full-featured and most likely is ridden with bugs, but pretty usable. Use at your own risk 🤓.


  • A system that go-deltachat will run on. It should work on all systems that are supported by golang and libdeltachat, but the static object file that is distributed with go-deltachat has been compiled on an amd64 linux system, so for other architectures you will need to compile the lib yourself.
  • An Android or iOS device that is capable of running the WhatsApp mobile app. go-whatsapp uses the WhatsApp Web API, so when you use this bridge you will still need to have a device that is running WhatsApp somewhere.


There are no stable releases as of yet, so the only installation method right now is just installing from source.

Installation example:

# clone
git clone

# build
cd ./whapp-deltachat
go build .

cp ./config.yml.example ./config.yml

# Now edit the config.yml file
"$EDITOR" ./config.yml

# Finally, run the program.
./whapp-deltachat ./config.yml

First run

During the first time the program runs, there are two QR codes that need to be scanned: First, the program will print a QR code to stdout. Scan this QR code from your deltachat client to become a verified contact of the bridge. The bridge will then create a verified chat with you and send you a QR code to scan from your WhatsApp mobile app. When you have done this, the bridge will start doing it's thing.

Known bug during first run

The first time that the bridge runs it will receive a lot of messages at the same time and not in chronological order. This means that pre-existing WhatsApp messages will not be in chronological order when they appear in your deltachat client. New messages received while the bridge is running will of course arrive in chronological order.

Feature checklist

This is a list of features that are either implemented already or will be implemented in the future.

  • Receive text messages
  • Receive image messages
  • Receive video messages
  • Receive audio messages
  • Receive document messages
  • Receive contact (vcf) messages
  • Send text messages
  • Send image messages
  • Send video messages
  • Send audio messages
  • Send document messages
  • Send contact (vcf) messages
  • See chat's profile pic
  • Sync user's deltachat profile pic with whatsapp profile pic
  • Change group chat name


This code is in no way affiliated with, authorized, maintained, sponsored or endorsed by WhatsApp or any of its affiliates or subsidiaries. This is an independent and unofficial software. Use at your own risk.

You can’t perform that action at this time.