알림

설정

알림은 무슨 일이 생겼을 때 Discord나 이메일로 메시지를 보냅니다. 요청이 기다리고 있을 때, 영화가 들어왔을 때, 상태 점검에 문제가 생겼을 때 등입니다. Change settings(설정 변경) 권한이 필요합니다.

알림 추가하기

Settings > Alerts(설정 > 알림)를 열고 Add an Alert(알림 추가)를 선택하세요.
Name(이름)을 정하고 Kind(종류)를 고르세요. Discord 또는 이메일입니다.
종류에 맞는 항목을 채우세요(종류 참고).
When to send(보낼 시점)에서 원하지 않는 시점의 체크를 푸세요. 처음에는 모두 체크되어 있습니다. All of these(모두 선택)와 None of these(모두 해제)는 그룹 전체에 적용됩니다.
Send messages(메시지 보내기)는 켜 둔 채로 Save(저장)를 선택하세요.
카드에서 Send a test(테스트 보내기)를 선택하세요. 메시지가 도착하고 카드에 Last sent(마지막 전송)가 표시됩니다.

종류

Discord

Discord에서 채널 설정을 열고 Integrations > Webhooks(연동 > 웹훅)로 가서 링크를 복사하세요. Discord link(Discord 링크)에 붙여 넣으세요. 링크는 https://discord.com/으로 시작합니다. 계정에 Discord 사용자 ID를 추가한 사람은 본인 요청에 관한 메시지에서 멘션됩니다.

이메일

항목	입력할 내용
Mail server(메일 서버), Port(포트)	쓰는 메일 서버
Security(보안)	STARTTLS(587 포트), TLS(465 포트) 또는 None(없음). None은 내 네트워크 안의 메일 서버에만 쓰세요
From address(보내는 주소)	발신 주소
Mail username(메일 사용자 이름), Mail password(메일 비밀번호)	메일 계정
Staff addresses(운영진 주소)	하나 이상, 쉼표로 구분

요청에 관한 메시지는 요청한 사람에게, 그 사람의 계정 주소로 갑니다. 나머지는 모두 운영진 주소로 갑니다.

Telegram, ntfy, Gotify, Pushover, 웹훅은 이번 릴리스에서 보류되어 있습니다. 보류된 기능을 보세요.

선택 사항

보낼 시점

시점	받는 사람	언제
New request(새 요청)	운영진	영화, 시리즈 또는 아티스트가 승인을 기다릴 때
Approved(승인됨)	요청자	요청이 승인됐을 때
Declined(거절됨)	요청자	거절됐을 때, 남긴 메모와 함께
Ready(준비됨)	요청자	파일이 라이브러리에 들어왔을 때
New episodes(새 에피소드)	요청자와 팔로워	시리즈당 1시간에 최대 1번. 각자 끌 수 있습니다
New albums(새 앨범)	아티스트 팔로워	아티스트당 1시간에 최대 1번
Problem reported(문제 신고됨)	운영진	누군가 작품을 신고했을 때. 신고는 `/requests/reports`에 있습니다
Problem fixed(문제 해결됨)	신고자	남긴 답변과 함께
Sent to download(다운로드로 보냄)	운영진	릴리스가 다운로더로 넘어갔을 때
In the Library(라이브러리에 들어옴)	운영진	파일이 배치됐을 때. 더 좋은 사본도 포함
Renamed(이름 변경됨)	운영진	파일 이름이 바뀌었을 때
Added(추가됨)	운영진	작품이 수동으로, 목록에서 또는 요청으로 추가됐을 때
Deleted(삭제됨)	운영진	영화, 시리즈, 시즌 또는 에피소드가 라이브러리에서 빠졌을 때
Health(상태)	운영진	상태 점검에 문제가 생기거나 해결됐을 때
Needs a decision(결정 필요)	운영진	다운로드나 가져오기에 결정이 필요할 때

시즌 팩

목록 아래의 Season packs(시즌 팩)는 에피소드가 여러 개 든 다운로드 하나가 무엇을 보낼지 정합니다. 에피소드마다 한 줄씩 들어가는 One Alert for the pack(팩에 알림 하나), 또는 One Alert per episode(에피소드마다 알림 하나)입니다.

로컬 네트워크 접근

기본값은 꺼짐입니다. 꺼져 있는 동안 Discord 알림은 discord.com으로만, 다른 종류는 인터넷 서버로만 갑니다. 이 장비나 홈 네트워크를 가리키는 링크는 이름을 조회한 뒤에도 거부됩니다. 집에 있는 메일 서버나 수신 서버를 쓰려면 켜세요. 리디렉션은 절대 따라가지 않습니다.

알림 일시 중지

