Skip to content

xxd-dev/video

Repository files navigation

xxd video

a minimal version of youtube, without any recommendations

quickstart

  • if you're here to replace your sub-box, go to this link and follow the instructions.
  • if you're here to watch one video free of recommendations, get a valid api key and see watch for reference.
  • if you want to self-host this, get the sourcecode.

components of the website

watch

usage: https://xxd-dev.github.io/video/watch/?api=[YOUR_API_KEY]&v=[VIDEO_ID]
YOUR_API_KEY: youtube enabled api key (look here for help)
VIDEO_ID: video-id (i.e. https://www.youtube.com/watch?v=dQw4w9WgXcQ)
quota cost: 3 points
An interface to view youtube videos. It comes with the usual information and includes the top few comments.

search

usage: https://xxd-dev.github.io/video/search/?api=[YOUR_API_KEY]&search=[SEARCH_QUERY]
YOUR_API_KEY: youtube enabled api key (look here for help)
SEARCH_QUERY: the search-query (URI-encoded, except that spaces become a '+')
quota cost: 102 points
warning: many searches will use up your daily quota quickly!
a youtube search, that will only return videos. a search can be triggered from the search bar present on all other pages.

channel

Usage: htttps://xxd-dev.github.io/video/channel/?api=[YOUR_API_KEY]&c=[CHANNEL_ID]
YOUR_API_KEY: youtube enabled api key (look here for help)
CHANNEL_ID: id of the youtube channel (i.e. https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw)
quota cost: 3 points
a channel view, containing the 50 most recent videos of a channel. reachable by clicking on a channelname or avatar wherever visible.

subscriptions

usage: https://xxd-dev.github.io/video/?api=[YOUR_API_KEY]&subs=[CHANNEL_IDS]&maxv=[MAX_VIDEOS]
YOUR_API_KEY: youtube enabled api key (look here for help)
CHANNEL_IDS: comma-separated list of channel-ids (use subbox generator for help)
MAX_VIDEOS: (optional, default is 50) number of returned videos
quota cost: 1 point per channel + 1 point for each 50 channels + 1 point for each 50 returned videos
warning: many channels/refreshes can use your daily quota quickly!
similar to youtubes subscription page, this shows all recent uploads of your subscribed cannels. for each channel, only the newest 50 videos are reported, but in total you can get however many videos back as you specify in MAX_VIDEOS.
if possible, subscriptions and your api key is saved in local storage after opening the page with the correct parameters. this way, you don't need to pass all parameters to the page, but only open xxd-dev.github.io/video to access your subs.
it is possible to pass rules attached to a channel. these rules are: minimal video length, maximal video length, words needed to be in the title, words to avoid in the title. instead of passing just the channel-id in the comma-separated list, you can pass the id like this:
this UCuAXFkgsw1L7xaCfnd5JJOw[2:00-4:00;Rick;] returns only videos between 2 and 4 minutes including the word "Rick"
this UCuAXFkgsw1L7xaCfnd5JJOw[-4:00;Rick,Astley;Cover] returns all video shorter than 4 minutes, including "Rick" and "Astley" but not "Cover"
this UCuAXFkgsw1L7xaCfnd5JJOw[;;] returns the unfiltered videos equivalent to just UCuAXFkgsw1L7xaCfnd5JJOw

subbox generator

usage: https://xxd-dev.github.io/video/subbox-generator
quota cost: 0 or 1 points per channel
guides you through transferring your youtube subscriptions onto this website.
the parameters for your api key and subs are saved in local storage too. to be safe, the link returned still has all the parameters, but it is theoretically possible to just open xxd-dev.github.io/video directly and see all of your subscriptions.

subbox editor

usage: https://xxd-dev.github.io/video/subbox-generator/?api=[YOUR_API_KEY]&subs=[CHANNEL_IDS]
YOUR_API_KEY: youtube enabled api key (look here for help)
CHANNEL_IDS: comma-separated list of channel-ids (use subbox generator for help)
quota cost: 1 point per channel
lets you edit your subscribed list. this menu is reachable from the subbox, and allows you to add or remove channels, as well as edit rules for them. to see how rules work, see subscriptions for help. after editing, click the save button and bookmark your edited subbox, or let local storage take care of everything.

About

a minimal version of youtube, without any recommendations

Resources

License

Stars

Watchers

Forks