Concord is a feature-rich TUI (terminal user interface) client for Discord, written in Rust with ratatui. Full Discord experience, right in your terminal.

brew install chojs23/tap/concord

cargo install concord

To install the latest unreleased version directly from the Git repository:

cargo install --git https://github.com/chojs23/concord

Run without installing (requires flakes enabled):

nix run github:chojs23/concord

Install into your profile:

nix profile install github:chojs23/concord

Or add the flake as an input in your own flake.nix:

{
  inputs.concord.url = "github:chojs23/concord";
}

Then reference it as concord.packages.${system}.default in your configuration.

A development shell with the pinned Rust toolchain and rust-analyzer is also available:

nix develop github:chojs23/concord

Install the latest release with the cargo-dist shell installer:

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/chojs23/concord/releases/latest/download/concord-installer.sh | sh

The installer places concord under $CARGO_HOME/bin, which is usually ~/.cargo/bin. Make sure that directory is on your PATH before running concord.

You need the Rust stable toolchain and Cargo.

git clone https://github.com/chojs23/concord.git
cd concord
cargo build --release

The release binary is produced at:

target/release/concord

By default, source builds can join voice channels and decode received voice audio, but they do not open local audio input or output devices. To build with voice playback and gated microphone transmit, enable the optional voice-playback feature:

cargo build --release --features voice-playback

Linux playback uses the system audio stack through cpal. You may need ALSA development files when building from source:

sudo apt install libasound2-dev

On WSLg, audio is usually exposed through PulseAudio instead of a real ALSA sound card. If playback does not start, check that PulseAudio and ALSA routing work before debugging Discord voice itself:

pactl info
paplay /usr/share/sounds/alsa/Front_Center.wav
aplay -D pulse /usr/share/sounds/alsa/Front_Center.wav

Concord can request joining and leaving Discord voice channels. Default builds do not open local audio devices, while source builds with --features voice-playback support voice playback and gated microphone transmit.

• Token : paste an existing Discord token.
• Email / Password : login with credentials. MFA (TOTP, SMS) is fully supported.
• QR Code : scan the code from the Discord mobile app.

Email and QR code logins may trigger a CAPTCHA challenge on Discord's side. We cannot solve that, so I strongly recommend using token authentication.

Tokens are saved under Concord's config directory in plain text. See the Security section below for details.

• Browse servers with guild folder grouping
• Navigate text channels, threads, and forum channels
• View and filter forum posts (active / archived)
• Load pinned messages per channel
• Open channel actions for pinned messages, thread lists, and mark-as-read
• Join and leave voice channels
• Receive voice playback when built with --features voice-playback
• Transmit microphone audio when built with --features voice-playback, joined from this Concord session, explicitly allowed, and not self-muted
• Highlight active voice speakers in voice channel participant rows
• Track unread messages and mention counts per channel
• Mute and unmute channels and servers

• Send, edit, and delete messages
• Reply to specific messages
• Upload files by copying them from your file manager and pasting them into the composer
• Use @mention autocomplete while composing messages
• View full message history with pagination
• Rich content display (embeds, attachments, stickers, and mentions)
• Direct message shortcuts for copy, reply, edit, delete, pin/unpin, reactions, image viewing, and profile lookup

Concord renders a practical subset of Discord-style Markdown in message bodies:

• Headings: # H1, ## H2, ### H3
• Quotes: > quoted text
• Bullets: - item and * item
• Inline styles: **bold**, *italic*, and `inline code`
• Fenced code blocks with optional language labels, rendered as compact boxes

• View, add, and remove emoji reactions (Unicode and custom server emoji)
• Browse who reacted with a specific emoji
• View and vote on polls

• Inline image previews directly in the terminal
• Avatar and custom emoji rendering
• Download attachments to your platform Downloads directory (XDG_DOWNLOAD_DIR on Linux)
• Large centered image viewer with navigation

Image rendering is powered by ratatui-image. On startup, Concord queries the terminal to detect the best available graphics protocol. Supported protocols:

• Kitty Graphics Protocol - Kitty, WezTerm, Ghostty, etc.
• iTerm2 Inline Images - iTerm2, WezTerm, mintty, etc.
• Sixel - foot, mlterm, xterm (if compiled with Sixel support), etc.
• Halfblocks (fallback) - works on any terminal, but uses block characters instead of true pixels.

If your terminal does not support any graphics protocol, images will be rendered as halfblock approximations. For the best experience, use a terminal that supports the Kitty or iTerm2 protocol.

You can toggle image viewing on or off in the configuration file. When image viewing is off, attachments and emojis will be shown as text placeholders.

• Member list with grouping
• Presence indicators (Online, Idle, DND, Offline)
• User profile popups with guild-specific details

• Live "user is typing..." indicators
• Unread message tracking with mention counts
• Mark server, channel as read

• Desktop notifications for Discord messages that pass your Discord notification settings
• Active channel notifications are suppressed so Concord does not notify for the conversation you are already viewing
• On macOS, Concord plays one explicit notification sound so focused terminal windows do not silently swallow audible alerts

Concord has a four-pane layout like Discord. Guilds (1), Channels (2), Messages (3), Members (4)

With vim-style navigation:

Press Space to open the leader shortcut window.

Focus a pane, then press Space, a to open actions for that pane. Action shortcuts are shown inside the leader popup and only run when the action is enabled. In the Messages pane, the selected message also supports direct shortcuts:

Message shortcuts:

Server actions:

Channel actions:

Voice actions:

When the image viewer is open, press d to download the current image directly.

Hidden side panes give their width back to Messages. Pressing a hidden pane's number key directly shows and focuses it again.

You can paste copied files into the composer to attach them. Pending uploads are shown above the input before sending.

