フォルダー

はじめての方

フォルダーを一度設定しておけば、完了したダウンロードが、コピーを増やさずに瞬時にライブラリへ入ります。

インストールの例では、/movies、/tv、/music、/downloads を 1 つずつマウントしています。これでも動きますが、インポートのたびに丸ごとコピーになります。このページでは、この 4 つのマウントを 1 つの共有の親フォルダーに置き換えます。この設定は任意です。

ルール

ダウンロードとメディアを 1 つのディスク上の、1 つの親フォルダーの下に置き、その親フォルダーを HolyArrs とダウンローダーに同じパスでマウントします。

ハードリンクは、同じファイルに付ける 2 つ目の名前です。余分な容量を使わず、瞬時に作られます。ただし、1 つのファイルシステムの中でしか使えません。Docker はマウントをそれぞれ別のファイルシステムとして扱うので、マウントを分けると丸ごとコピーになります。

/srv/data                  mounted as /data in HolyArrs and the downloader
├── downloads
│   ├── torrents
│   └── usenet
└── media
    ├── movies
    ├── tv
    └── music

設定する

ホストでフォルダーを作成します。

mkdir -p /srv/data/downloads/{torrents,usenet} /srv/data/media/{movies,tv,music}

PUID のユーザーに書き込み権限を付けます。
Terminal window
```
chown -R 1000:1000 /srv/data
```
親フォルダーを HolyArrs にマウントします: - /srv/data:/data。
ダウンローダーにも同じようにマウントします: - /srv/data:/data。保存先フォルダーは /data/downloads/torrents または /data/downloads/usenet に設定します。
HolyArrs では、初回セットアップのときに /data/media/movies、/data/media/tv、/data/media/music をライブラリフォルダーとして使います。

Settings > Library folders(設定 > ライブラリフォルダー)に No hardlink(ハードリンクなし)の警告が表示されなくなります。

オプション

マウントを分ける

/movies、/tv、/music、/downloads を 4 つのマウントにしても動きます。その場合、インポートのたびにファイルがコピーされるので、時間がかかり、ダウンローダーが自分のファイルを削除するまで 2 倍の容量を使います。

ダウンローダーが別のコンテナにあり、パスが違う場合

ダウンローダーからフォルダーが別の名前で見えている場合は、Settings > Downloaders(設定 > ダウンローダー)のそのダウンローダーで、Downloader’s path(ダウンローダー側のパス)と HolyArrs’ path(HolyArrs 側のパス)を入力します。たとえば /data/torrents と /downloads です。パスが同じなら、対応付けは不要です。

うまくいかないとき

表示される内容	原因	対処
ライブラリフォルダーに No hardlink	ダウンロードとメディアが別のマウントまたはファイルシステムにあります	上の説明のとおり、親フォルダーを 1 つマウントします
Read only(読み取り専用)または Missing(見つかりません)	パスが間違っているか、`PUID` に書き込み権限がありません	コンテナの中のパスを使い、所有者を直します
フォルダーが見つからない	ホスト側のパスを入力しています	コンテナ側のパスを入力します。たとえば `/data/media/movies` です
インポートで、パスが許可されていないと表示される	ダウンロードフォルダーが既知の場所ではありません	`HOLYARRS_SAVE_PATH` を設定するか、Settings > Library folders > Extra import folders(追加のインポートフォルダー)に追加します

上級者向け

フォルダーの確認で調べること

確認	失敗したときの表示
フォルダーが存在する	Missing(フォルダーは使われません)
HolyArrs がテストファイルを書き込める	Read only(フォルダーは使われません)
有効な各ダウンローダーのフォルダーからハードリンクできる	No hardlink(警告。インポートはコピーになります)
空き容量が 100 MB 以上ある	空き容量不足のメモ

テストファイルは確認のあとに削除されます。Check again(もう一度確認)でやり直せます。

ライブラリフォルダーのルール

存在すること、フォルダーであること、フルパスであることが必要です。
別のライブラリフォルダーの中や、それを含む位置には置けません。各パスは 1 回しか使えません。
Rename(名前の変更)は、表示名だけを変更します。Remove(削除)はファイルをすべて残します。そのフォルダーをまだ使っているタイトルがある間は拒否されます。
Extra import folders: 1 行に 1 つのフルパスで、最大 32 個。/ や C:\ のようなディスク全体は拒否されます。リストを変更できるのは、オーナーか、パスワードでサインインした管理者だけです。
手動インポートでは、ライブラリフォルダー、HOLYARRS_SAVE_PATH、各ダウンローダーのパス対応の HolyArrs 側も使えます。.. を含むパス、ネットワーク共有のパス、外に出るリンクは拒否されます。