Pinchflat

Overview

Pinchflat is your next YouTube media manager **This is a pre-release of Pinchflat. Things will change and may break. Use at your own risk** Pinchflat is a lightweight and self-contained tool for automatically downloading and organizing media from YouTube

Runtime arguments

Web UI: http://[IP]:[PORT:8945]/
Network: bridge
Shell: bash
Privileged: false
Extra Params: --user 99:100

Template configuration

Config PathPathrw

Pinchflat config storage path. Default is /mnt/user/appdata/pinchflat

Target: /config
Default: /mnt/user/appdata/pinchflat
Value: /mnt/user/appdata/pinchflat

Download PathPathrw

Path to store downloaded media. Ideally separate from your other media like TV shows.

Target: /downloads

Web UI PortPorttcp

Pinchflat web UI port. Default is 8945

Target: 8945
Default: 8945
Value: 8945

Auth UsernameVariable

The username for HTTP basic authentication. Leave blank to disable. Default is blank

Target: BASIC_AUTH_USERNAME

Auth PasswordVariable

The password for HTTP basic authentication. Leave blank to disable. Default is blank

Target: BASIC_AUTH_PASSWORD

TimezoneVariable

Your local timezone

Target: TZ
Default: America/New_York

Enable Prometheus MetricsVariable

See docs for more information. Leave blank to disable. Default is blank

Target: ENABLE_PROMETHEUS

UMASKVariable

Default: 000

Log LevelVariable

Set to debug for more verbose logging or when troubleshooting. Default is info

Target: LOG_LEVEL
Default: info

Expose Feed EndpointsVariable

Set to any value to expose feed endpoints. See docs on RSS feeds for explanation. Default is blank

Target: EXPOSE_FEED_ENDPOINTS

Enable IPv6Variable

Set to any non-blank value to enable IPv6. Default is blank

Target: ENABLE_IPV6

yt-dlp Worker ConcurrencyVariable

The number of concurrent workers that use yt-dlp per queue. Set to 1 if you're getting IP limited, otherwise don't touch it

Target: YT_DLP_WORKER_CONCURRENCY
Default: 2

Base route pathVariable

The base path for route generation. Useful when running behind certain reverse proxies

Target: BASE_ROUTE_PATH
Default: /

Links

Template Support Registry Project

Details

Repository

ghcr.io/kieraneglin/pinchflat:latest

Registry

https://github.com/kieraneglin/pinchflat/pkgs/container/pinchflat

Last Updated2026-06-02

First Seen2024-03-25

Run Pinchflat on Unraid.

Pinchflat is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS