Skip to main content
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:
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

​
Desktop build

Build the desktop bundle:
Inject the built bundle into Discord desktop:
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:
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:
For web builds:

​
Validate your build

Use the targeted checks while developing:
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:
If Discord was updated or the install state looks inconsistent:
Client mods may violate Discord’s Terms of Service. Use Illegalcord at your own risk.