diff --git a/README.md b/README.md
index bc26a0d..eedb77d 100644
--- a/README.md
+++ b/README.md
@@ -3,15 +3,20 @@
 Privacy and hardening app for Google Pixel phones (Pixel 8 – 10, Android 15/16, no root).
 Audit your device, fine-tune permissions and settings, and undo every change.
 
-[<img src="https://raw.githubusercontent.com/ImranR98/Obtainium/main/assets/graphics/badge_obtainium.png" alt="Get it on Obtainium" height="80">](https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://git.mrblake.cc/MrBlake/Pixelwall)
+[<img src="https://raw.githubusercontent.com/ImranR98/Obtainium/main/assets/graphics/badge_obtainium.png" alt="Get it on Obtainium" height="54">](https://apps.obtainium.imranr.dev/redirect?r=obtainium://app/%7B%22id%22%3A%22org.pixelwall.app%22%2C%22url%22%3A%22https%3A%2F%2Fgit.mrblake.cc%2FMrBlake%2FPixelwall%22%2C%22author%22%3A%22MrBlake%22%2C%22name%22%3A%22Pixelwall%22%2C%22overrideSource%22%3A%22Codeberg%22%2C%22additionalSettings%22%3A%22%7B%5C%22apkFilterRegEx%5C%22%3A%5C%22pixelwall-core-%5C%22%7D%22%7D)
 
 > Status: early development (milestone 1 of 9). Architecture and roadmap: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) (German).
 
 ## Install
 
-Install and update through [Obtainium](https://obtainium.imranr.dev) with the button above, or add
-`https://git.mrblake.cc/MrBlake/Pixelwall` as an app source. Releases ship two APKs: pick `core`
-(no network permission) or `full` with Obtainium's APK filter.
+**Android 14 or newer.** Made for Google Pixel 8 – 10 on Android 15/16.
+
+- **Obtainium (recommended):** tap the badge above on your phone. It installs the `core` APK (no network permission)
+  and keeps Pixelwall up to date. For the `full` variant use [this Obtainium link](https://apps.obtainium.imranr.dev/redirect?r=obtainium://app/%7B%22id%22%3A%22org.pixelwall.app.full%22%2C%22url%22%3A%22https%3A%2F%2Fgit.mrblake.cc%2FMrBlake%2FPixelwall%22%2C%22author%22%3A%22MrBlake%22%2C%22name%22%3A%22Pixelwall%20%28full%29%22%2C%22overrideSource%22%3A%22Codeberg%22%2C%22additionalSettings%22%3A%22%7B%5C%22apkFilterRegEx%5C%22%3A%5C%22pixelwall-full-%5C%22%7D%22%7D) instead.
+  Manual setup: add `https://git.mrblake.cc/MrBlake/Pixelwall` in Obtainium, choose **Forgejo (Codeberg)** as the source
+  and set the APK filter to `pixelwall-core-` (or `pixelwall-full-`).
+- **Direct download:** get `pixelwall-core-v<version>.apk` or `pixelwall-full-v<version>.apk` from the
+  [releases page](https://git.mrblake.cc/MrBlake/Pixelwall/releases) and install it.
 
 ## Build variants
 
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index a5b629d..2b80e47 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -240,7 +240,9 @@ Pixelwall soll direkt über **Obtainium** aus den Releases auf `git.mrblake.cc`
 
 - **Releases mit APK-Assets**: Jeder Git-Tag `vX.Y.Z` bekommt ein Gitea-Release mit
   `pixelwall-core-vX.Y.Z.apk` und `pixelwall-full-vX.Y.Z.apk` (universelle APKs, kein ABI-Split nötig).
-  In Obtainium wählt man den Flavor per APK-Filter-Regex (`core` bzw. `full`).
+  In Obtainium wählt man den Flavor per APK-Filter-Regex (`pixelwall-core-` bzw. `pixelwall-full-`).
+- **Quelle „Forgejo (Codeberg)“**: Obtainium erkennt den eigenen Gitea-Host nicht automatisch. Der README-Button
+  nutzt deshalb `obtainium://app/{JSON}` mit `overrideSource: "Codeberg"` und APK-Filter (wie bei MrTerm).
 - **Versionen**: `versionName` = Tag ohne „v“; `versionCode` steigt streng monoton
   (Schema `MAJOR*10000 + MINOR*100 + PATCH`), damit Obtainium Updates sicher erkennt.
 - **Stabiler Signaturschlüssel**: Release-Keystore liegt außerhalb des Repos; Pfad und Passwörter kommen aus