Discord CLI

A terminal-based Discord chat interface. Allows you to use Discord directly from your terminal, stripped of the bloat.

Images

Features

• 🎨 Modern terminal interface: Clean and minimal UI.
• 💬 Real-time messaging: Chat with zero lag.
• 🔔 Real-time notifications: Stay updated on new messages (per-user/channel).
• ⌨️ Vim-style navigation: Use k, j keys or arrow keys to navigate effortlessly.
• 🖼️ Media support: View images, files, and stickers explicitly.
• 📎 File upload: Easily upload files directly from the CLI.
• 📌 Pin messages: Keep important messages accessible.
• ❤️ Reactions: React to messages seamlessly.
• ✏️ Message management: Edit and delete your own messages.
• 💬 Replies: Reply directly to specific messages.
• 🎲 Random Welcome Quotes: Enjoy a fresh, bloat-free quote every time you start the app.
• 🚀 Fast and lightweight: Bye bye Electron. Hello performance.

Installation

1. Clone or download the project repository.
2. Install the necessary dependencies:

npm install

3. Setup your environment variables:

• Windows: Run setup_env.bat to automatically create the .env file. Open the created file and paste your token after the = sign.
• Manual: Create a .env file in the root directory and add your token:

DISCORD_USER_TOKEN=your_user_token_here

How to Get Your Discord User Token

• Watch this tutorial video if you don't know how to obtain your user token.

⚠️ Important Security Notes:

• Never share your user token with anyone!
• Your token grants full access to your entire Discord account.
• If you suspect your token is compromised, change your Discord password immediately to reset it.
• Disclaimer: Using self-bots may be prohibited under Discord's Terms of Service. Use this application at your own risk.

Usage

Start DM/Chat interface:

npm run dm

Start server browser (servers, categories, and channels):

npm run server

Show Help / Available Commands:

npm run help

Keyboard Shortcuts

• Esc: Exit the application or view
• Ctrl+D: Clear the input box
• j, k or Up, Down: Navigate between messages or lists
• Enter: Send message or select an item

CLI Commands within Chat

• /upload <file_path>: Upload a file to the current channel
• /view <message_id>: Open a file/image/sticker in your default web browser
• /reply <message_id> <message>: Reply to a specific message
• /r <message_id> <message>: Quick reply to a message
• /edit <message_id> <new_message>: Edit your own message
• /delete <message_id>: Delete your own message
• /pin <message_id>: Pin a message to the channel
• /react <message_id> <emoji>: Add a reaction to a message
• /help: Show all available commands in the chat interface

File Upload Examples

# Upload a single file
/upload C:\Users\username\Desktop\image.png

# Upload a file with spaces in the path (use quotes)
/upload "C:\Users\username\My Documents\file.pdf"

Message ID Format

• Message IDs are displayed in yellow color within blue parentheses.
• File and Sticker names are displayed in yellow within blue brackets.
• File Example: [File: filename.png] (1455312755623067821)
• Sticker Example: [Sticker: StickerName] (1455312755623067822)

Requirements

• Node.js version 18 or higher
• A valid Discord User Token

License

This project is licensed under the MIT License.