Library folders

Setup

Tell HolyArrs where your finished movies, shows and music live.

You need the Change settings permission. First-run setup adds one folder; add the rest here.

Before you start

The folder exists and HolyArrs can write to it.
In Docker, you know the path inside the container, such as /movies. The host path does not work.

Add a folder

Open Settings > Library folders.
Select Add a folder. The Add a Library folder card opens.
Under Holds, pick Movies, Shows or Music.
Enter the full path as HolyArrs sees it under Folder path.
Enter a Name, or leave it empty to use the last part of the path, such as movies.
Select Add. You should see the folder in its group with free space and a health state.

What the check tells you

The check confirms the folder exists, writes and removes a small test file, tries a hardlink from each active Downloader folder, and looks for at least 100 MB free. The refresh button on a row runs it again.

A hardlink is a second name for the same file on the same disk. It is instant and uses no extra space.

State shown	Meaning	Imports
Healthy	All checks passed	Instant moves
Folder not found or Cannot write here	The folder is gone or not writable	Stopped until you fix it
Works, but files are copied (no hardlinks)	Downloads sit on another disk or mount	Work, but copy the file: slower, and double space until the Downloader deletes its copy

Under 100 MB free adds a low space note. Imports work until the disk fills.

Rename or remove a folder

Rename changes the name you see. Nothing moves on disk.

The trash button removes the folder from HolyArrs and leaves every file in place. HolyArrs refuses while titles use the folder. Move those titles first.

If it does not work

Symptom: the state says files are copied (no hardlinks). Cause: downloads and media are on separate mounts. Fix: mount one shared parent folder holding both, at the same path in every container.

Symptom: import says the path is not allowed. Cause: the path is outside every allowed place (see Extra import folders below). The message names the allowed places. Paths with .., network shares such as \\server\share, and links or junctions that lead outside are refused too.

Symptom: import cannot see the download folder. Cause: HOLYARRS_SAVE_PATH is not set and no Downloader has a path pair. Fix: set HOLYARRS_SAVE_PATH, or add the download folder, such as /downloads, under Extra import folders.

Symptom: cannot remove a folder. Fix: move its titles to another folder first.

For experts

Folder rules

A Library folder must exist, be a folder, be a full path, be writable, and not sit inside or around another Library folder. Each kind (Movies, Shows, Music) uses its own folders.

Extra import folders

Library > Import files by hand reads, copies and moves files only inside:

your Library folders,
the folders your Downloaders save into, as HolyArrs sees them: HOLYARRS_SAVE_PATH and the HolyArrs side of each Downloader path pair,
the Extra import folders on Settings > Library folders.

Type one full path per line, such as /imports or D:\Imports. Up to 32. A whole disk such as / or C:\ is refused.

Only the owner, or an admin signed in with a password, can change the list. An API key also needs the admin scope. Others see Owner and admins only.

HolyArrs is free. If it saved you time, star it on GitHub, sponsor it or buy me a coffee.