Frequent Questions
The purpose of this page is to answer commonly asked questions regarding the BetterDiscord client mod and installer. This page should not be treated as documentation.
Documentation is still under construction. Some links may either work improperly or not be added.
1. How do I install this?
- Download our installer from here and open it.
- Agree to the license.
- Select "Install BetterDiscord" from the list of options.
- Choose your current discord build.
- Click the "Install" button, and discord should restart with BetterDiscord installed.
2. The installer isn't working.
- Run the installer you used to originally download BetterDiscord. If you don't have that, you can get it here.
- Agree to the license.
- Select "Repair BetterDiscord" from the list of options.
- Choose your current discord build.
- Click the "Repair" button and see if that resolves the issue.
If neither of those instructions worked, join our discord community for support.
3. Is this against the terms of service?
Yes. BetterDiscord violates Discord's terms of service by modifying the client, although there is no evidence that discord either cares or takes actions against users who modify their client. Your account is not at risk for simply using BetterDiscord alone. Abusing the service or using plugins which further violate the Terms of Service can get your account terminated, however. All plugins from our official website are safe.
4. Can BetterDiscord get me banned?
As mentioned in the last question, discord does not hand out bans for simply using BetterDiscord. If you abuse the service to further violate discord's policies, you risk account suspension.
5. Does this work on mobile?
No. Mobile builds of discord are built on entirely different frameworks, and are not compatible with BetterDiscord.
6. Does this work on browser/chromebook?
No. BetterDiscord requires the full desktop app to load.
7. How do I download themes?
- Find a theme you like from our themes page.
- Click the "Download" button on the theme you want.
- Ensure you have BetterDiscord installed. If you don't, refer to question #1.
- Open your discord user settings. Near the very bottom, there should be a themes tab. Click it.
- At the top of the themes page, click the "Open themes folder" button.
- Drag the file you downloaded into the themes folder that opened.
8. How do I download plugins?
- Find a plugin you like from our plugins page.
- Click the "Download" button on the plugin you want.
- Ensure you have BetterDiscord installed. If you don't, refer to question #1.
- Open your discord user settings. Near the very bottom, there should be a plugins tab. Click it.
- At the top of the plugins page, click the "Open plugins folder" button.
- Drag the file you downloaded into the plugins folder that opened.
9. How do I uninstall BetterDiscord?
- Run the installer you used to originally download BetterDiscord. If you don't have that, you can get it here.
- Agree to the license.
- Select "Uninstall BetterDiscord" from the list of options.
- Choose your current discord build.
- Click the "Uninstall" button, and discord should restart with BetterDiscord removed.
10. Can I use BD on linux?
Yes. You can either use the AppImage build of our GUI installer, or attempt a manual injection.
11. Can I see deleted messages?
Message loggers are in violation discord's API terms and privacy policy, and can result in account termination. We will not provide such plugins.
12. How do twitch emotes work?
Typing the name of most BTTV, FFZ and Twitch subscriber emotes in chat will show the emote image in it's place. Only BetterDiscord users can see these emotes.
13. Is there an account switching plugin?
Account switchers put users at unnessecary risk by storing either their account token or email/password combo. We will not provide such plugins.
14. BetterDiscord is causing discord to crash on startup.
This is likely caused by a broken plugin. Locate your plugins folder and delete whichever plugin might be causing the crash.
If that doesn't work, try completely wiping your BetterDiscord data folder and reinstalling.
If neither of those instructions worked, join our discord community for support.
If that doesn't work, try completely wiping your BetterDiscord data folder and reinstalling.
If neither of those instructions worked, join our discord community for support.
15. How can I delete all of my messages in a DM/Server?
Automating requests through discord's API will get your account flagged for selfbotting which can result in account termination. Additionally, sending requests in rapid succession is a form of API spam which increases the odds of being flagged. As such, we will not provide any plugins that do this.
16. How safe are themes/plugins?
Plugins should be treated like any other program installed on your computer. They have direct access to both your account and filesystem. All plugins from our official repository are checked for malicious code and must follow our guidelines. Anything downloaded outside of this website is out of our control. Themes are for the most part harmless and pose no threat to you.
17. Can I get free nitro with this?
BetterDiscord is a client-side modification, not a hacking tool. Attempting to bypass server-side permissions (for example, screenshare quality) can result in account termination.
18. I can't find a theme that I like.
If you are knowledgeable of CSS, you can edit the preset variables of most themes using a text editor. Otherwise, you can customize themes with a theme generator.
19. My theme looks broken.
If your theme is partially broken, you should contact the developer. Themes need consistent management and will break over time if the author doesn't update it frequently.
20. Is BetterDiscord safe?
BetterDiscord contains no malicious code, nor does it collect any meaningful user data without your knowledge. The source code for both the client mod and installer are freely available for anyone to view on GitHub.
21. Do you have an automatic status changer plugin?
Automating server-side actions through discord's API is considered selfbotting, and therefore highly bannable under discord's API terms. Additionally, using such a plugin spam's discord's API with HTTP requests which will get your account flagged and terminated.
22. Can discord detect if I am using BetterDiscord?
BetterDiscord runs entirely clientside, and discord has no clientside checks for such modifications. Even if they did, discord has not been known to ban for client modding, nor has there ever been a proven ban case for client modding alone. Using unofficial plugins which utilize server-side API calls can get your account flagged for selfbotting, however.
23. My theme/plugin is not showing up on the themes/plugins page.
Make sure the file name of your theme/plugin does not contain a number at the end. All themes and plugins must end in
*.theme.css
or *.plugin.js
. Downloading an addon twice is a common reason for the addon not showing up in settings lists, as most operating systems append a (1) at the end of a duplicate file.