DiscordInjections

by DiscordInjections

DiscordInjections /DiscordInjections

Injects CSS and JS into the Discord client.

134 Stars 25 Forks Last release: about 2 years ago (v4.0.1) MIT License 514 Commits 18 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

DiscordInjections

latest release license discord issues prs

This script aims to pick up where BeautifulDiscord ends. Not only does it support custom CSS injections, but it also gives you the ability for custom JavaScript.

Important notice

This is version 4 of Discord Injections.

Please report any problems, bugs, suspicious behavior, etc to Github. Thank you very much!

DTinker

Need help installing? Want to give a suggestion? Want to just chat? I'm using DTinker as a hub for DiscordInjections! Click right on Lil' Bub's face to go there!

LIL BUB!!!

(Or click here if you're boring)

Features

  1. Custom CSS
  2. CSS hot-loading and watching
  3. Custom JS in the form of Plugins
  4. Custom commands
  5. Custom settings
  6. Transparency and frame settings
  7. Custom splash screen CSS

Requirements

This module requires you to have node.js installed with ES6 support.

This module optionally requires git for easier version updating.

Installation

  1. Go to the directory you would like to install this module in

  2. Download the files

    #### With releases (currently no v4 versions have been released!)

    1. Download the latest release
    2. Extract to the desired location

    #### With git 1. Type

    git clone https://github.com/DiscordInjections/DiscordInjections folderName
    2. Type
    git checkout tags/
    to go to a specific version. This is recommended

    NOTE: No support is giving for

    HEAD
    - it is in a constant changing and breaking state.
  3. Type

    cd folderName
  4. Run

    npm install
  5. Run

    npm run inject
  6. Edit the config.json file as desired

  7. Install any desired plugins, and then run

    npm run install-plugins

To uninstall, run

npm run uninject

To reinstall, run

npm run reinject

Updating

WARNING: If you currently have any version below 4.X.X installed, you must run

npm run uninject
before doing this step, and then
npm run inject
afterwards!

With releases

  1. Download the latest release
  2. Extract to the desired location

With git

  1. Run
    git fetch --tags
  2. Run
    git checkout tags/

or

  1. Run
    git pull
    if you are using master

Next Steps

  1. Make sure all dependencies are installed (run
    npm install
    - new dependencies might have been added)

Usage

All usage takes place in the folder you installed DiscordInjections into.

Config

DiscordInjections has some configuration options. A default config.json file is provided as config.json.template. Feel free to copy over and customize it to your liking.

Every option that accepts paths can start with a placeholder:

.
The working directory of DI

~
The users home path

%%
The config folder
discordinjections
. On Windows, it is located in
%APPDATA%
, on Linux, you can find it usually under
~/.config

%
The config folder for your discord distribution (
discord
,
discordptb
,
discordcanary
,
discorddevelopment
). On Windows, it is located in
%APPDATA%
, on Linux, you can find it usually under
~/.config

&
The runtime folder for your discord distribution (
discord
,
discordptb
,
discordcanary
,
discorddevelopment
). On Windows, it is located in
%LOCALAPPDATA%
, on Linux, you can find it usually under
~/.share

CSS

The CSS tree can be changed in the settings of Discord.

To adjust the CSS for the splash screen, adjust the

splash
key of the config.json file. To see the HTML of the splash screen, extract the app.asar file in the Discord resources folder. Then load the app_bootstrap/spash/index.html in Vanilla Electron.

JavaScript

For extensibility, DiscordInjections uses a simple plugin system. Plugins are placed in the

Plugins/
directory.

To create a plugin, you must extend the

Structures/Plugin
class. See the
Plugins/SamplePlugin.js.EXAMPLE
file for an example.

For a list of plugins, visit Plugins

WARNING

Plugins can be dangerous. Please read the disclaimer.

Disclaimer

DiscordInjections is not responsible for any plugins created by a third party. Needless to say, running plugins can be extremely dangerous as it exposes your entire discord client, as well as localStorage.

Before adding a plugin, be sure to thoroughly check its code to see what it does.

Stay safe.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.