Home

Welcome to the Pinchflat docs! Check out the sidebar to get help on specific topics

What it does

Pinchflat is a self-hosted app for downloading YouTube content built using yt-dlp. It's designed to be lightweight, self-contained, and easy to use. You set up rules for how to download content from YouTube channels or playlists and it'll do the rest, checking periodically for new content. It's perfect for people who want to download content for use in with a media center app (Plex, Jellyfin, Kodi) or for those who want to archive media!

It's not great for downloading one-off videos - it's built to download large amounts of content and keep it up to date. It's also not meant for consuming content in-app - Pinchflat downloads content to disk where you can then watch it with a media center app or VLC.

If it doesn't work for your use case, please make a feature request! You can also check out these great alternatives: Tube Archivist, ytdl-sub, and TubeSync

Features

• Self-contained - just one Docker container with no external dependencies
• Powerful naming system so content is stored where and how you want it
• Easy-to-use web interface with presets to get you started right away
• First-class support for media center apps like Plex, Jellyfin, and Kodi
• Automatically downloads new content from channels and playlists
  • Uses a novel approach to download new content more quickly than other apps
• Supports downloading audio content
• Custom rules for handling YouTube Shorts and livestreams
• Advanced options like setting cutoff dates and filtering by title
• Reliable hands-off operation