https://github.com/ayn2op/discordo
A lightweight, secure, and feature-rich Discord terminal (TUI) client.
https://github.com/ayn2op/discordo
client cross-platform discord discord-bot discord-client discordo go golang lightweight linux macos terminal terminal-based tui windows
Last synced: about 1 month ago
JSON representation
A lightweight, secure, and feature-rich Discord terminal (TUI) client.
- Host: GitHub
- URL: https://github.com/ayn2op/discordo
- Owner: ayn2op
- License: gpl-3.0
- Created: 2021-07-17T11:00:48.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2026-10-09T22:52:05.000Z (about 1 month ago)
- Last Synced: 2026-10-10T21:33:14.878Z (about 1 month ago)
- Topics: client, cross-platform, discord, discord-bot, discord-client, discordo, go, golang, lightweight, linux, macos, terminal, terminal-based, tui, windows
- Language: Go
- Homepage:
- Size: 16 MB
- Stars: 5,823
- Watchers: 40
- Forks: 231
- Open Issues: 48
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-cli-apps - Discordo - A lightweight, secure, and feature-rich Discord terminal client. (<a name="chat"></a>Chat and instant messaging)
- awesome-cli-apps-in-a-csv - Discordo - A lightweight, secure, and feature-rich Discord terminal client. (Chat and instant messaging)
- definitive-opensource - Discordo - rich Discord terminal (TUI) client. | `Cross` | **5.8k** | (Table of Contents / Discord Client)
- awesome - ayn2op/discordo - rich Discord terminal (TUI) client. (TUI)
- starred - ayn2op/discordo - A lightweight, secure, and feature-rich Discord terminal (TUI) client. (Go)
- awesome-go - ayn2op/discordo - A lightweight, secure, and feature-rich Discord terminal (TUI) client. (User Interface / Applications and End User Tools)
- github-ultimate-repos - ayn2op/discordo - | ⭐ 5,846★ | 🍴 235 | 💻 `Go`🔗 <https://github.com/ayn2op/discordo>📝 A lightweight, secure, and feature-rich Discord terminal (TUI) client.⚙️ `Zero-cost abstraction type checking -> affine borrow checker & lifetime validation -> LLVM backend code generation -> memory-safe native binary emission.` (📜 Master Categorized Repository Directory (100% Clickable Links) / [45] SYSTEMS PROGRAMMING, LOW-LEVEL RUNTIMES, MEMORY SAFETY & WEBASSEMBLY (WASM))
- awesome-golang-repositories - discordo - rich Discord terminal client (Repositories)
README
# Discordo · [](https://discord.com/invite/VzF9UFn2aB) [](https://github.com/ayn2op/discordo/blob/master/LICENSE)
Discordo is a lightweight, secure, and feature-rich Discord terminal client.


## Installation
### Prebuilt binaries
You can download and install a [prebuilt binary here](https://nightly.link/ayn2op/discordo/workflows/ci/main) for Windows, macOS, or Linux.
### Package managers
- Arch Linux: `yay -S discordo-git`
- Gentoo (available on the guru repos as a live ebuild): `emerge net-im/discordo`
- FreeBSD: `pkg install discordo` or via the ports system `make -C /usr/ports/net-im/discordo install clean`
- Nix: Add `pkgs.discordo` to `environment.systemPackages` or `home.packages`
- Android (Termux): `pkg install discordo`
- Windows (Scoop):
```sh
scoop bucket add vvxrtues https://github.com/vvirtues/bucket
scoop install discordo
```
### Building from source
Requires [Go](https://go.dev/dl). Voice support requires a C compiler, and `libpulse` or `libasound` on Linux.
```sh
git clone https://github.com/ayn2op/discordo
cd discordo
go build .
```
#### Tags
- `no_voice` to build without voice support.
- `no_spoof_tls_fingerprint` to build without TLS fingerprint spoofing.
## Usage
### Password (UI)
1. Run the `discordo` executable with no arguments.
2. Open the "Password" tab, enter your email address or E.164-formatted phone number and password, then click the "Login" button.
### QR (UI)
1. Run the `discordo` executable with no arguments.
2. Click on the "Login with QR" button.
3. Follow the instructions in the QR Login screen.
### Token (UI)
1. Run the `discordo` executable with no arguments.
2. Enter your token and click on the "Login" button to save it.
### Token (environment variable)
Set the value of the `DISCORDO_TOKEN` environment variable to the authentication token to log in with.
```sh
DISCORDO_TOKEN="OTI2MDU5NTQxNDE2Nzc5ODA2.Yc2KKA.2iZ-5JxgxG-9Ub8GHzBSn-NJjNg" discordo
```
## Configuration
The configuration file allows you to configure and customize the behavior, keybindings, and theme of the application.
- Unix: `$XDG_CONFIG_HOME/discordo/config.toml` or `$HOME/.config/discordo/config.toml`
- Darwin: `$HOME/Library/Application Support/discordo/config.toml`
- Windows: `%AppData%/discordo/config.toml`
Use `-config-path` to change the path.
Discordo uses the default configuration if a configuration file is not found in the aforementioned path; however, the default configuration file is not written to the path. [The configuration reference can be found here](./docs/config.md).
## Logs
The log file is replaced on each run.
- Unix: `$XDG_CACHE_HOME/discordo/logs.txt` or `$HOME/.cache/discordo/logs.txt`
- Darwin: `$HOME/Library/Caches/discordo/logs.txt`
- Windows: `%LocalAppData%/discordo/logs.txt`
Use `-log-path` to change the path, and `-log-level` (`debug`, `info`, `warn`, or `error`) to set the verbosity of what is logged.
## License
Copyright (C) 2025-present ayn2op
This project is licensed under the GNU General Public License v3.0 (GPL-3.0).
See the [LICENSE](./LICENSE) file for the full license text.
# Disclaimer
> [!IMPORTANT]
> Automated user accounts or "self-bots" are against Discord's Terms of Service. I am not responsible for any loss caused by using "self-bots" or Discordo.