Skip to content
Adds custom CSS support to Discord.
Branch: master
Clone or download
Pierce01 Fixes BeauD from crashing
... and not loading external style sheets

Electron v5 deprecated `registerURLSchemeAsBypassingCSP` apparently, here's a fix. Doesn't allow insecure content to be loaded like the other method.

fixes the following error
Latest commit 1848f2a Apr 8, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
beautifuldiscord Fixes BeauD from crashing Apr 8, 2019
.gitignore initial commit Sep 22, 2016
LICENSE initial commit Sep 22, 2016 initial commit Sep 22, 2016 fix inconsistent path on the README Feb 5, 2018
requirements.txt unpin psutil May 2, 2017 initial commit Sep 22, 2016


Simple Python script that adds CSS hot-reload to Discord.

demo gif


I wanted custom CSS injection for Discord, with no JavaScript add-ons or anything. That's BeautifulDiscord.

If you want JS, you can either:

You could also fork this repo and add it, it's not that big of a stretch. I just didn't add it because it's not what I want to do here.


Just invoke the script when installed. If you don't pass the --css flag, the stylesheet will be placed wherever the Discord app resources are found, which is not a very convenient location.

NOTE: Discord has to be running for this to work in first place. The script works by scanning the active processes and looking for the Discord ones.

(yes, this also means you can fool the program into trying to apply this to some random program named Discord)

$ beautifuldiscord --css C:\mystuff\myown.css
0: Found DiscordPTB.exe
1: Found DiscordCanary.exe
Discord executable to use (number): 1


You may now edit your C:\mystuff\myown.css file,
which will be reloaded whenever it's saved.

Relaunching Discord now...

Pass the --revert flag to restore Discord to its initial state. You can also do this manually if your Discord install gets screwed up, by first locating where Discord stores its resources:

  • On Windows, it's C:\Users\<username>\AppData\Roaming\discord[ptb,canary]\<version>\modules\discord_desktop_core
  • On OSX, it's ~/Library/Application Support/discord[ptb,canary]/<version>/modules/discord_desktop_core
  • On Linux, it's ~/.config/discord[ptb,canary]/<version>/modules/discord_desktop_core

(<...> means it's required, [...] means it's optional)

In that folder, there should be four files, with core.asar and original_core.asar being the interesting ones. You should then remove the existing core.asar and rename original_core.asar to core.asar.

$ beautifuldiscord --revert
0: Found DiscordPTB.exe
1: Found DiscordCanary.exe
Discord executable to use (number): 1
Reverted changes, no more CSS hot-reload :(

You can also run it as a package - i.e. python3 -m beautifuldiscord - if somehow you cannot install it as a script that you can run from anywhere.


python3 -m pip install -U

Usage of a virtual environment is recommended, to not pollute your global package space.


Normally, pip should install any required dependencies.

More GIFs

demo gif

You can’t perform that action at this time.