oiupoyt/discordo
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
No description
1461 commits 5 branches 0 tags 19 MiB
Go 100%
Find a file
ayn2op b9152f8b21 refactor(config): make config.toml the sole source of keybind keys 
defaultKeybinds() now supplies only help descriptions; the actual keys
are read from the embedded config.toml at load time, eliminating the
duplicate key definitions that could drift out of sync.

Add a test that walks every keybind after loading the defaults and fails
if any is missing a key (config.toml) or description (defaultKeybinds).
2026-05-22 23:12:15 -04:00
.github docs(README): add picker preview 2026-05-18 03:43:32 -04:00
cmd Revert "fix: limit mouse handling to button events" 2026-04-30 02:04:03 -04:00
internal refactor(config): make config.toml the sole source of keybind keys 2026-05-22 23:12:15 -04:00
.gitignore refactor: unexport local symbols 2025-06-01 22:51:30 -04:00
go.mod build: go mod tidy 2026-05-18 03:31:07 -04:00
go.sum build: go mod tidy 2026-05-18 03:31:07 -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 docs(README): add picker preview 2026-05-18 03:43:32 -04:00

README.md

Discordo · discord ci Go Report Card license

Discordo is a lightweight, secure, and feature-rich Discord terminal client. Heavily work-in-progress, expect breaking changes.

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.

  • 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 .

Wayland clipboard support

wl-clipboard is required for clipboard support.

Usage

Token (UI, recommended)

  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

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.

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.

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.

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.