discordo

README

Discordo ·

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

Table of Contents

• Features
• Installation
  • Prebuilt binaries
  • Package managers
  • Building from source
• Usage
  • Configuration
• Disclaimer

Features

• Lightweight
• Secure
• Configurable
• Cross-platform
• Minimalistic
• Feature-rich
  • Mouse & clipboard support
  • 2-Factor authentication
  • Desktop notifications
  • Partial 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 (thanks to Alyxia Sother for maintaining the AUR package).
• FreeBSD: pkg install discordo or via the ports system make -C /usr/ports/net-im/discordo install clean.

Building from source

git clone https://github.com/ayntgl/discordo
cd discordo
make build

# optional
sudo mv ./discordo /usr/local/bin

Linux clipboard support

• xclip or xsel for X11.
  • Ubuntu: apt install xclip
  • Arch Linux: pacman -S xclip
  • Fedora: dnf install xclip
• wl-clipboard for Wayland.
  • Ubuntu: apt install wl-clipboard
  • Arch Linux: pacman -S wl-clipboard
  • Fedora: dnf 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.

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

• Most of the Discord third-party clients store the token in a configuration file unencrypted. Discordo securely stores the token in the default OS-specific keyring.

Configuration

A default configuration file is created on first start-up at $HOME/.config/discordo.yml on Unix, $HOME/Library/Application Support/discordo.yml on Darwin, and %AppData%/discordo.yml on Windows. The configuration file path can be customized using the config command-line flag (eg: --config ~/myconfigs/discordo.yml).

Similarly, a log file is created on first start-up at $HOME/.cache/discordo.log on Unix, $HOME/Library/Caches/discordo.log on Darwin, and %LocalAppData%/discordo.yml on Windows. The log file path can be customized using the log command-line flag.

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.