cutthecord/BUILDING.md

5.2 KiB

CutTheCord: Building

Toolchain setup

  • Get apktool (due to 2 bugs present in v2.3.4, you're strongly recommended to use v2.4.0 or higher, I compile latest from source).
  • Get a keystore, see here, step 1.
  • Get apksigner, it's part of android build tools.
  • If you want Mutant Standard emoji patches, get 72x72 PNG copies of latest version of mutant standard emojis with codepoints. I have a zip here.
  • If you want Blob emoji patches, get 72x72 PNG copies of blobmojis with codepoints. I personally resized the png/128 folder in this repo (find /home/ave/blobmoji/png/72 -iname '*.png' -exec convert \{\} -verbose -resize 72x72\> \{\} \;).
  • Extract the emojis you got somewhere.
  • Clone this repo somewhere, edit patches/mutant/emojireplace.py and patches/blobs/emojireplace.py, set the extracted_mutstd_path and extracted_blobmoji_path folders respectively to the folder you just extracted emojis to.
  • Get a Discord apk (cough apkmirror, aptoide API).

Using CutTheCord CI

CutTheCord CI (CTCCI) is what powers the official builds. It allows for extensive customization. It relies on distok files and state. While state is public, files aren't, so you'll have to create a similar file structure.

CTCCI requires python3.6+, and also likely requires Linux (I haven't tried it on other OSes, and use of things like patch and pipes might limit it to Linux).

Initial setup

  • Follow the "Toolchain setup" steps above in case you haven't already.
  • Install dependencies (python3 -m pip install -Ur requirements.txt)
  • Copy ctcci/ctcconfig.example.py to ctcci/ctcconfig.py and configure contents to your local data and your personal preferences.
  • If you don't want to always automatically be required to use the latest discord version, set LOCAL_STATE to True and point STATE_FILE to a state.json file that looks like this: {"android": {"com.discord": {"version": 909}}}.
  • Set up a local distok-style file storage for your APKs, and copy your APKs on it, and name them properly (the format is $DISTOK_FOLDER/android/$PACKAGE_ID-$VERSION_NUMBER.apk, example: /home/ave/distok/android/com.discord-909.apk).

Running builds

  • Simply run the ctcci.py script, with first argument being branch name, and latter ones being name of patches you want to add in.

Example: python3.6 /home/ave/distokrepos/cutthecord/ctcci/ctcci.py ave mutant customfont slashcommands tokenlogin customtheme customdefaultemoji customring bettertm notrack noprofilestrip nonearby experiments noblocked squareavatars

Manually

Building a patched discord app

  • Extract it with apktool (apktool d <apk path>)
  • Get all the necessary patches for that version. Necessary patches are not available for all versions and are only required to get some versions to pack together correctly.
  • Get optional patches you want for your version. If the patch you want isn't available for your version, you'll have to port them yourself.
  • Apply the patches (patch -p1 < <patch name>).
  • If you want mutant (or other emoji patches), edit patches/mutant/emojireplace.py to point to extracted discord folder (extracted_discord_path), and apply emoji patches (python3 emojireplace.py)
  • Build the new APK (apktool b com.discord-832)
  • Sign the new APK (jarsigner -keystore <keystore path> <foldername>/dist/<foldername>.apk <alias>)
  • Get your new APK from <foldername>/dist/<foldername>.apk, install and enjoy!

Building patches

After extracting the APK, copy it to a folder that you won't modify (cp -r com.discord-836 com.discord-836-base), so that you can easily diff them.

To get the diff, run diff -crB -x "dist" -x "res/raw" -x "build" CleanFolder PatchedFolder > patchname.patch

Porting patches

You can use patchport.py to easily attempt to port patches. This is what I use to port between every single version.

It's not really intelligent and doesn't do much more than manually preparing necessary patch, checking if an existing patch can be applied to a given version, replacing relevant variables required for porting various patches and eliminating offsets caused by updates, but it saves a lot of time if used carefully.

Example command: python3 patchport.py /home/ave/workbench/ctc/com.discord-968

Figuring out which patch is causing your build to break

You can use patchbisect.py to have a git bisect-like system of switching between patchsets to find which patch(es) is(/are) the ones that cause issues.

Simply let it do its thing, do whatever test you want to make, type y if it works or n if it doesn't and finally hit return, rinse and repeat until you find what's wrong.

There's no automated checking to allow checking for a wide range of issues like build issues, app crashing on boot, or simple functionality breakages.

Keep in mind that this doesn't account for the case of multiple patches being used together causing issues, nor does it account for conflicting patches.

Example command: python3 patchbisect.py /home/ave/workbench/ctc/com.discord-968