explaingit

ayn2op/discordo

5,519GoAudience · developerComplexity · 2/5LicenseSetup · moderate

TLDR

A lightweight Discord client that runs entirely in your terminal window instead of a browser or desktop app, letting you chat on Discord using keyboard commands with a customizable theme.

Mindmap

mindmap
  root((discordo))
    What it does
      Terminal Discord client
      Keyboard-driven UI
      Theme and keybindings
    Installation
      Prebuilt binaries
      Package managers
      Build from source
    Login
      User token
      Environment variable
      QR code scan
    Platforms
      Linux
      macOS
      Windows
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Use Discord from a terminal window without a browser or desktop app installed.

USE CASE 2

Customize your Discord interface with keyboard shortcuts and a color theme via a config file.

USE CASE 3

Run Discord on a headless Linux server over SSH where no graphical display is available.

USE CASE 4

Connect to Discord with just a terminal on minimal Linux setups or inside Docker containers.

Tech stack

GoTUI

Getting it running

Difficulty · moderate Time to first run · 30min

Requires a Discord user token (not email/password login), using self-bot accounts violates Discord's Terms of Service.

You can use, modify, and share this software freely, but any version you distribute must also be released under the same GPL v3 license.

In plain English

Discordo is a Discord client that runs entirely inside a terminal window, with no graphical interface required. Instead of opening a browser or a desktop app, you use Discord by typing commands and reading text in the same kind of window a developer uses to run code. This style of interface is sometimes called a TUI, short for terminal user interface. The project is written in Go and described as lightweight and still under active development, with the README noting that breaking changes are expected. It runs on Windows, macOS, and Linux. You can install it from prebuilt binaries, through a package manager on several Linux distributions and FreeBSD, through Scoop on Windows, or by building it from source if you have Go installed. Logging in requires a Discord user token, not a standard email and password flow. The README offers three paths: entering the token through the app's own login screen, setting it as an environment variable before launching, or scanning a QR code. The README also includes a warning that using self-bots or automated user accounts violates Discord's Terms of Service, and the author notes they are not responsible for any consequences. Once running, you can customize the app through a configuration file stored in a standard location for your operating system. The configuration controls keybindings and the visual theme of the terminal interface. On Linux systems using Wayland (a display system common on modern Linux desktops), clipboard support requires an additional utility called wl-clipboard. The project is licensed under the GNU General Public License v3.0, which means you can use, modify, and redistribute it, but any changes you distribute must also be released under the same license.

Copy-paste prompts

Prompt 1
I want to use Discordo to access Discord from my terminal. Walk me through getting my Discord user token and setting it up to log in without a browser.
Prompt 2
Help me write a Discordo configuration file that remaps the send-message key to Ctrl+Enter and sets a dark terminal color theme.
Prompt 3
I'm on Linux with Wayland and Discordo clipboard paste isn't working. Explain what wl-clipboard is and how to install it so copy-paste works in the terminal Discord client.
Prompt 4
Build discordo from source on my machine using Go and explain where to place the config file on macOS vs Linux.
Prompt 5
Explain the Discord Terms of Service risk of using a user token with Discordo and what self-bot restrictions mean in practice.
Open on GitHub → Explain another repo

← ayn2op on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.