sheltupdate

sheltupdate is a fork of GooseUpdate, which replicates Discord's update API, and injects mods and tweaks into the served modules.

Changes from GooseUpdate:

• Fixes to bring it up to date for 2024
• Different branches, for use with shelter
• Hugely refactored and converted to use much more modern technology (axios -> fetch, fastify -> hono, etc.)
• A more robust patch system that improves multi-mod support

Branches

Check the shelter documentation for install instructions.

The uwu.network instance of sheltupdate hosts the branches exactly as found in this repository:

• shelter - injects shelter
• vencord - injects vencord
• betterdiscord - injects BD
• reactdevtools - adds react dev tools to your client

Deploying

1. Install SheltUpdate's dependencies with npm install
2. Copy config.example.json to config.json and modify it to your liking, then run node src/index.js.

Deploying with Docker

Run the container as so:

docker run -v /path/to/your/config.json:/config.json -p 8080:8080 yellosink/sheltupdate

Usage

Discord fetches the update API URL from a settings.json file stored in various directories depending on your operating system.

Said directories are found below:

• Windows:
  • %appdata%\discord<channel>\settings.json
• Mac:
  • ~/Library/Application Support/discord<channel>/settings.json
• Linux:
  • Package Manager/tar.gz Installation: ~/.config/discord<channel>/settings.json
  • Flatpak: ~/.var/app/com.discordapp.Discord/config/discord<channel>/settings.json

Set UPDATE_ENDPOINT and NEW_UPDATE_ENDPOINT in settings.json as follows:

"UPDATE_ENDPOINT": "https://<instance URL>/branch"
"NEW_UPDATE_ENDPOINT": "https://<instance URL>/branch/"

SheltUpdate also supports including multiple branches in updates by separating their names with a +, like https://<instance URL>/branch1+branch2.

Adding a branch

SheltUpdate branches patch discord_desktop_core with files stored in branches/<branch name>/.

Branches must have a patch.js file to handle their injection in their branch directory, which is prepended to Discord's base index.js of the module.

They must have a meta.js file that exports a name and description, and can optionally export a setup function, which may be asynchronous and will be periodically run. Use this to download other branch files you need. As arguments, you will be passed an absolute path to a folder to leave your files in, which on scheduled setup reruns may or may not contain your previous set-up files, and a log function. You have access to node and @electron/asar.

They may optionally include a preload.js file to supplement their injection, which will automatically be injected for you by sheltupdate.

sheltupdate will not automatically pick up and inject anything into the renderer, but it is trivial to implement this in your preload.

// patch.js
require('mod.js')

// preload.js (optional)
const { webFrame } = require("electron");

webFrame.top.executeJavaScript("console.log('HELLO FROM THE RENDERER');");

If other files are in the branch directory, they will be added the module directory.

Credits

GooseUpdate was originally written by Ducko.

The shelter desktop injector has been contributed to by most of uwu.network at this point, and is the basis of the shelter branch here.

The vencord branch is very very loosely based on the Kernel vencord loader.

sheltupdate is a passion project made with love by Yellowsink (and other uwu.network contributors).