GitLocker: The Coding Marketplace

Description:

jps2sm 1.16

jps2sm

A project to migrate torrents from JPopSuki to SugoiMusic
jps2sm will automatically gather and validate data from JPS and transfer it to SM. jps2sm does not download any data using torrents themselves and is not a torrent client.
Features

Create upload on SM by automatically retrieving all data on JPS, including english and original titles, group description, release information (format / media / bitrate etc.), group images, contributing artists, original titles, mediainfo data and remaster information if applicable.
Upload by specifiyng a JPS group or release --url
Upload all your (or someone elses) personally uploaded / seeding / snatched torrents with --batchupload / --batchseeding / --batchsnatched
Contribute to SM by uploading ALL non-large recent torrents to SM with --batchrecent mode. Note: This mode will prompt you to continue once the JPS data has been downloaded. A maximum size can be configured with MaxSizeRecentMode in jps2sm.cfg
Search for your media files specified in MediaDirectories and run Mediainfo against them and save the output to the 'mediainfo' field and parse the data to populate the codec, container, audioformat and resolution fields. DVD ISOs are automatically extracted and Mediainfo is run against the VOB files, BR ISO images are not currently supported in the pyunpack module.
Exclude certain audioformats, medias or categories with --excaudioformat , --excmedia and --exccategory
Test your uploads with --dryrun mode.

Install
From PyPi:
pip install jps2sm

Or use the latest commit:
git clone https://github.com/damonjavert/jps2sm.git
cd jps2sm
python setup.py install

jps2sm requires python >=3.8
Quickstart

Install the latest release of python: https://www.python.org/downloads/
Launch your favourite terminal emulator, if you are not familiar with command-line usage or tools, on Windows: Type Win+R and run 'cmd'. On Mac: Go > Utilities > Terminal.
Install the package as above pip install jps2sm and add your JPS & SM login credentials and the directories where your media is stored to jps2sm.cfg, using jps2sm.cfg.example as a template.

The SM torrents are automatically downloaded to the $HOME/SMTorrents, or My Documents\SMTorrents if on Windows by default. All video torrents MUST have mediainfo extracted to be uploaded - you must setup MediaDirectories as below in order for jps2sm to find your media files:
[Media]
MediaDirectories: d:\Music, e:\BR-Rips, .....

MediaInfo will also need to be installed.
To upload an single release or a whole group:
jps2sm --urls <group-url or release-url(s)>

A group-url looks like https://jpopsuki.eu/torrents.php?id=111284
A release-url looks like https://jpopsuki.eu/torrents.php?id=111284&torrentid=148289
See Command line usage for batch processing options.

Command line usage Examples
To upload all your current seeding torrents, whilst automatically retrieving mediainfo data:
jps2sm --batchseeding --mediainfo

To upload the latest 50 torrents uploaded to JPS, prompting the user to continue once JPS data has been downloaded:
jps2sm --batchrecent --mediainfo

To test upload all your JPS uploads:
jps2sm --batchuploaded --dryrun

To upload all your JPS uploads:
jps2sm --batchuploaded

To upload the most recent 50 torrents you uploaded at JPS:
jps2sm --batchuploaded --batchsort time --batchsortorder desc --batchstart 1 --batchend 1

To upload your 100 most popular uploads, based on snatches:
jps2sm --batchuploaded --batchsort snatches --batchsortorder desc --batchstart 1 --batchend 2

To upload every release of AKB48 - 1830m:
jps2sm --urls "https://jpopsuki.eu/torrents.php?id=111284"

To upload only the FLAC and MP3 320:
jps2sm --urls "https://jpopsuki.eu/torrents.php?id=111284&torrentid=148289 https://jpopsuki.eu/torrents.php?id=111284&torrentid=147830"

To upload every release of AKB48 - 1830m, excluding the ISOs (in JPS ISO is considered an audio format):
jps2sm --urls "https://jpopsuki.eu/torrents.php?id=111284" --excaudioformat ISO

Please only upload torrents you intend to SEED. Never-seeded torrents are deleted after 48 hours.
Usage
usage: jps2sm ( --urls | --torrentid | --batchuploaded | --batchseeding | --batchsnatched | --batchrecent )
[--batchuser] [--batchsort] [--batchsortorder] [--batchstart --batchend]
[--exccategory] [--excaudioformat] [--excmedia]
[--help] [--version] [--debug] [--dryrun] [--mediainfo] [--wait-for-jps-dl]

Single group / release(s):

--urls URLS

