[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-73433":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":18,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":22,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":30,"readmeContent":31,"aiSummary":32,"trendingCount":16,"starSnapshotCount":16,"syncStatus":33,"lastSyncTime":34,"discoverSource":35},73433,"pinchflat","kieraneglin\u002Fpinchflat","kieraneglin","Your next YouTube media manager","",null,"Elixir",5008,144,19,200,0,10,30,96,107.08,"GNU Affero General Public License v3.0",false,"master",true,[26,27,28,29],"media","youtube","youtube-dl","yt-dlp","2026-06-12 04:01:09","> [!IMPORTANT]  \n> (2025-02-14) [zakkarry](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fzakkarry), who is a collaborator on [cross-seed](https:\u002F\u002Fgithub.com\u002Fcross-seed\u002Fcross-seed) and an extremely helpful community member in general, is facing hard times due to medical debt and family illness. If you're able, please consider [sponsoring him on GitHub](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fzakkarry) or donating via [buymeacoffee](https:\u002F\u002Ftip.ary.dev). Tell him I sent you!\n\n\u003Cp align=\"center\">  \n  \u003Cimg \n    src=\"priv\u002Fstatic\u002Fimages\u002Foriginals\u002Flogo-white-wordmark-with-background.png\" \n    alt=\"Pinchflat Logo by @hernandito\"\n    width=\"700\" \n  \u002F>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">  \n  \u003Csup>\n    \u003Cem>logo by \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fhernandito\" target=\"_blank\">@hernandito\u003C\u002Fa>\u003C\u002Fem>\n  \u003C\u002Fsup>\n\u003C\u002Fp>\n\n\u003Cdiv align=\"center\">\n\n[![](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fkieraneglin\u002Fpinchflat?style=for-the-badge&color=ee512b)](LICENSE)\n[![](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fkieraneglin\u002Fpinchflat?style=for-the-badge&color=purple)](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Freleases)\n[![](https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?style=for-the-badge&logo=discord&message=Chat&color=5865F2&label=Discord)](https:\u002F\u002Fdiscord.gg\u002Fj7T6dCuwU4)\n[![](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Fkieraneglin\u002Fpinchflat\u002Flint_and_test.yml?style=for-the-badge)](#)\n[![](https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode&style=for-the-badge)](https:\u002F\u002Fvscode.dev\u002Fredirect?url=vscode:\u002F\u002Fms-vscode-remote.remote-containers\u002FcloneInVolume?url=https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat)\n\n\u003C\u002Fdiv>\n\n# Your next YouTube media manager\n\n## Table of contents:\n\n- [What it does](#what-it-does)\n- [Features](#features)\n- [Screenshots](#screenshots)\n- [Installation](#installation)\n  - [Unraid](#unraid)\n  - [Portainer](#portainer)\n  - [Docker](#docker)\n  - [Environment Variables](#environment-variables)\n  - [A note on reverse proxies](#reverse-proxies)\n- [Username and Password (authentication)](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fwiki\u002FUsername-and-Password)\n- [Frequently asked questions](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fwiki\u002FFrequently-Asked-Questions)\n- [Documentation](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fwiki)\n- [EFF donations](#eff-donations)\n- [Pre-release disclaimer](#pre-release-disclaimer)\n- [Development and Contributing](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fwiki\u002FDevelopment-and-Contributing)\n\n## What it does\n\nPinchflat is a self-hosted app for downloading YouTube content built using [yt-dlp](https:\u002F\u002Fgithub.com\u002Fyt-dlp\u002Fyt-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, periodically checking 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!\n\nWhile you can [download individual videos](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fwiki\u002FFrequently-Asked-Questions#how-do-i-download-one-off-videos), Pinchflat is best suited for downloading content from channels or playlists. 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.\n\nIf it doesn't work for your use case, please make a feature request! You can also check out these great alternatives: [Tube Archivist](https:\u002F\u002Fgithub.com\u002Ftubearchivist\u002Ftubearchivist), [ytdl-sub](https:\u002F\u002Fgithub.com\u002Fjmbannon\u002Fytdl-sub), and [TubeSync](https:\u002F\u002Fgithub.com\u002Fmeeb\u002Ftubesync)\n\n## Features\n\n- Self-contained - just one Docker container with no external dependencies\n- Powerful naming system so content is stored where and how you want it\n- Easy-to-use web interface with presets to get you started right away\n- First-class support for media center apps like Plex, Jellyfin, and Kodi ([docs](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fwiki\u002FFrequently-Asked-Questions#how-do-i-get-media-into-plexjellyfinkodi))\n- Supports serving RSS feeds to your favourite podcast app ([docs](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fwiki\u002FPodcast-RSS-Feeds))\n- Automatically downloads new content from channels and playlists\n  - Uses a novel approach to download new content more quickly than other apps\n- Supports downloading audio content\n- Custom rules for handling YouTube Shorts and livestreams\n- Apprise support for notifications\n- Allows automatically redownloading new media after a set period\n  - This can help improve the download quality of new content or improve SponsorBlock tags\n- Optionally automatically delete old content ([docs](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fwiki\u002FAutomatically-Delete-Media))\n- Advanced options like setting cutoff dates and filtering by title ([docs](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fwiki\u002FFrequently-Asked-Questions#i-only-want-certain-videos-from-a-source---how-can-i-only-download-those))\n- Reliable hands-off operation\n- Can pass cookies to YouTube to download your private playlists ([docs](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fwiki\u002FYouTube-Cookies))\n- Sponsorblock integration\n- \\[Advanced\\] allows custom `yt-dlp` options ([docs](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fwiki\u002F%5BAdvanced%5D-Custom-yt%E2%80%90dlp-options))\n- \\[Advanced\\] supports running custom scripts when after downloading\u002Fdeleting media (alpha - [docs](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fwiki\u002F%5BAdvanced%5D-Custom-lifecycle-scripts))\n\n## Screenshots\n\n\u003Cimg src=\"priv\u002Fstatic\u002Fimages\u002Fapp-form-screenshot.jpg\" alt=\"Pinchflat screenshot\" width=\"700\" \u002F>\n\u003Cimg src=\"priv\u002Fstatic\u002Fimages\u002Fapp-screenshot.jpg\" alt=\"Pinchflat screenshot\" width=\"700\" \u002F>\n\n## Installation\n\n### Unraid\n\nSimply search for Pinchflat in the Community Apps store!\n\n### Portainer\n\n> [!IMPORTANT]  \n> See the note below about storing config on a network file share. It's preferred to store the config on a local disk if at all possible.\n\nDocker Compose file:\n\n```yaml\nversion: '3'\nservices:\n  pinchflat:\n    image: ghcr.io\u002Fkieraneglin\u002Fpinchflat:latest\n    environment:\n      # Set the timezone to your local timezone\n      - TZ=America\u002FNew_York\n    ports:\n      - '8945:8945'\n    volumes:\n      - \u002Fhost\u002Fpath\u002Fto\u002Fconfig:\u002Fconfig\n      - \u002Fhost\u002Fpath\u002Fto\u002Fdownloads:\u002Fdownloads\n```\n\n### Docker\n\n1. Create two directories on your host machine: one for storing config and one for storing downloaded media. Make sure they're both writable by the user running the Docker container.\n2. Prepare the docker image in one of the two ways below:\n   - **From GHCR:** `docker pull ghcr.io\u002Fkieraneglin\u002Fpinchflat:latest`\n     - NOTE: also available on Docker Hub at `keglin\u002Fpinchflat:latest`\n   - **Building locally:** `docker build . --file docker\u002Fselfhosted.Dockerfile -t ghcr.io\u002Fkieraneglin\u002Fpinchflat:latest`\n3. Run the container:\n\n```bash\n# Be sure to replace \u002Fhost\u002Fpath\u002Fto\u002Fconfig and \u002Fhost\u002Fpath\u002Fto\u002Fdownloads below with\n# the paths to the directories you created in step 1\n# Be sure to replace America\u002FNew_York with your local timezone\ndocker run \\\n  -e TZ=America\u002FNew_York \\\n  -p 8945:8945 \\\n  -v \u002Fhost\u002Fpath\u002Fto\u002Fconfig:\u002Fconfig \\\n  -v \u002Fhost\u002Fpath\u002Fto\u002Fdownloads:\u002Fdownloads \\\n  ghcr.io\u002Fkieraneglin\u002Fpinchflat:latest\n```\n\n### Podman\n\nThe Podman setup is similar to Docker but changes a few flags to run under a User Namespace instead of root. To run Pinchflat under Podman and use the current user's UID\u002FGID for file access run this:\n\n```\npodman run \\\n  --security-opt label=disable \\\n  --userns=keep-id --user=$UID \\\n  -e TZ=America\u002FLos_Angeles \\\n  -p 8945:8945 \\\n  -v \u002Fhost\u002Fpath\u002Fto\u002Fconfig:\u002Fconfig:rw \\\n  -v \u002Fhost\u002Fpath\u002Fto\u002Fdownloads\u002F:\u002Fdownloads:rw \\\n  ghcr.io\u002Fkieraneglin\u002Fpinchflat:latest\n```\n\nUsing this setup consider creating a new `pinchflat` user and giving that user ownership to the config and download directory. See [Podman --userns](https:\u002F\u002Fdocs.podman.io\u002Fen\u002Fv4.6.1\u002Fmarkdown\u002Foptions\u002Fuserns.container.html) docs.\n\n### IMPORTANT: File permissions\n\nYou _must_ ensure the host directories you've mounted are writable by the user running the Docker container. If you get a permission error follow the steps it suggests. See [#106](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fissues\u002F106) for more.\n\n> [!IMPORTANT]\n> It's not recommended to run the container as root. Doing so can create permission issues if other apps need to work with the downloaded media.\n\n### ADVANCED: Storing Pinchflat config directory on a network share\n\nAs pointed out in [#137](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fissues\u002F137), SQLite doesn't like being run in WAL mode on network shares. If you're running Pinchflat on a network share, you can disable WAL mode by setting the `JOURNAL_MODE` environment variable to `delete`. This will make Pinchflat run in rollback journal mode which is less performant but should work on network shares.\n\n> [!CAUTION]\n> Changing this setting from WAL to `delete` on an existing Pinchflat instance could, conceivably, result in data loss. Only change this setting if you know what you're doing, why this is important, and are okay with possible data loss or DB corruption. Backup your database first!\n\nIf you change this setting and it works well for you, please leave a comment on [#137](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fissues\u002F137)! Doubly so if it does _not_ work well.\n\n### Environment variables\n\n| Name                        | Required? | Default                   | Notes                                                                                                                                     |\n| --------------------------- | --------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |\n| `TZ`                        | No        | `UTC`                     | Must follow IANA TZ format                                                                                                                |\n| `LOG_LEVEL`                 | No        | `debug`                   | Can be set to `info` but `debug` is strongly recommended                                                                                  |\n| `UMASK`                     | No        | `022`                     | Unraid users may want to set this to `000`                                                                                                |\n| `BASIC_AUTH_USERNAME`       | No        |                           | See [authentication docs](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fwiki\u002FUsername-and-Password)                                            |\n| `BASIC_AUTH_PASSWORD`       | No        |                           | See [authentication docs](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fwiki\u002FUsername-and-Password)                                            |\n| `EXPOSE_FEED_ENDPOINTS`     | No        | `false`                   | See [RSS feed docs](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fwiki\u002FPodcast-RSS-Feeds)                                                      |\n| `ENABLE_IPV6`               | No        | `false`                   | Setting to _any_ non-blank value will enable IPv6                                                                                         |\n| `JOURNAL_MODE`              | No        | `wal`                     | Set to `delete` if your config directory is stored on a network share (not recommended)                                                   |\n| `TZ_DATA_DIR`               | No        | `\u002Fetc\u002Felixir_tzdata_data` | The container path where the timezone database is stored                                                                                  |\n| `BASE_ROUTE_PATH`           | No        | `\u002F`                       | The base path for route generation. Useful when running behind certain reverse proxies - prefixes must be stripped.                       |\n| `YT_DLP_WORKER_CONCURRENCY` | No        | `2`                       | 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           |\n| `ENABLE_PROMETHEUS`         | No        | `false`                   | Setting to _any_ non-blank value will enable Prometheus. See [docs](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fwiki\u002FPrometheus-and-Grafana) |\n\n### Reverse Proxies\n\nPinchflat makes heavy use of websockets for real-time updates. If you're running Pinchflat behind a reverse proxy then you'll need to make sure it's configured to support websockets.\n\n## EFF donations\n\nPrior to 2024-05-10, a portion of all donations were given to the [Electronic Frontier Foundation](https:\u002F\u002Fwww.eff.org\u002F). Now, the app doesn't accept donations that go to me personally and instead directs you straight to the EFF. [Here](https:\u002F\u002Fgithub.com\u002Fkieraneglin\u002Fpinchflat\u002Fissues\u002F234) are some people that have generously donated.\n\nThe EFF defends your online liberties and [backed](https:\u002F\u002Fgithub.com\u002Fgithub\u002Fdmca\u002Fblob\u002F9a85e0f021f7967af80e186b890776a50443f06c\u002F2020\u002F11\u002F2020-11-16-RIAA-reversal-effletter.pdf) `youtube-dl` when Google took them down.\n\n## Stability disclaimer\n\nThis software is in active development and anything can break at any time. I make no guarantees about the stability of this software, forward-compatibility of updates, or integrity (both related to and independent of Pinchflat).\n\n## License\n\nSee `LICENSE` file\n\n\u003C!-- Images and links -->\n\n[license-badge]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fkieraneglin\u002Fpinchflat?style=for-the-badge&color=ee512b\n[license-badge-url]: LICENSE\n","Pinchflat 是一个用于下载 YouTube 内容的自托管应用程序。它使用 yt-dlp 技术构建，具有轻量级、自包含和易于使用的特点。用户可以设置规则来定期检查并下载来自特定 YouTube 频道或播放列表的新内容。该工具非常适合希望将视频保存到本地媒体中心（如 Plex、Jellyfin 或 Kodi）进行离线观看，或者需要归档在线媒体资源的用户。",2,"2026-06-11 03:45:32","high_star"]