oiupoyt/discordo
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
No description
1674 commits 5 branches 0 tags 19 MiB
Go 100%
Find a file
ayn2op 688cb05f67 refactor(ui): move help keybinds to keymap.go
2026-10-09 18:29:39 -04:00
.github feat(config): generate docs/config.md from the config structs (#842) 2026-10-07 18:06:07 -04:00
cmd refactor(cmd): parse log level with slog.Level.UnmarshalText 2026-09-29 01:13:48 -04:00
docs feat(config): add keybinds to scroll the trees 2026-10-08 17:42:35 -04:00
internal refactor(ui): move help keybinds to keymap.go 2026-10-09 18:29:39 -04:00
.gitignore refactor: unexport local symbols 2025-06-01 22:51:30 -04:00
AGENTS.md docs(AGENTS): remove redundant newline 2026-07-23 14:57:41 -04:00
go.mod refactor(ui): scroll the trees and lists with a viewport 2026-10-08 19:10:20 -04:00
go.sum refactor(ui): scroll the trees and lists with a viewport 2026-10-08 19:10:20 -04:00
LICENSE SWITCH TO A SUPERIOR LICENSE 2025-05-03 17:46:09 -04:00
main.go fix: use log.Fatal for fatal errors 2026-04-20 13:18:23 -04:00
README.md feat(config): generate docs/config.md from the config structs (#842) 2026-10-07 18:06:07 -04:00

README.md

Discordo · discord ci license

Discordo is a lightweight, secure, and feature-rich Discord terminal client.

Preview Picker

Installation

Prebuilt binaries

You can download and install a prebuilt binary here 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):

scoop bucket add vvxrtues https://github.com/vvirtues/bucket
scoop install discordo

Building from source

git clone https://github.com/ayn2op/discordo
cd discordo
go build .

Usage

Password (UI, recommended)

  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.

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

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.

License

Copyright (C) 2025-present ayn2op

This project is licensed under the GNU General Public License v3.0 (GPL-3.0). See the 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.