Files

78 lines
4.8 KiB
Markdown

# Zenith Mod Queue Helper: checks
Sources:
- Uploading Rules, https://znth.cx/pages/8 (updated 2026-08-14)
- Movie/TV Naming Guide, https://znth.cx/wikis/7 (updated 2026-08-31)
- Banned groups, `GET /api/bannedReleaseGroups` (43 groups, 2026-09-25)
Severity:
- **Fail**: breaks a written Zenith rule. Goes into the corrective message.
- **Warning**: likely problem, or the page could not be read. Goes into the message.
- **Review**: shown for the moderator only, never in the message. Used where Zenith has no rule, or where the rule depends on facts the page does not show.
## Content and naming
| Check | Rule | Severity | Notes |
|---|---|---|---|
| TMDB title match | 3.1, guide: Name | Fail/Warning | Title must start with the TMDB title shown on the page |
| Season/episode format | 3.1, guide: S##E## | Fail | `S##`, `S##E##`, zero-padded |
| Title element order | 3.1, guide: templates | Fail/Warning | Full Disc/REMUX and Encode/WEB templates |
| Naming convention | 3.1 | Fail/Warning | Resolution, source, codecs, HDR, channels, object |
| Title template | 3.1 | Fail | Required elements. A missing tag is Review ("If none exists, leave empty") |
| Release group | banned list | Fail/Warning | Zenith API list, 43 groups, no exceptions |
| Banned group in files | banned list | Fail | Group hidden in file names under a different title tag |
| Release tag | 1.4 | Review | Untagged or NOGROUP is allowed. A banned group in the files stays Fail |
| Screenshots | 3.4 | Fail/Warning | At least 3, TMDB posters excluded |
## Technical
| Check | Rule | Severity | Notes |
|---|---|---|---|
| MediaInfo | 3.2 | Fail/Warning | Found in the MediaInfo tab (Zenith panel has no heading) |
| BDInfo | 3.3 | Fail | Blu-ray full discs only |
| Container | 3.5 | Fail | MKV, MP4, AVI. `.ts` only for HDTV/UHDTV, `.ps`/`.mpg` only for SDTV |
| Extraneous files | 3.6 | Fail | NFO, txt, images, `.plexmatch` and similar. Games/Apps skipped |
| Folder structure | 3.6, 3.7 | Fail/Warning | |
| Resolution type | 3.1 | Fail/Warning | Title resolution matches the torrent's resolution field |
| Audio compliance | 3.1, guide: Dub/ACodec | Fail/Warning | Default track codec, channels, Atmos, Dual-Audio/Multi tags |
| Pack uniformity | | Fail/Warning | All episodes share specs |
| Subtitles | 1.5 | Review | English subs are optional on Zenith |
| Encode compliance | none | Review | Encoder settings. Zenith has no encode spec |
| Upscale detection | none | Review | |
| Unknown language | none | Review | Tracks without a language tag |
| Single file in folder | none | Review | |
| Category/type | | Warning | Category and type fit each other and the title |
| Missing episodes | 2.4 | Warning | Gaps in a season pack |
| Suspicion heuristics | none | Review | Group mismatch, raw `.ts`, unknown 4K REMUX group |
## Zenith rules (new in this script)
| Check | Rule | Severity | Fails when |
|---|---|---|---|
| Archives | 2.1 | Fail | `.rar`, `.r00`, `.zip`, `.7z` in the file list. Games/Apps skipped |
| Movie boxset | 2.2 | Fail | Title has Collection/Trilogy/Boxset, or video files from 2+ years. Full disc: Review (guide allows multi-title discs) |
| Season packaging | 2.3 | Fail | `S##-S##`, `COMPLETE`, or episodes from 2+ seasons. Full disc: Review (2.3.1) |
| Single episode | 2.4 | Review | `S##E##`. Allowed only while the season airs, which the page does not show |
| Full disc | 3.3, 3.9, 3.9.1 | Fail | Blu-ray without BDInfo, ISO for a normal disc, 3D/MGVC not as ISO, no BDMV/VIDEO_TS files |
| TrueHD compatibility track | 3.8 | Fail | REMUX whose default audio is TrueHD and no AC-3/E-AC-3 track exists |
| Advertising | 1.3 | Review | Description names another tracker or says "downloaded from" |
Not checked: 1.1, 1.2 (exclusivity), 1.5 retail subs, 2.6 (XXX), 3.10, music, audiobooks, ebooks, games and software rules.
## Tested
- Offline unit tests: `tests/15_zenith_test.js`, every rule in both directions
- Full script in a headless browser on a saved Zenith torrent page (Encode, 1080p): all checks pass
- The same page, altered once per rule (no MediaInfo, banned group, RAR/NFO, no screenshots, S01-S03, boxset with AVI/WMV, TrueHD REMUX with and without AC-3, German audio without subs, tracker name in the description): each produced the expected result
- No network requests with the default settings
## Not tested
| Area | Why | How to close it |
|---|---|---|
| Postpone/Reject paste | Needs the staff view of a pending torrent | A Zenith moderator tries both buttons |
| BDInfo detection | No saved full-disc page | Save a full-disc torrent page |
| HDTV/SDTV container exceptions | Zenith type names for HDTV not confirmed | Save an HDTV torrent page |
| TV pages | No saved TV page | Save a season pack and an episode page |
| SRRDB/Prowlarr on Zenith | Integrations are off by default | Enable in settings and search once |