Recently Written · git

scan-subread

PDF reader that follows an audiobook with the SubRead suite

git clone https://github.com/equwal/scan-subread

Log | Files | Refs


commit 8e8ca40f898aae159e4327c06fa5a314d0991e80
truex <truex@equwal.com>
2026-09-26 23:02:56 -0700

Show phone screenshots and the install steps in the README

The screenshots come from the test phone, without the status bar and the navigation bar. They are in the fastlane folder, where F-Droid also finds them, as in SubRead Overlay.

 README.md                                              |  17 +++++++++++++++++
 .../android/en-US/images/phoneScreenshots/1.png        | Bin 0 -> 35686 bytes
 .../android/en-US/images/phoneScreenshots/2.png        | Bin 0 -> 28827 bytes
 .../android/en-US/images/phoneScreenshots/3.png        | Bin 0 -> 36042 bytes
 .../android/en-US/images/phoneScreenshots/4.png        | Bin 0 -> 42525 bytes
 5 files changed, 17 insertions(+)
diff --git a/README.md b/README.md
index 138796e..58810e1 100644
--- a/README.md
+++ b/README.md
@@ -23,6 +23,23 @@ dictionary of your choice. Press a word for half a second, and SubRead
 Anki makes a card. The player pauses while the dictionary or the card
 is open.
 
+<p>
+  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/1.png" width="200" alt="A text PDF: the line that the narrator reads is marked in yellow">
+  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/2.png" width="200" alt="A Japanese scan: OCR read the page, and the current line is marked">
+  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/3.png" width="200" alt="After a page turn by hand, the page stops following, and the Follow button brings it back">
+  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/4.png" width="200" alt="The start card with the checklist of the SubRead suite">
+</p>
+
+## Install
+
+On Android, download `Scan-SubRead-<version>.apk` from the
+[latest release](https://github.com/equwal/scan-subread/releases/latest)
+and open it. The release APKs have the signature of the SubRead suite. A
+debug build from your own PC has a different signature: uninstall it
+first. This deletes the pages and the books that the app keeps.
+
+In a browser, build and serve the web app (see "Run").
+
 ## How to use it
 
 1. Press "Open a PDF" on the start card, or open the menu (the `☰`
diff --git a/fastlane/metadata/android/en-US/images/phoneScreenshots/1.png b/fastlane/metadata/android/en-US/images/phoneScreenshots/1.png
new file mode 100644
index 0000000..cd6578e
Binary files /dev/null and b/fastlane/metadata/android/en-US/images/phoneScreenshots/1.png differ
diff --git a/fastlane/metadata/android/en-US/images/phoneScreenshots/2.png b/fastlane/metadata/android/en-US/images/phoneScreenshots/2.png
new file mode 100644
index 0000000..c10f642
Binary files /dev/null and b/fastlane/metadata/android/en-US/images/phoneScreenshots/2.png differ
diff --git a/fastlane/metadata/android/en-US/images/phoneScreenshots/3.png b/fastlane/metadata/android/en-US/images/phoneScreenshots/3.png
new file mode 100644
index 0000000..1dc1e95
Binary files /dev/null and b/fastlane/metadata/android/en-US/images/phoneScreenshots/3.png differ
diff --git a/fastlane/metadata/android/en-US/images/phoneScreenshots/4.png b/fastlane/metadata/android/en-US/images/phoneScreenshots/4.png
new file mode 100644
index 0000000..03a5bac
Binary files /dev/null and b/fastlane/metadata/android/en-US/images/phoneScreenshots/4.png differ