Appearance

Installation ​

WARNING

If you experience any issues following these steps, try the troubleshooting guide.

Automatic Installation ​

Video ​

If you prefer a video tutorial, take a look at this:

Step-by-Step ​

  1. Go to the BetterDiscord Website and click the big download button. Save this somewhere on your computer.
  2. Open the installer you downloaded in the previous step.
  3. Accept the license agreement, and click next to proceed.

BetterDiscord Installer

  1. Select Install then click the next button to proceed with installation.
  2. Select the version of Discord you want to use. If you're not sure what this means, just select Stable. Click the install button when ready.
  3. Let the installer process the installation. It should tell you when the installation has completed.
  4. Verify that BetterDiscord is installed.
  • Open (or switch to) Discord, and open Discord's settings.
  • Check the tabs on the left for a new section called BetterDiscord (see below)

BetterDiscord Settings Tabs

  1. Enjoy BetterDiscord!

Manual Installation ​

For those that can't get the automatic installers to work, those that want more control over their installation, and for developers.

Prerequisites ​

Steps ​

1. Clone the BetterDiscord repository ​

bash
git clone --single-branch -b main https://github.com/BetterDiscord/BetterDiscord.git

If this fails due to region lock or something similar, you can download a zipped copy directly from https://github.com/BetterDiscord/BetterDiscord/archive/refs/heads/main.zip

2. Enter the directory ​

bash
cd BetterDiscord

3. Install dependencies ​

Install BetterDiscord's dependencies

bash
bun install

4. Build BetterDiscord ​

This will create injector.js, preload.js, renderer.js, and an /editor directory in the dist/ directory.

bash
bun run build

5. Inject into Discord ​

bash
bun inject
bash
bun inject canary
bash
bun inject ptb