# Zenith Mod Queue Helper

Tampermonkey userscript for Zenith (znth.cx). It checks a torrent page against the Zenith upload rules and naming guide and shows the result in a panel above the moderation section.

## Install

1. Install [Tampermonkey](https://www.tampermonkey.net/).
2. Open **[modq-helper-zenith.user.js](https://gitea.computerliebe.org/Procuria/zenith-modq-helper/raw/branch/main/modq-helper-zenith.user.js)** and click **Install**.

The script runs on `https://znth.cx/torrents/*`. Tampermonkey checks for updates on its own. To force a check: Tampermonkey menu > Utilities > Check for userscript updates.

If the DarkPeers Mod Queue Helper is installed, disable it. Both scripts use the same settings key.

## What it checks

- Title against TMDB and the [naming guide](https://znth.cx/wikis/7): element order, resolution, source, codecs, HDR, channels, tag
- Screenshots (3.4), MediaInfo (3.2), BDInfo (3.3), container (3.5), extraneous files (3.6)
- Banned release groups, in the title and in file names
- Packaging: archives (2.1), boxsets (2.2), multi-season packs (2.3), single episodes (2.4)
- Full discs: unpacked BDMV/VIDEO_TS, 3D and MGVC as ISO (3.9)
- TrueHD REMUX without an AC-3/E-AC-3 compatibility track (3.8)
- Other trackers mentioned in the description (1.3)

Every check with its rule and severity: [CHECKS.md](CHECKS.md).

Results are **Pass**, **Fail**, **Warning** or **Review**. Review is informational and never goes into the corrective message.

## Corrective message

The panel builds a message from all fails and warnings, with links to the Uploading Rules and the naming guide. Click it to edit, then copy it. The Postpone and Reject buttons paste it into the moderation form, which only staff see. The script never submits a form.

## Settings

Tampermonkey menu > **ModQ Helper Settings**.

- Turn the Zenith rule checks on or off
- Optional integrations, both off by default:
  - **SRRDB**: looks up scene releases and compares file names
  - **Prowlarr**: your own Prowlarr URL and API key, used to detect renamed releases

With both integrations off, the script makes no network requests.

## Known limits

- The Postpone/Reject paste targets the standard UNIT3D moderation form. It has not been tested on Zenith's staff view yet.
- BDInfo detection on full-disc pages has not been tested on Zenith.
- Checks read the rendered page. If Zenith changes its theme, some checks may report "not found" until the selectors are updated.

## Feedback

Open an issue in this repository or reply in the Zenith forum thread.

## License

MIT