mirror of
https://github.com/narrrl/proton-stream.git
synced 2026-11-03 16:41:26 +01:00
nvrl
16c2b4c9d3
docs/ gains pages for people using the app rather than building it: getting started, installation, the user guide, account and sync, Android and iOS, the command line, privacy, an FAQ and troubleshooting. docs/README.md is the wiki's home page. scripts/publish-wiki.sh, ported from proton-drive-linux, checks every link in docs/ and README.md, rewrites links between pages to wiki page names and copies the images they show. The Wiki workflow runs the check on pull requests and publishes on every push to main. images/ holds library, title and episode screenshots from the desktop and Android apps, and the logo.
85 lines
3.4 KiB
Markdown
85 lines
3.4 KiB
Markdown
# Android and iOS
|
|
|
|
The Android and iOS apps share the desktop app's engine, so a library, its watch history and its
|
|
settings behave the same everywhere. This page covers what is different on a phone, a tablet and
|
|
a TV. [Installation](INSTALL.md) explains how to install each one.
|
|
|
|
<table>
|
|
<tr>
|
|
<td><img src="../images/android-home.png" alt="Home" width="200"></td>
|
|
<td><img src="../images/android-library.png" alt="All titles" width="200"></td>
|
|
<td><img src="../images/android-title.png" alt="A title page" width="200"></td>
|
|
<td><img src="../images/android-episodes.png" alt="Episodes and downloads" width="200"></td>
|
|
</tr>
|
|
</table>
|
|
|
|
## Adding a share
|
|
|
|
Tap **Add share** on the **Shares** tab, paste the link, and add a custom password if the link has
|
|
one. The app checks the link before it saves it.
|
|
|
|
- **Android:** you can also share a link to the app from your browser or a chat app, or open a
|
|
`drive.proton.me/urls/…` link directly if you allow the app to open supported links in the
|
|
system settings.
|
|
- **iOS:** there is no share sheet. Copy the link, then tap **Paste link** in the dialog.
|
|
|
|
Folders of your own Drive work as on the desktop: sign in on the **Shares** tab, then **Add from
|
|
your Drive**. See [Account and sync](ACCOUNT_AND_SYNC.md).
|
|
|
|
## The player
|
|
|
|
- Tap to show or hide the controls.
|
|
- **Double-tap** the left or right third of the screen to go back or forward 10 seconds. Double-tap
|
|
the middle to pause.
|
|
- The menu has **Episodes**, **Chapters**, **Playback speed**, the audio and subtitle tracks, and
|
|
**Lock to landscape**.
|
|
- Sound keeps playing with the screen off or the app in the background, with controls on the lock
|
|
screen. Turn off **Background audio** in Settings to stop that.
|
|
|
|
Picture-in-Picture is not available on either platform.
|
|
|
|
## Android TV
|
|
|
|
The app appears in the TV launcher. With the controls hidden:
|
|
|
|
| Remote | Does |
|
|
|---|---|
|
|
| Left / right | Back or forward 10 seconds |
|
|
| Centre, up or down | Show the controls |
|
|
| Play/pause | Pause and play |
|
|
|
|
There is no separate TV layout yet, and the app has not been tested on a real TV. Reports are
|
|
welcome.
|
|
|
|
## Downloads
|
|
|
|
Download an episode, a season or a show from its title page, and play it from the **Downloads**
|
|
tab without a connection.
|
|
|
|
- **Android** waits for Wi-Fi unless you turn off **Download on Wi-Fi only**. Downloads continue
|
|
with the app closed.
|
|
- **iOS** downloads only while the app is open, and for the short time iOS allows after you leave
|
|
it. A stopped download resumes where it stopped.
|
|
|
|
**Delete all offline episodes** in Settings frees the space in one step.
|
|
|
|
## New episodes
|
|
|
|
When a share gains episodes of a show, the app sends a notification.
|
|
|
|
- **Android** checks about every 6 hours, when the device has a network and the battery is not
|
|
low. Turn it off with **New episode notifications** in Settings.
|
|
- **iOS** asks the system to check every 6 hours or so; iOS decides when it actually runs.
|
|
|
|
## Where your secrets are kept
|
|
|
|
- **Android:** in the app's private storage, encrypted with a key in the Android Keystore. If you
|
|
change or remove the device's screen lock, Android may delete that key. The app then asks you
|
|
to **Re-enter link** for each share.
|
|
- **iOS:** in the Keychain, only on this device, and not in backups.
|
|
|
|
## Requirements
|
|
|
|
- **Android 12** or newer, on an arm64 or x86_64 device. 32-bit devices are not supported.
|
|
- **iOS 17** or newer, on iPhone or iPad.
|