Pinchflat

Pinchflat is a lightweight, self-contained YouTube media manager for homelab users that automatically downloads and organizes video content into local…

  • Backup
  • Downloaders
  • Media Applications
  • Media Servers
  • Tools & Utilities
Pinchflat is a lightweight, self-contained YouTube media manager for homelab users that automatically downloads and organizes video content into local libraries, though it remains a pre-release and may change.

Platform availability

Available on 5 of 10 platforms

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

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

Collected 49 days ago - public community threads