Go to file

Zack Rauen 74b2dace04 Restructure BD into a small mono-repo This is a repo-wide refactor that introduces the injector to the main branch. The new architecture is as such: common/ injector/ renderer/		2021-03-06 03:30:16 -05:00
.github	Wrap with try..catch	2020-07-27 12:41:14 -04:00
assets	Emotes semi-rewrite, removal of old styles and broken setting, temporarily comment out patcher code for .bd-guild. (#511 )	2020-12-12 15:33:32 -05:00
common	Restructure BD into a small mono-repo	2021-03-06 03:30:16 -05:00
injector	Restructure BD into a small mono-repo	2021-03-06 03:30:16 -05:00
renderer	Restructure BD into a small mono-repo	2021-03-06 03:30:16 -05:00
scripts	Restructure BD into a small mono-repo	2021-03-06 03:30:16 -05:00
tests	Restructure BD into a small mono-repo	2021-03-06 03:30:16 -05:00
.eslintrc	Restructure BD into a small mono-repo	2021-03-06 03:30:16 -05:00
.gitignore	Adds some final touches	2020-07-30 11:34:59 -04:00
.travis.yml	Removes gulp dependency	2020-10-24 20:10:46 -04:00
CONTRIBUTING.md	Restructure BD into a small mono-repo	2021-03-06 03:30:16 -05:00
LICENSE	some organization and devops	2020-07-23 16:51:58 -04:00
README.md	Fixes minor bugs	2021-02-22 17:53:21 -05:00
lgtm.yml	more devops/ci stuff	2020-07-24 00:07:50 -04:00
package-lock.json	Restructure BD into a small mono-repo	2021-03-06 03:30:16 -05:00
package.json	Restructure BD into a small mono-repo	2021-03-06 03:30:16 -05:00

README.md

BetterDiscord

BetterDiscord is a client modification for Discord. This allows you to add plugins and themes to your personal copy of Discord. BetterDiscord also adds a number of other features out of the box.

Installation

Auto Installers

Windows

Grab the exe file from here.

macOS/OS X

Grab the zip file from here.

Linux

See this gist.

Manual Installation

Windows

Download and extract this: https://github.com/rauenzi/BetterDiscordApp/archive/injector.zip
Rename BetterDiscordApp-injector to app.
Go to %localappdata%\Discord\, and locate the directory with the largest version number (e.g. app-0.0.306).
Within app-0.0.306 navigate to resources.
If an app folder already exists inside resources, delete it.
Move the app folder (the one you downloaded and renamed) inside of resources.
Fully quit Discord and restart it.

macOS/OS X

Download and extract this: https://github.com/rauenzi/BetterDiscordApp/archive/injector.zip
Rename BetterDiscordApp-injector to app.
Go to /Applications/, right click Discord.app and select Show Package Contents.
Within Discord.app navigate to Contents -> Resources.
If an app folder already exists inside Resources, delete it.
Move the app folder (the one you downloaded and renamed) inside of Resources.
Fully quit Discord and restart it.

Local Installation

By default BD loads majority of the package through a CDN at runtime so you always have the latest version. However, if you'd rather only load something from your PC and update when you want, you can do that too!

Prerequisites: Node.js 12.x+ and the package manager npm.

Clone this repository git clone https://github.com/rauenzi/BetterDiscordApp.git
Install dependencies with npm install
Build both the JavaScript and CSS bundles with npm run deploy this will create a style.css and remote.js in the dist folder.
Follow the steps for manual installation from before.
Inside the app folder you created as a part of that process, find the file betterdiscord\config.json
Edit the file and change the value of local to true and change the localPath value to match the absolute path of the dist folder from step 3.
Fully quit Discord and restart it.

FAQ

What is this?

This is a client modification for Discord. It allows you to add plugins and themes to your client. Plugins can add functionality and useful features. Themes can completely change the look and feel of Discord.

BD has some other built-in features such as Emotes from Twitch, FFZ, and BBTV, as well as an in-client server browser.

Where can I get plugins and themes?

In our support servers we have channels with lists of official plugins and themes. Please note we do not have an official listing on a website and are not affiliated with any of those websites. However BetterDiscordLibrary is generally trustworthy.