vencord / installer

A cross platform gui/cli app for installing Vencord

Vencord

The cutest Discord client mod

A screenshot of vencord showcasing the vencord-theme

Features

• 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)

Installing / Uninstalling

Visit https://vencord.dev/download

Join our Support/Community Server

https://discord.gg/D9uwnFnqmd

Sponsors

Thanks a lot to all Vencord sponsors!!
generated using github-sponsor-graph

Star History

Disclaimer

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.

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

installer's Issues

[Feature request] discord-screenaudio support/integration?

So, i was using discord-screenaudio (i'm using Arch btw) for a while now, and it is very convenient since standart discord client can't even stream sound out-of-the-box, and i, unlike many linux users, am too lazy to fix this issue myself.
Vencord has some very cool plugins, but it seems that the installer cannot install it on a discord-screenaudio client. Will there be any way to fix this, or, perhaps, a similar feature?

Vencord not working.

Even after I hit cancel it just closes and I can't download it, please help.

[Linux] Can't install

^C^Xutkug@UBUNTU-E17DEO:~$ sh -c "$(curl -sS https://raw.githubusercontent.com/Vendicated/VencordInstaller/main/install.sh)"
Downloading Installer...
X11 detected

Now running VencordInstaller
Do you want to run as root? [Y|n]
This is necessary if Discord is in a root owned location like /usr/share or /opt

n
Running unprivileged
Using UserConfig
Checking if /home/utkug/.config/Vencord/dist exists: Yes
Is Dev Install: false
Fetching https://api.github.com/repos/Vendicated/Vencord/releases/latest
Checking for Installer Updates...
Fetching https://api.github.com/repos/Vencord/Installer/releases/latest
Finished fetching GitHub Data
Latest hash is e36f4e5 Local Install is outdated!
Checking if resources exists: No
Checking if app.asar exists: No
Tried to parse invalid Location:
Checking if /snap/bin/discord/resources exists: No
Checking if /snap/bin/discord/app.asar exists: No
Tried to parse invalid Location: /snap/bin/discord

Android integration support appeal.

Can this code be modded and compiled for Android device so that Android devices can use more plugins just like old Aliucord in the new updated versions of Discord. Discord is updated their app to react native so the old Aliucord is broken so it can get any new updates and features by Discord. Aliucord is based on old method of modding and they have for a lot years so much cool and best plugins in the world that is ported from BetterDiscord but after this freaking Discord update, this adventure is officially EOL so every single plugin by devs needs to be written from scratch for react native platform. Many devs just quit in porting from desktop PCs those cool plugins and some of them are died so we can't get many plugins anymore i those new versions of Discord.

This project can be light for us and revival for our devices to be able to mod Discord again like before because this Discord client have already PC support and many plugins that we've used before in old Aliucord client but in react-native plugins list, those plugins are not ported and many of them will never be ported so it would be nice for android devices to get support, even unofficialy to run this client and have again traditional number of plugins to continue to use those cool experience with those plugins.

I know that PCs are much in trending than phones/tablets but let's accept the truth - many people use more phones than PC due to many reasons - and most of them is money inability to get some PC but also there is other reasons too so it's actually the fact that phone is much better than PC in the terms of having it in 2023 and to be able without any lags to use it online for literally anything.

Especially, rooted Android devices. So, one Discord client who have at least very similar number or completely the same number of plugins like PC clients have it will be so much useful and the best. So, even if maybe many of them are even don't care at least a little bit for mobile users, it would be nice to do this - one good will for us sadly poor-in-development-popularity mobile users to get experience we had before in the history of Discord clients for Android.

Thank you so much in advance devs and owner for your understanding and will to do this.

Cant change theme anymore

Was working fine perfectly untill I used spoticord theme then i couldnt change it anymore. Might just re-install but hope to get this fixed so it doesnt happen again.

[Windows] With hash #a2f0c91 transparency effects break the Discord client.

When transparent bar and Discord transparency is enabled, Discord completely breaks on startup and doesn't display even when the app is open on the taskbar.

Dicord doesnt start after patching

Well nothing happens when I try to open discord after patching literally nothing.

Support for doas

when using opendoas I just get an error about SUDO_USER not being set, I tried setting it manually based on the sudo manual with no luck.

can't install due to older bd installation?

the installer chooses older directory which has an installation of discord bd which didn't go away upon using the bd installer to uninstall.


would this be an issue of bd?

welp this happened

updated discord now its broken

Where are the plugin files located?

^

Preserve environment variables

Please preserve user's environment variables with sudo -E (here).

I personally need this to pass LIBGL_ALWAYS_SOFTWARE=1...

(Yes, the installer is hardware accelerated and I'm stuck to OpenGL 2.1)

---

My current workaround

url="https://github.com/Vendicated/VencordInstaller/releases/latest/download/VencordInstaller-x11"
out="vinst"
curl -sS "$url" --output "$out" --location
chmod +x "$out"
LIBGL_ALWAYS_SOFTWARE=1 sudo -E "$out"

i can't open exe and terminal file

I can't open the file, even I tried an alternative way and nothing came out.

NixOS Support

Support for NixOS

[Feature Request] Show Activityicons

Show when a user has an activity and which kind it is
~https://github.com/Neodymium7/BetterDiscordStuff/tree/main/ActivityIcons

Vencord cant patch even when im using the 2nd option

It shows this error in the pic and it wont patch the discord files. I thought it downloaded the file but when going to folder path it doesnt show vencordinstaller.exe file, it didnt download. How to fix this?

soundboard and super reactions is not patched

stuff like emoji's work, but sadly the soundboard still need nitro

When running the installer script in Wayland, it fails due to not recognizing X11

2022/10/28 14:13:49 PlatformError: X11: Failed to open display :0
panic: NotInitialized: The GLFW library is not initialized

goroutine 1 [running, locked to thread]:
github.com/go-gl/glfw/v3.3/glfw.acceptError({0x0, 0x0, 0x10004?})
	/home/runner/go/pkg/mod/github.com/go-gl/glfw/v3.3/[email protected]/error.go:174 +0x1d9
github.com/go-gl/glfw/v3.3/glfw.panicError(...)
	/home/runner/go/pkg/mod/github.com/go-gl/glfw/v3.3/[email protected]/error.go:185
github.com/go-gl/glfw/v3.3/glfw.WindowHint(0xc0004a5e68?, 0x6fb29a?)
	/home/runner/go/pkg/mod/github.com/go-gl/glfw/v3.3/[email protected]/window.go:275 +0x3f
github.com/AllenDang/imgui-go.NewGLFW({0x31047c8?}, {0xa3b303, 0x11}, 0xac21b0?, 0x9dd740?, 0x0)
	/home/runner/go/pkg/mod/github.com/!allen!dang/[email protected]/PlatformGlfw.go:68 +0xba
github.com/AllenDang/giu.NewMasterWindow({0xa3b303, 0x11}, 0x4b0, 0x320, 0xa0?)
	/home/runner/go/pkg/mod/github.com/!allen!dang/[email protected]/MasterWindow.go:66 +0x10b
main.main()
	/home/runner/work/VencordInstaller/VencordInstaller/main.go:354 +0x75

sorry which one do i install? im on PC..

cant open it on my IMac

for some weird reason, i successfully open the app but i cant install it. it says it to run it as Administrator/Root, what does that mean?

Some Windows installs are in ProgramData instead of localappdata

It seems like Discord installs to C:\ProgramData\UserName\Discord if installing to localappdata fails. This leads to patching Discord having no effect because it launches the ProgramData one while only the localappdata one is patched

Cause is unknown, possibly due to running the installer twice at once?

In any case, the best fix is probably to

1. Detect if that folder exists
2. If yes:
   • Delete it
   • Show a warning popup that Discord might not start properly and to reinstall Discord if that's the case

error while launching discord

after patching my discord client with the vencord installer, i get this error when i try to run discord :

Uncaught Exception:
Error [ERR_REQUIRE_ESM]: require() of ES Module /home/chokerman/.config/Vencord/dist/patcher.js from /opt/discord/resources/app.asar/index.js not supported.
patcher.js is treated as an ES module file as it is a .js file whose nearest parent package.json contains "type": "module" which declares all .js files in that package scope as ES modules.
Instead rename patcher.js to end in .cjs, change the requiring code to use dynamic import() which is available in all CommonJS modules, or change "type": "module" to "type": "commonjs" in /home/chokerman/package.json to treat all .js files as CommonJS (using .mjs for all ES modules instead).

    at f._load (node:electron/js2c/asar_bundle:2:13330)
    at Object.<anonymous> (/opt/discord/resources/app.asar/index.js:1:1)
    at f._load (node:electron/js2c/asar_bundle:2:13330)
    at node:electron/js2c/browser_init:2:115672
    at node:electron/js2c/browser_init:2:115875
    at node:electron/js2c/browser_init:2:115879
    at f._load (node:electron/js2c/asar_bundle:2:13330)
[41156:0520/000044.567498:ERROR:object_proxy.cc(623)] Failed to call method: org.freedesktop.DBus.Properties.Get: object_path= /org/freedesktop/portal/desktop: org.freedesktop.DBus.Error.InvalidArgs: No such interface “org.freedesktop.portal.FileChooser”
[41156:0520/000044.567526:ERROR:select_file_dialog_linux_portal.cc(274)] Failed to read portal version property

this is on wayland on arch linux

how do you create a powershell cli/gui install command with a fork of vencord

just need to know what urls i need to change after forking the repo and i know you can do so what urls do i need to change

How to turn off custom placement in vencord

I don't know how to turn this off and I need help

Openasar Integration

A lot of people seem to struggle installing OpenAsar alongside Vencord. Integrating it into the installer would be trivial and probably useful for a bunch of people

I'm not sure what the best way to incorporate this into the ui would be, a dedicated button would feel weird. In any case, there should be a way to unpatch it again and it should show a clear disclaimer that it's third party software not affiliated with us that they're installing at their own discretion

Not an issue but more of a question on how to uninstall the "nsis-installer.exe".

How would I uninstall this? (The "nsis-installer.exe")

TypeError: Cannot read property of 'TOP' of undefined

Unable to open any kind of settings. Installed both vencord and asar.

at Z1 (VencordRenderer:70:7106)
at Sa (3ceSa3a3ee1992708511.js:1654:54)
at yu (3ce5a3a3ee1992708511.js:1708:146) at Oc (3ceSa3a3ee1992708511.js:1701:89)
at Ic (3ceSa3a3ee1992708511.js:1701:17) at he (3ce5a3a3ee1992708511.js:1700:867)
at is (3ce5a3a3ee1992708511.js:1697:642) at uc (3ceSa3a3ee1992708511.js:1698:49)
at Fo (3ce5a3a3ee1992708511.js:1637:577) at 3ce5a3a3ee1992708511.js:1695:555

Completely incompatible with my laptop,

I'm running win 10 and the proper one doesn't work, terminal in any way doesn't work and making my own doesn't tell me shit how to do it and that's kinda out of my reach.
Please help.

I would tell you what I have but this is public ish.

Vencord Installer not running on Windows 10

I'm currently running Windows 10 version 21h1 x64 and the installer is not opening up
I downloaded the Vencord Installer for Windows

welp

[Linux] Broken install if root sets XDG_CONFIG_HOME

Unless I'm mistaken.
The installer puts the Vencord files on /root after requiring root privileges to access /opt . Then, when trying to launch discord, it craps itself because it does not have access to /root/.config/Vencord.
I also tried to set the VENCORD_USER_DATA_DIR variable, but nothing happened. I even put it inside install.sh script and still it didn't affect anything.
In the end I installed it to a /home/user/.config/Vencord folder and manually moved the app.asar folder to /opt/discord/resources/, this time pointing at the user /home/user/.config/Vencord folder and it worked.

Make it easily accesible to install custom plugins

title

[Windows] Just comes up with errors

fixed it but dont know how to delete this sooo

make it so that if you uninstall vencord, the css shit resets and deletes everything on it. my discord fully breaks with vencord is installed because some imbecile cant code for shit and his code fully broke my discord

[Linux] Latest hash is e36f4e5 Local Install is outdated!

How do I even fix them? I tried 5 times.

Mic not working

Hi, when i was on Vencord, my mic wasn't working. I unninstall the patch and it work perfectly.

cant launch discord anymore

ive updated vencord and used the update feature of the installer but launching discord it gets stuck with "downloading updates 1 of 15" and then "update failed" on a loop

Message logger question

If i have the files of my history from the old message logger can i somehow import it to vencord's one?

Broken title bar on Gnome/Wayland (Fedora Linux)

When running the installer on my tablet running Fedora 37 with Gnome 43.4 on Wayland there is a broken title bar. It doesn't have any button to close the window, you have to either press Alt+F4 or kill the process, which is probably not how it is intended to be. If you need any other information, just reply to this issue.

i have no idea whats happening

im a complete noob, i run the command on my terminal like it said on the readme

then this happens

``Downloading Installer...
X11 detected

Now running VencordInstaller
Do you want to run as root? [Y|n]
This is necessary if Discord is in a root owned location like /usr/share or /opt

y
Running with sudo
[sudo] password for levih:
VencordInstaller was run with root privileges, actual user is levih
Looking up HOME of levih
Actual HOME is /home/levih
Using UserConfig
Checking if /home/levih/.config/Vencord/dist exists: Yes
Is Dev Install: false
Fetching https://api.github.com/repos/Vendicated/Vencord/releases/latest
Checking if /usr/share/discord/resources exists: Yes
Checking if /usr/share/discord/resources/app exists: No
Checking if /usr/share/discord/resources/app.asar is directory: No
Found Discord install at /usr/share/discord
Checking for Installer Updates...
Fetching https://api.github.com/repos/Vencord/Installer/releases/latest
panic: failed to create window: VersionUnavailable: GLX: Failed to create context: GLXBadFBConfig

goroutine 1 [running, locked to thread]:
github.com/AllenDang/giu.NewMasterWindow({0xa44174, 0x11}, 0x4b0, 0x320, 0x40?)
/home/runner/go/pkg/mod/github.com/!allen!dang/[email protected]/MasterWindow.go:68 +0x41f
main.main()
/home/runner/work/Installer/Installer/gui.go:64 +0x98``

i dont know what steps i have to follow how do i fix this when i open discord nothing happens help

The Installer is not opening problem

Running The Installer Does Nothing !

How Can I Fix The Problem ?
It Is For Windows 10, But The Extension Works Fine.

The Attached Is A Video Showing The Same.

screen-capture.10.webm

User perzonalitation

I liked to decorate my profile. But, Why did anyone added it? :(

how do you create a a powershell cli/gui install command with a fork of vencord

how do you create a a powershell cli/gui install command with a fork of vencord

Use XDG_DATA_HOME or XDG_CONFIG_HOME environment variable

It's somewhat of a standard on Linux and macOS

Required file not found when trying to run installer binary

[nixos@asus:~]$ sh -c "$(curl -sS https://raw.githubusercontent.com/Vendicated/VencordInstaller/main/install.sh)"
Downloading Installer...
X11 detected

Now running VencordInstaller
Do you want to run as root? [Y|n]
This is necessary if Discord is in a root owned location like /usr/share or /opt
> n
Running unprivileged
sh: line 51: /tmp/tmp.CRFyUEfCzj: cannot execute: required file not found

I assume this is not a bug caused by the script but a linked file being missing as this works:

[nixos@asus:~]$ outfile=$(mktemp)

[nixos@asus:~]$ trap 'rm -rf "$outfile"' EXIT

[nixos@asus:~]$ curl -sS https://github.com/Vendicated/VencordInstaller/releases/latest/download/VencordInstaller-x11 \
  --output "$outfile" \
  --location

[nixos@asus:~]$ chmod +x "$outfile"

[nixos@asus:~]$ "$outfile"
bash: /tmp/tmp.N0QWRGMO1d: cannot execute: required file not found

[nixos@asus:~]$ bat $outfile
───────┬───────────────────────────────────────────────────────────────────────────────────
       │ File: /tmp/tmp.N0QWRGMO1d   <BINARY>
───────┴───────────────────────────────────────────────────────────────────────────────────

Maybe a NixOS issue?

No compability for 32 Bits

addition switches for cli installer

additioal switches

1. -dir <dir> : installs vencord to
2. -dir [default|stable|ptb|canary] : installs vencord to the location sepecifed. defult location is the first hit

Installing not working (windows, powershell)

When running the command for windows, it throws this error after selecting graphical interface.

Start-Process : Cannot validate argument on parameter 'ArgumentList'. The argument is null or empty. Provide an
argument that is not null or empty, and then try the command again.
At line:68 char:56

• Start-Process -Wait -FilePath "$outfile" -ArgumentList "$flag"

•                                                    ~~~~~~~
  

  • CategoryInfo : InvalidData: (:) [Start-Process], ParameterBindingValidationException
  • FullyQualifiedErrorId : ParameterArgumentValidationError,Microsoft.PowerShell.Commands.StartProcessCommand