aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/MESHBAY_DESIGN.md19
-rw-r--r--docs/USERGUIDE.md7
2 files changed, 22 insertions, 4 deletions
diff --git a/docs/MESHBAY_DESIGN.md b/docs/MESHBAY_DESIGN.md
index a30215d..5ba1980 100644
--- a/docs/MESHBAY_DESIGN.md
+++ b/docs/MESHBAY_DESIGN.md
@@ -3414,10 +3414,23 @@ the edit is sent **beside the original**, as `<stem>-edited-<YYYYMMDD-HHMMSS>.<e
from the edit's date. A touch that left the bytes alone sends nothing. "Save as
copy" makes a new photo and needs no rule.
+**Videos.** Off by default, ticked in the same section: the videos of the
+chosen albums (a MediaStore bucket holds both, under one id) go beside the
+photos, in the same `YYYY/YYYY-MM` folders, under the same ledger, rules and
+unmetered network. `READ_MEDIA_VIDEO` is asked for when they are ticked in.
+The confirmation states the videos' count and size apart, because they are
+most of it. A file is never whole in the page: the upload reads it a chunk at
+a time and each chunk is a ranged request to the phone (`Range: bytes=a-b`,
+answered 206 by `ByteRange.kt`), so a video of gigabytes costs the WebView one
+chunk of memory; the SHA-256 the ledger keeps is then read from the phone once
+the node has the file. The Photos tab does not show videos yet; Files does.
+
**Location.** The manifest does not ask for `ACCESS_MEDIA_LOCATION`, so a
-photo read through MediaStore has its EXIF location **redacted by the
-platform**: a camera roll going to a group does not say where its owner lives,
-and nobody had to do anything for it.
+photo or video read through MediaStore has its location **redacted by the
+platform** (Android 10+): a photo's EXIF, and in an MP4 or MOV the location
+boxes MediaProvider finds (`IsoInterface`). A camera roll going to a group
+does not say where its owner lives, and nobody had to do anything for it. On
+Android 8 and 9 nothing redacts it.
**Refusals.** A refusal that will hold tomorrow โ€” `disk_full` (ยง6.4), a folder
no longer writable, gone or on a drive that is not plugged, the member removed
diff --git a/docs/USERGUIDE.md b/docs/USERGUIDE.md
index 1587160..dac1f9f 100644
--- a/docs/USERGUIDE.md
+++ b/docs/USERGUIDE.md
@@ -408,6 +408,10 @@ backup at all.
- **Set up** asks for access to your photos, then for the albums to send. The
camera is ticked; screenshots and other albums are yours to add.
+- **Videos too** adds the videos of the same albums, beside the photos. It is
+ off by default: videos are large, and the first backup can take a while.
+ They are sent on Wi-Fi like photos. For now they show in Files, not in the
+ Photos tab.
- By default **the photos already on the phone are sent too**, newest first,
then each new one. Choose "Only photos taken from now on" to skip the ones
already there. Before the first send you are told how many photos and how
@@ -422,7 +426,8 @@ backup at all.
the group is not sent again, unless the application is reinstalled. A photo
you edit on the phone is sent again beside the original, with `-edited-` and
the date in its name.
-- **Where a photo was taken is removed** from the copy that is sent.
+- **Where a photo or video was taken is removed** from the copy that is sent
+ (Android 10 and later).
#### Contacts