armcord/README.md

ArmCord is a custom client designed to enhance your Discord experience while keeping everything lightweight.

Features

• Standalone client

  ArmCord is built as a standalone client and doesn't rely on the original Discord client in any way.

• Various mods built-in

  Enjoy Vencord, Shelter and their many features, or have a more vanilla experience, it's your choice!

• Themes

  ArmCord natively supports theming of the entire app, you can easily import BetterDiscord themes and manage them

• Made for Privacy™

  ArmCord automatically blocks all of Discord's trackers; even without any client mods, you can feel safe and secure!

• Supports Rich Presence

  Unlike other clients, ArmCord supports rich presence (game activity) out of the box thanks to arRPC.

• Mobile support

  ArmCord has experimental mobile support for phones running Linux such as the PinePhone. While this is still far from an ideal solution, we're slowly trying to improve it.

• Much more stable

  ArmCord is using a newer build of Electron than the stock Discord app. This means you can have a much more stable and secure experience, along with slightly better performance.

• Cross-platform support!

  ArmCord was originally created for ARM64 Linux devices since Discord doesn't support them. We soon decided to support every platform that Electron supports!

How to run/install it?

Packaging status

Windows

If you're using an older version of Windows, you need to use pre-built installers.

Flatpak

Debian, Ubuntu and Raspbian repository

ArmCord is available on our official repositories for apt package manager. By using this method you'll receive automatic updates and get all the dependencies. Run the following commands to install ArmCord from them:

curl -fsSL https://apt.armcord.app/public.gpg | sudo gpg --dearmor -o /usr/share/keyrings/armcord.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/armcord.gpg] https://apt.armcord.app/ stable main" | sudo tee /etc/apt/sources.list.d/armcord.list
sudo apt update
sudo apt install armcord

If you previously used old ArmCord apt repo, here's how you can remove it:

sudo rm /etc/apt/sources.list.d/armcord.list
sudo rm /usr/share/keyrings/armcord.gpg
sudo apt update

Snap package

ArmCord is also available on the Snap store here.

Similar to armcord-git on AUR, you can install the latest dev builds through snaps by running this command:

sudo snap install armcord --channel=latest/edge

Snapd will automatically update the app including developer builds.

Winget Package

ArmCord is also available on the winget-pkgs repository:

winget install ArmCord.ArmCord

Scoop package

ArmCord is also available on Scoop extras repo:

scoop bucket add extras

scoop install armcord

AUR Package

ArmCord is also available on the Arch User Repository (AUR):

• armcord-bin - ArmCord Release ~ Static binary from release, stable release only

• armcord-git - ArmCord Dev ~ Latest devbuild built from source (takes ~1 minute) using the system electron

Install it via an AUR helper tool like yay.

Example: yay -S armcord-bin

Homebrew repository

ArmCord also has a homebrew repository

brew tap armcord/armcord

brew install --cask armcord

FreeBSD

You can also get ArmCord running on FreeBSD by following these instructions.

Pi-Apps

ArmCord is also available in Pi-Apps.

Pre-built binaries:

Check the releases tab for precompiled packages for Linux, Windows, and Mac OS. Alternatively, use our Sourceforge mirror.

Compiling:

Alternatively, you can run ArmCord from source (NodeJS, pnpm, and rust toolchain are required):

1. Clone ArmCord repo: git clone https://github.com/ArmCord/ArmCord.git
2. Run pnpm install to install dependencies
3. Build with pnpm run build
4. Compile/Package with pnpm run package

FAQ

Do you have a support Discord?

Will I get banned for using this?

• You are breaking Discord ToS by using ArmCord, but no one has been banned from using it or any of the client mods included.

Can I use this on anything other than ARM?

• Yes! ArmCord should work normally under Windows, MacOS, and Linux as long as it has Electron support.

How can I access the settings?

• Open Discord settings and there should be a button ArmCord Settings button with a white Discord icon, you can also right click on the tray icon and click Open Settings

How does this work?

• We are using the official web app and wrapping it up in Electron. While you may think this is lame and done like thousands of times before, what makes us unique is that we actually strive for creating a customized experience. You can very easily load themes and mods with no installers/injectors. You can even make the client have transparency effects and follow the fluent design of Windows! At its core, it's just a simple web wrapper, however, we applied many patches to make this work well for you <3

Why is MacOS support lacking?

• Due to me not owning any macOS device, I can't easily debug/test or do anything related to it. Of course, VMs and Hackintosh machines exist but from my experience, these are unreliable or very time-consuming to set up and maintain. While ArmCord "works" on macOS you may encounter weird issues or inconsistencies with other apps in terms of how they behave (for example macOS lack of tray).

Where can I find the source code?

• The source code is on GitHub.

Where can I translate this?

• Translations are done using our Weblate page.

Credits

• ArmCord UI design, branding, and a few features
• OpenAsar
• arRPC (for Rich Presence)
• (pre v3.1.0) Cumcord
• (pre v3.1.0) GooseMod
• (pre v3.1.0) GooseMod Extension
• (pre v3.1.0) FlickerMod
• (Pre v3.0.0) custom-electron-titlebar
• electron-builder

Discord is trademark of Discord Inc. ArmCord is not affiliated with or endorsed by Discord Inc.