diff --git a/README.md b/README.md
index bc361d5b6e..0c609d111f 100644
--- a/README.md
+++ b/README.md
@@ -45,6 +45,37 @@ Sable iOS builds are distributed as unsigned IPAs through [AltStore](https://alt
iOS builds are produced by the `ios` job in [`tauri-build.yml`](.github/workflows/tauri-build.yml) and track the same `dev`/`v*` triggers as desktop builds.
+## Android (Obtainium)
+
+### Nightly Source
+
+
+
+
+### Stable Source
+
+
+
+
+### Setup and install
+
+1. Set up [Obtainium](https://wiki.obtainium.imranr.dev/) on your device.
+2. Add the Sable source by either:
+ - Tapping one of the buttons above.
+ - Importing one of the JSON files:
+ - [Nightly](https://raw.githubusercontent.com/SableClient/Sable/refs/heads/dev/obtainium-source-nightly.json)
+ - [Stable](https://raw.githubusercontent.com/SableClient/Sable/refs/heads/dev/obtainium-source-stable.json)
+ - Adding it manually - use as the GitHub link and follow the section below with regards to setting app variables
+3. Install Sable from the source.
+
+### Relevant variables and switching between Nightly and Stable
+
+Relevant variable differences between Nightly and Stable:
+- *Include prereleases* - `true` for Nightly, `false` for Stable
+- *Fallback to older releases* - `false` for Nightly, `true` for Stable
+- *Use latest asset upload as release date* - `true` for Nightly, `false` for Stable (this is due to Nightly builds being uploaded to one release instead of creating new ones)
+- *Use release date as version string (pseudo-version)* - `true` for Nightly, `false` for Stable (this is due to Nightly builds being uploaded to one release instead of creating new ones)
+
## Self-hosting
You have a few options for self hosting, you can:
1. Run the prebuilt docker container.
@@ -55,7 +86,8 @@ You have a few options for self hosting, you can:
Prebuilt images are published to `ghcr.io/sableclient/sable`.
-- `latest` tracks the current `dev` branch image.
+- `latest` tracks the current latest version release.
+- `dev` tracks the current `dev` branch image.
- `X.Y.Z` tags are versioned releases.
- `X.Y` tags float within a release line.
- Pushes to `dev` also publish a short commit SHA tag.
diff --git a/obtainium-source-nightly.json b/obtainium-source-nightly.json
new file mode 100644
index 0000000000..9d4e3bdd00
--- /dev/null
+++ b/obtainium-source-nightly.json
@@ -0,0 +1,11 @@
+{
+ "apps": [
+ {
+ "id": "moe.sable.client",
+ "url": "https://github.com/SableClient/Sable",
+ "author": "SableClient",
+ "name": "Sable",
+ "additionalSettings": "{\"includePrereleases\":true,\"fallbackToOlderReleases\":false,\"filterReleaseTitlesByRegEx\":\"\",\"filterReleaseNotesByRegEx\":\"\",\"verifyLatestTag\":false,\"dontSortReleasesList\":false,\"useLatestAssetDateAsReleaseDate\":true,\"trackOnly\":false,\"versionExtractionRegEx\":\"\",\"matchGroupToUse\":\"\",\"versionDetection\":true,\"releaseDateAsVersion\":true,\"useVersionCodeAsOSVersion\":false,\"apkFilterRegEx\":\"\",\"invertAPKFilter\":false,\"autoApkFilterByArch\":true,\"appName\":\"Sable\",\"shizukuPretendToBeGooglePlay\":false,\"exemptFromBackgroundUpdates\":false,\"skipUpdateNotifications\":false,\"about\":\"An almost stable Matrix client\",\"appAuthor\":\"SableClient\"}"
+ }
+ ]
+}
\ No newline at end of file
diff --git a/obtainium-source-stable.json b/obtainium-source-stable.json
new file mode 100644
index 0000000000..9d4e3bdd00
--- /dev/null
+++ b/obtainium-source-stable.json
@@ -0,0 +1,11 @@
+{
+ "apps": [
+ {
+ "id": "moe.sable.client",
+ "url": "https://github.com/SableClient/Sable",
+ "author": "SableClient",
+ "name": "Sable",
+ "additionalSettings": "{\"includePrereleases\":true,\"fallbackToOlderReleases\":false,\"filterReleaseTitlesByRegEx\":\"\",\"filterReleaseNotesByRegEx\":\"\",\"verifyLatestTag\":false,\"dontSortReleasesList\":false,\"useLatestAssetDateAsReleaseDate\":true,\"trackOnly\":false,\"versionExtractionRegEx\":\"\",\"matchGroupToUse\":\"\",\"versionDetection\":true,\"releaseDateAsVersion\":true,\"useVersionCodeAsOSVersion\":false,\"apkFilterRegEx\":\"\",\"invertAPKFilter\":false,\"autoApkFilterByArch\":true,\"appName\":\"Sable\",\"shizukuPretendToBeGooglePlay\":false,\"exemptFromBackgroundUpdates\":false,\"skipUpdateNotifications\":false,\"about\":\"An almost stable Matrix client\",\"appAuthor\":\"SableClient\"}"
+ }
+ ]
+}
\ No newline at end of file