armcord/README.md
2026-03-26 16:58:20 +01:00

189 lines
7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

![Legcord](https://github.com/user-attachments/assets/f7b007d4-44fa-4c88-96e4-0a448b568b5d)
# Features
- **Standalone client**
Legcord is built as a standalone client and doesn't rely on the original Discord client in any way.
- **Various mods built-in**
Enjoy [Vencord](https://github.com/Vendicated/Vencord), [Equicord](https://github.com/Equicord/Equicord), [Shelter](https://github.com/uwu/shelter) and their many features, or have a more vanilla experience, it's your choice!
- **Themes**
Legcord natively supports theming of the entire app, you can easily import BetterDiscord themes and manage them
- **Made for Privacy™**
Legcord automatically blocks all of Discord's trackers; even without any client mods, you can feel safe and secure!
- **Supports Rich Presence**
Unlike other clients, Legcord supports rich presence (game activity) out of the box thanks to [arRPC](https://arrpc.openasar.dev).
- **Mobile support**
Legcord 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**
Legcord 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!**
Legcord was originally created for AArch64 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)!
# How to run/install it?
## Packaging status
[![Packaging status](https://repology.org/badge/vertical-allrepos/legcord.svg)](https://repology.org/project/legcord/versions)
### Windows
[Get the .exe installer](https://www.legcord.app/download)
[<img src="https://user-images.githubusercontent.com/49786146/159123313-3bdafdd3-5130-4b0d-9003-40618390943a.png" width="200" />](https://winstall.app/apps/smartfrigde.Legcord)
```pwsh
winget install --id=smartfrigde.Legcord -e
```
[<img src="https://learn.microsoft.com/en-us/windows/apps/images/new-badge-light.png" width="200" />](https://apps.microsoft.com/detail/9pdkjpv0wxlg?ocid=webpdpshare)
### Flatpak
Not available yet.
### Debian, Ubuntu and Raspbian
#### Install via .deb from GitHub Releases
You can install Legcord directly using the `.deb` packages published on the GitHub Releases page.
1. Go to the Releases page: https://github.com/Legcord/Legcord/releases
2. Download the `.deb` that matches your architecture:
- `amd64` (most Intel/AMD 64bit PCs)
- `arm64` (AArch64, e.g. Raspberry Pi 4/5 64bit, ARM laptops)
3. Install the downloaded file (this resolves dependencies automatically):
```sh
sudo apt install ./<downloaded-file>.deb
```
Alternatively, you can copy the asset link from the release and install via terminal:
```sh
# Replace the URL below with the copied link to the .deb asset from the Releases page
wget -O legcord.deb "https://github.com/Legcord/Legcord/releases/download/<tag>/<asset>.deb"
sudo apt install legcord.deb
```
If your system reports missing dependencies, you can also use this fallback:
```sh
sudo dpkg -i <downloaded-file>.deb || sudo apt -f install
```
#### Alternative: pacstall
legcord-deb is available on [pacstall](https://pacstall.dev/packages/legcord-deb)
```sh
sudo bash -c "$(wget -q https://pacstall.dev/q/install -O -)" # Install pacstall if not installed
pacstall -I legcord-deb
```
### Snap package
[![Get it from the Snap store](https://assets.ubuntu.com/v1/b16729d2-snap-store-black.svg)](https://snapcraft.io/legcord)
### Scoop package
Legcord is also available on the [Extras](https://github.com/ScoopInstaller/Extras) repo
```powershell
scoop bucket add extras # Ensure bucket is added first
scoop install legcord
```
### AUR Package
- [legcord-git](https://aur.archlinux.org/packages/legcord-git) Built locally against dev branch
### Homebrew repository
Legcord is also available on the [Homebrew Cask](https://github.com/Homebrew/homebrew-cask) repo
```zsh
brew install --cask legcord
```
### MacPorts
Legcord is available [via MacPorts](https://ports.macports.org/port/Legcord/)
```sh
sudo port install legcord
```
### FreeBSD
You can also get Legcord running on FreeBSD by following [these instructions](https://gist.github.com/axyiee/4d29c982ac85d5d26f98a51040b5de37).
### Pi-Apps
Legcord 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)
### Pre-built binaries
Check the **[releases tab](https://github.com/Legcord/Legcord/releases)** for precompiled packages for Linux, Windows, and macOS.
### Compiling
Alternatively, you can run Legcord from source ([NodeJS](https://nodejs.dev) and [pnpm](https://pnpm.io/installation#using-npm)) are required:
1. Clone Legcord repo: `git clone https://github.com/Legcord/Legcord.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?
[![Discord Server](https://dcbadge.vercel.app/api/server/TnhxcqynZ2)](https://discord.gg/TnhxcqynZ2)
## 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 Legcord, but no one has been banned from using it or any of the client mods included.
## How can I access the settings?
- Open Discord settings and there should be a button `Legcord 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 utilize the official web app and package it within Electron. While this approach may seem familiar, our focus is on delivering a truly customized and enhanced experience. Unlike many others, we provide seamless integration for loading themes and mods without the need for installers or injectors. You can easily enable transparency effects and adopt Windows' Fluent Design, offering a modern and sleek interface. Though it's fundamentally a web wrapper, we have implemented numerous optimizations and patches to ensure a smooth and tailored experience for you.
## Does Legcord have a portable mode for windows?
- Yes it does! Simply add a folder called "legcord-data" in the folder where your legcord executable is located and start Legcord. Make sure to download the archive/zip file.
## Where can I find the source code?
- The source code is on [GitHub](https://github.com/Legcord/Legcord/).
## Where can I translate this?
- Translations are done using our [Weblate page](https://hosted.weblate.org/projects/armcord/).
# Credits
- [Legcord 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)
- [electron-builder](https://electron.build)
Discord is trademark of Discord Inc. Legcord is not affiliated with or endorsed by Discord Inc.
Legcord is not affiliated with or endorsed by ARM Limited.