https://github.com/ayn2op/discordo
A lightweight, secure, and feature-rich Discord terminal (TUI) client.
https://github.com/ayn2op/discordo
cross-platform discord discordo go golang linux terminal terminal-based tui
Last synced: 5 months 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 (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2026-01-05T07:51:29.000Z (5 months ago)
- Last Synced: 2026-01-05T08:59:56.617Z (5 months ago)
- Topics: cross-platform, discord, discordo, go, golang, linux, terminal, terminal-based, tui
- Language: Go
- Homepage:
- Size: 9.85 MB
- Stars: 4,946
- Watchers: 37
- Forks: 165
- Open Issues: 69
-
Metadata Files:
- Readme: README.md
- License: LICENSE
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-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/ayn2op/discordo - Discord client (CLI/TUI Apps / Other)
- definitive-opensource - Discordo - rich Discord terminal (TUI) client. | `Cross` | **5.6k** | (Table of Contents / Chat)
- awesome - ayn2op/discordo - rich Discord terminal (TUI) client. (TUI)
- awesome-cli-apps-in-a-csv - Discordo - A lightweight, secure, and feature-rich Discord terminal client. (<a name="chat"></a>Chat and instant messaging)
- starred - ayn2op/discordo - A lightweight, secure, and feature-rich Discord terminal (TUI) client. (Go)
- awesome-rainmana - ayn2op/discordo - A lightweight, secure, and feature-rich Discord terminal (TUI) client. (Go)
- awesome-golang-repositories - discordo - rich Discord terminal client (Repositories)
README
# Discordo · [](https://discord.com/invite/VzF9UFn2aB) [](https://github.com/ayn2op/discordo/actions/workflows/ci.yml) [](https://goreportcard.com/report/github.com/ayn2op/discordo) [](https://github.com/ayn2op/discordo/blob/master/LICENSE)
Discordo is a lightweight, secure, and feature-rich Discord terminal client. Heavily work-in-progress, expect breaking changes.
## Features
- Lightweight
- Configurable
- Mouse & clipboard support
- Attachments
- Notifications
- 2-Factor & QR code authentication
- Discord-flavored markdown
## 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`.
- Windows (Scoop):
```sh
scoop bucket add vvxrtues https://github.com/vvirtues/bucket
scoop install discordo
```
### Building from source
```bash
git clone https://github.com/ayn2op/discordo
cd discordo
go build .
```
### Wayland clipboard support
`wl-clipboard` is required for clipboard support.
## Usage
### Token (UI)
1. Run the `discordo` executable with no arguments.
2. Enter your token and click on the "Login" button to save it.
### Token (CLI)
Provide the `token` command-line flag to the executable.
```sh
discordo --token "OTI2MDU5NTQxNDE2Nzc5ODA2.Yc2KKA.2iZ-5JxgxG-9Ub8GHzBSn-NJjNg"
```
Alternatively, set the value of the `DISCORDO_TOKEN` environment variable to the authentication token.
### QR
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.
## 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`
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 default configuration can be found here](./internal/config/config.toml).
> [!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.