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.

Official installer

The installer is maintained separately at ImHisako/IllegalcordInstaller. Use it when you want the installer-based flow instead of cloning and building this repository yourself.

The source code for the client lives at ImHisako/Illegalcord. Use the source flow below when you are developing, auditing, or building a custom version.

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:

npm i -g pnpm

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.

Clone and install

git clone https://github.com/ImHisako/Illegalcord
cd Illegalcord
pnpm install --frozen-lockfile

Desktop build

Build the desktop bundle:

pnpm build

Inject the built bundle into Discord desktop:

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:

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.

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

Development builds

Use watch mode while editing source:

pnpm watch

For web builds:

pnpm watchWeb

Validate your build

Use the targeted checks while developing:

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:

pnpm uninject

If Discord was updated or the install state looks inconsistent:

pnpm repair

Client mods may violate Discord’s Terms of Service. Use Illegalcord at your own risk.