# CleanCast

CleanCast is a self-hosted Go application that converts YouTube-hosted podcasts into audio-only RSS feeds, automatically removing sponsored segments. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2194/cleancast

## Description

CleanCast is a self-hosted Go application that converts YouTube-hosted podcasts into audio-only RSS feeds, automatically removing sponsored segments. Episodes are downloaded from YouTube on demand, making it useful for self-hosters who want ad-free, RSS-compatible podcast feeds.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

47/100 (Fair), based on 4 of 5 factors.
- Maintained: 78 (last commit 38 days ago)
- Popular: 42 (118 GitHub stars)
- Easy to install: 20 (1 install platform, Docker image)
- Security check: 20 (1 serious finding, 3 minor, CI, tests)

## Security check

1 serious finding: Uses github.com/labstack/echo/v4 v4.16.0, which has a known critical vulnerability.
Automated checks on commit d43adfc, 9 Nov 2026. Not an audit.

## Links

- Docker Hub: https://hub.docker.com/r/ikoyhn/clean-cast
- Unraid: https://ca.unraid.net/apps/cleancast-19goba317zoegn?q=CleanCast

## Common questions

### What Docker configuration is needed to run CleanCast?

Run the Docker image with a GOOGLE_API_KEY environment variable and a /config volume, and copy properties.yml into /config for settings such as NTFY. The example exposes port 8080, and you should restart the app after changing properties.yml.

### How are CleanCast podcast episodes delivered to podcast apps?

Episodes are downloaded on demand from YouTube when a user requests a specific episode, then the audio is served to the user.

### How can I reduce YouTube API quota usage when using the channel endpoint?

Add the date=MM-DD-YYYY URL parameter to the channel feed. This gives an RSS feed of videos published after that date.

### What should I test if a podcast app such as Pocket Casts cannot connect to CleanCast?

Connect directly to the CleanCast instance over LAN. This can rule out reverse proxy or Cloudflare-related issues.

---
Source: Our Local Host (https://ourlocalhost.com/app/2194/cleancast), the self-hosted and open-source app directory.
