armcord/README.md
2023-02-26 00:04:34 +01:00

7.5 KiB


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 anyway.

  • Various mods built in

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

  • 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 a experimental mobile support for phones running Linux such as the PinePhone. While this is still far from 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

Packaging status

Windows

Download ArmCord

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

Debian, Ubuntu, 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://eu.armcord.xyz/pgp-key.public | sudo gpg --dearmor -o /usr/share/keyrings/armcord.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/armcord.gpg] https://eu.armcord.xyz/apt-repo stable main" | sudo tee /etc/apt/sources.list.d/armcord.list
sudo apt update
sudo apt install armcord

Snap package

ArmCord is also available on the Snap store here.
Get it from the Snap Store

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

FreeBSD

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

Pi-Apps

ArmCord is also available in Pi-Apps.
badge

Pre-built binaries:

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

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 npm run build
  4. Compile/Package with npm 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 settings?

  • Either right click on the tray icon and click Open Settings or open Discord settings and scroll the sidebar down until you see information about versions. Click on ArmCord version and the settings window will popout.

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 in themes and mods with no installers/injectors. You can even make the client have transparency effects and follow fluent design on Windows! At it's 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 with it. Of course VMs and Hackintosh machines exist but from my experience these are unreliable or very time consuming to setup and mantain. 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?

Credits