mirror of
https://github.com/narrrl/proton-stream.git
synced 2026-11-03 16:41:26 +01:00
nvrl
f66faf6b75
My List is a list of titles to watch later, kept in my-list.json by
title key (pstr-core::mylist) and synced as one list/<key> register per
title, so an add or a removal on one device reaches every other. A list
file that will not parse is never written over: changing the list is
refused instead. It is a filter, a row on the library, a button on the
banner and the title page, and an entry in each tile's menu.
pstr-core::news reads node_first_seen against each share's first crawl,
so a newly added share does not badge its whole library. A title that
arrived in the last two weeks and was never played is New; a series
being watched counts the unwatched episodes that arrived after it was
last played ("3 new"). They fill the tile badge and the "New episodes"
and "Recently added" rows. shelves::home puts every row in one order
for all three apps, and a shelf tile of an airing show shows a
countdown ("Ep 8 · in 2 d").
The bridge gains TitleRecord.on_list and .badge, set_on_list, the
MyList filter, airing_countdown and SyncRecord.list_changed.
proton-stream documentation
proton-stream turns the videos in your Proton Drive, and the share links people send you, into a library you can browse and stream. It runs on Linux, Windows, Android, Android TV and iOS. This is an unofficial client, not a Proton product.
Start here
- Getting started: install, add your first share, press play.
- Installation: every platform, and how to update and uninstall.
- FAQ: short answers to the questions people ask first.
Using it
- User guide: the library, title pages, the player, downloads, history and settings.
- Account and sync: signing in, folders of your own Drive, and keeping your place on every device.
- Android and iOS: what is different on a phone, a tablet and Android TV.
Reference
- Command-line reference: the
pstrtool and theproton-streamlauncher. - Privacy: what goes where, and what stays on your device.
When something goes wrong
- Troubleshooting: links that will not add, sign-in problems, playback problems, and where the logs are.
Contributing
- Development: the state of each layer, the build order and the traps.
- Architecture: the crates, the data flow when an episode plays, and where secrets live.
- Testing, Metadata, Design tokens, Android development and iOS development.
Bugs are tracked in BUGS.md in the repository.