{"id":14986947,"url":"https://github.com/m4heshd/whatsapp-desktop-dark","last_synced_at":"2025-04-04T18:08:03.569Z","repository":{"id":35538725,"uuid":"203814394","full_name":"m4heshd/whatsapp-desktop-dark","owner":"m4heshd","description":"Dark mode for WhatsApp desktop official version (Windows \u0026 macOS)","archived":false,"fork":false,"pushed_at":"2022-12-11T22:48:11.000Z","size":32618,"stargazers_count":623,"open_issues_count":41,"forks_count":76,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-03-28T10:01:56.893Z","etag":null,"topics":["dark-mode","dark-theme","night-mode","tweak","whatsapp","whatsapp-dark-theme","whatsapp-desktop","whatsapp-web"],"latest_commit_sha":null,"homepage":null,"language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/m4heshd.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.txt","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null},"funding":{"ko_fi":"m4heshd","custom":["https://www.paypal.me/mpwk"]}},"created_at":"2019-08-22T14:42:02.000Z","updated_at":"2025-03-03T18:07:39.000Z","dependencies_parsed_at":"2023-01-15T23:15:56.318Z","dependency_job_id":null,"html_url":"https://github.com/m4heshd/whatsapp-desktop-dark","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m4heshd%2Fwhatsapp-desktop-dark","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m4heshd%2Fwhatsapp-desktop-dark/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m4heshd%2Fwhatsapp-desktop-dark/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m4heshd%2Fwhatsapp-desktop-dark/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/m4heshd","download_url":"https://codeload.github.com/m4heshd/whatsapp-desktop-dark/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247226215,"owners_count":20904465,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dark-mode","dark-theme","night-mode","tweak","whatsapp","whatsapp-dark-theme","whatsapp-desktop","whatsapp-web"],"created_at":"2024-09-24T14:13:51.104Z","updated_at":"2025-04-04T18:08:03.545Z","avatar_url":"https://github.com/m4heshd.png","language":"CSS","funding_links":["https://ko-fi.com/m4heshd","https://www.paypal.me/mpwk","https://www.paypal.me/mpwk?locale.x=en_US"],"categories":["others"],"sub_categories":[],"readme":"\n\u003ch1 align=\"center\"\u003e\n  \u003cbr\u003e\n\u003cimg src=\"https://i.ibb.co/SJjdwmF/banner-logo.png\" alt=\"WhatsApp Desktop Dark Mode by m4heshd\"\u003e\n  \u003cbr\u003e\nWhatsApp Desktop Dark Mode by \u003ca href=\"https://github.com/m4heshd\"\u003em4heshd\u003c/a\u003e\n  \u003cbr\u003e\n\u003cimg src=\"https://img.shields.io/github/downloads/m4heshd/whatsapp-desktop-dark/total.svg?label=Downloads\u0026logo=WhatsApp\u0026color=5792ff\u0026logoColor=5792ff\u0026labelColor=272c35\" alt=\"Total downloads\" height=\"25.2\"\u003e\n\u003ca href=\"https://github.com/m4heshd/whatsapp-desktop-dark/issues?q=is%3Aissue+is%3Aclosed\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues-closed/m4heshd/whatsapp-desktop-dark?label=Issues\u0026logo=github\u0026color=5792ff\u0026logoColor=5792ff\u0026labelColor=272c35\" alt=\"Closed issues\" height=\"25.2\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://t.me/wadarkmodechat\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/static/v1?label=Telegram%20Chat\u0026logo=Telegram\u0026color=5792ff\u0026logoColor=5792ff\u0026labelColor=272c35\u0026message=Join\" alt=\"Join the chat on Telegram\" height=\"25.2\"\u003e\n\u003c/a\u003e\n  \u003cbr\u003e\n\u003c/h1\u003e\n\nStable version: [**`0.4.930`**](https://github.com/m4heshd/whatsapp-desktop-dark/releases/tag/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)\n\nThis mod is a simple tweak for [WhatsApp Desktop **Official** version](https://www.whatsapp.com/download/) to make it look awesomely dark.\n\n\u003cspan color=\"red\"\u003e⚠ **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**  \u003c/span\u003e\n\u003ch4 align=\"center\"\u003e Windows \u003ch4\u003e\n\n![WhatsApp Desktop Dark Mode Windows](https://i.ibb.co/fnrk4p4/Screenshot.png)\n\n\u003ch4 align=\"center\"\u003e macOS \u003ch4\u003e\n\n![WhatsApp Desktop Dark Mode Mac](https://i.ibb.co/hy333DT/Screenshot-mac.png)\n\n### DISCLAIMER:\n\u003e **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.**\n\n# Is this safe?\nThe 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?\n\n**NOTE:** This script will not replace any of the functionality related coding inside WhatsApp. Just the styling.\n\n# Downloads\n\n**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](https://github.com/nexe/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.\n\n - [All releases (with source)](https://github.com/m4heshd/whatsapp-desktop-dark/releases)\n - Windows (x86 \u0026 x64) - [Download](https://github.com/m4heshd/whatsapp-desktop-dark/releases/download/0.4.930/WADark-0.4.930-Windows.zip)\n - macOS (x64) - [Download](https://github.com/m4heshd/whatsapp-desktop-dark/releases/download/0.4.930/WADark-0.4.930-macOS.zip)\n\n## Installation\n\nMake sure you have [WhatsApp Desktop](https://www.whatsapp.com/download/) installed in your PC or mac first.\n\n⚠ **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**\n\nMake sure WhatsApp Desktop is running before you start the installation. Then wait for the process to finish. That's it.\n\nSimply 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.\n\n⚠ **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.**\n\n**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.\n\n## Custom Themes\n\nYou can find all the resources and theming related documentation [right here](https://github.com/m4heshd/whatsapp-desktop-dark/tree/master/themes).\n\n### How to remove the mod?\nSimply 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)\n\n### My WhatsApp turned back to light theme after sometime. What to do?\nThis 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.\n\n# Build the installation script yourself\n\nBuilding process is really simple even if you're not a pro developer. You will just need [NodeJS](https://nodejs.org) and [NPM](https://www.npmjs.com/) (Usually packed with NodeJS) installed on your computer to build and run the script yourself.\n\nClone 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.\n\n**Method 1 (Build binaries)**\n\n 1. `npm install`  (Wait for this to finish)\n 2. `npm run dist-win` (Windows) or `npm run dist-mac` (macOS)\n 3. Finally locate and run the binary file created in `dist/$PLATFORM/` directory.\n\n**Method 2 (Run directly from source)**\n\n 1. `npm install`  (Wait for this to finish)\n 2. `npm run run-gui` for GUI installer or `npm run run-cli` for CLI installer\n\nSimple as that.\n\n# Support this project\n\nInvolvement 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.\n\n[![Donate to m4heshd](https://i.ibb.co/3vQTMts/paypal-donate-icon-7.png)](https://www.paypal.me/mpwk?locale.x=en_US)\n\nOr you can buy me a \"ko-fi\" by clicking this button\n\n[![ko-fi](https://i.ibb.co/QmQknmc/ko-fi.png)](https://ko-fi.com/m4heshd)\n\n# Got an Issue?\n\nThere 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.\n\n[Follow this link](https://github.com/m4heshd/whatsapp-desktop-dark/issues) 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.\n\n# Known issues\n\n**Windows:**\n\n - Automatically killing the WhatsApp process might take a little time or the process might repeat itself [`unfixable/SW-HW dependent`]\n\n# Changelog\n\nStyle changelog is available [here](changelog.txt).\n\n# License\n\"WhatsApp Desktop Dark Mode by m4heshd\" is licensed under [MIT License](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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm4heshd%2Fwhatsapp-desktop-dark","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fm4heshd%2Fwhatsapp-desktop-dark","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm4heshd%2Fwhatsapp-desktop-dark/lists"}