Skip to content

Instantly share code, notes, and snippets.

@ObserverOfTime

ObserverOfTime/BDLinux.md

Last active June 26, 2025 19:46
Show Gist options
  • Save ObserverOfTime/d7e60eb9aa7fe837545c8cb77cf31172 to your computer and use it in GitHub Desktop.
Save ObserverOfTime/d7e60eb9aa7fe837545c8cb77cf31172 to your computer and use it in GitHub Desktop.
Download ZIP
Install BetterDiscord on Linux
Raw
BDLinux.md

Install BetterDiscord on Linux

This Gist contains simple instructions on how to install, update, and uninstall BetterDiscord on Linux.

For more thorough documentation, take a look at betterdiscordctl's README.

Do NOT submit issues here as I don't check the comments. You should submit them here instead.

Install dependencies

Curl

Install using your package manager

Install betterdiscordctl

$ curl -O https://raw.githubusercontent.com/bb010g/betterdiscordctl/master/betterdiscordctl
$ chmod +x betterdiscordctl
$ sudo mv betterdiscordctl /usr/local/bin

You can then keep betterdiscordctl up to date with this command:

$ sudo betterdiscordctl self-upgrade

Install BetterDiscord

Replace [COMMAND] with install to install BD for the first time, reinstall to reinstall BD after a Discord update, or uninstall to uninstall an existing installation.

  • For Stable
$ betterdiscordctl [COMMAND]
  • For PTB
$ betterdiscordctl --flavor PTB [COMMAND]
  • For Canary
$ betterdiscordctl --flavor Canary [COMMAND]
  • For Snap
$ betterdiscordctl --d-install snap [COMMAND]
  • For Flatpak
$ betterdiscordctl --d-install flatpak [COMMAND]

Credits

BetterDiscord by Jiiks

Bandaged BD by Zerebos (rauenzi)

betterdiscordctl by bb010g

@HeyaGlitz
Copy link

@8jd --flavor is not a valid option, use -f
betterdiscordctl -f canary install

@RandomExplosion
Copy link

RandomExplosion commented Jul 21, 2021 •
edited
Loading

is there any plan to make this work with discord_arch_electron

@RandomExplosion
Copy link

i'm referring to the official aur repo by that name

@SmolAlli
Copy link

SmolAlli commented Nov 3, 2021

