Deploy Now

Stars

5,413

Forks

184

Watchers

22

Developer links

Pinchflat

Archiving YouTube channels and playlists into a local media server becomes effortless with Pinchflat, a self-hosted media manager that automates downloading, naming, and organizing online video and audio libraries on disk. Instead of manually copying links into command-line downloaders, you define reusable Media Profiles with presets tailored for Plex, Jellyfin, Kodi, or raw archival storage, and then attach any number of YouTube channels or playlists as monitored sources. Fast Indexing polls RSS feeds or the YouTube API to detect newly published uploads within minutes while falling back to scheduled full scans so back-catalog videos are never missed. Granular source rules let you include or exclude YouTube Shorts and livestreams, filter titles by keyword patterns, enforce earliest upload cutoff dates, and set automatic retention windows that prune older files after a configured number of days. Built-in SponsorBlock integration marks or strips sponsor segments and embeds chapters alongside thumbnails, subtitles, and NFO metadata files so episodes appear cleanly inside your home theater library. You can also schedule Delayed Redownloads a few days after initial publication to capture higher-bitrate transcodes or crowd-sourced SponsorBlock tags, supply browser cookies for private playlists, and subscribe to any archived source in mobile podcast players through generated RSS feeds. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. AGPL-3.0 licensed.

Pinchflat
Pinchflat
Pinchflat
Pinchflat
Pinchflat
Pinchflat

Benefits

  • Turnkey Plex, Jellyfin, and Kodi Presets
  • Formats output directories, MP4 containers, episode thumbnails, subtitles, and NFO metadata files automatically so home media centers recognize YouTube channels as structured television series.
  • Hybrid Fast RSS and Full Indexing
  • Combines rapid RSS and YouTube Data API polling for newly published uploads with periodic yt-dlp full-channel scans, detecting fresh videos quickly without hitting rate limits.
  • Automated SponsorBlock and Delayed Redownloads
  • Embeds or removes SponsorBlock chapters on download and optionally re-fetches recent uploads after a configurable delay to capture upgraded video streams and updated community segment tags.
  • Built-In Podcast RSS Feed Server
  • Generates subscribable XML podcast feeds for any video or audio-only source, allowing standard mobile podcast clients to stream or download archived channels directly from your server.

Features

  • Customizable Media Profiles
  • Configures video resolution caps, audio-only extraction, subtitle languages, output path templates, and custom yt-dlp flags across reusable profile presets.
  • Shorts and Livestream Filtering
  • Provides per-source toggles to skip or include YouTube Shorts and livestreams alongside title keyword filters, minimum duration rules, and upload cutoff dates.
  • Retention and Auto-Cleanup Rules
  • Deletes downloaded media files from disk automatically after a set age window while recording indexed video IDs so expired episodes are not re-downloaded.
  • Cookie Authentication Support
  • Accepts uploaded Netscape cookie files to authenticate yt-dlp requests for private playlists, age-restricted videos, and member-accessible channel feeds.
  • Apprise and Script Hooks
  • Sends download completion alerts through Apprise-compatible notification services and triggers custom post-processing shell scripts after media is saved or deleted.

Apps Similar to Pinchflat