다운로더

설정

다운로드 앱을 연결하면 HolyArrs가 릴리스를 보내고 완료된 것을 가져옵니다.

HolyArrs는 직접 다운로드하지 않습니다. 릴리스를 다운로더에 넘기고, 진행을 지켜보고, 파일을 가져옵니다.

종류	앱
토렌트	qBittorrent, Transmission 4 이상, Deluge
유즈넷	SABnzbd, NZBGet

시작하기 전에

소유자 또는 관리자여야 합니다.
다운로드 앱이 실행 중이고 그 웹 페이지를 열 수 있어야 합니다.

다운로더 추가하기

Settings > Downloaders(설정 > 다운로더)를 여세요.
Add a Downloader(다운로더 추가)를 누르세요.
Which app(어떤 앱) 아래에서 쓰는 앱을 고르세요.
Name(이름)을 입력하세요.
Address(주소)에 앱의 웹 페이지 주소를 입력하세요. 예: http://192.168.1.10:8090.
로그인 정보를 채우세요. 앱별 로그인 정보를 참고하세요.
Save(저장)를 누른 다음 해당 줄에서 Test(테스트)를 누르세요.

이름 옆에 Working(정상 작동)이 표시됩니다.

앱별 로그인 정보

앱	입력할 것	찾는 곳
qBittorrent	API key(API 키, qBittorrent 5.2 이상) 또는 Username and password(사용자 이름과 비밀번호)	Options > Web UI
Transmission	사용자 이름과 비밀번호. 요구하지 않으면 비워 둡니다	Transmission 설정
Deluge	Web UI 비밀번호. 사용자 이름은 없습니다	Deluge Web UI
SABnzbd	API 키	Config > General
NZBGet	사용자 이름과 비밀번호. NZBGet이 이것 없이도 HolyArrs를 받아 주면 비워 둡니다	NZBGet 설정

HolyArrs는 키와 비밀번호를 암호화해 저장하고 다시 보여 주지 않습니다. 저장된 값을 유지하려면 칸을 그대로 두세요. 주소를 다른 호스트로 바꾸면 키를 다시 입력하세요. HolyArrs는 저장된 키를 새 호스트로 보내지 않습니다.

선택할 수 있는 것

qBittorrent에서는 이 항목들이 More options(추가 옵션) 아래에 있습니다.

카테고리

HolyArrs는 자신의 다운로드를 이 카테고리에 넣고 이 카테고리만 지켜봅니다.

앱	카테고리 동작 방식
qBittorrent	없으면 자동으로 만들어집니다
SABnzbd	Config > Categories에 미리 있어야 합니다
Transmission, Deluge	라벨로 저장됩니다
NZBGet	다운로드 카테고리로 전송됩니다

우선순위와 태그

Priority(우선순위)는 1부터 50까지입니다. 가장 낮은 숫자가 먼저 쓰이고, 숫자가 같으면 번갈아 쓰입니다. Tags(태그)를 쓰면 같은 태그가 있는 작품만 이 다운로더를 씁니다. 태그가 없는 작품은 태그가 없는 다운로더를 씁니다.

경로

두 앱이 다운로드 폴더를 서로 다른 이름으로 볼 때만 Different folder names(서로 다른 폴더 이름) 아래의 Downloader’s path(다운로더의 경로)와 HolyArrs’ path(HolyArrs의 경로)를 채우세요. 예: 다운로더는 /data/torrents에 저장하고 HolyArrs는 그것을 /downloads로 봅니다. Add a path pair(경로 쌍 추가)는 줄을 하나 더 추가합니다.

더 좋은 해결책은 공유 상위 폴더 하나를 두 컨테이너에 같은 경로로 마운트하는 것입니다. 폴더를 참고하세요.

로컬 네트워크 접근

다운로더는 보통 집에서 실행되므로 기본값은 켜짐입니다. 인터넷에 있는 다운로더라면 끄세요.

HolyArrs가 이 다운로더를 변경할 수 있음

끄면 새 다운로드는 계속 그쪽으로 가지만, HolyArrs는 이미 들어 있는 것을 일시 중지하거나 바꾸거나 제거하지 않습니다. 다른 앱과 함께 쓰는 다운로더에 쓰세요.

다운로드 지켜보기

