Files
zenith-modq-helper/CHECKS.md
T

4.8 KiB

Zenith Mod Queue Helper: checks

Sources:

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