Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/aiko-chan-ai/discordbotclient

A patched version of discord, with bot login & Vencord support
https://github.com/aiko-chan-ai/discordbotclient

css discord discord-api discord-bot discord-bot-client discord-client html javascript nodejs

Last synced: 3 days ago
JSON representation

A patched version of discord, with bot login & Vencord support

Host: GitHub
URL: https://github.com/aiko-chan-ai/discordbotclient
Owner: aiko-chan-ai
License: gpl-3.0
Created: 2022-11-29T16:56:15.000Z (about 2 years ago)
Default Branch: electron-v3
Last Pushed: 2025-01-08T07:27:28.000Z (13 days ago)
Last Synced: 2025-01-11T01:02:12.805Z (10 days ago)
Topics: css, discord, discord-api, discord-bot, discord-bot-client, discord-client, html, javascript, nodejs
Language: JavaScript
Homepage:
Size: 21.3 MB
Stars: 843
Watchers: 14
Forks: 57
Open Issues: 4
Metadata Files:
- Readme: readme.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

        
Discord Bot Client


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

## Overview

- [How to install it](#installation)

  - [Windows](#windows)

  - [Using prebuilt binaries](#using-prebuilt-binaries)

  - [Building from source](#building-from-source)

- [Login](#login)

- [Features](#features)

- [Discord Version](#version)

- [Troubleshooting](#troubleshooting)

- [FAQ](#faq)

- [About anti-virus detection](#about-anti-virus-detection)

- [Similar projects](#similar-projects)

- [Update Discord Version](#how-to-update-to-the-latest-discord-version-)

- [Credits](#credits)

> [!WARNING]

> **Third party clients are discouraged and against the Discord TOS.**

Discord Bot Client is a custom [Discord](https://discord.com/app) 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](https://i.imgur.com/LXCQQZC.png)

---

## Installation

### Windows

Discord Bot Client can be installed in Windows via [Winget](https://learn.microsoft.com/en-us/windows/package-manager/):

```

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

    

    

      

        

      

    

  

   Linux

    .AppImage

    

      

    

  

  

    Mac arm64 (Apple Silicon)

    .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:

```shell

git clone https://github.com/aiko-chan-ai/DiscordBotClient.git

cd DiscordBotClient

git clone https://github.com/aiko-chan-ai/VencordDBC.git

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](https://i.imgur.com/ZGLE2Z8.png)

> [!NOTE]

> Enable `MessageContent` intent, other intents are optional.

> [!TIP]

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

![image](https://i.imgur.com/VENMB1U.png)

---

## Features

- **View Guilds** *(Lazy load them)*

- **Manage Guilds, Channels** 

- **Messages** (Send, View History, Embeds, Reactions, Manage)

- **Create a Guild**[^1]

- **Voice**[^2]

- **Nitro**[^3]

- **Direct Message**[^4]

[^1]: If your bot is in fewer than 10 servers.

[^2]: Except for features related to streams.

[^3]: Nitro features are reduced: Unable to use stickers everywhere, cannot send files larger than 25 MB or 10 MB (ref: https://discord.com/developers/docs/change-log#default-file-upload-limit-change), and cannot set avatar decorations.

[^4]: Implemented with restrictions on the client.

---

## Version

| Discord Build | Hash     | Vencord | Client version           | Status  |

|---------------|----------|---------|--------------------------|---------|

| Stable 355624 | 8dc6074  | v1.10.9 | v3.6.0 - v3.6.1          | Latest  |

| Stable 331146 | fddab3e  | v1.10.3 | v3.5.0                   | Deprecated  |

| Stable 302556 | 366c746  | v1.8.9  | v3.3.0 - v3.4.1          | EOL  |

| Stable 275565 | ede2af3  | v1.7.2  | v3.2.0 - v3.2.1          | EOL |

| Stable 263796 | 739ec78  | v1.6.7  | v3.0.0 - v3.1.3          | EOL |

| Stable 204762 | 78f82ba  | v1.2.8  | v2.4.0 - v2.4.2          | EOL[^5] |

| Stable 185832 | 29333f6  | v1.1.4  | v2.1.0 - v2.3.1          | EOL     |

| Stable 161052 | c7e0778  | -       | v1.0.0 - v2.0.1          | EOL     |

[^5]: _Latest version that supports Windows 7/8/8.1 is 2.4.2._

---

## 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](https://github.com/aiko-chan-ai/DiscordBotClient/issues/8):

## 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 " add exception"

## Similar projects

Here is a list of similar projects:

- [Discord Bot Client](https://github.com/SamuelScheit/discord-bot-client)

- [BotClient](https://github.com/DarkGuy10/BotClient)

- [ChrisEric1.GitHub.io](https://github.com/ChrisEric1/ChrisEric1.GitHub.io)

- [LiveBot](https://github.com/SebOuellette/LiveBot)

- [BetterDiscordPanel](https://github.com/SanjaySunil/BetterDiscordPanel)

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

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=aiko-chan-ai/DiscordBotClient&type=Date)](https://star-history.com/#aiko-chan-ai/DiscordBotClient&Date)

---

## How to update to the latest Discord version ?

1. Clone the repository and cd into it.

```sh

git clone https://github.com/aiko-chan-ai/DiscordBotClient.git

cd DiscordBotClient

git clone https://github.com/Vendicated/Vencord.git

// Rename from Vencord to VencordDBC

// Ex: Windows PowerShell

Rename-Item -Path Vencord -NewName VencordDBC

```

2. Install required dependencies.

```sh

npm run requirement

```

3. Download the latest script from Discord

```sh

npm run fetchLatestDiscordBuild

```

4. Copy BotClient plugin from [my repo](https://github.com/aiko-chan-ai/VencordDBC)

> Guide: [Vencord.md](https://github.com/aiko-chan-ai/DiscordBotClient/blob/electron-v3/Vencord.md)

## Credits

Thanks to [ChrisEric](https://github.com/CE1CECL) for helping me create a local proxy server! (code)

This project was mainly inspired by [SamuelScheit](https://github.com/SamuelScheit)

[Discord Bot Client](https://github.com/SamuelScheit/discord-bot-client), which he sadly didn't

develop any further.

And a big thank to [Vencord](https://github.com/Vendicated/Vencord) developers for making it easier for me to create this app