Please update it to link to the current BetterDiscord repository (https://github.com/BetterDiscord/BetterDiscord)

@BLVCKLVND
Copy link

How do I put a theme on BetterDiscord Linux Version?

@SmolAlli
Copy link

SmolAlli commented Dec 9, 2021

@BLVCKLVND Join the BetterDiscord server for help on that regard here

@kyb3rcipher
Copy link

working on Ubuntu with flatpak
command:

betterdiscordctl --d-install flatpak install

@Hri7566
Copy link

Hri7566 commented Feb 8, 2022

using the snap version of discord, i have absolutely no clue where to find the plugins folder, and the button in the plugins menu does nothing

@Vcyberpunk
Copy link

betterdiscordctl, ะธะปะธ ะบะฐะบ ะฑั‹ัั‚ั€ะพ ัะปะพะผะฐั‚ัŒ discord

@tw1nkey
Copy link

tw1nkey commented Mar 10, 2022

Ubuntu says i don't have discord install
image

@pedromtsilva
Copy link

pedromtsilva commented Mar 15, 2022 •
edited
Loading

Hey, i had this problem too. To solve it download the file from their website, it will download as an .appImage file, it shoud be this: "BetterDiscord-Linux.AppImage" go to your downloads directory and do the following:
$ chmod +x BetterDiscord-Linux.AppImage
$ ./BetterDiscord-Linux.AppImage
And it should run the normal installer with no problems. Now the problem that i have is that it's not finding the discord install to install BD. :/

EDIT: after reading a bit up above, the command betterdiscordctl --d-install flatpak install works for me.

@saku-bruh
Copy link

Hey, i had this problem too. To solve it download the file from their website, it will download as an .appImage file, it shoud be this: "BetterDiscord-Linux.AppImage" go to your downloads directory and do the following: $ chmod +x BetterDiscord-Linux.AppImage $ ./BetterDiscord-Linux.AppImage And it should run the normal installer with no problems. Now the problem that i have is that it's not finding the discord install to install BD. :/

EDIT: after reading a bit up above, the command betterdiscordctl --d-install flatpak install works for me.

thats so god damn dumb lmao should revise the tutorial as its kind of useless aside from the install atm

@shinji257
Copy link

Thanks for this. I'm on Linux Mint and using the Flatpak version of Discord. Went and used betterdiscordctl and had it install for flatpak and it worked first try. You do not need to download the Better Discord AppImage installer as betterdiscordctl takes care of installing it for you. Yay!

This is all part of my (inevitable) transition to Linux Mint.

@teunissenstefan
Copy link

I'm getting "/bin/bash: error reading input file: Permission denied" when using betterdiscordctl --d-install snap install. Any ideas?

@soraA420
Copy link

betterdiscordctl --flavor does not work anymore. only betterdiscordctl -f does

@Danielk14565
Copy link

eay

@mtfy
Copy link

mtfy commented Jun 10, 2022 •
edited
Loading

@teunissenstefan

I'm getting "/bin/bash: error reading input file: Permission denied" when using betterdiscordctl --d-install snap install. Any ideas?

Try running the command as super user. Simply prefix the command with sudo, for example betterdiscordctl --d-install snap install.

@kaosine
Copy link

kaosine commented Jul 19, 2022

This works better than the default installer for me except it's missing the beta branch of flatpak....

@hiromiya1
Copy link

7

@WalaGithub
Copy link

Installation process in terminal is normal but does not work at all after rebooting on my Debian 12 build after update

@Matty-exe
Copy link

i installed it on ubuntu 22.04.4, but the section betterdiscord don't apear, why and how can i solve ?

@ItsCDubb
Copy link

What's the theme folder location?

@AskAlice
Copy link

anyone got a working pacman hook?

@mesaprotector
Copy link

anyone got a working pacman hook?

Probably not optimal, but this works for me.

[Trigger]
Type = Package
Operation = Install
Operation = Upgrade
Target = discord*

[Action]
Description = Rebuild BetterDiscord after Discord update
When = PostTransaction
Exec = /usr/bin/sudo -u USERNAME betterdiscordctl reinstall
NeedsTargets

@AskAlice
Copy link

AskAlice commented Jun 11, 2024 •
edited
Loading

ahh yeah i think where i went wrong was putting two dashes between the sudo param and the betterdiscordctl cmd. ty ๐Ÿ‘ 
[Trigger]
Operation=Upgrade
Type=Package
Target=discord

[Action]
Description=Update BetterDiscord
When=PostTransaction
Exec=runuser -u alice -- /usr/local/bin/betterdiscordctl reinstall

@mesaprotector
Copy link

ahh yeah i think where i went wrong was putting two dashes between the sudo param and the betterdiscordctl cmd. ty ๐Ÿ‘

Very late update :) and maybe the above works for your needs, but I figured out that I actually need to get Discord to update through its own installer and then only after inject betterdiscord. The following is a hack but it does work. This will terminate with Discord not running but fully updated; if you want a hook that ends with Discord running, good luck.

[Trigger]
Type = Package
Operation = Install
Operation = Upgrade
Target = discord*

[Action]
Description = Rebuild BetterDiscord after Discord update
When = PostTransaction
Exec = /usr/bin/sh -c 'sudo -u USERNAME betterdiscordctl reinstall; sudo -u USERNAME discord --help; sudo -u USERNAME betterdiscordctl install'
NeedsTargets

What "discord --help" does is causes the auto-updater to crash as soon as it finishes updating because it doesn't understand the option :) No guarantee how long it will continue to work, but for the past month it's run very smoothly.

@AskAlice
Copy link

AskAlice commented Aug 18, 2024 •
edited
Loading

dude nice

@alprojects1
Copy link

Screenshot_20240914_065811
up and running thank you !!!

@GitXpresso
Copy link

I haven't used betterdiscord in a long time

@PeteBoi64
Copy link

Everytime I restart discord it doesn't load, I have to reinstall it manually each time

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment