Improved sKai support and overall download algo

README.md

@@ -10,7 +10,23 @@ Structurally, Kopher is a KaiOS-specific frontend to the hi01379.js library whic
 
 ## Which KaiOS versions are supported?
 
-Tested on 2.5 up to 2.5.4. May work on 1.0 (e.g. Alcatel Cingular Flip 2), definitely won't work on 3.x.
+Tested on 2.5.x up to 2.5.4. Doesn't work on 1.0 (some bug with mozTCPSockets I'm not gonna investigate) and definitely won't work on 3.x.
+
+More specifically, as of now, Kopher has been tested on the following devices and KaiOS versions (ordered from oldest to newest):
+
+- Nokia 8110 4G v13 (2.5/GerdaOS)
+- Nokia 8110 4G v17 (2.5.1)
+- Doro 7060 (DFC-0190) (2.5.1)\*\*
+- Sigma mobile S3500 sKai (2.5.1.1)\*
+- Nokia 800 Tough (2.5.2)
+- Nokia 2720 Flip (2.5.2.2)
+- Crosscall Core-S4 (2.5.3.2)
+- Nokia 8000 4G (2.5.4)
+
+*\* there is a bug with displaying Blob-type images on the sKai, so only the download option works correctly*
+*\*\* install-via-FFBM trick; also, the system statusbar on the Doro is larger than usual, so the addressbar is a bit overlapped (doesn't hamper its readability)*
+
+N.B. If you want to debug Kopher to support KaiOS 1.0, make sure to replace the `'\u{1f310}'` reference in `js/app.js` with `'\uD83C\uDF10'` surrogate pair first.
 
 ## Which Gophermap entry types are supported?
 
@@ -38,6 +54,7 @@ Note that currently, Kopher and hi01379.js assume that the search request from a
 - One-key switching the line wrapping mode between off (default) and on (for comfortable reading)
 - Unlimited navigation history (doesn't persist between sessions)
 - Up to 10 numbered bookmarks plus customizable homepage
+- Binary blob downloads (see "Downloads")
 
 ## Controls
 
@@ -61,6 +78,12 @@ Kopher's controls were inspired by old WAP browsers and partially Opera Mini. On
 - Version and page info: `# #`
 - Exit: End
 
+## Downloads
+
+For image files supported by KaiOS, Kopher prompts whether or not you want to just view or store them, and if you choose to store them, they are saved to your default gallery storage. All other types are downloaded directly **to the root of your default storage** (the storage you selected in KaiOS setttings as the default media location, be it internal or the SD card). Note that Kopher does not do any heuristics on how the downloads folder should be named, nor does it create any by itself. Different phones handle the download storage place differently and B2G doesn't have a specific designator for it, so just using the root is the safest and most cross-device way of saving the files.
+
+Note that in most KaiOS phones the internal storage root isn't fully viewable with the stock file manager, so you might have to use MTP and/or third-party file managers like Explorer to see the files if this is the case with your device. For more consistent UX with downloads, please consider using an SD card as the default storage.
+
 ## Wait... no input fields in the UI?!
 
 Exactly. No need to reinvent the wheel when the JS engine offers the `prompt()` method. You enter the starting address in the popup window, same way you enter search queries in the gopherholes.