Skip to main content

nexus-cli

Read NexusPHP private-tracker torrents from the terminal as Markdown (default) or JSON.

There is no official NexusPHP data API — this scrapes the server-rendered torrents.php / details.php pages using your logged-in session cookie, and uses your passkey (auto-discovered from any page) for .torrent downloads.

Install

uv tool install nexusphp-cli   # or: pipx install nexusphp-cli

The installed command is nexusphp. From a checkout you can also run it with uv run nexusphp ....

Auth

Grab the access_token cookie value from your browser (DevTools → Application → Cookies) and export it together with the site URL:

export NEXUS_BASE='https://your-tracker.example'   # required (or pass --base)
export NEXUS_TOKEN='eyJ0eXAiOiJKV1Qi...'           # required (or pass --token)
export NEXUS_PASSKEY='...'                          # optional, auto-discovered

Usage

uv run nexusphp search "人生切割术"                 # Markdown list
uv run nexusphp search "人生切割术" --json          # JSON
uv run nexusphp search "severance" --cat tv,anime --incldead 1
uv run nexusphp search "office" --area subtitle --mode exact
uv run nexusphp details 472747                     # single torrent
uv run nexusphp details 472747 --json
uv run nexusphp url 472747                          # print download URL (incl. passkey)
uv run nexusphp download 472747 -o sev.torrent      # save the .torrent file

Or install it as a tool:

uv tool install .
nexusphp search "无职转生" -j | jq '.torrents[] | {id, title, seeders, size}'

Commands

Command Description
search <query> Search torrents. --area title/subtitle/uploader/imdb/douban, --mode and/or/exact, --cat, --incldead 0/1/2, -p/--page (0-indexed)
details <id> Torrent detail page (name, size, subtitle, imdb, ...)
url <id> Print the download.php URL including your passkey (nothing is saved)
download <id> Fetch that URL and save the .torrent file (-o for filename)

Global: --base, --token, -j/--json.

Categories

movie tv show doc anime music mv sport software game material misc mobile (or pass numeric NexusPHP cat ids). Comma-separate for multiple.

Metadata

Release files for nexusphp-cli 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nexusphp-cli 0.1.0
File Size Uploaded Provenance Actions
nexusphp_cli-0.1.0.tar.gz 8.3 kB Without provenance Details for nexusphp_cli-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for nexusphp-cli 0.1.0
File Interpreter ABI Platform Actions
nexusphp_cli-0.1.0-py3-none-any.whl Python 3 none any Details for nexusphp_cli-0.1.0-py3-none-any.whl

Total release size: 18.4 kB

Release files / nexusphp_cli-0.1.0.tar.gz

Download URL nexusphp_cli-0.1.0.tar.gz
Size 8.3 kB
Tags Source
SHA-256 checksum
How to use checksums
b4e4f973c9c60760ca9580f2a91f95a4265a822442ea593f782a4839f41f55e8
BLAKE2b-256 checksum
How to use checksums
35e65a3739db0c06083e17de3f208cc1e7485f469e6f208d564219253ef6ced5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release files / nexusphp_cli-0.1.0-py3-none-any.whl

Download URL nexusphp_cli-0.1.0-py3-none-any.whl
Size 10.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8d780f07f7c2e5fc1d5a411826c4e6d0906e849080a3fd0dbead37e42c5f11b0
BLAKE2b-256 checksum
How to use checksums
ab01be3a2b25fc9e6abfcdc59dbf0352836dbe32b7389086fc2b7e5cec5e2d97
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Security for nexusphp-cli 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page