Skip to main content

Libraries

Libraries are where the files are stored in the system and the directories that will be scanned for files.

Reprocessing a Library

To reprocess all files within a library, simply right-click on the selected library or libraries, and choose the Reprocess option from the context menu.

General Options

Name

The name of the library, must be unique.

Path

The path of the library. This path must be be available on all processing Nodes.
Mapping may be required to map this path for external nodes.

Flow

The flow to execute against files found in this library.

Priority

The priority in which these files will be processed. If a library has higher priority files those will be processed before the lower priority ones.

Extensions

An optional list of extensions for files to include in this library.

If left blank, all files will be included, unless a filter or exclusion filter is defined on the Advanced tab.

Hold Minutes

Optionally hold any files found in this library for this amount of minutes before processing them. Each file will be held for this amount of time.

Enabled

If this library is enabled or not, and whether or not files should be processed from it.

Processing Order

The order in which to process files in this library.

  • As Found
    • The default order, as they are found and added to the system, this is the order they will be processed.
  • Smallest First
    • Files will be processed smallest to largest
  • Largest First
    • Files will be processed largest to smallest
  • Newest First
    • Files will be processed newest first, the newer the file the sooner it will be processed.
  • Oldest First
    • Files will be processed oldest first, the older the file the sooner it will be processed.
  • Random
    • Files will be processed randomly
    • Note the order files appear in the queue will not match the processing order for these files then. As a file will be randomly selected when a processing node requests a file.
Processing Order

This is a premium feature and requires a license to use


Schedule

This allows you to configure when this library will be active.

The library scanner will not run against this library nor will any files be processed outside of the schedule.

Max Runners

The maximum runners that can process files in this library at one time.

Unlimited

Set to 0 for unlimited.


Detection

Here you can configure a library to only detect files that match the given patterns.

For example, this allows you to only include files that are

- Files that were created less than 7 days ago
- Files that were last written to between 3 and 7 days ago
- File size is greater than 1 gigabyte
  • Files that were created before or after a specific date
  • Files that were modified before or after a specific date

Scan

Scan

When Scan is enabled the library will be routinely scanned for new content. When disabled the library will listen for file system events to detect new files. It is best to leave this off unless you are having issues with files not being detected.

Disable Full Scan

The full scan's intended purpose is to catch any files that may be missed by the file system watch events.

Full Scan Interval

The interval when a full scan of this library should take place


Advanced

Filter

A filter to match files against.

  • The full path of the file will be used to match against this, e.g. C:\My Videos\TV Shows\MyShow.mkv
  • Using a regular expression to match against

Exclusion Filter

Will be used to exclude any files.

  • Run before the exclusion filter, any files matching this will be excluded
  • Using a regular expression to match against

Exclude Hidden

If this is on, any hidden files will not be added to the library.

Folders

If this is on folders will be processed in a flow instead of files.

Only use this if you want to process a Folder

This does not mean scan sub-folders and process sub-folders.

Libraries will always be searched recursively, this option means to process a FOLDER and not a FILE.

Meaning a Folder will be passed into the flow and not individual files in that folder.

Skip File Access Tests

When this is enabled, the server will not attempt to open the file for reading/writing when scanning.

The server usually tries to see if a file can be read/written to, so if using a Replace Original or similar, the operating will succeed.

Use Fingerprinting

When enabled, files will have a checksum run against them when being imported and after a flow is completed. Any matching checksum files will be skipped from future library imports.

Update Moved Files

When enabled, if a file has been detected as moved within the same library, then the original file will be updated to point to this new file.

Otherwise when disabled, a duplicate will be added instead.

info

A file will be detected as moved if the original file does not exist and a new file is found with the same signature.

Reprocess Recreated Files

When enabled if a file is re-detected with a different creation time than that is recorded, the file will be automatically set to reprocess. This is helpful on a library of downloaded files, where you may download the same file multiple times and wish to process it each time.

Downloads Directory

A special directory where if a file that has been successfully processed is rediscovered in this folder, that file will automatically be reprocessed.

This is helpful if you re-download a file.