Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ayn2op/discordo
A lightweight, secure, and feature-rich Discord terminal client.
https://github.com/ayn2op/discordo
cross-platform discord discordo go golang linux terminal
Last synced: 3 days ago
JSON representation
A lightweight, secure, and feature-rich Discord terminal client.
- Host: GitHub
- URL: https://github.com/ayn2op/discordo
- Owner: ayn2op
- License: mit
- Created: 2021-07-17T11:00:48.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-13T16:55:51.000Z (3 months ago)
- Last Synced: 2024-10-29T17:55:57.234Z (2 months ago)
- Topics: cross-platform, discord, discordo, go, golang, linux, terminal
- Language: Go
- Homepage:
- Size: 5.88 MB
- Stars: 2,168
- Watchers: 22
- Forks: 69
- Open Issues: 42
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-cli-apps - Discordo - A lightweight, secure, and feature-rich Discord terminal client. (<a name="chat"></a>Chat and instant messaging)
- awesome-golang-repositories - discordo - rich Discord terminal client (Repositories)
- awesome-cli-apps-in-a-csv - Discordo - A lightweight, secure, and feature-rich Discord terminal client. (<a name="chat"></a>Chat and instant messaging)
- starred - ayn2op/discordo - A lightweight, secure, and feature-rich Discord terminal client. (Go)
- awesome-rainmana - ayn2op/discordo - A lightweight, secure, and feature-rich Discord terminal client. (Go)
- awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/ayn2op/discordo - Discord client (Jump To / CLI/TUI Apps)
README
# Discordo · [](https://discord.com/invite/VzF9UFn2aB) [](https://github.com/ayn2op/discordo/actions/workflows/ci.yml) [](https://goreportcard.com/report/github.com/ayn2op/discordo) [](https://github.com/ayn2op/discordo/blob/master/LICENSE)
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](https://support.discord.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline-)
## Installation
### Prebuilt binaries
You can download and install a [prebuilt binary here](https://nightly.link/ayn2op/discordo/workflows/ci/main) 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):
```sh
scoop bucket add vvxrtues https://github.com/vvirtues/bucket
scoop install discordo
```
### Building from source
```bash
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.
## 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](./internal/config/config.go).
## 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
```bash
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
```bash
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.