-
Notifications
You must be signed in to change notification settings - Fork 30
Installing Modifications
NOTE: This tutorial is intended for those that do not quite understand the installation instructions on mod's repository, or are having issues while trying to install it.
NOTE: If you get a Syntax Error when running any command, it means you are in the Python REPL. Type in exit() and then run the command again.
BeautifulDiscord is created in the Python programming language, and as such you must install it.
Open https://www.python.org in your preferred web browser and download the latest version.
Install Python and at the end there should be an option that says something along the lines of Add to PATH. If you don't check this, it'll make a future step slightly harder.
Open a command prompt/terminal, and enter python -m pip install -U https://github.com/leovoel/BeautifulDiscord/archive/master.zip, this will download and install BeautifulDiscord so that you can use it. If you did not add Python to PATH, navigate to the directory of where Python is installed and run the command.
If you get an error which says Unable to find vcvarsall.bat, you may need to download and install the Microsoft Visual C++ Compiler for Python 2.7
. If the error persists, follow the next steps.
If you get an error while installing that says something along the lines of Microsoft Visual C++ 14.0 is required, follow these steps.
A. If you do not have Visual Studio 2015 installed, go to http://landinghub.visualstudio.com/visual-cpp-build-tools and download the Visual C++ Build Tools 2015. When it's done installing, run python -m pip install -U https://github.com/leovoel/BeautifulDiscord/archive/master.zip again and it should work.
B. If you do have Visual Studio 2015 installed, it's a little bit harder.
- Open up the 'Change or remove a program' dialog, and find something along the lines of
Microsoft Visual Studio 2015in the list. Double-click it and a dialog will appear. PressModifythen selectProgramming Languages > Visual C++ > Common Tools for Visual C++ 2015. Press Ok and wait for it to install. This'll take a while. - When it's finished installing, run
python -m pip install -U https://github.com/leovoel/BeautifulDiscord/archive/master.zipagain and it SHOULD work.
Make sure that you have the version(s) of Discord that you would like to have BeautifulDiscord applied to, and in the command prompt, type python3 -m beautifuldiscord and it will generate a css file for you to edit. Alternatively, you can use python3 -m beautifuldiscord --css path/to/your.css and it'll automatically detect the open Discord instances and apply itself to them.
In the event that a Discord update causes BeautifulDiscord to unload, or it unloads in a crash, you can easily reapply it by following the instructions in step 3, as BeautifulDiscord is fairly forwards-compatible.
Press Windows Key + R to open the run dialog, type cmd and press Enter.
Open Finder, Select Utilities under the Applications tab, then double-click on Terminal.
This varies depending on what Linux distribution you are using, but if you are using Linux you should know. It is probably in your applications under System tools.
Follow the BeautifulDiscord guide, but replace beautifuldiscord with mydiscord, and use https://github.com/justinoboyle/mydiscord/archive/master.zip instead
NOTE: This tutorial is intended for those that do not quite understand the installation instructions on the DiscordInjections repository, or are having issues while trying to install it.
Find your download on https://git-scm.com/downloads and install it. On Linux, check if git is not already installed, or maybe available in your package manager.
Check if it's properly installed with git --version
Download node.js on https://www.npmjs.com/get-npm or find it in your package manager, and run through installment.
Check if it's properly installed with npm -v
Run the following code in CMD/Terminal while discord is open:
git clone https://github.com/DiscordInjections/DiscordInjections
cd DiscordInjections
npm install
If no errors appear in console, it should be installed correctly. The default css is stored in DiscordInjections/style.css, but can be changed by running the following in Console (Ctrl + Shift + I): _cssInjector.set("path/to/css");
Plugins can be installed in DiscordInjections/Plugins, check here for a list of pre-made plugins.
If in the npm install process you encounter an error similar to "VCBuild.exe" exited with code -1 in Windows, use the following command in Administrator:
npm install --global --production windows-build-tools
-
Download the binary from GH releases
-
Windows users need to add the
.exeextension, this is a bug in our build system but shouldn't pose a problem -
Open a terminal and run
./installer --ext-asar=falseorinstaller --ext-asardepending on your system, the installer will guide you through the installation -
Done! After the first startup, you should see a
.discord.modsfolder in your home directory. You can customize the look and feel of your client by creating the filetheme.cssinside that folder
You can try the more mature and stable ext-asar mode, this is the default when nothing is specified, simple replace --ext-asar=false with --ext-asar=true or omit it.
Note This requires installing node.js and the utility asar so it is available in the command line.
First, press Ctrl+I to open the console and check if it contains log messages from Discord.Mods.
If not, navigate to your Discord installation directory and check the app.asar has been unpacked correctly or when using the ext-asar engine, has been patched correctly. If it is unpacked but the file app.asar is still present, check that app.asar.bak exists and delete app.asar, then it should work.