Repository files navigation

ChannelTube is a tool for synchronizing and fetching content from YouTube channels using yt-dlp.

services:channeltube:image:thewicklowwolf/channeltube:latestcontainer_name:channeltubevolumes:      -/path/to/config:/channeltube/config      -/data/media/video:/channeltube/downloads      -/data/media/audio:/channeltube/audio_downloads      -/etc/localtime:/etc/localtime:roports:      -5000:5000restart:unless-stopped

Certain values can be set via environment variables:

• PUID: The user ID to run the app with. Defaults to1000.
• PGID: The group ID to run the app with. Defaults to1000.
• video_format_id: Specifies the ID for the video format. The default value is137.
• audio_format_id: Specifies the ID for the audio format. The default value is140.
• defer_hours: Defines the time to defer in hours. The default value is0.
• thread_limit: Sets the maximum number of threads to use. The default value is1.
• fallback_vcodec: Specifies the fallback video codec to use. Defaults tovp9.
• fallback_acodec :Specifies the fallback audio codec to use. Defaults tomp4a.
• subtitles: Controls subtitle handling. Options:none,embed,external. Defaults tonone.
• subtitle_languages: Comma-separated list of subtitle languages to include. Defaults toen.
• include_id_in_filename: Include Video ID in filename. Set totrue orfalse. Defaults tofalse.
• verbose_logs: Enable verbose logging. Set totrue orfalse. Defaults tofalse.

For information on format IDs, refer tohttps://github.com/yt-dlp/yt-dlp

Use a comma-separated list of hours to search for new items (e.g.2, 20 will initiate a search at 2 AM and 8 PM).

Note: There is a deadband of up to 10 minutes from the scheduled start time.

A media server library scan can be triggered when new content is retrieved.

For Plex, use:Plex: http://192.168.1.2:32400
For Jellyfin, use:Jellyfin: http://192.168.1.2:8096
To use both, enter:Plex: http://192.168.1.2:32400, Jellyfin: http://192.168.1.2:8096
The same format applies for the tokens.

TheMedia Server Library Name refers to the name of the library where the videos are stored.

To disable this feature:

• LeaveMedia Server Addresses,Media Server Tokens andMedia Server Library Name blank.

To utilize a cookies file with yt-dlp, follow these steps:

• Generate Cookies File: Open your web browser and use a suitable extension (e.g. cookies.txt for Firefox) to extract cookies for a user on YT.

• Save Cookies File: Save the obtained cookies into a file namedcookies.txt and put it into the config folder.

https://hub.docker.com/r/thewicklowwolf/channeltube