KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #ai-agents #dsh-plugin #codex #developer-tools #claude-code #windows #cli #desktop-app #typescript #rust #ai-agent

pynps

★ 90 Open GitHub ↗

A cli Linux and Windows Nopaystation client made with python and wget. Works with PSvita, PSP, PSMobile and PS3 packages

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pynps)
![PyPI - License](https://img.shields.io/pypi/l/pynps)

![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/evertonstz/pynps)
![PyPI](https://img.shields.io/pypi/v/pynps)

[![Downloads](https://pepy.tech/badge/pynps)](https://pepy.tech/project/pynps)

Currently, all the work is being done inside the [refactoring branch](https://github.com/evertonstz/pynps/tree/code_refactoring).

# pyNPS - A cli Linux and Windows Nopaystation client made with python 3 and wget 
<p align="center">
<img src="https://octodex.github.com/images/pythocat.png" width="448" height="448">
</p>

PyNPS is a [Nopaystation](https://nopaystation.com/) client writen in python 3 that, with the help of [wget](https://www.gnu.org/software/wget/) and [pkg2zip](https://github.com/mmozeiko/pkg2zip/), can search, download and decrypt/extract PSVita, PSP, PSX, PSM and PS3 games from Nopaystation database. It's basically a command line version of [NPSBrowser](https://nopaystation.com/vita/npsReleases/) writen by a moron (aka me).

# This project wouldn't be possible without the help of these folks
* [Nopaystation](https://nopaystation.com/): for making our beloved database this software hooks on
* [mmozeiko](https://github.com/mmozeiko/pkg2zip): for making the original pkg2zip
* [lusid1](https://github.com/lusid1/pkg2zip): for forking pkg2zip and making theme extraction great again
* [BertrandHustle](https://github.com/BertrandHustle/psx_scraper): for coding a python solution to detect names on PSX's EBOOT that's used in this software
* [Contributors](https://github.com/evertonstz/pynps/graphs/contributors): for helping with pull requests.

# Table of Contents

- [Installation](#installation)
  * [Binary](#binary)
  * [Using PIP](#using-pip)
  * [pkg2zip](#pkg2zip)
  * [wget](#wget)
  * [Windows](#windows)
- [Updating database](#updating-database)
  * [Updating all databases](#updating-all-databases)
  * [Updating database per console](#updating-database-per-console)
  * [Updating database, even more fragmented](#updating-database-even-more-fragmented)
  * [Database file](#database-file)
- [Configuration file](#configuration-file)
- [Examples](#examples)
  * [Searching](#searching)
  * [Syntax for selecting files to download](#syntax-for-selecting-files-to-download)
  * [Resuming downloads](#resuming-downloads)
  * [More information](#more-information)
- [Make a donation](#make-a-donation)
  * [Paypal](#paypal)
  * [Crypto](#crypto)
******
# Installation
There are tree methods you can install pyNPS:

## Using PIP
This is for both 32 and 64bits systems. All you need is python 3.7 or newer alongside PIP:

>pip install pynps

Make sure to also install pkg2zip and wget (this should already be installed in most Linux distros tho).

******
# pkg2zip
This script uses lusid1's pkg2zip, as [recomended by NoPayStation](https://twitter.com/NoPayStation/status/1096508850080043010), to handle the .pkg extractions, you have 3 options:

1. Use pre-compied binary, compiled by myelf (version 2.2) [here](https://pixeldrain.com/u/qJ05A7Si), just drop it inside `/home/$USER/.config/pyNPS/lib/` and make it executable by runing:

> chmod -R +x /home/$USER/.config/pyNPS/lib/pkg2zip

2. If you're an Arch user, you can compile it from [AUR](https://aur.archlinux.org/packages/pkg2zip-fork/) after you install it pyNPS will autodetect and use it automatically, no need to add the path to your config file, the yay command is:

>$ yay -S pkg2zip-fork

3. Or you can just grab the sources from lusid1's repo and compile it yourself [here](https://github.com/lusid1/pkg2zip/releases) and move the binary into this folder `/home/$USER/.config/pyNPS/lib/`.

For methods 1 and 3 pyNPS will autodetect and use it automatically, so there's no need to add the path to your config file

In case you decide to store your binary outside `/home/$USER/.config/pyNPS/lib/` you'll need to specify this folder in your config file unde the "pkg2zip_location" option.

******
# wget
This software uses wget to make the downloads therefore it won't work if you don't have it installed in your system, most distros already come with wget installed, if you don't have it chances are you're on some crazy non-userfriendly distro and you probably know your way around for installing it. If you don't just google.

You can drop a wget binary at `/home/$USER/.config/pyNPS/lib/` after that pyNPS will autodetect and use it automatically, no need to add the path to your config file.

In case you decide to store your binary outside `/home/$USER/.config/pyNPS/lib/` you'll need to specify this folder in your config file unde the "wget_location" option.
******
# Windows
TL;DR: install with the windows installer (available at [releases page](https://github.com/evertonstz/pynps/releases)) as administrator (aka select "install for every user in this PC" when you run the installer), open CMD and start using by typing `pynps`. More info about download directories and config files can be found in [these notes](https://github.com/evertonstz/pynps/releases/tag/1.6.2)

The Windows installer comes bundled with wget and pkg2zip and when installed as administrator it'll also include itself on PATH (if not the user will need to add it manually). There's also a portable binary and Windows can also install it with pip. More infor is found in [these notes](https://github.com/evertonstz/pynps/releases/tag/1.6.2).

People on Windows that don't actually care about command line stuff can also try [NPSBrowser](https://nopaystation.com/vita/npsReleases/).

******
# Updating database
Before downloading any of your legally obtained (wink wink wink) pkg file you have to update your NPS database, you don't have to do it every time you want to download something, but only in your first run to construct your initial database and after that just once in a while to get info about new pkgs NPS adds to their database:

## Updating all databases
>$ pynps -u

## Updating database per console

updates only vita's db
>$ pynps -c psv -u

Or:

>$ pynps -uc psv

You can do the same for psp, psx and psm.

## Updating database, even more fragmented

Updates only games and themes database for psp and psx (note: since there's no themes database for psx, only the games db will be updated for this system):
>$ pynps -c psp -u -GT

Or:

>$ pynps -GTuc psp

Updates only games database for every system:
>$ pynps -u -G

Or:
>$ pynps -Gu

## Database file

Database is located by default at `/home/$USER/.config/pyNPS/database/pynps.db`
******
# Configuration file
Configuration file is created at `/home/$USER/.config/pyNPS/settings.ini`

If you delete it, it'll be recreated with default parameters in the next run. The options are pretty much self explanatory.

******
# Examples
## Searching
******
Search for an european release of Crash for PSX and PSP
>$ pynps --console psp --console psx --region eur --games crash

Or:
>$ pynps -c psv -T -E touhou

Or:
>$ pynps -c psv -TE touhou

Or if you like high suffering :
>$ pynps --console psv --games --dlcs --themes --updates --demos knight

Or if you like medium suffering:
>$ pynps -c psv -G -D -T -U -E knight

Low suffering:

>$ pynps -c psv -GDTUE knight

Alternative low suffering:
>$ pynps -GDTUEc psv knight

******
## Resuming downloads
Resuming downloads in supported since version 1.4.0, more info can be found in the release notes [here](https://github.com/evertonstz/pynps/releases/tag/1.4.0)

******
## More information
Just run:
>$ pynps -h

```
usage: pynps       [-h] [-c {psv,psp,psx,psm,ps3}] [-r {usa,eur,jap,asia,int}] [-s SORT] [-G] [-D] [-T] [-U] [-E] [-A]
                   [-k] [-eb] [-cso {1,2,3,4,5,6,7,8,9}] [-zip] [-l LIMIT_RATE] [-u] [-p] [-R] [-v]
                   [search]

pyNPS is a Nopaystation client writen in python 3that, with the help of wget and pkg2zip, can search, download and
decrypt/extract PSVita, PSP, PSX and PSM games from Nopaystation database.

positional arguments:
  search                search something to download, you can search by name or ID or use '_all' to return
                        everythning.

optional arguments:
  -h, --help            show this help message and exit
  -c {psv,psp,psx,psm,ps3}, --console {psv,psp,psx,psm,ps3}
                        the console you wanna get content with NPS.
  -r {usa,eur,jap,asia,int}, --region {usa,eur,jap,asia,int}
                        the region for the pkj you want.
  -s SORT, --sort SORT  sort search output by column name, can string multiple names by using a comma. Available
                        options are: console or c, title_id or id, region or r, type or t, game_name or n, size or s.
                        Default value: c,t,r,n
  -G, -dg, --games      to download PSV/PSP/PSX/PSM/PS3 games.
  -D, -dd, --dlcs       to download PSV/PSP/PS3 dlcs.
  -T, -dt, --themes     to download PSV/PSP/PS3 themes.
  -U, -du, --updates    to download PSV/PSP game updates.
  -E, -dde, --demos     to download PSV/PS3 demos.
  -A, -da, --avatars    to download PS3 avatars.
  -k, --keepkg          using this flag will keep the pkg after the extraction
  -eb, --eboot          use this argument to unpack PSP pkgs as EBOOT.pbp.
  -cso {1,2,3,4,5,6,7,8,9}, --compress_cso {1,2,3,4,5,6,7,8,9}
                        use this argument to unpack PSP games as a compressed .cso file. You can use any number
                        beetween 1 and 9 for compression factors, were 1 is less compressed and 9 is more compressed.
  -zip, --compress_zip  extract pkgs into zip files instead of folders, this flag won't work with PS3 pkgs.
  -l LIMIT_RATE, --limit_rate LIMIT_RATE
                        limit download speed, input is the same as wget's.
  -u, --update          update database.
  -p, --print           just print the result and exit, you can use this option to redirect the output to a file!
  -R, --resume_session  resume a download session that was saved previously.
  -v, --version         show program's version number and exit
```
******
# Make a donation
kaching kaching

## Paypal
[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=HX93DYLRCWG2W)

## Crypto
BTC: bc1qh53mg0gm6hfjsaphw3x4ct3753rr949lfpere7

LTC: ltc1qp6230jydx7hyht7tu5cuxkk3t7j3t8s0f5wgy8

XLM: evertonstz*keybase.io

ETN: etnjyromPydDjvE6m64mvTTrtzd2k7wm3hFCAAsYBc9kdX3N5PHRA3nTescTqq7xGVBrsk8uJXwN5RnwvdbQH2KR6DbHPzE9Ey

pynps

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README