# Pinchflat

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. It is open source and self-hosted, installable on Proxmox, ZimaOS, Unraid and Umbrel.

Canonical page: https://ourlocalhost.com/app/3188/pinchflat

## Description

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: Unraid, Umbrel, ZimaOS, Proxmox, Any server.

## Health score

66/100 (Good), based on 4 of 5 factors.
- Maintained: 39 (last commit 340 days ago)
- Popular: 75 (5,467 GitHub stars)
- Easy to install: 75 (5 install platforms, install notes, Docker image)
- Security check: 100 (no serious findings, CI, tests)

## Links

- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=pinchflat
- ZimaOS: https://github.com/IceWhaleTech/CasaOS-AppStore/tree/main/Apps/Pinchflat
- Unraid: https://ca.unraid.net/apps/pinchflat-0gemfy50zvtrpd?q=Pinchflat
- Umbrel: https://apps.umbrel.com/app/pinchflat
- GitHub: https://github.com/kieraneglin/pinchflat

## 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.

## Alternatives

- Tubesync: TubeSync is a personal video recorder for YouTube that automatically downloads channels and playlists to local directories and updates your…

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