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: 2 months 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 (almost 3 years ago)
Default Branch: main
Last Pushed: 2024-04-03T21:36:23.000Z (3 months ago)
Last Synced: 2024-04-06T13:26:10.578Z (3 months ago)
Topics: cross-platform, discord, discordo, go, golang, linux, terminal
Language: Go
Homepage:
Size: 5.81 MB
Stars: 1,743
Watchers: 22
Forks: 58
Open Issues: 30
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

cli-apps - Discordo - A lightweight, secure, and feature-rich Discord terminal client. (<a name="chat"></a>Chat and instant messaging)
my-awesome-stars - ayn2op/discordo - A lightweight, secure, and feature-rich Discord terminal client. (Go)
awesome-stars - ayn2op/discordo - A lightweight, secure, and feature-rich Discord terminal client. (Go)
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)

README

        # Discordo · [![ci](https://github.com/ayn2op/discordo/actions/workflows/ci.yml/badge.svg)](https://github.com/ayn2op/discordo/actions/workflows/ci.yml) [![Go Report Card](https://goreportcard.com/badge/github.com/ayn2op/discordo)](https://goreportcard.com/report/github.com/ayn2op/discordo) [![license](https://img.shields.io/github/license/ayn2op/discordo?logo=github)](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.

![Preview](.github/preview.png)

- Lightweight

- Secure

- Configurable

- Cross-platform

- Minimalistic

- Feature-rich

  - Mouse & clipboard support

  - 2-Factor authentication

  - Partial [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`

### 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`

```toml

mouse = true

timestamps = false

timestamps_before_author = false

timestamps_format = "3:04PM"

messages_limit = 50

editor = "default"

[keys]

focus_guilds_tree = "Ctrl+G"

focus_messages_text = "Ctrl+T"

focus_message_input = "Ctrl+P"

toggle_guild_tree = "Ctrl+B"

select_previous = "Rune[k]"

select_next = "Rune[j]"

select_first = "Rune[g]"

select_last = "Rune[G]"

[keys.guilds_tree]

select_current = "Enter"

[keys.messages_text]

select_reply = "Rune[s]"

reply = "Rune[r]"

reply_mention = "Rune[R]"

delete = "Rune[d]"

yank = "Rune[y]"

open = "Rune[o]"

[keys.message_input]

send = "Enter"

editor = "Ctrl+E"

cancel = "Esc"

[theme]

border = true

border_color = "default"

border_padding = [0, 0, 1, 1]

title_color = "default"

background_color = "default"

[theme.guilds_tree]

auto_expand_folders = true

graphics = true

[theme.messages_text]

author_color = "aqua"

reply_indicator = "╭ "

```

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