Installation

Snail consists of a little inject.js script packaged in the asar archive, that loads all of the other patches from ~/.snail/. That makes it easy to install & update, as you only need to modify one file once and update the rest without repacking slack.

GUI Installation

This is the recommended way to install snail!

windows

oop

Manual Installation

This isn't exactly a guide, but here are the general steps to patch slack!

1. Download the inject.js script here and save it somewhere.

2. Unpack slack's asar archive. On macOS, it's located at /Applications/Slack.app/Contents/Resources/app.asar. You can use the asar npm package to unpack it:

   bunx asar extract /path/to/app.asar /path/to/extracted

3. Put the contents of inject.js into extracted/dist/main.bundle.cjs at the top of the file!

4. Repack the asar archive:

   bunx asar pack /path/to/extracted /path/to/app.asar

5. Disable electron's integrity check by setting the fuses

   bunx @electron/fuses write --app /path/to/app.asar EnableEmbeddedAsarIntegrityValidation=off

6. Create the ~/.snail/ directory and copy the following files into it:

   • config.json example:

   {
     "serverUrl": "https://snail.hackclub.cc",
     "pluginsEnabled": [
       "snail-plugin-manager"
     ],
     "themesEnabled": []
   }

   • plugins/ (create an empty directory)
   • themes/ (create an empty directory)
   • internal/ -> download the preload.js and main.js files and put them in here.

7. (optional) If you want to use the react plugin manager, download the latest release from here and unzip it in plugins/ (if you don't install this, you'll need to edit the config.json file manually)

8. Restart slack!