WhatsApp Desktop

Unofficial WhatsApp Desktop Client for OSX, Linux and Windows. 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 versions of WhatsApp Desktop was written by:

• @bcalik : https://github.com/bcalik/Whatsapp-Desktop
• @Enrico204 : https://github.com/Enrico204/Whatsapp-Desktop

Features

• Cross platform (OSX, Windows x64, Linux ia32/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
• Auto-hide menu bar (Windows, Linux)
• Disabling GPU rendering (useful when dealing with bugged video drivers)
• 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

Download WhatsApp

• Windows 10/11 - Download -
• Mac OSX - Download -
• Ubuntu (32 bits) - Download -
• Ubuntu (64 bits) - Download -

Donations

❤️ Donations are always welcome ❤️.

Coins	Symbols	Addresses
	BTC	3B52fbzNFQTaKZxWf5GrCUsASD2UP8na4A
	ETH	0x1C389f1f85Cdb3C2996b83fAc87E496A80698B7C
	SOL	F14pWhGjGLcCF8RMk4JhbK2kD49iBBwa9KFygRJo54Fm

Build WhatsApp Debian/Ubuntu/Mint packages

Follow these instructions to install whatsapp-desktop on your system.

Install NPM and Yarn

You need NPM and Yarn to be installed on your system before building deb package.

• NPM : https://nodejs.org/en/download/package-manager/
• Yarn : https://yarnpkg.com/lang/en/docs/install/

Build Linux 32/64 bits packages

You can build whatsapp-linux-xxx.deb package with:

git clone https://github.com/oOthkOo/whatsapp-desktop.git
cd whatsapp-desktop
npm run build:linux   # for x64 arch
npm run build:linux32 # for x32 arch

You'll find debian packages into build/releases directory.

Install WhatsApp on Debian, Ubuntu, Mint, ...

sudo apt install ./build/releases/whatsapp-linux-x64.deb
sudo apt install -f

Contributions

Contributions are welcome! For feature requests and bug reports please submit an issue.

Build from source

To build from the source, run the following commands:

npm install
npm run build:{platform}

Platform	OS	Format
win	Windows only	zip
osx	OSX only	zip
osxm1	OSX arm64 (m1)	zip
linux	Linux 64 bits	deb
linux32	Linux 32 bits	deb
linuxarmv7l	ARM Linux	deb

Or if you wants build for all platforms:

npm install
npm run build:all

You'll find artifacts into build/releases/ directory.

Cross-build for Windows (from Linux/macOS)

Wine needs to be installed. On macOS, it is installable via Homebrew:

brew install wine

On Linux, it is installable via:

sudo apt 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)

Run on-the-fly (for devs)

If you're a developer, you may want to use directly yarn run dev (in project root) instead of compiling the code each time. Please note that autostart feature will not work in this mode.