https://github.com/3ofiz4/discordcli
A Discord on a terminal with ability to navigate through server's channels and DM and replying. Made in like ~4.5 Hours, single-night project
https://github.com/3ofiz4/discordcli
cli convenience discord discord-py minimalistic python python-3 python3 single-night-project terminal
Last synced: about 1 month ago
JSON representation
A Discord on a terminal with ability to navigate through server's channels and DM and replying. Made in like ~4.5 Hours, single-night project
- Host: GitHub
- URL: https://github.com/3ofiz4/discordcli
- Owner: 3oFiz4
- Created: 2025-06-17T02:01:37.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-06-17T02:43:12.000Z (12 months ago)
- Last Synced: 2025-06-17T03:19:17.821Z (12 months ago)
- Topics: cli, convenience, discord, discord-py, minimalistic, python, python-3, python3, single-night-project, terminal
- Language: Python
- Homepage:
- Size: 902 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ⚙️ DiscordCLI
> A Discord terminal client built in ~4 hours. Functional: message, reply, upload — all from the command line.
---
## 🖼️ Thumbnail
Watch more of the showcase here:
https://jmp.sh/s/d63EFvt1hZTQpvic5paR
---
## ⚠️ Caution
> ⚠️ **USE AT YOUR OWN RISK**
This client acts like a **selfbot**, and using it **violates Discord's TOS**.
You **may get banned**.
I am **not responsible** for any account loss.
✅ Use an **alt account**, or use within a proper **Discord Bot** context.
---
## 📦 Requirements
```
emoji==1.6.3 clipboard rich prompt_toolkit discord.py asyncio shutil tkinter playsound threading json
````
---
## 🚀 Setup
First of all. Set up your token first. There's 2 way.
> a. `python main.py -t [YOUR_TOKEN]`
> b.
1. Open / Create your token.txt. Insert this template:
```
---
Username: Account_Username_0
Token: Token_Username_0
---
Username: Account_Username_1
Token: Token_Username_1
---
```
2. And replace Token_Username_0 with each desired token. You can also add more entry if you want to.
3. Then do `python main.py -s [index_token]/[username]`
> Example:
> `python main.py -s 1` # Starts Token_Username_1
> `python main.py -s Account_Username_1` # Starts token of Account_Username_1
4. REMEMBER, it should be Username-Token as the template, do not skip it, not even the between Token and :.
c. `python main.py` # Is equal to `python main.py -s 0`
### 🔹 Fresh Start
```bash
python main.py
# then use -h or -changelog
````
### 🔹 Add to System PATH (Recommended)
1. Clone this repo to:
`C:/Users/[your-name]/DisCLI`
2. Open `System Properties` → `Advanced` → `Environment Variables`
3. Under **System Variables**, edit `Path`
4. Add:
`C:\Users\[your-name]\DisCLI\`
5. Click `OK` on all windows.
Now you can run `main.py` from anywhere.
---
## 🧩 Command List
> `-h` → help
> `-changelog` → recent updates
🧭 Navigation
```
-s [server] Pick a server
-c [channel] Pick a chat channel (needs -s first)
-cf [friend] Pick a friend to DM
-q / -e Quit the CLI
-ct [emoji] React a message with emoji, ex: -ct 5 :sob:
```
⌨️ Typing
```
-r [index] [msg] Reply to message by index
-d [idx ...] Delete messages (list accepted)
-up Upload a file (via Explorer popup)
-deup Clear all staged uploads
-fw [idx] [target] Forward message to someone
-y [index] Copy or Yank a message
-p [index] Pin a message, if authorized
-dp [index] Unpin a message, if authorized
-e [index] [edit] Edit a message of index_message with new edit
"say" Without (-) will say something in current_channel, also sends a file if -up is triggered before
"@" List all mentionable users
":...:" List all possible emoji
```
🔔 Misc
```
-ntf / -notif Show notifications
-gntf / -gonotif Jump to notif source
->n / -
---
## 🐞 Known Bugs
> *Minor = doesn't affect core usage much*
* emoji picker wont work on `react` command. *i can actually fix it, but my time is up already`
* @ mention won't work.
* (minor) Screen may scroll to top on mention
* (minor) Command auto-complete can break before API init (fix: press space and retype)
* (minor) Display name invisibility on some servers
🐛 Found a bug? [Submit an Issue](../../issues)
---
## ✅ Features
### ✔ Done
* Reply, send, delete messages
* Copy, Pin, Edit messages
* React to messages
* Chat in servers / DMs
* Message forwarding
* Upload + auto-remove file attachments
* Display name + timestamp
* Emoji reactions
* Notification system (WIP)
* Rich config via `conf.json`
* Multi-token login
* Multi-Access Login (either via ~~Username and Password (not possible apparently, it asked for CAPTCHA instead)~~ or Token)
### 🚧 Planned / In Progress
* ⏳ Per-channel notification sounds
* ⏳ Hotkey support
* ⏳ Change profile pic, bio, banner
* ⏳ Open files via browser
* ⏳ Colored text / markdown preview (via `rich` and `lexer`
* ⏳ Snippets like `{myutc}` → current time
* ⏳ Join/leave server
* ⏳ Bookmark message
* ⏳ Join & Leave a server
* ⏳ Color a text (similar to snippet, reference [Rebane Message Color](https://rebane2001.com/discord-colored-text-generator/)
---
Changelog:
v25.06.17 (yy/mm/dd)
- Initial release (took 4.5~ hours)
a. Working Reply and Sending messages
b. Ability to DM or Interact with friends
c. Proper Chat UI
v25.06.19 (Major Tweaks and Improvement) (took ~9.2 hours)
- Improved Chat UI
a. Different color for user and other people
b. Added timestamp
c. Auto-clear for every command trigger
d. Long message has horizontal bar
e. Reply to message is visible
f. Display name and User name shows (tweakable)
g. Added more colors
h. Color change upon command insert, the input I mean
- More commands (check -h)
a. -d(elete messages)
b. -up(load file)
c. -de(stage)up(load file)
d. -f(or)w(ard) message
e. -n(o)t(i)f
f. -g(o to)n(o)t(i)f
- Misc
a. Minor revamp of code structure
b. Added notifications for ping (untested)
v25.06.19.01 (Minor tweaks)
- Chat UI
a. Attachment is shown
- Misc
a. Added `conf.json` to configure the terminal
v25.06.21 (Minor bug fixes)
v25.06.21.01 (minor bug fixes)
v25.06.21.02 (added few features)
- More commands
a. -y(ank message) # Yank is Copy
b. -p(in message)
c. -d(eny)p(in message)
d. -e(dit message)
v25.06.21.03 (added react to message)
- More commands
a. -(rea)ct (message)
> This won't display properly if your CMD unable to show emoji. It do works in Win 11.
- Added Account Template
a. You can now switch to different account easily through `token.txt`
b. Input token via `-t` in CLI