discordo/README.md

Discordo ·

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

• Lightweight
• Secure
• Configurable
• Cross-platform
• Minimalistic
• Feature-rich
  • Mouse & clipboard support
  • 2-Factor authentication
  • Discord-flavored markdown

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

• FreeBSD: pkg install discordo or via the ports system make -C /usr/ports/net-im/discordo install clean.

• NixOS: nix-shell -p 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 .

Linux clipboard support

• xclip or xsel for X11 (apt install xclip)
• wl-clipboard for Wayland (apt install wl-clipboard)

Usage

1. Run the discordo executable with no arguments.

If you are logging in using an authentication token, provide the token command-line flag to the executable (eg: --token "OTI2MDU5NTQxNDE2Nzc5ODA2.Yc2KKA.2iZ-5JxgxG-9Ub8GHzBSn-NJjNg"). The token is stored securely in the default OS-specific keyring.

2. Enter your email and password and click on the "Login" button to continue.

Keymaps

Global

• j: Navigate down (any context except input).
• k: Navigate up (any context except input).
• Esc: Reset message selection or close the channel selection popup.
• Ctrl+C: Quit the application.
• ⚠️ Ctrl+D: Delete credentials (requires re-login upon restart).

Message Input

• Alt+Enter: Add a new line to the current text.
• Ctrl+W / Alt+Backspace: Delete the last word.
• Up: Move to the previous line.
• Down: Move to the next line.
• Ctrl+U: Delete to the start of the line.
• Enter: Send the message.
• Ctrl+E: Open message input in your default $EDITOR.

Message Text

• r: reply selected message.
• R: reply selected message and mention the user who sent it.
• d: delete selected message.
• y: yank (copy) selected message content.

Guilds Tree

• Ctrl+g: Switch to group/server channel selection.
• Ctrl+m: Expand a channel/server.
• Ctrl+r: Quick-select a channel.
• Ctrl+b: Hide the channels sidebar.
• Ctrl+t: Switch to the currently selected channel.
• Ctrl+p: Switch to the user input box.
• g: navigate to the first item.
• G: navigate to the last item

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

The default configuration can be found here.

FAQ

Manually adding token to keyring

Do this if you get the error:

failed to get token from keyring: secret not found in keyring

1. First, start the keyring daemon

eval $(gnome-keyring-daemon --start)
export $(gnome-keyring-daemon --start)

2. Create a keyring using seahorse application if a keyring doesn't already exist.

3. Add the token secret using

secret-tool store --label="Discord Token" service discordo username token

4. When it prompts for the password, paste your token, and that's it!

Disclaimer

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.