From b467d582aa7435c9123b76204fd7521e3db0d896 Mon Sep 17 00:00:00 2001 From: Priveetee Date: Sun, 19 Jul 2026 15:50:10 +0200 Subject: [PATCH 1/3] docs: document TypeType 1.1 playback features --- docs/.vitepress/config.mts | 2 +- docs/guide/library.md | 3 ++- docs/guide/watching.md | 14 ++++++++++++++ 3 files changed, 17 insertions(+), 2 deletions(-) diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 2e7ddba..745996d 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -25,7 +25,7 @@ export default withMermaid({ text: "Version", items: [ { text: "latest", link: "/" }, - { text: "1.0", link: "/" }, + { text: "1.1", link: "/" }, ], }, { diff --git a/docs/guide/library.md b/docs/guide/library.md index 4428905..5312aee 100644 --- a/docs/guide/library.md +++ b/docs/guide/library.md @@ -36,7 +36,8 @@ You can clear it whenever you want, see [Privacy & blocking](./privacy#your-data ## Watch later Send a video to **Watch later** to come back to it, a simple queue separate from your -playlists. +playlists. Open a video's actions menu and select **Save to Watch later** to add it +immediately; select **Remove from Watch later** from the same menu to remove it. ## Favorites diff --git a/docs/guide/watching.md b/docs/guide/watching.md index fc2065e..1f266fe 100644 --- a/docs/guide/watching.md +++ b/docs/guide/watching.md @@ -70,6 +70,20 @@ On a touch screen: When enabled, the next video starts automatically when the current one ends. Toggle it in [Settings](./settings#playback). +## Livestreams + +YouTube livestreams use TypeType's native SABR player. The player follows the live +edge automatically, keeps buffering ahead during short network interruptions, and +allows seeking within the DVR window when the stream provides one. Quality and audio +track controls remain available during live playback. + +## Embedded player + +Embed a YouTube video with `/embed/VIDEO_ID` on your instance. The `t`, `start`, and +`time_continue` parameters accept seconds or values such as `1h30m`; add `autoplay=1` +to request autoplay. Framed playback requires guest access to be enabled on the +instance. + ## Shorts Shorts play in a dedicated vertical, swipeable player. You can turn the Shorts surface From 40835c1074b35144074c8fdb2c0fab14ba0e819b Mon Sep 17 00:00:00 2001 From: Priveetee Date: Sun, 19 Jul 2026 16:44:31 +0200 Subject: [PATCH 2/3] docs: clarify live playback scope --- docs/guide/watching.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/guide/watching.md b/docs/guide/watching.md index 1f266fe..1a20175 100644 --- a/docs/guide/watching.md +++ b/docs/guide/watching.md @@ -74,8 +74,7 @@ in [Settings](./settings#playback). YouTube livestreams use TypeType's native SABR player. The player follows the live edge automatically, keeps buffering ahead during short network interruptions, and -allows seeking within the DVR window when the stream provides one. Quality and audio -track controls remain available during live playback. +allows seeking within the DVR window when the stream provides one. ## Embedded player From fe3e85701fcc389a114ff98c2a94fd134aaf0fa5 Mon Sep 17 00:00:00 2001 From: Priveetee Date: Sun, 19 Jul 2026 17:04:35 +0200 Subject: [PATCH 3/3] docs: expand embedded player guide --- docs/.vitepress/config.mts | 1 + docs/guide/embedding.md | 76 ++++++++++++++++++++++++++++++++++++++ docs/guide/watching.md | 7 ++-- 3 files changed, 80 insertions(+), 4 deletions(-) create mode 100644 docs/guide/embedding.md diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 745996d..f946001 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -81,6 +81,7 @@ export default withMermaid({ items: [ { text: "Overview", link: "/guide/" }, { text: "Watching & the player", link: "/guide/watching" }, + { text: "Embedded player", link: "/guide/embedding" }, { text: "Your library", link: "/guide/library" }, { text: "Finding content", link: "/guide/finding-content" }, { text: "Signing in", link: "/guide/accounts" }, diff --git a/docs/guide/embedding.md b/docs/guide/embedding.md new file mode 100644 index 0000000..046df8b --- /dev/null +++ b/docs/guide/embedding.md @@ -0,0 +1,76 @@ +# Embedded player + +TypeType provides a dedicated player route for embedding YouTube videos without the +rest of the watch page. + +## URL format + +Use the YouTube video identifier after `/embed/`: + +```text +https://your-instance.example/embed/VIDEO_ID +``` + +The identifier is the 11-character value after `v=` in a regular YouTube watch URL. +For example, `https://www.youtube.com/watch?v=dQw4w9WgXcQ` becomes +`/embed/dQw4w9WgXcQ`. + +## Start position and autoplay + +| Parameter | Value | Behavior | +| --- | --- | --- | +| `t` | Seconds or a duration | Start position | +| `start` | Seconds or a duration | Alias for `t` | +| `time_continue` | Seconds or a duration | Invidious-compatible alias for `t` | +| `autoplay` | `1` | Request autoplay | + +Durations can combine hours, minutes, and seconds, such as `1h30m15s`. When several +start parameters are present, TypeType uses `t`, then `start`, then `time_continue`. +Invalid or negative values start from the beginning. + +```text +/embed/dQw4w9WgXcQ?t=90 +/embed/dQw4w9WgXcQ?start=1m30s +/embed/dQw4w9WgXcQ?time_continue=45&autoplay=1 +``` + +Autoplay remains subject to the browser's media policy. A browser can require a user +gesture before starting audio. + +## Add an iframe + +```html + +``` + +Give the iframe an explicit responsive size in the surrounding page. For example: + +```css +.video-embed { + width: 100%; + aspect-ratio: 16 / 9; + border: 0; +} +``` + +Add `class="video-embed"` to the iframe when using this example. + +## Accounts, settings, and guest access + +Opening an embed URL directly in a browser tab can reuse the current TypeType account +and player settings. Inside an iframe, playback is anonymous and does not read the +embedding site's TypeType session or settings. + +The instance must therefore allow guest access for iframe playback. An administrator +can enable **Allow guest mode** from the TypeType administration settings. When guest +access is disabled, the embed shows a dedicated message with a link to the normal +watch page instead of attempting playback. + +The embed also shows the same unavailable, scheduled, and members-only states as the +watch page. Temporary loading failures provide a retry action when retrying is safe. diff --git a/docs/guide/watching.md b/docs/guide/watching.md index 1a20175..05dfc06 100644 --- a/docs/guide/watching.md +++ b/docs/guide/watching.md @@ -78,10 +78,9 @@ allows seeking within the DVR window when the stream provides one. ## Embedded player -Embed a YouTube video with `/embed/VIDEO_ID` on your instance. The `t`, `start`, and -`time_continue` parameters accept seconds or values such as `1h30m`; add `autoplay=1` -to request autoplay. Framed playback requires guest access to be enabled on the -instance. +TypeType provides a dedicated route for embedding YouTube videos. See +[Embedded player](./embedding) for the URL format, parameters, iframe markup, and guest +access requirements. ## Shorts