> ## Documentation Index
> Fetch the complete documentation index at: https://illegalcord.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Illegalcord

> Install Illegalcord with the official installer, build it from source, inject it into Discord desktop, or create a browser extension build.

Illegalcord has two installation paths. Most users can use the official installer project, while contributors can build directly from source.

<Button href="https://github.com/ImHisako/IllegalcordInstaller">
  Open IllegalcordInstaller on GitHub
</Button>

<Button href="https://github.com/ImHisako/Illegalcord">
  View Illegalcord source code
</Button>

## Official installer

The installer is maintained separately at [ImHisako/IllegalcordInstaller](https://github.com/ImHisako/IllegalcordInstaller). Use it when you want the installer-based flow instead of cloning and building this repository yourself.

<Info>
  The source code for the client lives at [ImHisako/Illegalcord](https://github.com/ImHisako/Illegalcord). Use the source flow below when you are developing, auditing, or building a custom version.
</Info>

## Source build

## Requirements

* Git.
* Node.js 22 or newer. The root `package.json` declares `node >=22`.
* `pnpm` 11.9.0 or newer.
* Discord desktop if you plan to use `pnpm inject`.

Install `pnpm` if you do not already have it:

```bash theme={null}
npm i -g pnpm
```

<Warning>
  After installing dependencies, do not run the build or injector from an administrator or root terminal unless you know exactly why you need to. The source injector operates on your user-level Discord installation.
</Warning>

## Clone and install

```bash theme={null}
git clone https://github.com/ImHisako/Illegalcord
cd Illegalcord
pnpm install --frozen-lockfile
```

## Desktop build

Build the desktop bundle:

```bash theme={null}
pnpm build
```

Inject the built bundle into Discord desktop:

```bash theme={null}
pnpm inject
```

Fully quit Discord, then launch it again. Open User Settings and look for the **Illegalcord Settings** section. It should contain tabs such as **Illegalcord**, **Plugins**, **Themes**, **Updater**, **Cloud**, and **Backup & Restore**.

## Web build

Build the browser extension target:

```bash theme={null}
pnpm buildWeb
```

After the build finishes, check `dist` for the generated browser extension output. Load the matching unpacked extension or archive through your browser's extension developer tools.

<Info>
  Browser support depends on the generated target and browser restrictions. Firefox extension archives may require Firefox Developer Edition or a compatible extension workflow.
</Info>

## Development builds

Use watch mode while editing source:

```bash theme={null}
pnpm watch
```

For web builds:

```bash theme={null}
pnpm watchWeb
```

## Validate your build

Use the targeted checks while developing:

```bash theme={null}
pnpm testTsc
pnpm lint
pnpm lint-styles
pnpm lint:intl
pnpm lint:patches
pnpm generatePluginJson
```

The full `pnpm test` script is heavier. It builds standalone output, runs type checks and linters, and regenerates plugin metadata.

## Remove or repair injection

If you need to remove the desktop injection:

```bash theme={null}
pnpm uninject
```

If Discord was updated or the install state looks inconsistent:

```bash theme={null}
pnpm repair
```

<Warning>
  Client mods may violate Discord's Terms of Service. Use Illegalcord at your own risk.
</Warning>