Skip to content

Latest commit

 

History

History
268 lines (196 loc) · 9.2 KB

readme.md

File metadata and controls

268 lines (196 loc) · 9.2 KB

Discord Bot Client

Discord Bot Client allows you to use your bot, just like any other user account, except Friends and Groups.

Overview

Warning

Third party clients are discouraged and against the Discord TOS.

Discord Bot Client is a custom Discord client that aims to support bot accounts and be aimed at power-users.

The application only uses the official Discord API and doesn't send data to third parties. However, this application is not an official product by Discord Inc.

Demo Screenshot

Installation

Windows

Discord Bot Client can be installed in Windows via Winget:

winget install aiko-chan-ai.DiscordBotClient

Using prebuilt binaries

If you don't want to build the application yourself or use some kind of package management system, you can get the latest binaries for the three major systems in the release overview:

Tip

Platform Binary Type Download Link
Windows NSIS installer DiscordBotClient-win-x64.exe
Linux .AppImage DiscordBotClient-linux-x86_64.AppImage
Mac arm64 (Apple Silicon) .dmg DiscordBotClient-mac-arm64.dmg
Mac x64 (Intel) .dmg It seems I can only choose one MacOS version in Github Actions, so I choose arm64 (Apple Silicon) 😭
But you can build from source 🎉

Building from source

In order to execute the following commands, you need to install NodeJS v16 or higher. You can find nodejs packages at https://nodejs.org/en. On top of that, you need to have git installed. It can be found at https://git-scm.com/downloads.

UPDATES HAVE TO BE INSTALLED MANUALLY

Open a command line and execute the following commands:

git clone https://github.com/aiko-chan-ai/DiscordBotClient.git
cd DiscordBotClient
npm run requirement
npm run build

This will create an executable called DiscordBotClient or DiscordBotClient.exe in the dist folder depending on whether you are using Windows or not.

Login

Logging in works via the UI on first startup of the application.

screenshot

Note

Enable MessageContent intent, other intents are optional.

Tip

If you want a list of members and status, enable all intents.

image

Features

  • View Guilds (Lazy load them)
  • Manage Guilds, Channels
  • Messages (Send, View History, Embeds, Reactions, Manage)
  • Create a Guild1
  • Voice2
  • Nitro3
  • Direct Message4
  • Vencord Built-in

Version

  • Currently, I will only support the latest version of this application; other versions will not receive bug fixes.

  • The versions removed from the table were unstable and did not work properly.

Discord Build Hash Vencord Client version Status
Latest ? ? v3.7.? Beta
Stable 391738 51404a7 v1.11.9 v3.7.0 Latest
Stable 360320 38aca73 v1.10.9 v3.6.2 Deprecated
Stable 355624 8dc6074 v1.10.9 v3.6.1 EOL
Stable 204762 78f82ba v1.2.8 v2.4.2 EOL5

Troubleshooting

If you happen to encounter a crash or a bug, please submit a bug report via the projects GitHub issue tracker.

FAQ

In order to find answers to common questions, check out the FAQ in the wiki:

About anti-virus detection

Sometimes, DiscordBotClient will be flagged as malware by several anti-virus programs (Avast, AVG, Norton, McAfee, Windows Defender, etc.), this, however, is a false positive.

The reason for this is that the application is not signed.

If downloaded from my GitHub, the program is safe to use (I cannot give this promise if you download it from somewhere else!). It is okay if you do not trust me; you can always go ahead and compile it yourself.

For a tutorial on how to exclude this program from your antivirus so it can run anyway, check out these links:

Windows Defender: https://support.microsoft.com/en-us/windows/add-an-exclusion-to-windows-security-811816c0-4dfd-af4a-47e4-c301afe13b26
Avast: https://support.avast.com/en-ww/article/Antivirus-scan-exclusions#pc
AVG: https://support.avg.com/SupportArticleView?l=en&urlName=avg-antivirus-scan-exclusion
Norton: https://support.norton.com/sp/en/us/home/current/solutions/v3672136
McAfee: https://www.mcafee.com/support/?page=shell&shell=article-view&articleId=TS102056
For other antiviruses, try searching for "<antivirus name> add exception"

Similar projects

Here is a list of similar projects:

Hit me up if you have a similar project, and I'll gladly add it to the list.

Star History

Star History Chart

How to update to the latest Discord version ?

  1. Clone the repository and cd into it.
git clone https://github.com/aiko-chan-ai/DiscordBotClient.git
cd DiscordBotClient
  1. Install required dependencies.
npm run requirement
  1. Download the latest script from Discord
npm run fetchLatestDiscordBuild
  1. (Optional) Update discord-protos
git clone https://github.com/discord-userdoccers/discord-protos.git
cd discord-protos
# Delete `.git` folder
npm install
cd ..
npm run proto:update
npm run proto:build:ts

Credits

Thanks to ChrisEric for helping me create a local proxy server! (code)

This project was mainly inspired by SamuelScheit Discord Bot Client, which he sadly didn't develop any further.

And a big thank to Vencord developers for making it easier for me to create this app

Disclaimer

Discord is trademark of Discord Inc. and solely mentioned for the sake of descriptivity. Mention of it does not imply any affiliation with or endorsement by Discord Inc.

Footnotes

  1. See https://discord.com/developers/docs/change-log?topic=HTTP+API#deprecating-guild-creation-by-apps ↩

  2. Except for features related to streams. ↩

  3. Nitro features are reduced: Unable to use stickers everywhere, cannot send files larger than 10 MB, and cannot set avatar decorations. ↩

  4. Implemented with restrictions on the client. ↩

  5. Latest version that supports Windows 7/8/8.1 is 2.4.2. ↩