작품 페이지에는 각 다운로드가 표시됩니다. 차례 대기 중, 속도와 남은 시간이 함께 나오는 다운로드 중, 멈춤, 또는 이유와 함께 나오는 실패입니다.

원하지 않는 다운로드를 끝내려면 Mark failed(실패로 표시)를 누르세요. 그러면 HolyArrs는 다음을 합니다.

그 릴리스를 작품의 Turned down(거부됨) 목록에 추가해 다시 선택되지 않게 합니다.
다운로더에서 파일과 함께 제거합니다.
다시 검색해 그다음으로 좋은 릴리스를 보냅니다.

규칙을 통과하는 다른 릴리스가 없으면 작품에 Needs a decision(결정 필요)이 표시됩니다.

줄 상태

상태	의미
Working	마지막 확인에 응답했습니다
Paused(일시 중지됨)	직접 일시 중지했습니다. 새로 보내는 것은 없고, 진행 중인 다운로드는 계속 지켜봅니다
Resting(쉬는 중)	응답하지 않아서 HolyArrs가 표시된 시각까지 기다립니다
Not answering(응답 없음)	마지막 확인에 응답이 없었습니다
Sign-in refused(로그인 거부됨)	키나 로그인 정보가 거부되었습니다

줄의 Pause(일시 중지)와 Resume(재개)은 보내기를 멈추고 다시 시작합니다. 응답을 멈춘 다운로더는 최대 30분 동안 건너뜁니다.

문제가 생기면

증상: Address에 호스트 이름을 쓰면 SABnzbd 테스트가 실패합니다. 원인: SABnzbd는 모르는 호스트 이름을 거부합니다. 해결: IP 주소를 쓰거나, SABnzbd의 Config > Special에서 host_whitelist에 HolyArrs의 호스트 이름을 추가하세요.

증상: SABnzbd가 카테고리가 없다고 합니다. 해결: SABnzbd의 Config > Categories에서 카테고리를 만든 다음 Test를 누르세요.

증상: Deluge가 작동하지 않습니다. 해결: Deluge Web UI에서 데몬에 직접 연결하고 Label 플러그인을 켜세요. HolyArrs는 데몬을 고르지 않습니다.

증상: 프록시를 쓰는 소스의 .torrent나 .nzb가 거부됩니다. 원인: Transmission, Deluge, NZBGet은 아직 프록시를 거치는 소스의 이런 파일을 받지 못합니다. 마그넷 링크는 됩니다.

증상: 줄에 Check whether this download arrived(이 다운로드가 도착했는지 확인하세요)가 표시됩니다. 원인: Transmission, Deluge, NZBGet이 릴리스를 받는 도중에 연결이 끊겼습니다. HolyArrs는 이것을 알아서 다시 보내지 않습니다. 해결:

다운로더 앱에서 그 다운로드를 찾아보세요.
HolyArrs에서 Give up on it(포기하기)을 누르세요. 다운로드는 다운로더에 남습니다. 다른 릴리스를 원하면 Needs a decision에서 고르세요.

증상: Sign-in refused. 해결: 다운로더에서 키나 비밀번호를 복사해 다시 입력하고 Test를 누르세요.

더 많은 내용은 문제 해결에 있습니다.

고급 사용자용

HolyArrs가 다운로더를 고르는 방식

토렌트 릴리스는 토렌트 다운로더로, 유즈넷 릴리스는 유즈넷 다운로더로 갑니다.
우선순위 숫자가 가장 낮은 것이 먼저입니다. 숫자가 같으면 번갈아 쓰입니다.
일시 중지된 다운로더와 쉬는 중인 다운로더는 건너뜁니다.
하나가 릴리스를 거부하면 같은 종류의 다음 다운로더를 시도합니다(Try the next Downloader(다음 다운로더 시도)).
한 다운로더로 보내는 간격은 기본값으로 2 s입니다.
태그가 일치해야 합니다. 태그가 없는 작품은 태그가 없는 다운로더로 갑니다.

다운로드가 잘못될 때: 해당하는 경우와 설정

HolyArrs는 다음 경우를 Mark failed와 똑같이 처리합니다.

