tubearchivist/docs
1
0
Fork 0
mirror of https://github.com/tubearchivist/docs.git synced 2024-11-15 00:20:12 +00:00
Code Issues Packages Projects Releases Wiki Activity
9e3a452aaa
docs/mkdocs/docs/urls.md
Simon c9c901f032
Consolidate links to separate page 
closes #7
2023-07-30 23:05:01 +07:00

2.2 KiB
Raw Blame History

description
How URLs from YouTube get parsed

URLs

This document describes how Tube Archivist identifies and treats links from YouTube.

!!! note Application logic of Tube Archivist is tied only to the IDs, not the names.

Video

A video ID is 11 characters long, e.g. 2tdiKTSdE9Y.

Urls can have several forms:

  • Watch URL: Regular URLs so will see while browsing YouTube, with the path /watch and a v parameter, e.g. https://www.youtube.com/watch?v=2tdiKTSdE9Y
  • Share URL: Link you will get when you click on share on a video, e.g. https://youtu.be/2tdiKTSdE9Y
  • Shorts URL: e.g. https://www.youtube.com/shorts/U80grnZJm_8

Channel

A channel ID is 24 characters long, e.g. UCBa659QWEk1AI4Tg--mrJ2A.

Channel URLs can have these forms, all will get translated to the ID:

  • ID URL: With a channel path, e.g. https://www.youtube.com/channel/UCBa659QWEk1AI4Tg--mrJ2A
  • Channel Handle: Starting with a @ this handle is personal and unique, e.g. @TomScottGo
  • Alias URL: Based off the channel handle, e.g. https://www.youtube.com/@TomScottGo

Channel sub pages

Tube archivist can separate between different subpages:

  • Videos only: https://www.youtube.com/@IBRACORP/videos
  • Shorts only: https://www.youtube.com/@IBRACORP/shorts
  • Streams only: https://www.youtube.com/@IBRACORP/streams
  • Every other channel sub page will default to download all, for example https://www.youtube.com/@IBRACORP/featured will download videos and shorts and streams.

Playlist

A playlist ID can be 34, 26 or 18 characters long, e.g. PL96C35uN7xGLLeET0dOWaKHkAlPsrkcha

  • Playlist URLs start with a playlist path and has a list parameter, e.g. https://www.youtube.com/playlist?list=PL96C35uN7xGLLeET0dOWaKHkAlPsrkcha

Playlist vs Video URLs

While browsing YouTube videos in Playlists, you might encounter URLs looking like that: https://www.youtube.com/watch?v=QPZ0pIK_wsc&list=PL96C35uN7xGLLeET0dOWaKHkAlPsrkcha. As established above, based on the /watch path and the v parameter, Tube Archivist will treat this as a video with the ID QPZ0pIK_wsc and not as a playlist. If you mean the playlist, you can easily grab the correct ID from the URL, e.g. PL96C35uN7xGLLeET0dOWaKHkAlPsrkcha.