diff --git a/README.md b/README.md index 54f4ba32..c894fae0 100644 --- a/README.md +++ b/README.md @@ -1,217 +1,73 @@ -# BetterDiscord [![Language Grade][lgtm-badge]][lgtm-link] [![GitHub Releases][downloads-badge]][downloads-link] [![Discord][discord-badge]][discord-link] +
-[lgtm-badge]: https://img.shields.io/lgtm/grade/javascript/g/BetterDiscord/BetterDiscord.svg?labelColor=0c0d10&style=for-the-badge -[lgtm-link]: https://lgtm.com/projects/g/BetterDiscord/BetterDiscord/context:javascript +[![BetterDiscord Logo](https://media.discordapp.net/attachments/341062370627682315/1053477174566465567/logo_large_ish.png)](https://betterdiscord.app/) + +[![CI Status][build-badge]][build-link] [![GitHub Releases][downloads-badge]][downloads-link] [![Discord][discord-badge]][discord-link] [![Website][website-badge]][website-link] [![Docs][docs-badge]][docs-link] + + +[build-badge]: https://img.shields.io/github/actions/workflow/status/BetterDiscord/BetterDiscord/ci.yml?branch=main&logo=Github&logoColor=3a71c1&labelColor=0c0d10&color=3a71c1&style=for-the-badge +[build-link]: https://github.com/BetterDiscord/BetterDiscord/actions/workflows/ci.yml [downloads-badge]: https://img.shields.io/github/downloads/BetterDiscord/Installer/total?labelColor=0c0d10&color=3a71c1&style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNDgiIGhlaWdodD0iNDgiIHZpZXdCb3g9IjAgMCA0OCA0OCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyLjI1IDM4LjVIMzUuNzVDMzYuNzE2NSAzOC41IDM3LjUgMzkuMjgzNSAzNy41IDQwLjI1QzM3LjUgNDEuMTY4MiAzNi43OTI5IDQxLjkyMTIgMzUuODkzNSA0MS45OTQyTDM1Ljc1IDQySDEyLjI1QzExLjI4MzUgNDIgMTAuNSA0MS4yMTY1IDEwLjUgNDAuMjVDMTAuNSAzOS4zMzE4IDExLjIwNzEgMzguNTc4OCAxMi4xMDY1IDM4LjUwNThMMTIuMjUgMzguNUgzNS43NUgxMi4yNVpNMjMuNjA2NSA2LjI1NThMMjMuNzUgNi4yNUMyNC42NjgyIDYuMjUgMjUuNDIxMiA2Ljk1NzExIDI1LjQ5NDIgNy44NTY0N0wyNS41IDhWMjkuMzMzTDMwLjI5MzEgMjQuNTQwN0MzMC45NzY1IDIzLjg1NzMgMzIuMDg0NiAyMy44NTczIDMyLjc2OCAyNC41NDA3QzMzLjQ1MTQgMjUuMjI0MiAzMy40NTE0IDI2LjMzMjIgMzIuNzY4IDI3LjAxNTZMMjQuOTg5OCAzNC43OTM4QzI0LjMwNjQgMzUuNDc3MiAyMy4xOTg0IDM1LjQ3NzIgMjIuNTE1IDM0Ljc5MzhMMTQuNzM2OCAyNy4wMTU2QzE0LjA1MzQgMjYuMzMyMiAxNC4wNTM0IDI1LjIyNDIgMTQuNzM2OCAyNC41NDA3QzE1LjQyMDIgMjMuODU3MyAxNi41MjgyIDIzLjg1NzMgMTcuMjExNyAyNC41NDA3TDIyIDI5LjMyOVY4QzIyIDcuMDgxODMgMjIuNzA3MSA2LjMyODgxIDIzLjYwNjUgNi4yNTU4TDIzLjc1IDYuMjVMMjMuNjA2NSA2LjI1NThaIiBmaWxsPSIjM2E3MWMxIi8+Cjwvc3ZnPgo= [downloads-link]: #auto-installers -[discord-badge]: https://img.shields.io/badge/support%20server-join-green?labelColor=0c0d10&color=7289da&style=for-the-badge&logo=discord&logoColor=7289da +[discord-badge]: https://img.shields.io/badge/discord-green?labelColor=0c0d10&color=7289da&style=for-the-badge&logo=discord&logoColor=7289da [discord-link]: https://discord.gg/bnSUxedypU -[patreon-badge]: https://img.shields.io/badge/Patreon-Donate-%2300457C.svg?logo=Patreon&logoColor=ff424d&labelColor=0c0d10&color=ff424d&style=for-the-badge -[patreon-link]: https://patreon.com/Zerebos +[website-badge]: https://img.shields.io/badge/website-green?labelColor=0c0d10&color=3a71c1&style=for-the-badge&logo=firefoxbrowser&logoColor=3a71c1 +[website-link]: https://betterdiscord.app -[paypal-badge]: https://img.shields.io/badge/Paypal-Donate-%2300457C.svg?logo=Paypal&labelColor=0c0d10&color=002f86&style=for-the-badge -[paypal-link]: https://paypal.me/ZackRauen +[docs-badge]: https://img.shields.io/badge/docs-green?labelColor=0c0d10&color=3a71c1&style=for-the-badge&logo=readthedocs&logoColor=3a71c1 +[docs-link]: https://docs.betterdiscord.app + + +BetterDiscord is a client modification for Discord with endless flexibility and addons. The only limit to the customization is your own imagination. + +[![Theme Split](https://betterdiscord.app/resources/branding/split.png)](https://betterdiscord.app/) + +
-BetterDiscord is a client modification for Discord. This allows you to add plugins and themes to your personal copy of Discord. BetterDiscord also adds a number of other features out of the box. ---- # Installation -## Auto Installers +Download the installer for your operating system below. You can check [this page](https://docs.betterdiscord.app/users/getting-started/installation) for a more detailed guide. [![Windows Installer][windows-badge]][windows-link] [![Mac Installer][mac-badge]][mac-link] [![Linux Installer][linux-badge]][linux-link] [windows-link]: https://github.com/BetterDiscord/Installer/releases/latest/download/BetterDiscord-Windows.exe -[windows-badge]: https://img.shields.io/badge/Windows%20(7+)-Download-3a71c1?logo=Windows&logoColor=3a71c1&labelColor=0c0d10&color=3a71c1&style=for-the-badge +[windows-badge]: https://img.shields.io/badge/Windows%20(7+)-3a71c1?logo=Windows&logoColor=3a71c1&labelColor=0c0d10&color=3a71c1&style=for-the-badge [mac-link]: https://github.com/BetterDiscord/Installer/releases/latest/download/BetterDiscord-Mac.zip -[mac-badge]: https://img.shields.io/badge/macOS%20(10.10+)-Download-3a71c1?logo=Apple&logoColor=3a71c1&labelColor=0c0d10&color=3a71c1&style=for-the-badge +[mac-badge]: https://img.shields.io/badge/macOS%20(10.10+)-3a71c1?logo=Apple&logoColor=3a71c1&labelColor=0c0d10&color=3a71c1&style=for-the-badge [linux-link]: https://github.com/BetterDiscord/Installer/releases/latest/download/BetterDiscord-Linux.AppImage -[linux-badge]: https://img.shields.io/badge/Linux-Download-3a71c1?logo=Linux&logoColor=3a71c1&labelColor=0c0d10&color=3a71c1&style=for-the-badge +[linux-badge]: https://img.shields.io/badge/Linux-3a71c1?logo=Linux&logoColor=3a71c1&labelColor=0c0d10&color=3a71c1&style=for-the-badge -## Manual Installation -For normal users, installing via the installers makes the most sense. However when wanting to either develop BetterDiscord, or when the installers do not work, this option can be used. -### Prerequisites -- [Git](https://git-scm.com) -- [Node.js](https://nodejs.org/en/) with [pnpm](https://pnpm.io/). -- Command line of your choice. +# Manual Installation -### 1: Clone the repository -```ps -git clone https://github.com/BetterDiscord/BetterDiscord.git -``` -### 2: Install dependencies -```ps -pnpm recursive install -``` -### 3: Run Build Script -This will create a `injector.js`, `preload.js`, and `renderer.js` in the `dist` folder. -```ps -pnpm run build -``` -### 4: Inject into your Discord client -#### Install to Stable -```ps -pnpm run inject -``` -#### Install to PTB -```ps -pnpm run inject ptb -``` -#### Install to Canary -```ps -pnpm run inject canary -``` +For normal users, installing via the installers makes the most sense. However when wanting to either develop BetterDiscord, or when the installers do not work, this option can be used. Please see our [detailed documentation](https://docs.betterdiscord.app/users/getting-started/installation#manual-installation) for a guide on how to do this. -## Additional Scripts -### Compiling & Distribution -This will create a `betterdiscord.asar` file in the `dist` folder. -```ps -pnpm run dist -``` ---- +# Addons -# FAQ +Installing addons--like plugins and themes--is easy. All you need to do is select and download an addon from [our website][website-link] and put it in your folder. If you want some more details, or just prefer a visual guide, take a look at our [tutorial on installing addons](https://docs.betterdiscord.app/users/guides/installing-addons) that includes a demonstration video. -### What is this? -This is a client modification for Discord. It allows you to add plugins and themes to your client. Plugins can add functionality and useful features. Themes can completely change the look and feel of Discord. -BD has some other built-in features such as Emotes from Twitch, FFZ, and BBTV, as well as an in-client server browser. -### Where can I get plugins and themes? -The easiest way to find plugins and themes is to browse them on [our website: https://betterdiscord.app/](https://betterdiscord.app/). Additionally, in our [support servers](#support-servers) we have channels with lists of official plugins and themes. +# Platform Support -### Support Servers? -There are two: [The main server][discord-link], and [the backup](https://discord.gg/XqSpb9e3dq). +BetterDiscord currently only supports standard local Discord installs. This means snap packages, portable apps, and the web version are all not supported. -# Supporters -These people have all subscribed to the `True Supporter` tier on Patreon to support me. +Examples of supported platforms: +- Windows 7 and newer +- macOS Yosemite and newer +- Ubuntu 14.04 and newer - - - - - - - - - - -
- Kraken
- Kraken
-
- SPHHAX
- SPHHAX
-
- DefCon42
- DefCon42
-
- Justxn
- Justxn
-
- monkey
- monkey
-
- Gibbu
- Gibbu -
- Orekieh
- Orekieh -
-# Bandagers -These people have all subscribed to the `Bandager` tier on Patreon to support me. - - - - - - - - - - -
- William JCM
- William JCM -
- NFLD99
- NFLD99 -
- Tenuit
- Tenuit -
- Pu
- Pu -
- Paco
- Paco -
- Jordan
- Jordan -
- -# Donors -These people have either donated or subscribed to the most basic patron tier to support me. - - - - - - - - - - - - - - - -
-
- aetheryx -
-
- JBeauDee -
-
- vantiss -
-
- xstefen -
-
- 『Sorey』 -
-
- LiVeR -
-
- SweetLilyCake -
-
- GameKuchen -
-
- Lozo -
-
- Akira -
-
- Pixel -
# Contributors diff --git a/lgtm.yml b/lgtm.yml deleted file mode 100644 index 460604a6..00000000 --- a/lgtm.yml +++ /dev/null @@ -1,5 +0,0 @@ -path_classifiers: - generated: - - "dist/*" - test: - - "tests/*.js" \ No newline at end of file