CouchTube

A self-hosted, YouTube based application that recreates the feel of a TV channel.

  • Media Applications
  • Media Servers
  • Other
  • Productivity
  • Tools & Utilities
A self-hosted, YouTube based application that recreates the feel of a TV channel. CouchTube schedules YouTube video playback dynamically from user-defined channel lists. Customize, share, and submit JSON-based playlists to make CouchTube your own!

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

53/100 Fair

Maintained
48last commit 247 days ago
Popular
49267 GitHub stars
Easy to install
302 install platforms, Docker image
Light to run
No data
Security check
90no serious findings, CI

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 23 days ago

GitHub stars
267
Open issues
4
Last commit
2026-03-19
License
GPL-3.0
Activity
stale

Checked 23 days ago - source: GitHub (ozencb/couchtube)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

No first-install notes yet.

Alternatives

No alternatives collected yet.

Common questions

What port does the example Docker deployment expose?

The compose and docker run examples map port 8363 and set PORT to 8363.

Where does CouchTube keep its data?

It uses a SQLite database file specified by DATABASE_FILE_PATH. On first run, it creates couchtube.db at that path.

How can I add my own channel list?

You can submit custom video lists through a JSON file URL. New channel JSON lists can also be added to the default set by pull request.

Are two users likely to see the same video for a channel?

The scheduler aims to distribute videos throughout the day, so two different users should see the same video for a given channel.

What does the initial interface show if no videos are defined?

It shows a welcome page with options to load default videos or go to the editor, and notes that editor mode is disabled.

Answers sourced from couchtube.fly.dev, github.com

Community

Collected 47 days ago - public community threads