/Whatsapp-Desktop

Unofficial whatsapp web desktop client for OSX, Linux and Windows. Build with Electron.

Primary LanguageJavaScript

WhatsApp Desktop Build Status

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

Features

  • Cross platform. (OSX, Windows, Linux)
  • 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
  • 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

Installation on ArchLinux

You can download the ArchLinux package from https://aur.archlinux.org/packages/whatsapp-desktop/

Thanks to @bil-elmoussaoui

Installation on Debian/Ubuntu

You can download the DEB package from the latest release

Installation (no package / others platforms)

Download and run the WhatsApp file from the latest release.

How to use in Linux

In order to execute the program in Linux, first you should give it permission to the App:

sudo chmod u+x WhatsApp
./WhatsApp

Contributions

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

Build

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.

Building Windows build from non-Windows platforms

Wine needs to be installed. On OS X, 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)

Build Debian package

After npm run build:linux, launch:

debuild -b -uc -us

Note that if version is changed you should use dch first.