feat: Add initial support for YouTube clip links by radmorecameron · Pull Request #9532 · FreeTubeApp/FreeTube

radmorecameron · 2026-07-29T23:40:55Z

Pull Request Type

Feature Implementation

Related issue

#4323

Description

This PR adds initial support for clip links.

Testing

Enter https://www.youtube.com/clip/UgkxxPM3BRphCAPLP88YoUGuj79KXPfpNNO_ into top nav url
Get redirected to the correct video at the correct time stamp (end timestamp + clip title are parsed but currently not displayed)

Desktop

OS: Fedora Linux
OS Version: 42
FreeTube version: latest nightly

github-actions · 2026-08-11T19:52:46Z

This pull request has conflicts, please resolve those before we can evaluate the pull request.

github-actions · 2026-08-24T22:00:17Z

Conflicts have been resolved. A maintainer will review the pull request shortly.

efb4f5ff-1298-471a-8973-3d47447115dc · 2026-08-26T17:42:51Z

Can be undrafted :)

Shadorc · 2026-08-29T09:12:39Z

Navigating to the URL with Invidious API throws too

Co-authored-by: Cameron Radmore <radmorecameron@gmail.com>

radmorecameron · 2026-09-01T03:10:04Z

Both the Invidious and local api should be working now. Issue was a mix of typo + updating the name of a param in my YouTube.js PR and forgetting to reflect that change here.

absidue · 2026-09-01T15:15:30Z

+  const parsedParams = ClipParams.decode(Utils.base64ToU8(decodeURIComponent(clipResponse.payload.params)))
+
+  return {
+    videoId,
+    startTime: parsedParams.clipParamData.startTime / 1000, // convert to seconds
+    endTime: parsedParams.clipParamData.endTime / 1000, // convert to seconds
+    clipTitle: parsedParams.clipParamData.clipTitle,
+    clipMetadata: parsedParams.clipParamData.clipMetadata
+  }


As this section of the code is the same for the local and Invidious APIs apart from where the video ID and params string is read from, could you please extract it into a shared function that takes the video ID and params text as the input, decodes it and returns the object.

I created a new shared.js file in the api folder. I felt like the current utils.js wasn't a great fit for this shared code since it wouldn't have much use outside of the local.js and invidious.js files.

Shadorc

Tested with local API, Invidious API and SUPPORTS_LOCAL_API set to false