When the @mention picker is open, use Up / Down, Ctrl+p / Ctrl+n, Tab, or Enter to choose a mention.

Type : plus at least two emoji shortcode letters, such as :he, to open Unicode emoji and current-server custom emoji suggestions. Use Up / Down, Ctrl+p / Ctrl+n, Tab, or Enter to choose an emoji. Complete Unicode shortcodes such as :heart: are converted to their emoji when the message is sent; selected custom emojis are sent using Discord's custom emoji markup.

Mouse support is also available: click to focus or select rows, double-click to open or activate items, and use the wheel to scroll panes and popups.

Concord options are stored under Concord's config directory. If XDG_CONFIG_HOME is set, Concord uses $XDG_CONFIG_HOME/concord/config.toml. Otherwise it uses the platform config directory. The usual fallback is ~/.config/concord/config.toml on Linux, ~/Library/Application Support/concord/config.toml on macOS, and the roaming AppData config directory on Windows.

• Disable all image previews with one master switch
• Toggle inline image previews
• Set image preview quality for attachments, embeds, and the image viewer
• Toggle avatar display
• Toggle custom emoji rendering
• Toggle desktop notifications
• Set your Discord voice mute and deaf state
• Set microphone and received voice volume from 0 to 100
• Allow gated microphone transmit while joined from this Concord session and not self-muted

You can change these from the in-app Options menu, and Concord saves them back to the config file.

Example:

[display]
disable_image_preview = false
show_avatars = true
show_images = true
image_preview_quality = "balanced"
show_custom_emoji = true

[notifications]
desktop_notifications = true

[voice]
self_mute = false
self_deaf = false
allow_microphone_transmit = false
microphone_sensitivity = -30
microphone_volume = 100
voice_output_volume = 100

image_preview_quality supports these values:

• efficient: smaller preview requests to reduce bandwidth and memory use.
• balanced: default quality with bounded resource use.
• high: sharper resized previews using lossless quality.
• original: request the original source image for previews when possible.

This setting only applies to attachment, embed, and image viewer previews. Avatars and custom emoji keep their separate small-image behavior.

desktop_notifications under [notifications] controls OS notifications for Discord messages that pass Discord notification settings. On macOS, Concord keeps the visual notification and audible alert separate to avoid duplicate sounds while still playing a sound when the terminal app is focused.

self_mute and self_deaf under [voice] control the voice state Concord sends when joining, leaving, or updating your current Discord voice channel. self_deaf also mutes Concord's local playback and clears buffered received audio.

allow_microphone_transmit is a local safety gate. When built with voice-playback, turning it on may open microphone input and transmit voice only while this Concord session is joined to voice and self_mute is false. Microphone input is converted to Discord's 48 kHz voice format before Opus encoding. Concord sends Discord Speaking on/off around transmitted audio, and transmit stops when the gate closes, the app leaves voice, or the voice session ends. If Discord DAVE encryption is required but outbound encryption is not ready, Concord fails closed instead of sending plaintext audio.

microphone_sensitivity controls how loud a 20 ms microphone frame must be before Concord transmits it. It accepts an integer dB threshold from -100 to 0. Lower values transmit quieter input. The default is -30, which filters small ambient noise so the active speaker indicator does not stay green all the time. microphone_volume and voice_output_volume accept 0 to 100 percent and default to 100, which preserves the normal audio level. Press Space, o, d for display options, Space, o, n for notification options, or Space, o, v for voice options. In Voice Options, select Microphone sensitivity and press h/l to adjust by 1 dB or H/L to adjust by 10 dB. The microphone and voice volume rows use the same keys to adjust by 1 or 10 percent.

Concord is designed to stay lightweight in normal terminal use. In observed typical use, it usually uses about 20-40 MB of memory.

Image-heavy screens can temporarily use more memory because compressed image bytes need to be decoded before they can be rendered in the terminal. When many images are loaded, memory can briefly rise to around 100-200 MB while decoding and then drop again as work completes and caches are pruned.

To keep resource usage bounded, Concord limits media work in several places:

• Attachment previews are downloaded with an 8 MiB per-preview cap.
• Attachment downloads are capped at 64 MiB.
• Up to 4 attachment previews are fetched at once.
• Up to 2 inline image previews are decoded at once.
• Inline image previews, avatars, and custom emoji use small LRU caches.
• Image preview requests prefer resized Discord proxy URLs sized for the terminal instead of original full-size media when possible.
• The preview quality preset can lower preview source dimensions or opt into original source images. It does not change avatar or custom emoji sizing.

Message history is also cached with a per-channel limit, so long-running sessions do not keep every message in memory forever.

Honestly, no.

In day-to-day use, I have not seen an account block after several months of using Concord. There was one path that did trigger a temporary block: trying to create a new DM channel and send a message to an unknown user(meaning there was no pre-existing DM created through the Discord client) immediately blocked my account for 30 minutes. That feature has been removed. Other supported features have not caused blocks in my testing.

That said, Concord is not an official Discord client. Using unofficial clients, automated user accounts, or self-bots can violate Discord's TOS, so there is always some risk. Use it at your own discretion.

No. If Discord requires a CAPTCHA during login, use token login instead.

• Tokens are stored as plain text in Concord's config directory. So keep that file secure and do not share it. You can use the token from that file to log in to the official Discord client, so treat it like a password.
• On Unix, the credential's parent directory is created with 0700 and the credential file with 0600 permissions.
• All concord state (config, credential, log) lives under a single concord/ directory inside XDG_CONFIG_HOME when it is set, or inside the platform config directory otherwise.
• No system keychain integration yet.

Any issues, pull requests, and feedback are welcome. See CONTRIBUTING.md for details.

Concord is licensed under GPL-3.0-only.