Need help with BeautifulDiscord?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

leovoel
508 Stars 62 Forks MIT License 69 Commits 28 Opened issues

Description

Adds custom CSS support to Discord.

Services available

!
?

Need anything else?

Contributors list

# 2,378
Discord
discord...
python-...
cpp17
28 commits
# 125,473
Discord
React
CSS
HTML
23 commits
# 326,014
JavaScr...
Discord
discord...
Linux
5 commits
# 32,290
Python
python-...
async-p...
Postgre...
2 commits
# 407,942
Python
Discord
2 commits
# 466,308
Python
Discord
2 commits
# 534,562
Python
Discord
1 commit
# 85,150
Discord
Crystal
gtk
wlroots
1 commit
# 112,945
Discord
starter...
CSS
HTML
1 commit
# 531,497
Python
Discord
1 commit

BeautifulDiscord

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

demo gif

Motivation

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

If you want JS, you can either: - Use BetterDiscord - Make your own thing!

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.

Usage

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

Done!

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\\AppData\Roaming\discord[ptb,canary]\\modules\discord_desktop_core
  • On OSX, it's
    ~/Library/Application Support/discord[ptb,canary]//modules/discord_desktop_core
  • On Linux, it's
    ~/.config/discord[ptb,canary]//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.

Installing

python3 -m pip install -U https://github.com/leovoel/BeautifulDiscord/archive/master.zip

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

Requirements

  • Python 3.x (no interest in compatibility with 2.x, untested on Python 3.x versions below 3.4)
  • psutil
    library: https://github.com/giampaolo/psutil

Normally,

pip
should install any required dependencies.

More GIFs

demo gif

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.