* development: (46 commits) Translated using Weblate (Azerbaijani) Translated using Weblate (Japanese) Translated using Weblate (Hungarian) Translated using Weblate (Estonian) Translated using Weblate (Turkish) Translated using Weblate (Czech) Translated using Weblate (Portuguese (Brazil)) Translated using Weblate (French) Translated using Weblate (Chinese (Simplified Han script)) feat: Add initial support for YouTube clip links (FreeTubeApp#9532) Show 'Premiere' instead of 'Live' for premieres (FreeTubeApp#9795) Bump the stylelint group across 1 directory with 3 updates (FreeTubeApp#9777) Translated using Weblate (Estonian) Add handling for `/show/` urls (FreeTubeApp#9788) Translated using Weblate (Portuguese (Brazil)) Feature/drag drop improve (FreeTubeApp#9591) cleanup leftover from workflow removal (FreeTubeApp#9792) Translated using Weblate (Icelandic) Translated using Weblate (Azerbaijani) Bump vue-router from 5.3.0 to 5.3.1 (FreeTubeApp#9779) ... # Conflicts: # pnpm-lock.yaml # src/renderer/views/Playlist/Playlist.vue

* development: Translated using Weblate (Azerbaijani) Translated using Weblate (Japanese) Translated using Weblate (Hungarian) Translated using Weblate (Estonian) Translated using Weblate (Turkish) Translated using Weblate (Czech) Translated using Weblate (Portuguese (Brazil)) Translated using Weblate (French) Translated using Weblate (Chinese (Simplified Han script)) feat: Add initial support for YouTube clip links (#9532) Show 'Premiere' instead of 'Live' for premieres (#9795) Bump the stylelint group across 1 directory with 3 updates (#9777) Translated using Weblate (Estonian) Add handling for `/show/` urls (#9788) Translated using Weblate (Portuguese (Brazil)) Feature/drag drop improve (#9591) cleanup leftover from workflow removal (#9792) Translated using Weblate (Icelandic) Translated using Weblate (Azerbaijani) Bump vue-router from 5.3.0 to 5.3.1 (#9779) # Conflicts: # pnpm-lock.yaml

github-actions Bot added the PR: waiting for review For PRs that are complete, tested, and ready for review label Jul 29, 2026

FreeTubeBot enabled auto-merge (squash) July 29, 2026 23:41

radmorecameron commented Jul 29, 2026

View reviewed changes

Comment thread src/renderer/helpers/api/local.js Outdated

radmorecameron marked this pull request as draft July 29, 2026 23:43

auto-merge was automatically disabled July 29, 2026 23:43
Pull request was converted to draft

github-actions Bot removed the PR: waiting for review For PRs that are complete, tested, and ready for review label Jul 29, 2026

radmorecameron force-pushed the add-initial-support-for-clip-links branch from 613257f to 1644ed0 Compare August 2, 2026 20:03

radmorecameron mentioned this pull request Aug 2, 2026

fix: make clip api less expensive iv-org/invidious#5871

Closed

2 tasks

radmorecameron marked this pull request as ready for review August 2, 2026 20:35

radmorecameron requested review from PikachuEXE and absidue as code owners August 2, 2026 20:35

github-actions Bot added the PR: waiting for review For PRs that are complete, tested, and ready for review label Aug 2, 2026

FreeTubeBot enabled auto-merge (squash) August 2, 2026 20:35

radmorecameron mentioned this pull request Aug 2, 2026

feat(protos): Add ClipParams LuanRT/YouTube.js#1215

Merged

radmorecameron marked this pull request as draft August 2, 2026 22:43

auto-merge was automatically disabled August 2, 2026 22:43
Pull request was converted to draft

github-actions Bot removed the PR: waiting for review For PRs that are complete, tested, and ready for review label Aug 2, 2026

github-actions Bot added the PR: merge conflicts / rebase needed label Aug 11, 2026

radmorecameron force-pushed the add-initial-support-for-clip-links branch from 2dba6f2 to 9d63ca8 Compare August 24, 2026 22:00

github-actions Bot removed the PR: merge conflicts / rebase needed label Aug 24, 2026

radmorecameron added 3 commits August 26, 2026 18:49

Add initial support for clip links

36f7eaf

add link to Invidious PR to make clip api endpoint less expensive.

091e8bd

Parse params for clips using ClipParams from YouTube.js

9f06cb5

radmorecameron force-pushed the add-initial-support-for-clip-links branch from 9d63ca8 to 9f06cb5 Compare August 26, 2026 22:49

radmorecameron marked this pull request as ready for review August 26, 2026 22:51

github-actions Bot added the PR: waiting for review For PRs that are complete, tested, and ready for review label Aug 26, 2026

FreeTubeBot enabled auto-merge (squash) August 26, 2026 22:52

radmorecameron added the PR: waiting for review For PRs that are complete, tested, and ready for review label Aug 28, 2026

radmorecameron requested a review from efb4f5ff-1298-471a-8973-3d47447115dc August 28, 2026 19:32

radmorecameron commented Aug 30, 2026

View reviewed changes

Comment thread src/renderer/helpers/api/invidious.js Outdated

Comment thread src/renderer/helpers/api/invidious.js Outdated

Comment thread src/renderer/helpers/api/invidious.js Outdated

Comment thread src/renderer/helpers/api/invidious.js Outdated

radmorecameron added 2 commits August 30, 2026 08:00

fix invidious

9675e80

Co-authored-by: Cameron Radmore <radmorecameron@gmail.com>

Fix invidious for real

755a46d

absidue reviewed Sep 1, 2026

View reviewed changes

efb4f5ff-1298-471a-8973-3d47447115dc added PR: changes requested and removed PR: waiting for review For PRs that are complete, tested, and ready for review labels Sep 1, 2026

Move ClipParams parsing to new shared.js file

5c7f8b6

radmorecameron requested a review from absidue September 9, 2026 01:58

radmorecameron added PR: waiting for review For PRs that are complete, tested, and ready for review and removed PR: changes requested labels Sep 9, 2026

Shadorc previously approved these changes Sep 10, 2026

View reviewed changes

absidue requested changes Sep 10, 2026

View reviewed changes

Comment thread src/renderer/helpers/api/shared.js Outdated

efb4f5ff-1298-471a-8973-3d47447115dc added PR: changes requested and removed PR: waiting for review For PRs that are complete, tested, and ready for review labels Sep 10, 2026

Use ESM import

b82e3a8

radmorecameron dismissed Shadorc’s stale review via b82e3a8 September 13, 2026 00:41

Shadorc approved these changes Sep 13, 2026

View reviewed changes

efb4f5ff-1298-471a-8973-3d47447115dc approved these changes Sep 13, 2026

View reviewed changes

efb4f5ff-1298-471a-8973-3d47447115dc added PR: waiting for review For PRs that are complete, tested, and ready for review and removed PR: changes requested labels Sep 13, 2026

radmorecameron requested a review from absidue September 13, 2026 20:54

absidue approved these changes Sep 14, 2026

View reviewed changes

FreeTubeBot merged commit 48ca7a0 into FreeTubeApp:development Sep 14, 2026
5 checks passed

github-actions Bot removed the PR: waiting for review For PRs that are complete, tested, and ready for review label Sep 14, 2026

Navigation Menu

Uh oh!

feat: Add initial support for YouTube clip links - #9532

feat: Add initial support for YouTube clip links#9532
FreeTubeBot merged 8 commits into
FreeTubeApp:developmentfrom
radmorecameron:add-initial-support-for-clip-links

radmorecameron commented Jul 29, 2026 •

edited

Loading

Uh oh!

Uh oh!

github-actions Bot commented Aug 11, 2026

Uh oh!

github-actions Bot commented Aug 24, 2026

Uh oh!

efb4f5ff-1298-471a-8973-3d47447115dc commented Aug 26, 2026

Uh oh!

Shadorc commented Aug 29, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

radmorecameron commented Sep 1, 2026

Uh oh!

absidue Sep 1, 2026

Uh oh!

radmorecameron Sep 9, 2026

Uh oh!

Uh oh!

Shadorc left a comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Uh oh!

Conversation

radmorecameron commented Jul 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Pull Request Type

Related issue

Description

Testing

Desktop

Uh oh!

Uh oh!

github-actions Bot commented Aug 11, 2026

Uh oh!

github-actions Bot commented Aug 24, 2026

Uh oh!

efb4f5ff-1298-471a-8973-3d47447115dc commented Aug 26, 2026

Uh oh!

Shadorc commented Aug 29, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

radmorecameron commented Sep 1, 2026

Uh oh!

absidue Sep 1, 2026

Choose a reason for hiding this comment

Uh oh!

radmorecameron Sep 9, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Shadorc left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

radmorecameron commented Jul 29, 2026 •

edited

Loading