armcord/README.md

158 lines
8 KiB
Markdown
Raw Normal View History

2022-01-15 21:21:51 +00:00
2022-01-17 12:13:10 +00:00
<div align="center">
2023-07-29 18:01:43 +00:00
<img src="https://armcord.app/logo.png" width="520">
2022-07-09 22:46:17 +00:00
<br>ArmCord is a custom client designed to enhance your Discord experience while keeping everything lightweight.
2022-01-17 12:13:10 +00:00
</div>
2022-01-15 21:21:51 +00:00
# Features
2021-05-01 17:53:38 +00:00
2022-01-17 12:13:10 +00:00
- **Standalone client**
ArmCord is built as a standalone client and doesn't rely on the original Discord client in any way.
2022-01-17 12:13:10 +00:00
- **Various mods built-in**
2022-01-17 12:13:10 +00:00
2022-12-15 20:02:15 +00:00
Enjoy [Vencord](https://github.com/Vendicated/Vencord), [Shelter](https://github.com/uwu/shelter) and their many features, or have a more vanilla experience, it's your choice!
2022-01-17 12:13:10 +00:00
2023-05-14 09:32:59 +00:00
- **Themes**
ArmCord natively supports theming of the entire app, you can easily import BetterDiscord themes and manage them
2022-07-07 19:31:29 +00:00
- **Made for Privacy™**
2022-01-17 12:13:10 +00:00
ArmCord automatically blocks all of Discord's trackers; even without any client mods, you can feel safe and secure!
2022-01-17 12:13:10 +00:00
2022-12-15 20:02:15 +00:00
- **Supports Rich Presence**
Unlike other clients, ArmCord supports rich presence (game activity) out of the box thanks to [arRPC](https://arrpc.openasar.dev).
2022-12-15 20:02:15 +00:00
- **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.
2022-01-17 12:13:10 +00:00
2022-07-07 19:31:29 +00:00
- **Much more stable**
2022-01-17 12:13:10 +00:00
2022-07-07 19:31:29 +00:00
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.
2022-01-17 12:13:10 +00:00
2022-07-07 19:31:29 +00:00
- **Cross-platform support!**
2022-01-17 12:13:10 +00:00
ArmCord was originally created for ARM64 Linux devices since Discord doesn't support them. We soon decided to support every platform that [Electron supports](https://github.com/electron/electron#platform-support)!
2022-01-17 12:13:10 +00:00
2021-03-20 19:07:15 +00:00
# How to run/install it?
2022-12-26 17:28:15 +00:00
2022-12-15 20:02:15 +00:00
## Packaging status
[![Packaging status](https://repology.org/badge/vertical-allrepos/armcord.svg)](https://repology.org/project/armcord/versions)
2023-02-25 18:08:21 +00:00
### Windows
2023-02-25 23:04:34 +00:00
<a href="https://microsoft.com/store/apps/9PFHLJFD7KJT">
2023-02-25 18:08:21 +00:00
<img src="https://get.microsoft.com/images/en-us%20dark.svg" alt="Download ArmCord" />
</a>
2023-07-29 18:01:43 +00:00
If you're using an older version of Windows, you need to use [pre-built installers](https://www.armcord.app/download).
2023-02-25 18:08:21 +00:00
### Flatpak
<a href='https://flathub.org/apps/details/xyz.armcord.ArmCord'><img width='240' alt='Download on Flathub' src='https://flathub.org/assets/badges/flathub-badge-en.svg'/></a>
### Debian, Ubuntu and Raspbian repository
2022-12-26 17:28:15 +00:00
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:
```sh
2024-01-28 18:16:02 +00:00
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
2022-12-26 17:28:15 +00:00
sudo apt update
sudo apt install armcord
```
2024-01-28 18:16:02 +00:00
If you previously used old ArmCord apt repo, here's how you can remove it:
```sh
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](https://snapcraft.io/armcord).
<a href="https://snapcraft.io/armcord">
<img alt="Get it from the Snap Store" src="https://snapcraft.io/static/images/badges/en/snap-store-black.svg" />
</a>
Similar to `armcord-git` on AUR, you can install the latest dev builds through snaps by running this command:
```shell
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](https://github.com/microsoft/winget-pkgs) repository:
```
winget install ArmCord.ArmCord
```
2022-09-27 13:31:04 +00:00
### Scoop package
ArmCord is also available on [Scoop extras](https://github.com/ScoopInstaller/Extras) repo:
```
scoop bucket add extras
```
```
scoop install armcord
```
2022-01-17 13:55:16 +00:00
### AUR Package
ArmCord is also available on the Arch User Repository (AUR):
2022-12-26 17:28:15 +00:00
- [armcord-bin](https://aur.archlinux.org/packages/armcord-bin) - ArmCord Release ~ Static binary from release, stable release only
- [armcord-git](https://aur.archlinux.org/packages/armcord-git) - ArmCord Dev ~ Latest devbuild built from source (takes ~1 minute) using the system electron
2022-01-17 13:55:16 +00:00
Install it via an AUR helper tool like `yay`.
**Example:** `yay -S armcord-bin`
2022-12-28 14:46:19 +00:00
### FreeBSD
2023-07-22 08:38:47 +00:00
You can also get ArmCord running on FreeBSD by following [these instructions](https://gist.github.com/txxlchains/4d29c982ac85d5d26f98a51040b5de37).
2022-06-21 21:50:12 +00:00
### Pi-Apps
ArmCord is also available in [Pi-Apps](https://github.com/Botspot/pi-apps).
[![badge](https://github.com/Botspot/pi-apps/blob/master/icons/badge.png?raw=true)](https://github.com/Botspot/pi-apps)
2022-07-07 19:31:29 +00:00
2022-12-26 17:28:15 +00:00
### Pre-built binaries:
Check the **releases tab** for precompiled packages for Linux, Windows, and Mac OS. Alternatively, use our Sourceforge mirror.
2022-12-26 17:28:15 +00:00
<a href="https://sourceforge.net/projects/armcord/files/latest/download"><img alt="Download ArmCord" src="https://a.fsdn.com/con/app/sf-download-button" width=276 height=48 srcset="https://a.fsdn.com/con/app/sf-download-button?button_size=2x 2x"></a>
2022-07-07 19:31:29 +00:00
### Compiling:
Alternatively, you can run ArmCord from source ([NodeJS](https://nodejs.dev), [pnpm](https://pnpm.io/installation#using-npm), and [rust toolchain](https://www.rust-lang.org/tools/install) are required):
2022-01-17 12:15:16 +00:00
1. Clone ArmCord repo: `git clone https://github.com/ArmCord/ArmCord.git`
2022-10-08 15:43:08 +00:00
2. Run `pnpm install` to install dependencies
2022-05-21 10:17:28 +00:00
3. Build with `npm run build`
4. Compile/Package with `npm run package`
2021-05-01 17:08:41 +00:00
2021-05-01 12:48:50 +00:00
2020-11-16 13:59:19 +00:00
# FAQ
2022-12-26 17:28:15 +00:00
## Do you have a support Discord?
[![](https://dcbadge.vercel.app/api/server/TnhxcqynZ2)](https://discord.gg/TnhxcqynZ2)
2022-07-07 19:31:29 +00:00
## Will I get banned for using this?
- You are breaking [Discord ToS](https://discord.com/terms#software-in-discord%E2%80%99s-services) 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.
2022-07-07 19:31:29 +00:00
## How can I access the settings?
2024-01-30 08:47:52 +00:00
- 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`
2022-12-15 20:02:15 +00:00
2022-07-07 19:31:29 +00:00
## 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
2022-12-15 20:02:15 +00:00
## 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).
2021-05-01 13:46:53 +00:00
2022-07-07 19:31:29 +00:00
## Where can I find the source code?
- The source code is on [GitHub](https://github.com/ArmCord/ArmCord/).
2021-05-01 13:46:53 +00:00
2022-07-07 19:31:29 +00:00
## Where can I translate this?
2022-12-15 20:02:15 +00:00
- Translations are done using our [Weblate page](https://hosted.weblate.org/projects/armcord/armcord/).
2021-05-01 17:08:41 +00:00
2021-05-04 10:18:49 +00:00
# Credits
- [ArmCord UI design, branding, and a few features](https://github.com/kckarnige)
- [OpenAsar](https://github.com/GooseMod/OpenAsar)
- [arRPC (for Rich Presence)](https://github.com/OpenAsar/arrpc)
- (pre v3.1.0) [Cumcord](https://github.com/Cumcord/Cumcord)
- (pre v3.1.0) [GooseMod](https://github.com/GooseMod/GooseMod)
- (pre v3.1.0) [GooseMod Extension](https://github.com/GooseMod/extension)
- (pre v3.1.0) [FlickerMod](https://github.com/FlickerMod)
- (Pre v3.0.0) [custom-electron-titlebar](https://github.com/AlexTorresSk/custom-electron-titlebar)
- [electron-builder](https://electron.build)
2023-07-28 21:36:29 +00:00
Discord is trademark of Discord Inc. ArmCord is not affiliated with or endorsed by Discord Inc.