Module: YouTube

Allows you to browse and watch the latest videos from a curated list of YouTube channels.

Contributors: anthonycaccese

Features

Browse

• Lists videos via YouTube RSS feeds from your curated list of channels
• Subscriptions View: Browse the latest videos from all of your curated channels in a reverse chronological list
• Channels View: Select a channel to view its latest videos
• Save to Watch Later: Save videos to watch later. This is local to 240-MP (on device only), not associated to any account and the list can be cleared in settings at any time.
• View Watch History: Displays a list of recently watch videos via the module. This is local to 240-MP (on device only), not associated to any account and the list can be cleared in settings at any time.
• Choose if Shorts are displayed while browsing (default is On / can be toggled in Settings > YouTube)

Playback

• Playback is handled via mpv + yt-dl (please keep yt-dl to reduce the chance of errors)
• Resume Playback: Resume from your last playback position or restart from the beginning
• Set Playback Resolution: 480p (default and good for the RaspberryPi), 720p and 1080p

Settings

Option	Values	Info
Enabled	On/Off	Sets if the module should display in the main module list when you start 240-MP.
Playback Resolution	480p (Default), 720p, 1080p	Set the resolution of the video to request for playback. I recommend to keep this on 480p for the Raspberry Pi on a CRT for best performance
Resume Playback	Ask/Always	'Ask' will present you with an option to restart playback or resume and 'Always' will resume without asking
Display Shorts	On/Off	Choose if YouTube shorts should display while browsing Subscriptions and Channels
Delete Watch Later	--	Removes your Watch Later list from youtube_watch_later.json
Delete History	--	Removes your Watch History from youtube_history.json

To Enable

1. Make sure the latest version of yt-dlp is installed (mpv requires this to resolve YouTube URLs at playback time):
   • On Raspberry Pi: sudo apt install yt-dlp
   • On macOS: brew install yt-dlp
2. Create a youtube_subscriptions.txt file in the 240-MP data directory
   • On Raspberry Pi: ~/.local/share/240-MP/youtube_subscriptions.txt
   • On macOS: ~/Library/Application Support/240-MP/youtube_subscriptions.txt
3. And add the channel ID's you'd like to be able to view (one channel ID per line) into that file.
   • Blank lines and lines starting with # are ignored
   • Example:

   UC-2YHgc363EdcusLIBbgxzg
   UCgRaK4A7yi4ZELCLUjdP_pg
   UC3IYhdamzjvEJ9CwkQa4RAw
   

4. Then go to Settings > YouTube and set Enabled to On

Creating youtube_subscriptions.txt

A channel's ID is in the URL of its channel page (youtube.com/channel/<ID>). If the page shows a @handle URL instead, view page source and search for "channelId", or use any handle-to-ID lookup tool.