TheAnachronism/tt-rss-viewer
1
0
Fork 0
Code Issues Pull requests Projects Releases 5 Packages Wiki Activity Actions

Research: YouTube and Vimeo embed approaches for Flutter Reader #32

New issue
Closed
opened 2026-08-03 15:00:35 +00:00 by TheAnachronism · 1 comment
TheAnachronism commented 2026-08-03 15:00:35 +00:00
Owner
Copy link

Part of #30

Question

How should a Flutter Android app embed YouTube and Vimeo (v1 only) inside a flutter_html-based Reader without making WebView the primary article renderer?

Cover:

  • Detecting embeds from common HTML shapes (iframe src, YouTube/Vimeo URLs in links)
  • Recommended packages or patterns (official players vs thumbnail+Custom Tabs vs constrained platform WebView slot)
  • Gesture / lifecycle pitfalls next to a horizontally swipeable Reader (PageView)
  • Licensing / ToS constraints that would force thumbnail+external open instead of inline play

Capture findings under docs/research/ and link them from the resolution.

Part of #30 ## Question How should a Flutter Android app embed **YouTube** and **Vimeo** (v1 only) inside a `flutter_html`-based Reader without making WebView the primary article renderer? Cover: - Detecting embeds from common HTML shapes (iframe `src`, YouTube/Vimeo URLs in links) - Recommended packages or patterns (official players vs thumbnail+Custom Tabs vs constrained platform WebView slot) - Gesture / lifecycle pitfalls next to a horizontally swipeable Reader (`PageView`) - Licensing / ToS constraints that would force thumbnail+external open instead of inline play Capture findings under `docs/research/` and link them from the resolution.
TheAnachronism commented 2026-08-03 15:42:16 +00:00
Author
Owner
Copy link

Resolution

Gist: Keep flutter_html as the Reader; detect allowlisted YouTube/Vimeo iframe/href shapes into an EmbedRef; default UX is poster + play → url_launcher (Custom Tabs/external). Do not enable wholesale flutter_html_iframe. Optional later inline = one constrained webview_flutter slot loading the official embed URL (provider chrome) only after tap, disposed on PageView leave, with external fallback. Prefer youtube_player_iframe URL/thumbnail helpers over youtube_player_flutter custom overlays (ToS + gesture risk). Vimeo: preserve h=; domain allowlists often force external open.

Doc: docs/research/youtube-vimeo-embeds.md on branch research/youtube-vimeo-embeds (commit 913e3d9).

Hands off to #35 Grill: YouTube/Vimeo embed UX in swipeable Reader. No production Reader code in this ticket.

## Resolution **Gist:** Keep `flutter_html` as the Reader; detect allowlisted YouTube/Vimeo iframe/`href` shapes into an `EmbedRef`; default UX is **poster + play → `url_launcher` (Custom Tabs/external)**. Do **not** enable wholesale `flutter_html_iframe`. Optional later inline = one constrained `webview_flutter` slot loading the **official** embed URL (provider chrome) only after tap, disposed on `PageView` leave, with external fallback. Prefer `youtube_player_iframe` URL/thumbnail helpers over `youtube_player_flutter` custom overlays (ToS + gesture risk). Vimeo: preserve `h=`; domain allowlists often force external open. **Doc:** [`docs/research/youtube-vimeo-embeds.md`](https://git.anachronis.dev/TheAnachronism/tt-rss-viewer/src/branch/research/youtube-vimeo-embeds/docs/research/youtube-vimeo-embeds.md) on branch `research/youtube-vimeo-embeds` (commit `913e3d9`). Hands off to [#35 Grill: YouTube/Vimeo embed UX in swipeable Reader](https://git.anachronis.dev/TheAnachronism/tt-rss-viewer/issues/35). No production Reader code in this ticket.
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
master
beta/0.0.4
beta/0.0.3
beta/0.0.2
beta/0.0.1
alpha/0.0.2
Labels
Clear labels   
needs-info
Waiting on reporter for more information

  
needs-triage
Maintainer needs to evaluate this issue

  
ready-for-agent
Fully specified, ready for an AFK agent

  
ready-for-human
Requires human implementation

  
wayfinder:grilling
HITL grilling/decision ticket

  
wayfinder:map
Wayfinder effort map

  
wayfinder:prototype
HITL prototype ticket

  
wayfinder:research
AFK research ticket

  
wayfinder:task
Unblocking manual task ticket

  
wontfix
Will not be actioned

No labels
needs-info
needs-triage
ready-for-agent
ready-for-human
wayfinder:grilling
wayfinder:map
wayfinder:prototype
wayfinder:research
wayfinder:task
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
TheAnachronism
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
TheAnachronism/tt-rss-viewer#32
No description provided.