Pinchflat
Pinchflat is a lightweight, self-contained YouTube media manager for homelab users that automatically downloads and organizes video content into local…
Platform availability
Available on 5 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel
- ZimaOS
- Proxmox
- 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.
66/100 Good
- Maintained
- 39last commit 340 days ago
- Popular
- 755,467 GitHub stars
- Easy to install
- 755 install platforms, install notes, Docker image
- Light to run
- No data
- Security check
- 100no serious findings, CI, tests
Based on 4 of 5 factors.
Availability: platform listings confirmed today, links checked 3 days ago
- GitHub stars
- 5,467
- Open issues
- 218
- Last commit
- 2025-12-16
- Latest release
- v2025.9.26
- License
- AGPL-3.0
- Activity
- stale
Checked 6 days ago - source: GitHub (kieraneglin/pinchflat)
Resources & Compatibility
Requirements not published yet.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Map port 8945 and storage folders Start the app with -p 8945:8945 so you can open Pinchflat in a browser. Also map /config and /downloads to real folders on your machine; otherwise your settings and downloaded files can be lost when the app is recreated. source
- Set a username and password Set BASIC_AUTH_USERNAME and BASIC_AUTH_PASSWORD in the Docker command if you are using basic auth. This protects the app and its media or feeds from strangers who can reach your open port. source
- Set your local timezone Set -e TZ to your time zone, for example TZ=America/New_York. It keeps logs, dates, and download records in the time you expect instead of UTC. source
Fetched 53 days ago - each note links to its source
Variants
Alternatives (1)
- Tubesync - TubeSync is a personal video recorder for YouTube that automatically downloads channels and playlists to local directories and updates your…
Checked 54 days ago - source: AlternativeTo
Common questions
Which Docker port and folders must I map?
Map the app with -p 8945:8945 and bind /config and /downloads to real folders on the host. Without the volume mappings, settings and downloaded files can be lost when the container is recreated.
How do I protect the web UI if the port is reachable?
Set BASIC_AUTH_USERNAME and BASIC_AUTH_PASSWORD to enable basic auth. This protects the app, media, and feeds from strangers who can reach the open port.
How do I stop logs and download records from using UTC?
Set the container environment variable TZ to your local timezone, for example TZ=America/New_York.
What should I expect about stability and updates?
Pinchflat is a pre-release, so things can change and may break. The README says to use it at your own risk.
Does Pinchflat play videos in the web interface?
No, it downloads content to disk rather than being for in-app consumption. You are expected to watch the files with a media center app or VLC.
Answers sourced from context7.com, github.com
Community
- Pinchflat (a new YouTube media manager) is out of alpha! - Reddit (reddit)
- Pinchflat - YouTube Content Downloader - discussion.scottibyte.com (forum)
- Introducing Pinchflat - a new YouTube media manager (in alpha) (reddit)
- Pinchflat: YouTube media manager issue - Channels Community (other)
- Jellyfin and Pinchflat (forum)
Collected 49 days ago - public community threads