vimcord - Terminal UI Discord client

About

vimcord is a terminal UI Discord client written in Rust.

For best visuals, install NerdFonts

Terms of Service Notice

Warning

Under no circumstances should you use a Discord User Token (also known as a self-bot token) with this software or any associated tools.

Discord's Terms of Service (ToS) explicitly prohibits the use of User Tokens for programmatic access or self-botting. Violation of these terms can lead to permanent termination of your Discord account.

Do not use self-bots or user-bots. Each account must be associated with a human, not a bot. Self-bots put strain on Discord’s infrastructure and our ability to run our services. For more information, you can read our Developer Policies here.

The developers, contibutors, and maintainers are not responsible for any consequences resulting from a user's violation of Discord's Terms of Service. You (the user) assumes all risk if you choose to ignore Discord's policies.

Installation

Arch Linux (AUR)

Requires YaY

yay -S vimcord
# or
yay -S vimcord-git

Binaries

Download prebuilt binaries from: releases

Cargo

Requires Rust

Make sure that ~/.cargo/bin is in your PATH env variable.

With crates.io

cargo install vimcord

From Source

git clone https://github.com/YetAnotherMechanicusEnjoyer/vimcord
cd vimcord/
cargo build --release

Run:

./target/release/vimcord

Configuration

Set your Discord token using one of the following:

.env file

DISCORD_TOKEN="your-token-here"

Shell

export DISCORD_TOKEN="your-token-here"

Inline

DISCORD_TOKEN="your-token-here" vimcord

Usage

vimcord

or

DISCORD_TOKEN="your-token-here" vimcord

Roadmap & Missing Features

While vimcord is fully functional for basic chat and navigation, there are many exciting features on our radar!

To see our future plans, feature backlog, and what still needs to be implemented (such as mentions, threaded conversations, and reactions), please take a look at our Roadmap & Feature Backlog. We have carefully detailed and categorized upcoming features by priority and difficulty to help guide development and encourage community contributions. We'd love your help in making this the best terminal Discord client possible!

Licence