WhatsApp Desktop Dark Mode by firefinchdev
This is a fork of WhatsApp Desktop Dark Mode by m4heshd
Stable version: 2.2025.7 (Check if this version matches with your version of WhatsApp. The mod will still work even if the versions doesn't match)
This mod is a simple tweak for WhatsApp Desktop Official version to enable dark mode until it is released officially. It works for Windows and macOS.
⚠ Please note that this script won't work with Microsoft store or App store version of WhatsApp desktop. You need to use the direct downloaded version linked above
This is not an official version of WhatsApp Desktop Dark mode. So make sure to read through this document before you use this mod because i won't be responsible for any damage you've done yourself trying to install this mod (It's not even that hard 🙄). The coding/styling behind this tweak has full transparency since I've made it open-source right here.
- Download the files.
- Run the downloaded files.
- Open WhatsApp Desktop -> Settings -> Chats -> Theme and select Dark.
The answer is right there on the top. This is an open source project. which literally means that you can see through the source code of this mod. So I CANNOT STEAL YOUR MESSEGES, I CANNOT TAP INTO YOUR CALLS. If you're like one of the "Anti-Vaccination" parents, please avoid using this mod. Wouldn't you rather use the official WhatsApp version with a simple tweak like this than using some random third-party app just to have a proper dark UI?
NOTE: This script will not replace any of the functionality related coding inside WhatsApp. Just the styling.
NOTE: THIS IS NOT A MODDED VERSION OF WhatsApp. WhatsApp Desktop Dark Mode is a simple set of styling that needs to be injected to the source files of your current installation of WhatsApp. I've made it much easier by creating a installation script using NodeJS and made it easier furthermore by creating simple executable files using nexe. If you don't trust the executable files I've provided below, you can build and run it from the source code itself by following the instructions in the next section.
- All releases (with source)
- Windows (x86 & x64) - Download
- macOS (x64) - Download
Make sure you have WhatsApp Desktop installed in your PC or mac first.
⚠ Please note that this script won't work with Microsoft store or App store version of WhatsApp desktop. You need to use the direct downloaded version linked above
Make sure WhatsApp Desktop is running before you start the installation. Then wait for the process to finish. That's it.
Simply extract the downloaded ZIP file and run WADark.exe on windows. For macOS you'll need to make WADark executable first, by executing chmod +x WADark from the root of extracted directory. Then run it with WADark from the same directory.
NOTE: It's recommended not to delete the script folder after the installation because the script automatically creates a backup of your original WhatsApp source in case you need to revert back to the original version.
Simply rerun the script and it will ask you to restore the backup made by any previous installations. (Or use the button on top left to switch to light mode)
This means that your WhatsApp build is probably auto updated to a newer version. Rerun the script and It'll tell you if a new version is available. Even if the dark mode version is not updated, just rerun the script and install the dark mode again.
Building process is really simple even if you're not a pro developer. You will just need NodeJS and NPM (Usually packed with NodeJS) installed on your computer to build and run the script yourself.
Clone or download this repository, cd to that directory and enter the following commands to start the script. There are two methods you can run the script.
Method 1 (Build binaries)
npm install(Wait for this to finish)npm run dist-win(Windows) ornpm run dist-mac(macOS)- Finally locate and run the binary file created in
dist/$PLATFORM/directory.
Method 2 (Run directly from source)
npm install(Wait for this to finish)npm run run-guifor GUI installer
Simple as that.
Involvement as a contributor by adding a few lines of code, fixing a bug, responding to issues, testing etc.. would be one of the most helpful methods you could support the project. If you're not a programmer but a generous person, you can send a small donation this way buy clicking the following button.
Or you can buy me a "ko-fi" by clicking this button
Follow this link to submit your issues and please remember to be descriptive when submitting issues. Also don't forget to attach a small screenshot if the issue is style/GUI related.
Windows:
- Automatically killing the WhatsApp process might take a little time or the process might repeat itself [
unfixable/SW-HW dependent]
"WhatsApp Desktop Dark Mode by firefinchdev" is licensed under MIT License. So you are allowed to use freely and modify the application. I will not be responsible for any outcome. Proceed with any action at your own risk.