Pinchflat Setup Guide - ajgillis04/GillisDockerDepot GitHub Wiki
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.
- Docker installed
- Pinchflat container running in your Docker stack
- Open your browser and navigate to
http://<your-ip-address>:<port>
. - Log in with your Pinchflat credentials.
- Follow the initial setup wizard to configure basic settings.
- Choose your preferred language for the Pinchflat interface.
- Navigate to the
Sources
tab. - Click
Add Source
. - Enter the URL of the YouTube channel or playlist you want to download.
- Click
Save
.
- Go to the
Settings
tab. - Configure download settings such as file naming conventions, download quality, and download frequency.
- Click
Save
.
- Navigate to the
Profiles
tab. - Click
Add Profile
. - Enter the profile details (e.g., folder structure, metadata settings).
- Click
Save
.
- Go to the
Dashboard
tab. - Monitor the status of your downloads, including progress and any errors.
- 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.
- Common Issues: List common issues and solutions.
- Logs: Check Pinchflat logs for error messages.
- Support: Link to the Pinchflat community and support resources.