Send messages의 체크를 푸세요. 카드에 Off(꺼짐)가 표시되고 알림은 그대로 남습니다.

비밀번호와 토큰

암호화해서 저장되고, 그 뒤에는 Stored(저장됨)로 표시됩니다. 그대로 두려면 칸을 비워 두세요. 알림이 다른 서버를 가리키게 바꾸면 비밀 값을 다시 입력해야 합니다. 저장된 비밀 값은 새 주소로 절대 가지 않습니다.

문제가 생기면

증상:

Paste the Discord link (Discord 링크를 붙여 넣으세요)

원인: 링크가 https://discord.com/으로 시작하지 않습니다. 해결: 웹훅 링크를 다시 복사하세요. 집에 있는 Discord 호환 서버라면 Reach the local network(로컬 네트워크 접근)를 켜세요.

증상:

Points to the local network, which this Alert may not reach (로컬 네트워크를 가리키는데, 이 알림은 거기에 접근할 수 없습니다)

원인: 서버가 이 장비나 홈 네트워크에 있습니다. 해결: Reach the local network를 켜세요.

증상: Last try failed(마지막 시도 실패)와 함께 401 또는 404 응답이 표시됩니다. 원인: 링크나 토큰이 틀렸습니다. 이 경우는 재시도하지 않습니다. 해결: 바로잡고 Send a test를 선택하세요.

증상: 요청한 사람이 아무것도 받지 못했습니다. 원인: 계정에 이메일 주소나 Discord 사용자 ID가 없거나, 그 시점의 체크가 풀려 있거나, 본인이 새 에피소드를 껐습니다. 해결: 이 세 가지를 확인하세요.

전문가용

재시도

시간 초과, 속도 제한 응답 또는 서버 오류는 5 s, 30 s, 2 min 뒤에 재시도합니다. 서버가 더 긴 대기를 요구하면 최대 5 min까지 따릅니다. 잘못된 링크 같은 거부는 재시도하지 않습니다. 실패할 때마다 기록에 “Alert could not be sent”(알림을 보낼 수 없음) 행이 추가됩니다.

보류된 종류와 항목

alert_channels_more 스위치를 켰을 때만 표시됩니다.

종류	항목
Telegram	@BotFather에서 받은 Bot token(봇 토큰), Chat ID(채팅 ID: 사용자, 그룹 또는 채널 ID, 또는 `@channel`). 먼저 봇에게 메시지를 보내거나 봇을 그룹에 추가하세요
ntfy	Server address(서버 주소, 비우면 ntfy.sh), Topic(토픽), 선택 사항인 Access token(액세스 토큰). 토픽을 아는 사람은 누구나 읽을 수 있습니다
Gotify	Server address, App token(앱 토큰)
Pushover	User key(사용자 키, 그룹 키도 됩니다), App token
Webhook (JSON)	Webhook link(웹훅 링크), 선택 사항인 Secret(비밀 값), What the secret does(비밀 값의 용도)

웹훅이 받는 내용

메시지마다 POST 한 번, Content-Type: application/json, 그리고 아래 헤더가 붙습니다:

헤더	값
`X-HolyArrs-Event`	시점. 예: `import` 또는 `test`
`X-HolyArrs-Delivery`	이 메시지의 무작위 ID
`X-HolyArrs-Timestamp`	Signs each message(메시지마다 서명)일 때: 1970년부터의 초
`X-HolyArrs-Signature`	Signs each message일 때: `sha256=` 뒤에 `<timestamp>.<delivery>.<body>`를 비밀 값으로 HMAC-SHA256 계산한 16진수
`Authorization`	Is sent as a bearer token(bearer 토큰으로 전송)일 때: `Bearer <secret>`

Nothing(없음)이면 비밀 값을 보내지 않습니다. 서명을 쓸 때는 오래된 타임스탬프와 이미 본 전달 ID를 거부하세요. 그래야 복사한 메시지를 다시 보내는 공격을 막을 수 있습니다.

{
  "moment": "import",
  "event_kind": "import_done",
  "subject": "In the Library: Arrival (2016)",
  "text": "Import done: 1 placed by hardlink",
  "at": "2025-01-01T18:04:11Z",
  "movie": { "id": 12, "name": "Arrival", "year": 2016, "tmdb": "329865", "imdb": "tt2543164" },
  "data": { "from": "/downloads/Arrival.2016.1080p" }
}

해당될 때는 다른 필드도 나옵니다: test, show와 episodes, artist와 tracks, report, people. people에는 요청자 이름이 들어가고 주소는 절대 들어가지 않습니다. data에는 메시지의 바탕이 된 기록 행의 사유와 경로가 들어갑니다. 2xx 응답은 모두 전달된 것으로 봅니다.

알림