Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/leovoel/BeautifulDiscord
Adds custom CSS support to Discord.
https://github.com/leovoel/BeautifulDiscord
demo-gif discord theme
Last synced: 2 months ago
JSON representation
Adds custom CSS support to Discord.
- Host: GitHub
- URL: https://github.com/leovoel/BeautifulDiscord
- Owner: leovoel
- License: mit
- Created: 2016-09-22T06:01:21.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2023-10-25T17:06:30.000Z (8 months ago)
- Last Synced: 2024-04-12T17:32:59.210Z (3 months ago)
- Topics: demo-gif, discord, theme
- Language: Python
- Size: 64.5 KB
- Stars: 680
- Watchers: 18
- Forks: 76
- Open Issues: 33
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-discord - BeautifulDiscord - Adds custom CSS support to Discord. (💬 Modifications)
README
BeautifulDiscord
================
Simple Python script that adds CSS hot-reload to Discord.
## 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](https://github.com/Jiiks/BetterDiscordApp)
- 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
