A Forceful Blend of Discord Awesomeness! 🌌🚀🤖
Don't fork this repo to make plugins for Vencord. We will pull changes from upstream, so if you want to make a plugin for Vencord but have it in BV, just wait for us to pull from upstream.
- Super easy to install (Download Installer, open, click install button, done)
- 100+ plugins built in: See a list
- Some highlights: SpotifyControls, MessageLogger, Experiments, GameActivityToggle, Translate, NoTrack, QuickReply, Free Emotes/Stickers, PermissionsViewer, CustomCommands, ShowHiddenChannels, PronounDB
- Fairly lightweight despite the many inbuilt plugins
- Excellent Browser Support: Run Vencord in your Browser via extension or UserScript
- Works on any Discord branch: Stable, Canary or PTB all work (though for the best experience I recommend stable!)
- Custom CSS and Themes: Inbuilt css editor with support to import any css files (including BetterDiscord themes)
- Privacy friendly, blocks Discord analytics & crash reporting out of the box and has no telemetry
- Maintained very actively, broken plugins are usually fixed within 12 hours
- Settings sync: Keep your plugins and their settings synchronised between devices / apps (optional)
- BdApi Compatibility : Allows (most) BetterDiscord plugins to be ran as if it was normal BetterDiscord!
Note
External Sources were used.
- BrowserFS: https://github.com/jvilk/BrowserFS
- Some of BetterDiscord's code: https://github.com/Davilarek/Vencord/blob/main/src/plugins/bdCompatLayer/stuffFromBD.js
"it's called Vencord because it's made by ven,
it's called BetterVencord because it's bettter than Vencord"
- Davilarek
Node.js I recommend LTS version,
git clone https://github.com/Davilarek/Vencord.git
cd Vencord
BetterVencord needs to be compiled:
pnpm install --frozen-lockfile
pnpm build --standalone
pnpm buildWeb --standalone
Could be optionally run if you intend to use BetterVencord on the web, like ArmCord, or Discord in a browser.
After compile has finished, the resulting files in dist
is required to be left intact, in order to maintain BetterVencord functionality. The rest of the source could be optionally removed. Should you wish to keep the source, you could for instance, set it up to have partial update functionality (see Updating
section below), and/or for implementing other third party Vencord plugins
If for whatever reason you are an error during pnpm install
e.g.
pnpm install
ERR_PNPM_BAD_PM_VERSION This project is configured to use v8.10.2 of pnpm. Your current pnpm is v9.1.0
If you want to bypass this version check, you can set the "package-manager-strict" configuration to "false" or set the "COREPACK_ENABLE_STRICT" environment variable to "0"
This is set by package.json
You have few options:
- export the variable
COREPACK_ENABLE_STRICT=0
via eitherexport COREPACK_ENABLE_STRICT=0
orset COREPACK_ENABLE_STRICT=0
, - (less ideal), downgrade/install the older, required version, 8.10.2 and retry running
pnpm install
again. - (not recommended) edit
package.json
so that it correctly matches your installedpnpm
version, and retry runningpnpm install
again.
Run Vencord's official installer first. If your discord installation path includes files or directories that are not owned by you, or that you are not a member of, or you have no write access to, ensure that you run the installer as a privileged account. Vencord needs to patch app.asar
.
Once done,
- Backup your Vencord user data first. On Linux for example is defined by
XDG_CONFIG_HOME
, as$HOME/.config/Vencord/
, on Windows, try checking%appdata%/Vencord
. - Copy your compiled BetterVencord's
dist
directory/folder into own Vencord user data.
Once installed, BetterVencord functions similar to Vencord but with BD Compatibility Layer under Plugins. This needs to be enabled first before you can add BetterDiscord plugin(s). A successful enabling of BD Compatibility Layer will show up an extra menu entry (on the left of discord UI) as Virtual Filesystem, under Backup & Restore. To then add BetterDiscord plugins, in Virtual Filesystem, left click on /
, then BD
, then right click on plugins
, and click on Import a file here.
BetterVencord will not function properly if BD plugins are missing ZeresPluginLibrary, the BD Compatibility Layer does not provide this library either. You will need to click on the link download the file somewhere temporarily, then import the ZeresPluginLibrary. See the next section about adding BD plugins.
Newly imported plugins will not be immediately visible. To make it visible, collapse the plugins directory/folder then expand it again. This should ideally be done to visually confirm that the BD plugin has imported into the Virtual Filesystem, prior to enabling BD plugins to be visible within Vencord's plugin list. To do that, you will need to click on Reload BD Plugins, so that these changes should take effect under Vencord → Plugins. Confirm that the BD plugin has its own entry within Vencord. If the imported BD plugin does not have its own entry within the list of Plugins, it may not be compatible with BetterVencord, and should therefore be removed.
To remove BD plugins from BetterVencord, navigate to plugins directory/folder as mentioned above. Right click on the BD plugin that you wish to remove, and click on Delete file. You should also visually confirm that the removed BD plugin is no longer visible via collapsing and expanding plugins directory/folder. Once that is done, make sure you hit the Reload BD Plugins button to have changes take effect.
It should be possible to uninstall BetterVencord via Vencord's official installer tool. If that fails, you will need to revert changes done to your Vencord user data path first, before running the uninstaller. If you do not have a backup for whatever reason, try deleting your Vencord user data directory or folder first, run through Vencord's official installer to install, then try uninstalling.
You should keep the source code you cloned in first step to be able to update BV.
First, you cd
to your directory where you cloned the source code.
Then,
git fetch
git pull
and then repeat compiling steps.
Discord is trademark of Discord Inc. and solely mentioned for the sake of descriptivity. Mention of it does not imply any affiliation with or endorsement by Discord Inc.
For people who don't see it. Before you can actually use BetterVencord for the purpose of running BetterDiscord plugins on Vencord, You actually have to enable the compatibility layer for any BetterDiscord plugin to work. BD Compatibility Layer is a plugin that is NEEDED for BetterVencord to actually run BetterDiscord plugins.
Using Vencord violates Discord's terms of service
Client modifications are against Discord’s Terms of Service.
However, Discord is pretty indifferent about them and there are no known cases of users getting banned for using client mods! So you should generally be fine as long as you don’t use any plugins that implement abusive behaviour. But no worries, all inbuilt plugins are safe to use!
Regardless, if your account is very important to you and it getting disabled would be a disaster for you, you should probably not use any client mods (not exclusive to Vencord), just to be safe
Additionally, make sure not to post screenshots with Vencord in a server where you might get banned for it