a simple whatsapp web <-> irc gateway
- private chats;
- group chats, with op for admins;
- kicking, inviting, and stuff;
- LIST, WHO (with online/offline state);
- joining chats;
- converts names to irc safe names as much as possible;
- receiving files, hosts it as using a HTTP file server;
- receiving locations, will send a Google Maps link to the location;
- receiving reply messages;
- generating QR code;
- saves login state to disk;
- replay using
- no configuration needed;
- probably some stuff I forgot.
To use whapp-irc optimally you should set the following client capabilities:
server-time(this will show the time when the message was sent in whatsapp in your IRC client, instead of when the bridge received it);
whapp-irc/replay(this will replay all the messages the bridge missed, for example: when the bridge is turned off. The bridges stores the timestamp of the last message for every chat on disk and will send all newer messages to the client).
All configuration is done using environment variables. Quick and simple.
HOST: the IP/domain used to generate the URLs to media files;
FILE_SERVER_PORT: the port used for the file httpserver, if not 80 it will be appended to the URLs;
IRC_SERVER_PORT: the port to listen on for IRC connections;
verbose, if verbose it will log all communication between whapp-irc and the chromium instance;
MAP_PROVIDER: The map provider to use for location messages: can be one of
It's recommend to use the docker image. It's also the only supported version, since this way we have a consistent, predictable and reproducible version.
docker run -d \ --name whapp-irc \ -v PATH_TO_DIR_FOR_DATA_HERE:/root \ -p 6667:6060 \ -p 3000:3000 \ -e "HOST=IP_ADDRESS_OR_DOMAIN_HERE" \ lieuwex/whapp-irc
make sure you have go and dep, then clone the repo in your
dep ensure go build ./whapp-irc