104 lines
2.6 KiB
Markdown
104 lines
2.6 KiB
Markdown
> **Warning**
|
|
> These instructions are only for advanced users. If you're not a Developer, you should use our [graphical installer](https://github.com/Vendicated/VencordInstaller#usage) instead.
|
|
|
|
# Installation Guide
|
|
|
|
Welcome to Megu's Installation Guide! In this file, you will learn about how to download, install, and uninstall Vencord!
|
|
|
|
## Sections
|
|
|
|
- [Installation Guide](#installation-guide)
|
|
- [Sections](#sections)
|
|
- [Dependencies](#dependencies)
|
|
- [Installing Vencord](#installing-vencord)
|
|
- [Updating Vencord](#updating-vencord)
|
|
- [Uninstalling Vencord](#uninstalling-vencord)
|
|
- [Manually Installing Vencord](#manually-installing-vencord)
|
|
- [On Windows](#on-windows)
|
|
- [On Linux](#on-linux)
|
|
- [On MacOS](#on-macos)
|
|
- [Manual Patching](#manual-patching)
|
|
- [Manually Uninstalling Vencord](#manually-uninstalling-vencord)
|
|
|
|
## Dependencies
|
|
|
|
- Install Git from https://git-scm.com/download
|
|
- Install Node.JS LTS from here: https://nodejs.dev/en/
|
|
|
|
## Installing Vencord
|
|
|
|
Install `pnpm`:
|
|
|
|
> :exclamation: This next command may need to be run as admin/root depending on your system, and you may need to close and reopen your terminal for pnpm to be in your PATH.
|
|
|
|
```shell
|
|
npm i -g pnpm
|
|
```
|
|
|
|
> :exclamation: **IMPORTANT** Make sure you aren't using an admin/root terminal from here onwards. It **will** mess up your Discord/Vencord instance and you **will** most likely have to reinstall.
|
|
|
|
Clone Vencord:
|
|
|
|
```shell
|
|
git clone https://github.com/Vendicated/Vencord
|
|
cd Vencord
|
|
```
|
|
|
|
Install dependencies:
|
|
|
|
```shell
|
|
pnpm install --frozen-lockfile
|
|
```
|
|
|
|
Build Vencord:
|
|
|
|
```shell
|
|
pnpm build
|
|
```
|
|
|
|
Inject vencord into your client:
|
|
|
|
```shell
|
|
pnpm inject
|
|
```
|
|
|
|
Then fully close Discord from your taskbar or task manager, and restart it. Vencord should be injected - you can check this by looking for the Vencord section in Discord settings.
|
|
|
|
## Updating Vencord
|
|
|
|
If you're using Discord already, go into the `Updater` tab in settings.
|
|
|
|
Sometimes it may be neccessary to manually update if the GUI updater fails.
|
|
|
|
To pull latest changes:
|
|
|
|
```shell
|
|
git pull
|
|
```
|
|
|
|
If this fails, you likely need to reset your local changes to vencord to resolve merge errors:
|
|
|
|
> :exclamation: This command will remove any local changes you've made to vencord. Make sure you back up if you made any code changes you don't want to lose!
|
|
|
|
```shell
|
|
git reset --hard
|
|
git pull
|
|
```
|
|
|
|
and then to build the changes:
|
|
|
|
```shell
|
|
pnpm build
|
|
```
|
|
|
|
Then just refresh your client
|
|
|
|
## Uninstalling Vencord
|
|
|
|
Simply run:
|
|
|
|
```shell
|
|
pnpm uninject
|
|
```
|
|
|
|
If you need more help, ask in the support channel in our [Discord Server](https://discord.gg/D9uwnFnqmd).
|