selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
ChannelTube logo

Self-host ChannelTube

v0.9.10

Scheduled YouTube channel downloader using yt-dlp

BetaOpen SourceGPL-3.0
Updated8 hours ago
LanguagePython
Setup difficultyEasy
Stars
333
Port
5000 (Web UI)
Docker
thewicklowwolf/channeltube
Install with Docker Compose
ChannelTube light theme web interfaceChannelTube dark theme web interface

What is ChannelTube?

ChannelTube is a self-hosted application for downloading content from YouTube channels on a recurring schedule. It uses yt-dlp to fetch videos or audio from specified channels, with configurable format selection, subtitle handling, and automatic yt-dlp updates. The web UI runs on port 5000 for managing channel subscriptions and sync schedules. Optional integration with Plex and Jellyfin triggers library scans when new content arrives. It runs as a Docker container configured via environment variables for user/group IDs, format preferences, threading, and scheduling.

Should you self-host ChannelTube?

ChannelTube scores 47/100 on selfhost.directory (how scoring works) and ranks #31 of 45 in Download Management. It has 333 GitHub stars.

It shipped 16 stable releases in the past year. The latest, v0.9.10, came out on 27 October 2026. New versions land roughly every 5 days.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is cobalt (83/100, 45 586 stars). It scores higher overall, so compare the two before you pick. See ChannelTube vs cobalt side by side.

Features

  • Automatic yt-dlp updates
  • Cookie authentication for yt-dlp
  • Multi-threaded downloads
  • Plex and Jellyfin integration
  • Scheduled YouTube channel downloads
  • Short video filtering
  • Subtitle Handling
  • Video and audio format selection

ChannelTube README

How to install ChannelTube

Install ChannelTube with Docker Compose

services: channeltube: image: thewicklowwolf/channeltube:latest container_name: channeltube volumes: - /path/to/config:/channeltube/config - /data/media/video:/channeltube/downloads - /data/media/audio:/channeltube/audio_downloads - /etc/localtime:/etc/localtime:ro ports: - 5000:5000 restart: unless-stopped

Requires Docker and Docker Compose installed

How to configure ChannelTube

  • audio_format_id140Specifies the ID for the audio format

    Specifies the ID for the audio format

  • auto_update_hourdisabledEnables automatic nightly update of yt-dlp when set to a value between 0 and 23

    Enables automatic nightly update of yt-dlp when set to a value between 0 and 23

    values: 0-23

  • defer_hours0Defines the time to defer in hours

    Defines the time to defer in hours

  • fallback_acodecmp4aSpecifies the fallback audio codec to use

    Specifies the fallback audio codec to use

  • fallback_vcodecvp9Specifies the fallback video codec to use

    Specifies the fallback video codec to use

  • include_id_in_filenamefalseInclude Video ID in filename

    Include Video ID in filename

    values: true, false

  • PGID1000The group ID to run the app with

    The group ID to run the app with

  • PUID1000The user ID to run the app with

    The user ID to run the app with

  • short_video_cutoff180Time-based cutoff (in seconds) used to filter short videos

    Time-based cutoff (in seconds) used to filter short videos

  • subtitle_languagesenComma-separated list of subtitle languages to include

    Comma-separated list of subtitle languages to include

  • subtitlesnoneControls subtitle handling

    Controls subtitle handling

    values: none, embed, external

  • thread_limit1Sets the maximum number of threads to use

    Sets the maximum number of threads to use

  • verbose_logsfalseEnable verbose logging

    Enable verbose logging

    values: true, false

  • video_format_id137Specifies the ID for the video format

    Specifies the ID for the video format

  • ytdlp_update_typestableUpdate type for yt-dlp

    Update type for yt-dlp

    values: stable, nightly

ChannelTube releases & version history

More in Download Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…