From a8b5bd163d696a45103f24f55b2c71e207c439e2 Mon Sep 17 00:00:00 2001
From: Rombond <rombond@live.fr>
Date: Thu, 12 Nov 2026 20:36:20 -0500
Subject: [PATCH] README and docs: app screenshots, iOS in review, Android APK
 on GitHub releases (Obtainium)

---
 README.md           | 15 ++++++++++-----
 docs/mobile-apps.md |  7 ++++---
 2 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index aecbb23..f5cb9b2 100644
--- a/README.md
+++ b/README.md
@@ -16,8 +16,12 @@
   <a href="LICENSE"><img alt="MIT license" src="https://img.shields.io/github/license/Rombond/tipsarr"></a>
 </p>
 
-<!-- TODO: screenshots. Add docs/images/web-discover.png, web-request.png, ios-*.png, android-*.png and replace this comment
-     with an image row (no real account, library or server address visible). -->
+<p align="center">
+  <img alt="Discover" src="fastlane/screenshots/en-US/iphone69_01_discover.png" width="200">
+  <img alt="Title page" src="fastlane/screenshots/en-US/iphone69_02_title.png" width="200">
+  <img alt="Requests" src="fastlane/screenshots/en-US/iphone69_04_requests.png" width="200">
+  <img alt="Stats" src="fastlane/screenshots/en-US/iphone69_06_profile.png" width="200">
+</p>
 
 **[Try the live demo](https://tipsarr-demo.brebond.com)**: every visitor gets a private, throwaway Tipsarr with sample
 data and admin access. Nothing you do there is seen by anyone else; the sandbox is deleted after 30 minutes without
@@ -115,9 +119,10 @@ Radarr and Sonarr. The full walkthrough is in [docs/installation.md](docs/instal
 The iOS and Android apps connect to your own Tipsarr server (several servers or accounts are supported) and use the
 same API as the web interface.
 
-<!-- TODO: store links once published. -->
-- iOS (App Store): *coming soon*
-- Android (Google Play): *coming soon*
+- **iOS and iPadOS** (App Store): in review, link coming with the approval.
+- **Android**: signed APK attached to each [GitHub release](https://github.com/Rombond/tipsarr/releases/latest)
+  (`tipsarr-<version>.apk`). Add this repository to [Obtainium](https://github.com/ImranR98/Obtainium) to get updates.
+  Not on Google Play for now (internal testing only).
 
 Apple and Google only deliver notifications signed with the app publisher's credentials, so your server cannot push to
 a store app directly. Tipsarr goes through a small relay run by the publisher,
diff --git a/docs/mobile-apps.md b/docs/mobile-apps.md
index cda99fd..885ae81 100644
--- a/docs/mobile-apps.md
+++ b/docs/mobile-apps.md
@@ -4,9 +4,10 @@ Native apps for iOS/iPadOS (SwiftUI) and Android (Kotlin, Jetpack Compose), with
 discovery, search, requests (including 4K), request progress, issues, watchlist, profiles and stats, admin approval,
 and the Teasers tab when enabled on the server.
 
-<!-- TODO: store links once published. -->
-- App Store: *coming soon*
-- Google Play: *coming soon*
+- **iOS and iPadOS** (App Store): in review, link coming with the approval.
+- **Android**: signed APK attached to each [GitHub release](https://github.com/Rombond/tipsarr/releases/latest)
+  (`tipsarr-<version>.apk`). Add this repository to [Obtainium](https://github.com/ImranR98/Obtainium) to get updates.
+  Not on Google Play for now (internal testing only).
 
 ## Connecting