WhatsApp desktop client, based on the official WhatsApp web app. Build with Electron.
This is NOT an official product. This project does not attempt to reverse engineer the WhatsApp API or attempt to reimplement any part of the WhatsApp client. Any communication between the user and WhatsApp servers is handled by official WhatsApp Web itself; this is just a native wrapper for WhatsApp Web, like a browser.
Original version of WhatsApp Desktop was written by @bcalik there: https://github.com/bcalik/Whatsapp-Desktop
- Cross platform (OSX, Windows x64, Linux x64 and ARM v7l)
- Native notifications
- System tray icon
- Open links in browser
- Badge with the number of notifications in the dock/taskbar
- Dock icon bounces when a new message is received
- Focus on contact search input via CMD+F (WIN+F)
- Phone info window (s/w versions, battery status, etc)
- Auto-launch on login
- Start minimized to tray icon
- Logging system (log to console and userData/log.log)
- Apply custom CSS stylesheet
- A couple of things can be configured:
- Toggle avatar visibility
- Toggle preview of the messages visibility
- Set the size for the media thumbs
- Proxy settings connect to WhatsApp web
@bil-elmoussaoui maintains the ArchLinux package, you can download it from https://aur.archlinux.org/packages/whatsapp-desktop/
DEB and RPM packages for amd64 and armv7l (armhf) are hosted in latest release page
For all other platforms: you can download ZIP files from latest release page.
--debug-log Switch file's log level to "debug" (default: "warn")
Apparently it's caused by an issue of Electron with an older version of Pango. Upgrade Pango at least to 1.40.12 or downgrade to 1.40.5 should fix this. See https://github.com/Enrico204/Whatsapp-Desktop/issues/13
This is due to some bugs between Electron and KDE on tray icons, see this comment on issue #27 and vector-im/riot-web#3133. A workaround is to uninstall libappindicator and libappindicator-gtk3 packages (this will change also the behavior of click on the tray icon).
Contributions are welcome! For feature requests and bug reports please submit an issue.
To build from the source, run the following commands:
npm install
cd app/
npm install
cd ..
npm run build:platform
where build:platform can be build:linux if you want to build only for Linux, build:osx for OSX only, build:win for Windows only, or simply build to build for all platforms.
You'll find artifacts into dist/ directory.
If you're a developer, you may want to use directly npm run dev (in project root) instead of compiling the code each time. Please note that autostart feature will not work in this mode.
Wine needs to be installed. On macOS, it is installable via Homebrew:
brew install wine
On GNU/Linux you can install wine from your distro package manager.
Please mind that wine requires an Xorg display, so you should set correctly your DISPLAY env var (you can use Xvfb if you don't have/want a real Xorg display running)