Pinchflat Setup Guide - ajgillis04/GillisDockerDepot GitHub Wiki

Pinchflat Setup Guide

Introduction

Pinchflat is a lightweight, self-hosted YouTube media manager designed to download and manage YouTube content. It uses yt-dlp under the hood and offers an easy-to-use interface to get the media you want on-disk for use with media center apps like Plex, Jellyfin, or Kodi.

Prerequisites

  • Docker installed
  • Pinchflat container running in your Docker stack

Configuration Steps

Step 1: Accessing the Pinchflat UI

  1. Open your browser and navigate to http://<your-ip-address>:<port>.
  2. Log in with your Pinchflat credentials.

Step 2: Initial Setup Wizard

  1. Follow the initial setup wizard to configure basic settings.
  2. Choose your preferred language for the Pinchflat interface.

Step 3: Adding YouTube Channels or Playlists

  1. Navigate to the Sources tab.
  2. Click Add Source.
  3. Enter the URL of the YouTube channel or playlist you want to download.
  4. Click Save.

Step 4: Configuring Download Settings

  1. Go to the Settings tab.
  2. Configure download settings such as file naming conventions, download quality, and download frequency.
  3. Click Save.

Step 5: Customizing Media Profiles

  1. Navigate to the Profiles tab.
  2. Click Add Profile.
  3. Enter the profile details (e.g., folder structure, metadata settings).
  4. Click Save.

Step 6: Monitoring Downloads

  1. Go to the Dashboard tab.
  2. Monitor the status of your downloads, including progress and any errors.

Notes

  • Ensure all paths and environment variables are updated in the pinchflat.yaml file.
  • Regularly backup your config directory to save your settings and downloaded content.

Troubleshooting

  • Common Issues: List common issues and solutions.
  • Logs: Check Pinchflat logs for error messages.
  • Support: Link to the Pinchflat community and support resources.
⚠️ **GitHub.com Fallback** ⚠️