Monument

A Morphe patch bundle for the Monument photo storage app (com.getmonument.android, version 4.3.5, versionCode 683).

It contains two independent, default-on patches:

Patch	Type	What it does
Login with token	bytecode + extension	Adds a "Login with token" option to the setup screen that signs in against a local device using a serial + client id + access token, bypassing the cloud API.
Limit thumbnail cache by default	bytecode	Turns the "Unlimited cache size" preference off by default (limited ~100 MB thumbnail cache). Still user-toggleable in settings.

Both are selectable independently in Morphe's patch list. Click a patch name above for its detailed documentation.

---

How to use the patches

0. Get the app APK — download Monument (com.getmonument.android) from APKPure. These patches target version 4.3.5.
1. Add the patches to Morphe. Two ways — the remote source is recommended because it auto-updates whenever a new release is published:
   • Remote (GitHub) — recommended: Add patch source → Remote / URL and paste this repository's URL:

     https://github.com/enccmp/mn-patches
     

     Morphe pulls the latest patches-<version>.mpp from the repository's Releases. Enable the source's pre-release toggle if you also want pre-release builds. (If you hit GitHub rate limits, set a GitHub Personal Access Token in Morphe's advanced settings — a token with no scopes is enough for public repos.)
   • Local (manual): build the bundle or download a released patches-<version>.mpp from Releases, then Add patch source → Local and pick the .mpp (it must be .mpp, not a zip). Use this for your own unreleased local builds. On desktop, the + source control selects the file.
2. Select the app: choose Monument / com.getmonument.android, version 4.3.5, and supply Monument_4.3.5.apk as the APK. Both patches show up under the patch list.
3. Pick patches: enable Login with token and/or Limit thumbnail cache by default.
4. Patch & install the resulting APK (Morphe re-signs it). If replacing an existing install with a different signature, uninstall the old app first.
5. Log in with the Login with token option — see the patch doc for how to get the serial / client id / token from the device database and the exact steps.

---

Knowledge base

Tips and tricks for running Monument with a dead cloud backend. More entries will be added here over time.

Entry	What it covers
Creating a new user offline	Add a fully working new user by editing the device SQLite DB directly, bypassing the cloud-gated invite / register flow. Log in with the Login with token patch.
Disabling a user offline	App-based user deletion fails with the cloud gone. Lock an account out instead with a one-line database change.

---

Building

Prerequisites: JDK 17+ and a GitHub token with read:packages (the app.morphe.patches plugin and patcher library are on GitHub Packages).

1. Put credentials where Gradle (and the IDE) read them — ~/.gradle/gradle.properties:

   gpr.user=YOUR_GITHUB_USERNAME
   gpr.key=ghp_YOURTOKEN
   

   local.properties holds only sdk.dir (the Android SDK path; the extension is an Android library module).
2. Build:

   ./gradlew :patches:buildAndroid
   

   Output: patches/build/libs/patches-<version>.mpp — this is the file you load into Morphe.

Bump version in gradle.properties on every change so each .mpp is uniquely identifiable.

Releases (CI)

.github/workflows/release.yml publishes a release when the version changes. The flow is:

1. Bump version in gradle.properties locally (patch component) and push to main.
2. CI reads the version and checks whether a release v<version> already exists.
3. If it doesn't, CI builds patches-<version>.mpp and publishes a GitHub Release tagged v<version> (which also creates the tag) with the .mpp attached.
4. If it does (e.g. a docs-only push with an unchanged version), CI builds and releases nothing.

You can also trigger it manually via Run workflow.

Open the project in IntelliJ IDEA or Android Studio (not VS Code) for Kotlin/Gradle resolution; there is no root build.gradle by design — the settings plugin configures the subprojects.

Compatibility

com.getmonument.android, versionName 4.3.5 (versionCode 683), minSdk 21. R8 in this build keeps class names but obfuscates method names, which is why both patches match methods by signature/strings rather than by name.