다운로더가 포기한 경우(빠진 조각, 복구 실패). 다운로더가 밝힌 이유가 표시됩니다.
다운로드에 .exe, .bat, .scr, .lnk 같은 프로그램이 들어 있는 경우. movie.mkv.exe도 포함됩니다.
다운로드가 가짜로 보이는 경우: 비밀번호 안내 문서, 영상이나 오디오 없이 압축 파일만 있는 것, 옆에 미디어가 없는 웹 바로가기. 토렌트 파일 목록은 도착하자마자 읽으므로 가짜 릴리스는 다운로드되기 전에 실패합니다.
파일이 릴리스 이름과 맞지 않는 경우. 가져오기가 거부되고 다운로드가 제거됩니다.
포기 시간 동안 진행이 없는 경우. 차례 대기 중, 다운로더에서 일시 중지됨, 100%에서 복구 또는 압축 해제 중인 것은 해당하지 않습니다.
다운로드가 HolyArrs 밖에서 제거된 경우. 다음 릴리스로 대체됩니다.

이 설정들은 Settings > Downloaders의 When downloads go wrong(다운로드가 잘못될 때) 아래에 있습니다. 변경한 뒤 나타나는 막대에서 Save를 누르세요.

설정	기본값	바꿔야 할 때
Remove failed downloads from the Downloader(실패한 다운로드를 다운로더에서 제거)	켜짐	실패한 것을 살펴보고 싶을 때(끔). 켜면 그 파일도 삭제됩니다
Add matched titles to your Library(일치하는 작품을 라이브러리에 추가)	꺼짐	다운로더에 이미 있는 확실히 일치하는 작품을 검색 없이 추가하고 싶을 때
When you remove a download(다운로드를 제거할 때): Delete its files(파일 삭제)	켜짐	파일을 남겨 두고 싶을 때
When you remove a download: Turn down its Release(릴리스 거부)	꺼짐	그 릴리스가 이 작품에 다시는 선택되지 않게 하고 싶을 때
When you remove a download: Search again(다시 검색)	켜짐	다음 릴리스를 직접 고른다면 끄세요. Turn down its Release가 필요합니다
Stalled after (hours)(멈춤으로 보는 시간)	6	다운로드가 원래 느릴 때. 범위 1~168
Try the next Release after (hours)(다음 릴리스를 시도하기까지의 시간)	24	대체보다 기다리는 쪽을 원할 때. 마지막 진행 시점부터 셉니다. 범위: 멈춤 시간부터 720까지
Fail downloads that hold programs or fakes(프로그램이나 가짜가 든 다운로드를 실패 처리)	켜짐	거의 없습니다. 끄면 이런 것들이 가져오기까지 갑니다
Replace downloads removed outside HolyArrs(HolyArrs 밖에서 제거된 다운로드 대체)	켜짐	다운로드를 일부러 제거할 때. 끄면 작품이 사용자의 결정을 기다립니다
Try the next Downloader	켜짐	다운로더를 하나만 쓰고 싶을 때
Seconds between sends to one Downloader(한 다운로더로 보내는 간격(초))	2	한꺼번에 몰리면 다운로더가 버거워할 때. 0은 간격을 끕니다. 범위 0~60

서버에서 다운로더를 읽기 전용으로 잠그기

HOLYARRS_READONLY_DOWNLOADERS를 다운로더 ID나 주소를 쉼표로 구분한 목록으로 설정하세요.

HOLYARRS_READONLY_DOWNLOADERS=http://your-server:8080

목록에 있는 다운로더는 스위치가 어떻게 되어 있든 읽기 전용으로 유지됩니다. 제거했다가 다시 추가해도 마찬가지입니다. 스위치는 잠긴 것으로 표시되고, 다운로드 페이지는 그 다운로더의 줄에서 조작 버튼을 숨깁니다.

제거, NZBGet에서의 제거, API

다운로더에 진행 중인 다운로드가 있으면 Remove(제거)가 거부됩니다. 일시 중지하고 다운로드가 끝나기를 기다린 다음 제거하세요.
NZBGet은 다운로드나 그 기록 항목이 제거될 때마다 파일을 삭제하므로, HolyArrs는 파일을 남기라는 제거 요청을 거부합니다.
모든 다운로더 경로는 http://your-server:6262/api/v1/openapi.json에 있습니다.