m4heshd / whatsapp-desktop-dark

Dark mode for WhatsApp desktop official version (Windows & macOS)

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool


WhatsApp Desktop Dark Mode by m4heshd
WhatsApp Desktop Dark Mode by m4heshd
Total downloads Closed issues Join the chat on Telegram

Stable version: 0.4.930 (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 make it look awesomely dark.

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

Windows

WhatsApp Desktop Dark Mode Windows

macOS

WhatsApp Desktop Dark Mode Mac

DISCLAIMER:

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.

Is this safe?

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.

Downloads

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.

Installation

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.

GUI installer is still in beta stage and might contain bugs. If you want to run the legacy commandline version, run with cli argument. WADark.exe cli for Windows and WADark cli for macOS.

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.

Custom Themes

You can find all the resources and theming related documentation right here.

How to remove the mod?

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)

My WhatsApp turned back to light theme after sometime. What to do?

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.

Build the installation script yourself

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)

  1. npm install (Wait for this to finish)
  2. npm run dist-win (Windows) or npm run dist-mac (macOS)
  3. Finally locate and run the binary file created in dist/$PLATFORM/ directory.

Method 2 (Run directly from source)

  1. npm install (Wait for this to finish)
  2. npm run run-gui for GUI installer or npm run run-cli for CLI installer

Simple as that.

Support this project

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.

Donate to m4heshd

Or you can buy me a "ko-fi" by clicking this button

ko-fi

Got an Issue?

There can be a numerous amount of issues in the mod since I can't be testing every single corner in the styles of this huge program. That specially applies to macOS version because I'm doing all the mac development and testing on a macOS VM.

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.

Known issues

Windows:

  • Automatically killing the WhatsApp process might take a little time or the process might repeat itself [unfixable/SW-HW dependent]

Changelog

Style changelog is available here.

License

"WhatsApp Desktop Dark Mode by m4heshd" 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.

About

Dark mode for WhatsApp desktop official version (Windows & macOS)

License:Other


Languages

Language:CSS 48.6%Language:JavaScript 46.3%Language:HTML 5.1%