Single torrent id:

--torrentid JPSTORRENTID

Batch processing mode:

--batchuser BATCHUSER (--batchuploaded | --batchseeding | --batchsnatched | --batchrecent)
[--batchstart BATCHSTART] [--batchend BATCHEND]
[--exccategory EXCCATEGORY] [--excaudioformat EXCAUDIOFORMAT] [--excmedia EXCMEDIA]

Help for arguments for group/release uploads:

-t JPSTORRENTID, --torrentid JPSTORRENTID
Specify a JPS torrent id to upload
-u URLS, --urls URLS JPS URL for a group, or multiple individual releases URLs from the same group, space delimited
in quotes

Help for arguments for batch mode:

-b BATCHUSER, --batchuser BATCHUSER
User id for batch user operations, default is user id of SM Username specified in jps2sm.cfg
-U, --batchuploaded Upload all releases personally uploaded
**or**
-S, --batchseeding Upload all releases currently seeding
**or**
-SN, --batchsnatched Upload all releases that have been snatched
**or**
-R, --batchrecent Upload ALL recent releases uploaded to JPS
This mode will prompt you to continue once the JPS data has been downloaded, by default it parses
the first page at JPS - the last 50 torrents shown on the main page: https://jpopsuki.eu/torrents.php .
This mode is designed to contribute to SM even if you do not have much activity at JPS and/or ensure
that we have the very latest torrents!

Help for optional arguments for batch mode:

-s BATCHSTART, --batchstart BATCHSTART
Start at this page
-e BATCHEND, --batchend BATCHEND
End at this page
-bs BATCHSORT, --batchsort BATCHSORT
Sort for batch upload, must be one of: name,year,time,size,snatches,seeders,leechers
-bso BATCHSORTORDER, --batchsortorder BATCHSORTORDER
Sort order for batch upload, either ASC or DESC.
-exc EXCCATEGORY, --exccategory EXCCATEGORY
Exclude a JPS category from upload
-exf EXCAUDIOFORMAT, --excaudioformat EXCAUDIOFORMAT
Exclude an audioformat from upload
-exm EXCMEDIA, --excmedia EXCMEDIA
Exclude a media from upload

Help for optional arguments:

-h, --help show this help message and exit
-v, --version show program's version number and exit
-d, --debug Enable debug mode. Run your command with this before submitting bugs.
-n, --dryrun Just parse data and show the output, do not add the torrent to SM
-m, --mediainfo Search and get mediainfo data from the source file(s) in the directories
specified by MediaDirectories. Extract data to set codec, resolution,
audio format and container fields as well as the mediainfo field itself.
-w --wait-for-jps-dl (Non-batch mode only) Show a prompt for the user to continue after scraping JPS torrent data and the
torrent, to allow for the file to be downloaded before adding it to SM

Development
Pull requests are welcome!
See https://github.com/damonjavert/jps2sm/issues for areas that you can contribute to.
To setup your Dev environment for Mac/Linux:
git clone https://github.com/damonjavert/jps2sm.git
cd jps2sm
python3 -m venv .venv # or whatever
. .venv/bin/activate
pip install -r requirements_dev.txt

This will install the runtime and dev dependancies and jps2sm itself in editable mode.
To run tests:
cd tests
pytest

Windows
Windows 10 users can setup a Dev environment using Windows Subsystem for Linux. Windows 7 users can install cygwin and then select the python 3.8 packages. Or a python3 MSI installer can be found on the offical python 3 downloads page.
Mac OSX
Install Homebrew if you do not have it already and then brew install python3. See this guide: https://wsvincent.com/install-python3-mac/
Linux
Your distro's primary repos may not include packages for python3.8. Using apt-get install python3 for example may only install python3.6 (or even earlier) and due to the use of the walrus operator jps2sm requires python 3.8. The recommended approach to workaround this is to install LinuxBrew and then brew install python3 as also shown above. Otherwise Debian and Fedora based distros can follow this guide: https://docs.python-guide.org/starting/install3/linux/ .
Legal Disclaimer
Use of jps2sm is not illegal but piracy probably is in your country. Data transferred using jps2sm should be used to maintain backup copies on JPopSuki and SugoiMusic.
The developers of jps2sm are assuming that you own the original file and hold NO RESPONSIBILITY if further to the use of this software the files are misused in any way and cannot be held responsible for what uploads are created on SugoiMusic as a result.
jps2sm is not a torrent client and only migrates and validates metadata and not the actual data/files themselves.