Skip to main content

Sync your IM group chat to Slack.

Project description

Chatroom-Syncer

pdm-managed License PyPI GitHub stars Code size Actions Status Code style: black

Chatroom-Syncer is a project to sync IM Chat Room to the public domain like IRC in the old days, so that the information, context and history of communication could be discoverred, learnt from and referenced by others, anyware, anytime.

https://user-images.githubusercontent.com/1651790/207810877-b86943fa-24b3-479c-ac25-d602a6c5d53c.mp4

Components and Flow

Component Docker Images
wechaty-gateway Docker Image docker:wechaty-gateway
chatroom-syncer Docker Image docker:chatroom-syncer

There are two processes in the system:

  • Chatroom Syncer, current code base in Python as the WeChaty Client and the bot
  • WeChaty Gateway, which leverages the Wechaty with UOS Wechat Client(also named as a puppet) to be called by the Chatroom Syncer due to WebChaty is not a native Python library, and the Wechaty Gateway is a gRPC server to manipulate and watch WeChat the puppet.

Thus, we need to start the WeChaty Gateway before the Chatroom Syncer.

┌────────────────────────────┐          ┌────────┐
│                            │          │        │
│ Chatroom Syncer            │          │        │
│                            │          │        │
│ WebChaty.onMessage()       ├──────────▶ Slack  │
│                            │          │        │
└──────────────▲─────────────┘          │        │
               │                        └────────┘
             gRPC
               │
┌──────────────▼──────────────┐
│                             │
│  Wechaty Gateway            │
│                             │
│┌────────────────────────┐   │
││ Wechaty UOS puppet     │   │
│└────────────────────────┘   │
└─────────────────────────────┘

Run

Before running, we need follow prerequisites:

  • Configure WeChat Group Names and Slack Channel Names in config.yaml, they should exist in both WeChat and Slack.
  • Configure Slack API Token in .env.

Run with Docker

Run it in background:

cp config-example.yaml config.yaml
cp env-example .env
docker-compose up -d

Check both containers are Up:

docker-compose ps

In case there are any Exit 0 containers, give another try of starting up:

docker-compose up -d

Scan the QR code with your WeChat App, and you are ready to go!

docker logs chatroom-syncer_chatroom-syncer_1 2>/dev/null | grep -v Wechaty

Stop it:

docker-compose down

Run from host

Run Webchaty gateway first:

export token="iwonttellyou"
docker run -d \
    --name=wechaty-gateway \
    --net=bridge \
    -p 9009:9009 \
    -e WECHATY_PUPPET_SERVICE_TOKEN="$token" \
    -v /wechaty_data:/wechaty/data \
    --restart=unless-stopped weygu/wechaty-gateway:latest

Run Chatroom-Syncer:

python3 -m pip install chatroom-syncer
cp config-example.yaml config.yaml
export SLACK_TOKEN="xoxb-1234567890-1234567890-1234567890-1234567890"
python3 -m chatroom_syncer

Configuration

WeChat

Copy the config-example.yaml to config.yaml

cp config-example.yaml config.yaml

And fill in the following fields in the table:

Field Description
enable_slack Switch of slack sink
group_channel_mapping Mapping WeChat group name to Slack channel name
enable_avatar Switch to generate emoji-based avatar for Slack sink
enable_github_discussion Switch of Github Discussion sink
group_github_discussion_mapping Mapping WeChat group name to discussion:owner/repo/category

Contribute

Build from host

git clone https://github.com/wey-gu/chatroom-syncer && cd chatroom-syncer
# install pdm
curl -sSL https://raw.githubusercontent.com/pdm-project/pdm/main/install-pdm.py | python3 -
# install chatroom-syncer
pdm install

If dependencies are updated, run pdm sync to update the lock manifest.

pdm sync

Build from docker

docker-compose -f docker-compose.dev.yaml build
docker-compose -f docker-compose.dev.yaml up -d

# get QR code to scan
docker logs chatroom-syncer_chatroom-syncer_1 2>/dev/null | grep -v Wechaty

# watch logs of the chatroom syncer
docker logs chatroom-syncer_chatroom-syncer_1 --follow

# stop the chatroom syncer and remove the container
docker-compose -f docker-compose.dev.yaml down

linting

# install pre-commit
pip install pre-commit

# run pre-commit
pre-commit run --all-files

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chatroom-syncer-0.1.7.tar.gz (18.7 kB view hashes)

Uploaded Source

Built Distribution

chatroom_syncer-0.1.7-py3-none-any.whl (18.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page