Ilmoitukset

Ilmoitus (Alert) lähettää Discord- tai sähköpostiviestin, kun jotain tapahtuu: pyyntö odottaa, elokuva päätyy kirjastoon, kuntotarkistus pettää. Tarvitset oikeuden Change settings (muuta asetuksia).

Lisää ilmoitus

1. Avaa Settings > Alerts (asetukset > ilmoitukset) ja napsauta Add an Alert (lisää ilmoitus).
2. Anna sille Name (nimi) ja valitse Kind (tyyppi): Discord tai sähköposti.
3. Täytä tyypin kentät (katso Tyypit).
4. Kohdassa When to send (milloin lähetetään) poista rastit hetkistä, joita et halua. Kaikki ovat aluksi rastitettuina; All of these (kaikki nämä) ja None of these (ei yhtään näistä) toimivat koko ryhmälle.
5. Jätä Send messages (lähetä viestit) päälle ja napsauta Save (tallenna).
6. Napsauta kortilla Send a test (lähetä testi). Viestin pitäisi saapua, ja kortilla pitäisi näkyä Last sent (viimeksi lähetetty).

Tyypit

Discord

Avaa Discordissa kanavan asetukset, sitten Integrations > Webhooks, ja kopioi linkki. Liitä se kenttään Discord link (Discord-linkki); se alkaa merkeillä https://discord.com/. Ihmiset, jotka ovat lisänneet Discord-käyttäjätunnuksensa (user ID) tililleen, mainitaan heidän pyyntöjään koskevissa viesteissä.

Sähköposti

Kenttä	Mitä kirjoitetaan
Mail server (postipalvelin), Port (portti)	Postipalvelimesi
Security (suojaus)	STARTTLS (portti 587), TLS (portti 465) tai None (ei mitään). None vain oman verkkosi postipalvelimelle
From address (lähettäjän osoite)	Lähettäjän osoite
Mail username (postin käyttäjätunnus), Mail password (postin salasana)	Postitili
Staff addresses (henkilökunnan osoitteet)	Yksi tai useampi, pilkuilla erotettuina

Pyyntöjä koskevat viestit menevät pyytäneille ihmisille heidän tilinsä osoitteeseen. Kaikki muu menee henkilökunnan osoitteisiin.

Telegram, ntfy, Gotify, Pushover ja webhookit on jätetty myöhemmäksi tässä versiossa. Katso Myöhemmäksi jätetyt ominaisuudet.

Vaihtoehdot

Milloin lähetetään

Hetki	Kenelle	Milloin
New request (uusi pyyntö)	Henkilökunta	Elokuva, sarja tai artisti odottaa hyväksyntää
Approved (hyväksytty)	Pyytäjät	Heidän pyyntönsä hyväksyttiin
Declined (evätty)	Pyytäjät	Evätty, mukana sinun huomautuksesi
Ready (valmis)	Pyytäjät	Tiedostot ovat kirjastossa
New episodes (uudet jaksot)	Pyytäjät ja seuraajat	Enintään 1 sarjaa kohti tunnissa. Jokainen voi ottaa nämä pois päältä
New albums (uudet albumit)	Artistin seuraajat	Enintään 1 artistia kohti tunnissa
Problem reported (ongelma ilmoitettu)	Henkilökunta	Joku ilmoitti nimikkeestä. Ilmoitukset ovat osoitteessa /requests/reports
Problem fixed (ongelma korjattu)	Ilmoittaja	Mukana sinun vastauksesi
Sent to download (lähetetty lataukseen)	Henkilökunta	Julkaisu lähti latausohjelmalle
In the Library (kirjastossa)	Henkilökunta	Tiedostot sijoitettiin, myös parempi kopio
Renamed (nimetty uudelleen)	Henkilökunta	Tiedostot saivat uudet nimet
Added (lisätty)	Henkilökunta	Nimike lisättiin käsin, listalta tai pyynnöstä
Deleted (poistettu)	Henkilökunta	Elokuva, sarja, tuotantokausi tai jaksoja poistui kirjastosta
Health (kunto)	Henkilökunta	Kuntotarkistus petti tai korjaantui
Needs a decision (vaatii päätöksen)	Henkilökunta	Lataus tai tuonti tarvitsee sinua

Tuotantokausipaketit

Listan alla kohta Season packs (kausipaketit) päättää, mitä yksi monta jaksoa sisältävä lataus lähettää: One Alert for the pack (yksi ilmoitus paketista), jossa on rivi jaksoa kohti, tai One Alert per episode (yksi ilmoitus jaksoa kohti).

Yhteys paikalliseen verkkoon

