Install

Windows

Download wawf-windows-x64.exe from the latest release. No Python is needed. Run it from a terminal, or double-click it to open the window.

> wawf-windows-x64.exe <PROFILE> [options]

Caution:

The binary is unsigned. With Smart App Control enabled, Windows may refuse to run it (“An Application Control policy has blocked this file”). That block is reputation-based and can clear by itself after a while. Smart App Control cannot be turned back on once disabled, so running from Python instead is the safer workaround.

--history runs inside the .exe too: the linked-device client is implemented in Python, so no Node.js is needed.

Linux

Download wawf-linux-x64 from the latest release, or run from source as below.

From source (Linux and macOS)

$ git clone https://github.com/Mihir-Choudhary/Whatsapp-Web-Extractor.git$ cd Whatsapp-Web-Extractor$ pip install -r requirements.txt$ python3 wawf.py -h

requirements.txt installs cryptography, cramjam, websocket-client and ccl_chromium_reader (pinned to the commit the tool is tested against). python3 wawf.py -h also lists the browser profile locations on your machine as full paths.

Building your own binary

pyinstaller wawf.spec builds a binary for the current operating system. See BUILD.md in the repository for details and the release checklist.