DoChat is a Dockerized WeChat (盒装微信) PC Windows Client for Linux
APACHE-2.0 License
DoChat(盒装微信) is a Dockerized WeChat(微信) PC Windows Client for Linux.
Image Credit: Docker 101 + Icon Finder, and Ps-ed by Ruoxin Song
We have received reports from our user said that their WeChat account has been disabled after using this project, so use it at your own risk:
WeChat PC will be started on your Linux desktop by running the following one-line command:
curl -sL https://raw.githubusercontent.com/huan/docker-wechat/master/dochat.sh | bash
If you’re in China, try the following one-line command if the above one-line command does not work well:
curl -sL https://gitee.com/mirrors/dochat/raw/main/dochat.sh | bash
Just copy/paste the above one-line command to your terminal and press Enter. Then the WeChat PC should appear in your XWindows desktop shortly.
The dochat.sh script must not be with uid 0 (root user). Running it with uid 0 will lead to an infinite loop
that is hard to kill from the terminal. If your user doesn't have the right to run docker please add the user to the docker group sudo usermod -aG docker $USER
.
A reboot might be neccessary for the changes to take place.
The issue is described in #60.
It just works out-of-the-box with one-line of shell command!
Ctrl+V
sudo apt update && apt install docker.io
to install Docker for Ubuntu users)nvidia-container-toolkit
may be installed (#173)DOCHAT_DPI
DPI Scale Factors for graphic screen resolution.
DPI | Scale factor |
---|---|
96 | 100% |
120 | 125% |
144 | 150% |
192 | 200% |
Default: 120
To enlarge the window & fonts size:
curl -sL https://raw.githubusercontent.com/huan/docker-wechat/master/dochat.sh \
| DOCHAT_DPI=192 bash
DOCHAT_SKIP_PULL
If you do not want to pull docker image for the latest version at startup everytime, you can set DOCHAT_SKIP_PULL
environment variable.
curl -sL https://raw.githubusercontent.com/huan/docker-wechat/master/dochat.sh \
| DOCHAT_SKIP_PULL=true bash
In case you have downloaded dochat.sh
:
DOCHAT_SKIP_PULL=true ./dochat.sh
DOCHAT_DEBUG
Show more debug log messages.
curl -sL https://raw.githubusercontent.com/huan/docker-wechat/master/dochat.sh \
| DOCHAT_DEBUG=true bash
DOCHAT_WECHAT_VERSION
Use a specific version for WeChat.
You can get a full list of the supported versions from Docker Hub Image Tags at https://hub.docker.com/r/zixia/wechat/tags
For example:
curl -sL https://raw.githubusercontent.com/huan/docker-wechat/master/dochat.sh \
| DOCHAT_WECHAT_VERSION=3.3.0.115 bash
If you want to control everything by yourself, for example, open multiple WeChat PC client on your desktop; then, you might want to inspect the dochat.sh in our repository and try the following docker command:
docker run \
--name DoChat \
--rm \
-i \
\
-v "$HOME/DoChat/WeChat Files/":'/home/user/WeChat Files/' \
-v "$HOME/DoChat/Applcation Data":'/home/user/.wine/drive_c/users/user/Application Data/' \
-v /tmp/.X11-unix:/tmp/.X11-unix \
-v "/run/user/$(id -u)/pulse":"/run/pulse" \
\
-e DISPLAY \
\
-e XMODIFIERS=@im=fcitx \
-e GTK_IM_MODULE=fcitx \
-e QT_IM_MODULE=fcitx \
-e GID="$(id -g)" \
-e UID="$(id -u)" \
\
--ipc=host \
--privileged \
\
zixia/wechat
Modify it whatever you want to fulfill your needs.
The docker image has two schema of the versioning:
X.Y.Z.a
: This is for the WeChat PC Windows Client version
zixia/wechat:2.7.1.85
: WeChat 2.7.1.85zixia/wechat:2.8.0.112
: WeChat 2.8.0.112x.y
: This is for the docker image version.
zixia/wechat:0.2
: docker-wechat version 0.2The two version schema may overlap with each other.
For example: the zixia/wechat:0.2
may be the same image as the zixia/wechat:2.8.0.112
.
DOCHAT_WECHAT_VERSION=2.7.1.85
)Install Gnome Extension: Top Icons Plus Git by bijignome
Note 1: there's almost half dozen of the
TopIcons
extensions with very similar name: TopIcons, TopIcons Redux, TopIcons Plus, TopIcons Plus Git, TopIconsFix. Use TopIcons Plus Git, it's the right one.Note 2: The
TopIcons Plus
has the bug that cause thewine
itself shows a window on your desktop. (#19)
When you encounter problem that the app exit with code 5 on openSUSE Leap, you need to disable X server access control to allow any user to connect to the X server before you start the app. Use below command to disable it:
$ xhost +
To address the issue (#150) do the following: (Thanks Wu Bo)
$ xhost +; sudo chown -R $USER $HOME/DoChat/
This could be caused by an old bug in wine with multiple monitor setup. Workaround is to start it up with single monitor and then switch to multiple monitors
This behavior may cause the view disappear when you use the Join Displays mode, so you need change the mode to mirrors when the app start, this script may help:
#bin/bash
xrandr --output HDMI-1-2 --same-as eDP-1-1
curl -sL https://raw.githubusercontent.com/huan/docker-wechat/master/dochat.sh \
| DOCHAT_SKIP_PULL=true bash &
sleep 5
xrandr --output HDMI-1-2 --right-of eDP-1-1
Change the HDMI-1-2 to your external display name and eDP-1-1 to your built in display name. Display more than two, link to this.
Notice: you must drag the login dialog to built in display side when the process sleep 5, otherwise the view may stuck in the external display.
master
to main
DOCHAT_WECHAT_VERSION
to select WeChat version.curl -sL https://raw.githubusercontent.com/huan/docker-wechat/master/dochat.sh \
| DOCHAT_WECHAT_VERSION=2.8.0.112 bash
DOCHAT_DPI
to set DPI scale factors for graphicg screen resolution.Got a great logo from my art friend Ruoxin SONG.
The first working version, cheers!
Project created.
Huan Li (LinkedIn) Tencent TVP of Chatbot.