Oletuksena pois päältä. Kun se on pois, Discord-ilmoitukset menevät vain osoitteeseen discord.com ja muut tyypit vain internetin palvelimille; linkit tähän koneeseen tai kotiverkkoosi hylätään, jopa nimihaun jälkeen. Ota se käyttöön kotona olevaa postipalvelinta tai vastaanottajaa varten. Uudelleenohjauksia ei koskaan seurata.

Keskeytä ilmoitus

Poista rasti kohdasta Send messages. Kortilla näkyy Off (pois) ja ilmoitus säilyy.

Salasanat ja tokenit

Tallennetaan salattuina ja näytetään sitten tekstinä Stored (tallennettu). Jätä kenttä tyhjäksi, jos haluat säilyttää arvon. Jos osoitat ilmoituksen toiselle palvelimelle, kirjoitat salaisuuden uudelleen; tallennettu salaisuus ei koskaan siirry uuteen paikkaan.

Jos se ei toimi

Oire:

Paste the Discord link

(Liitä Discord-linkki.)

Syy: linkki ei ala merkeillä https://discord.com/. Ratkaisu: kopioi webhook-linkki uudelleen. Jos käytät kotona Discordin kaltaista palvelinta, ota käyttöön Reach the local network (yhteys paikalliseen verkkoon).

Oire:

Points to the local network, which this Alert may not reach

(Osoittaa paikalliseen verkkoon, johon tämä ilmoitus ei saa ottaa yhteyttä.)

Syy: palvelin on tässä koneessa tai kotiverkossasi. Ratkaisu: ota käyttöön Reach the local network.

Oire: Last try failed (viimeinen yritys epäonnistui) ja vastauksena 401 tai 404. Syy: linkki tai token on väärä. Näitä ei yritetä uudelleen. Ratkaisu: korjaa se ja napsauta Send a test.

Oire: pyytäjä ei saanut mitään. Syy: hänen tililleen ei ole sähköpostiosoitetta tai Discord-käyttäjätunnusta, hetkestä on poistettu rasti tai hän otti uudet jaksot pois päältä. Ratkaisu: tarkista nämä kolme.

Asiantuntijoille

Uudelleenyritykset

Aikakatkaisu, hidastusvastaus tai palvelinvirhe yritetään uudelleen 5 s, 30 s ja 2 min kuluttua. Palvelimen pyytämää pidempää odotusta noudatetaan enintään 5 min. Hylkäystä, kuten väärää linkkiä, ei yritetä uudelleen. Jokainen epäonnistuminen lisää Historiaan rivin “Alert could not be sent” (ilmoitusta ei voitu lähettää).

Myöhemmäksi jätetyt tyypit ja niiden kentät

Näkyy vain, kun kytkin alert_channels_more on päällä.

Tyyppi	Kentät
Telegram	Bot token (botin token) @BotFatherilta, Chat ID (käyttäjän, ryhmän tai kanavan tunnus, tai @channel). Lähetä botille viesti tai lisää se ensin ryhmään
ntfy	Server address (palvelimen osoite; tyhjä tarkoittaa ntfy.sh), Topic (aihe), valinnainen Access token (käyttötoken). Kuka tahansa, joka tietää aiheen, voi lukea sen
Gotify	Server address, App token (sovelluksen token)
Pushover	User key (käyttäjäavain; ryhmäavaimet toimivat), App token
Webhook (JSON)	Webhook link (webhook-linkki), valinnainen Secret (salaisuus), What the secret does (mitä salaisuus tekee)

Mitä webhook vastaanottaa

Yksi POST viestiä kohti, Content-Type: application/json, näillä otsakkeilla:

Otsake	Arvo
X-HolyArrs-Event	Hetki, kuten import tai test
X-HolyArrs-Delivery	Satunnainen tunnus tälle viestille
X-HolyArrs-Timestamp	Valinnalla Signs each message (allekirjoittaa jokaisen viestin): sekunteja vuodesta 1970
X-HolyArrs-Signature	Valinnalla Signs each message: sha256= ja <timestamp>.<delivery>.<body>:n heksadesimaalinen HMAC-SHA256, avaimena salaisuutesi
Authorization	Valinnalla Is sent as a bearer token (lähetetään bearer-tokenina): Bearer <secret>

Valinnalla Nothing (ei mitään) salaisuutta ei lähetetä. Allekirjoitettaessa hylkää vanhat aikaleimat ja jo nähdyt toimitustunnukset, jotta kopioitua viestiä ei voi toistaa.

{
  "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" }
}

Muut kentät näkyvät, kun ne koskevat viestiä: test, show ja episodes, artist ja tracks, report, people. Kenttä people sisältää pyytäjien nimet, ei koskaan osoitteita. Kenttä data sisältää viestin taustalla olevan Historia-rivin syyt ja polut. Mikä tahansa 2xx-vastaus lasketaan toimitetuksi.

Aiheesta lisää

• Kuntotarkistukset
• Pyyntöjen hyväksyminen
• Käyttäjät ja roolit