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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.