Pinchflat

New Source

General Options

Editing Mode:

Source URL

URL of a channel or playlist (required)

Custom Name

Does not impact indexing or downloading. Will be inferred from the source if left blank

Media Profile

Sets your preferences for what media to look for and how to store it

Indexing Options

Index Frequency

Indexing is the process of checking for media to download. For best results, set this to the longest delay you can tolerate for this source

Use Fast Indexing (pro)

Not recommended for playlists. Overrides 'Index Frequency'. See below for more details (seriously, there's a TL;DR that's worth reading)

Downloading Options

Download Media

Unchecking still indexes media but it won't be downloaded until you enable this option

Cookie Behaviour

Uses your YouTube cookies for this source (if configured). 'When Needed' tries to minimize cookie usage except for certain indexing and downloading tasks. See docs

Minimum Duration (seconds)

Minimum duration of the media to be downloaded. Can be blank

Maximum Duration (seconds)

Maximum duration of the media to be downloaded. Can be blank

Download Cutoff Date

Only download media uploaded after this date. Leave blank to download all media. Must be in YYYY-MM-DD format. Old media may be deleted or downloaded if you change this date

Retention Period (days)

Days between when media is downloaded and when it's deleted. Leave blank to keep media indefinitely

Advanced Options

Tread carefully

Title Filter Regex

A PCRE-compatible regex. Only media with titles that match this regex will be downloaded. See here for syntax

Output path template override

Must end with .{{ ext }}. Same rules as Media Profile output path templates. Click here to load your media profile's output template

What is fast indexing?

Indexing is the act of scanning a channel or playlist (aka: source) for new media.

Normal indexing uses yt-dlp to scan the entire source on your specified frequency, but it's very slow for large sources. This is the most accurate way to find uploaded media with the tradeoff being that pairing a large source that's indexed frequently will result in you spending most of your time indexing. Only so many indexing operations can be running at the same time so this can impact your other source's ability to index.

Fast indexing takes a different approach. It still does an initial scan the slow way but after that it uses a secondary mechanism (either RSS or YouTube's API) to frequently check for new videos. This has the potential to be hundreds of times faster, but it can miss videos if the uploader un-privates an old video or uploads dozens of videos in the space of a few minutes.

RSS is used by default but you should enable the YouTube API if you want the best version of fast indexing. This isn't needed for most users but it provides the fastest and most reliable media updates. Here is some documentation on how to get your API key which you can add in the settings page.

To make up for this limitation, a normal index is still run monthly to catch any videos that were missed by fast indexing. Fast indexing overrides the normal index frequency.

TL;DR

In general:

Uses RSS by default which is fine for most users
Create a YouTube API key and add it in your settings for the fastest possible media updates

Fast indexing is great if any of these apply:

The source is large channel and uploads frequently
You want to download a source's new content as soon as possible

Consider not using fast indexing if any of these apply:

The source is a playlist
The source has under 200 videos
The source rarely uploads
You don't mind if it takes longer for new content to be picked up

We can't find the internet

Something went wrong!

New Source

General Options

Indexing Options

Downloading Options

Advanced Options