armcord/README.md

80 lines
3.7 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">
<img src="https://armcord.vercel.app/armcord_full_logo.png" width="520">
2022-01-17 12:13:10 +00:00
<br>ArmCord is a custom client designed to enhance your Discord experience while keeping everything lightweight.
</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 standalone client, it doesn't rely on original Discord client.
- **Various mods built in**
Explore Cumcord/GooseMod/Flicker plugins and their features!
- **Made for Privacy**
ArmCord automatically blocks Discord's trackers.
- **Faster than normal Discord app**
ArmCord is using newer Electron than stock Discord app. This usually means increased performance and more stable experience.
- **Designed to work anywhere**
ArmCord was initially created in mind to run on Arm64 Linux devices. We soon expanded our support to more platforms. We plan to support every platform that [Electron supports](https://www.electronjs.org/docs/latest/tutorial/support#supported-platforms).
2021-03-20 19:07:15 +00:00
# How to run/install it?
2022-01-15 21:21:51 +00:00
### Recommended:
2022-04-20 18:43:38 +00:00
Check releases tab for precompiled packages for Linux, Windows and Mac OS. Alternatively use our Sourceforge mirror.
2022-02-07 17:25:47 +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-01-17 13:55:16 +00:00
### AUR Package
2022-05-21 10:11:55 +00:00
ArmCord is also available on the Arch User Repository (AUR) [here](https://aur.archlinux.org/packages/armcord-bin/).
2022-01-17 13:55:16 +00:00
Install it via an AUR helper tool like `yay`.
**Example:** `yay -S armcord-bin`
2022-05-21 10:11:55 +00:00
### 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>
2022-01-15 21:21:51 +00:00
### Manual:
2022-01-17 12:15:16 +00:00
Alternatively you can run ArmCord from source (npm, nodejs required):
1. Clone ArmCord repo: `git clone https://github.com/ArmCord/ArmCord.git`
2. Run `npm 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-01-17 12:13:49 +00:00
## 1. Will I get banned from using it?
2021-05-01 13:46:53 +00:00
2022-04-20 18:43:38 +00:00
- You are breaking Discord ToS if you decided to use client mods. But no one ever got banned from using ArmCord or any of the client mods included. If you wish to remove mods, check our documentation.
2022-01-17 12:13:49 +00:00
## 2. How does this work?
2021-05-01 13:46:53 +00:00
2022-04-20 18:43:38 +00:00
- We are using official web app and adding some magic powder to make it all work!
2022-01-17 12:13:49 +00:00
## 3. Can I use this on other architectures or operating systems?
2021-05-01 17:08:41 +00:00
2022-04-20 18:43:38 +00:00
- Yes! ArmCord should work normally under Windows, Mac OS and Linux as long as it has NodeJS, npm and Electron support.
## 4. Where can I translate this?
- Translations are done using our [Weblate page](https://hosted.weblate.org/projects/armcord/armcord/). They're pushed to this [repo](https://github.com/ArmCord/i18n).
2021-05-04 10:18:49 +00:00
# Credits
2021-05-10 09:53:52 +00:00
[ArmCord UI Elements and few features](https://github.com/kckarnige)
2021-11-01 20:48:21 +00:00
[Cumcord](https://github.com/Cumcord/Cumcord)
2022-01-15 21:21:51 +00:00
[GooseMod](https://github.com/GooseMod/GooseMod)
2021-06-26 19:02:50 +00:00
[GooseMod Extension](https://github.com/GooseMod/extension)
2021-05-04 10:20:10 +00:00
[electron-discord-webapp](https://github.com/SpacingBat3/electron-discord-webapp)
2022-01-15 21:21:51 +00:00
[custom-electron-titlebar (css only)](https://github.com/AlexTorresSk/custom-electron-titlebar)
[electron-builder](https://electron.build)
2022-05-22 16:14:54 +00:00
[OpenAsar (~~stole~~ borrowed code for adding custom build info seemlessly)](https://github.com/GooseMod/OpenAsar)
2022-05-13 13:17:29 +00:00
# Sponsors
[![JetBrains supports ArmCord with free licenses to their software to core developers](https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.svg)](https://jb.gg/OpenSourceSupport)