Equicord/README.md

# Equicord

An enhanced version of [Vencord](https://github.com/Vendicated/Vencord) by [Vendicated](https://github.com/Vendicated) called Equicord.

![image](https://github.com/Equicord/Equicord/assets/78185467/81707ad9-3a04-4f76-88a0-60ee70684f81)

## Features

-   Third-party plugins implemented into the main build.
-   100+ plugins built-in.
    -   Some highlights: SpotifyControls, MessageLogger, Experiments, GameActivityToggle, Translate, NoTrack, QuickReply, Free Emotes/Stickers, PermissionsViewer,
        CustomCommands, ShowHiddenChannels, PronounDB
-   Fairly lightweight despite the many inbuilt plugins
-   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
-   Able to update inside of Equicord through the update tab.
-   Same supporter badges as on Vencord (Don't lose your benefits)
-   Easy to install third-party plugins through the plugin page in Discord.
-   Request for plugins from Discord.

<details>
<summary>Extra included plugins (119 additional plugins)</summary>

- AllCallTimers by MaxHerbold and D3SOX
- AltKrispSwitch by newwares
- AmITyping by MrDiamond
- Anammox by Kyuuhachi
- atSomeone by Joona
- DecodeBase64 by ThePirateStoner
- BetterActivities by D3SOX, Arjix, AutumnVN
- BetterBanReasons by Inbestigator
- BetterQuickReact by Ven and Sqaaakoi
- BetterUserArea by Samwich
- BlockKeywords by catcraft
- BlockKrsip by D3SOX
- BypassDND by Inbestigator
- ChannelTabs by TheSun, TheKodeToad, keifufu, Nickyux
- CleanChannelName by AutumnVN
- ClientSideBlock by Samwich
- ColorMessage by Kyuuhachi
- CommandPalette by Ethan
- CopyUserMention by Cortex and castdrian
- CustomSounds by ScattrdBlade
- CuteAnimeBoys by ShadyGoat
- CuteNekos by echo
- CutePats by thororen
- DeadMembers by Kyuuhachi
- Demonstration by Samwich
- DiscordColorways by DaBluLite
- DNDWhilePlaying by thororen
- DoNotLeak by Perny
- DontFilterMe by Samwich
- DoubleCounterBypass by nyx
- EmojiDumper by Cortex, Samwich, Woosh
- Encryptcord by Inbestigator
- EquicordCSS by thororen (and all respective css developers)
- ExportContacts by dat_insanity
- FindReply by newwares
- FrequentQuickSwitcher by Samwich
- FriendshipRanks by Samwich
- FriendTags by Samwich
- GensokyoRadioRPC by RyanCaoDev and Prince527
- GifRoulette by Samwich
- Glide by Samwich
- GlobalBadges by HypedDomi and Hosted by Wolfie
- GodMode by Tolgchu
- GoodPerson by nin0dev
- GoogleThat by Samwich
- Grammar by Samwich
- GrammarFix by unstream
- HideMessage by Hanzy
- HolyNotes by Wolfie
- HomeTyping by Samwich
- HopOn by ImLvna
- Husk by nin0dev
- Identity by Samwich
- IgnoreTerms by D3SOX
- InRole by nin0dev
- IrcColors by Grzesiek11
- IRememberYou by zoodogood
- JumpToStart by Samwich
- KeyboardSounds by HypedDomi
- KeywordNotify by camila314 (maintained by thororen)
- LoginWithQR by nexpid
- MediaDownloader by Colorman
- Meow by Samwich
- MessageLinkTooltip by Kyuuhachi
- MessageLoggerEnhanced by Aria
- MessageTranslate by Samwich
- ModalFade by Kyuuhachi
- MusicTitleRPC by Blackilykay
- NewPluginsManager by Sqaaakoi
- noAppsAllowed by kvba
- NoBulletPoints by Samwich
- NoDefaultEmojis by Samwich
- NoDeleteSafety by Samwich
- NoModalAnimation by AutumnVN
- NoNitroUpsell by thororen
- NoRoleHeaders by Samwich
- NotificationTitle by Kyuuhachi
- NotifyUserChanges by D3SOX
- OnePingPerDM by ProffDea
- PlatformSpoofer by Drag
- PurgeMessages by bhop and nyx
- QuestCompleter by HappyEnderman, SerStars (maintained by thororen)
- QuestionMarkReplacement by nyx
- Quoter by Samwich
- RepeatMessage by Tolgchu
- ReplaceActivityTypes by Nyako
- ReplyPingControl by ant0n and MrDiamond
- RPCStats by Samwich
- ScreenRecorder by AutumnVN
- SearchFix by Jaxx
- SekaiStickers by MaiKokain
- ServerSearch by camila314
- Shakespearean by vmohammad
- ShowBadgesInChat by Inbestigator and KrystalSkull
- Slap by Korbo
- SoundBoardLogger by Moxxie, fres, echo (maintained by thororen)
- SteamStatusSync by niko
- StickerBlocker by Samwich
- TalkInReverse by Tolgchu
- TeX by Kyuuhachi
- TextToSpeech by Samwich
- ThemeLibrary by Fafa
- Title by Kyuuhachi
- TosuRPC by AutumnVN
- Translate+ by Prince527 (Using Translate by Ven)
- UnitConverter by sadan
- UnlimitedAccounts by thororen
- UserPFP by nexpid (maintained by thororen)
- UwUifier by echo
- VCSupport by thororen
- VencordRPC by AutumnVN
- VideoSpeed by Samwich
- ViewRaw2 by Kyuuhachi
- VoiceChatUtilities by Dams and D3SOX
- WebpackTarball by Kyuuhachi
- WhosWatching by fres
- WigglyText by nexpid
- Woof by Samwich
- YoutubeDescription by arHSM

</details>


## Installing / Uninstalling

Windows
- [GUI](https://github.com/Equicord/Equilotl/releases/latest/download/Equilotl.exe)
- [CLI](https://github.com/Equicord/Equilotl/releases/latest/download/EquilotlCli.exe)

MacOS
- [GUI](https://github.com/Equicord/Equilotl/releases/latest/download/Equilotl.MacOS.zip)

Linux
- [CLI](https://github.com/Equicord/Equilotl/releases/latest/download/EquilotlCli-Linux)


## Installing Equicord Devbuild

### Dependencies
[Git](https://git-scm.com/download) and [Node.JS LTS](https://nodejs.dev/en/) are required.

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/Equicord instance and you **will** most likely have to reinstall.

Clone Equicord:

```shell
git clone https://github.com/Equicord/Equicord
cd Equicord
```

Install dependencies:

```shell
pnpm install --frozen-lockfile
```

Build Equicord:

```shell
pnpm build
```
Inject Equicord into your client:

```shell
pnpm inject
```
After you have done this command, it will look like you are just installing Equicord but it will say it is a development build. If it doesn't say it is a development build, please reach out for support in the [Discord Server](https://discord.gg/5Xh2W87egW)

## Join our Support/Community Server

https://discord.gg/5Xh2W87egW

## Credits

Thank you to [Vendicated](https://github.com/Vendicated) for creating [Vencord](https://github.com/Vendicated/Vencord).

Thank you to [Suncord [EOL]](https://github.com/verticalsync/Suncord) by [VerticalSync](https://github.com/verticalsync) for helping me when needed.

## Star History

<a href="https://star-history.com/#Equicord/Equicord&Timeline">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Equicord/Equicord&type=Timeline&theme=dark" />
    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Equicord/Equicord&type=Timeline" />
    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Equicord/Equicord&type=Timeline" />
  </picture>
</a>

## Disclaimer

Discord is trademark of Discord Inc. and solely mentioned for the sake of descriptivity.
Mentioning it does not imply any affiliation with or endorsement by Discord Inc.
Vencord is not connected to Equicord and as such, all donation links go to Vendicated's donation link.

<details>
<summary>Using Equicord violates Discord's terms of service</summary>

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 if you don’t use plugins that implement abusive behaviour. But no worries, all inbuilt plugins are safe to use!

Regardless, if your account is essential to you and getting disabled would be a disaster for you, you should probably not use any client mods (not exclusive to Equicord), just to be safe

Additionally, make sure not to post screenshots with Equicord in a server where you might get banned for it

</details>