::
__________ _________
______ ___.__\______ \ ____ / _____/ ____ ____ ____ ____
\____ < | || __/ __ \ \_____ \_/ ____/ __ \ / \_/ __ \
| |_> \___ || | \ ___/ / \ \__\ ___/| | \ ___/
| __// ____||____|_ /\___ /_______ /\___ \___ |___| /\___ >
|__| \/ \/ \/ \/ \/ \/ \/ \/pyReScene is a port of ReScene .NET to the Python programming language, but by now many new features, improvements and scripts have been added. ReScene is a mechanism for backing up and restoring the metadata from "scene" released RAR files. RAR archive volumes are rebuild using the stored metadata in the SRR file and the extracted files from the RAR archive. This process only worked on RAR files created with "Store" mode (otherwise known as -m0 or No Compression), but since pyReScene version 0.4 this is also possible for various other compression settings. However, it is not guaranteed that reconstruction of compressed archives is always possible. Also a handful of known bugs related to this still exist. pyReScene consists of multiple related tools and scripts.
pyReSample is a companion to ReScene. It does for samples what ReScene does for RARs. You can use ReSample to build a blueprint of an AVI, MKV, MP4 or WMV sample, and then use that blueprint (the .srs file) with the full video file to recreate that sample. It contains backups of all parts of the sample file that are not the actual track data as well as a signature that helps ReSample locate the missing track data from the full video file.
Also MP3 and FLAC music files are supported. The tags with all the meta data are copied to the SRS file. This can be restored at another time. fpcalc must be available in your path to use this feature. It can be downloaded from https://bitbucket.org/acoustid/chromaprint/downloads. This tool creates 120s AcoustID music fingerprints. http://acoustid.org/chromaprint
The SRS of VOB and M2TS files are very small. They serve as verification of the sample data stream. The VOB SRS can rebuild the sample, but with M2TS this will always fail.
pyReScene Auto makes it all a bit easier: one command to create an SRR file. It does not require write access to the release directories and it can create SRR files of your whole collection! (Create and mount a private file share to force the read only behavior in Windows. This way you can be absolutely sure!)
pyReScene Usenet is able to create SRR files from NZB files. It works by downloading only (parts of) the segments it needs for creating an SRR file. srr_usenet.py and other NZB related scripts are located in the usenet directory. The compiled _yenc.so module (for more speed) can be obtained from http://pypi.python.org/pypi/yenc/. Create a srr_usenet.cfg configuration file in the usenet directory for easy usage. A template example file is available.
Some related external tools are included into the repository:
Awescript is a Usenet downloads post processing script made by Guber. It is able to create SRR files and extract RAR archives.
Rerar is a tool written in Python 3 by Vadmium to re-create sets of uncompressed rar files. It can also report the metadata and parameters stored in a rar file. It should be able to exactly re-create many real-world RAR files if the right input parameters and metadata are known.
View srr_spec.txt and http://rescene.wikidot.com/ for more info.
Shareware WinRAR setup files* (http://rescene.wikidot.com/rar-versions)
* Works without, but required for certain functionality.
pyReScene requires Python 2.6, 2.7, or 3 to run. There are some executables made available for Windows users. fpcalc is necessary for creating music SRS files. If you want to try reconstructing compressed RAR volumes, you will need to obtain a couple of the shareware (Win)RAR packages. These files will need to be preprocessed by the bin/preprardir.py script. This script extracts the RAR executables from the archives and renames them for further usage. The new folder with RAR executables will need to be passed to the -z parameter of ReScene when reconstructing compressed archives. UnRAR.exe or its Linux equivalent is required for SRR creation of vobsubs.
python setup.py install
Install chromaprint from your repository or put the fpcalc executable somewhere in your path. It will also work if you put it in the ./bin or ./resample directory.
Install Python 3. Download it from http://www.activestate.com/activepython Install it to C:\Python33\ for example.
Place the source somewhere on your hard disk. e.g. C:\pyReScene\
Add the bin\windows directory to your path.
add_current_dir_to_path.bat that you can find in that directory.
It'll prepend your SYSTEM path.Done! Now you will be able to call pyrescene from any directory.
Another way, but it's better to not mess with Windows folders! ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Copy the .bat to a folder that is in your PATH, e.g. C:\Windows\System32\ [1]_
Edit the .bat files to reflect the path where Python and the script source code
is located: e.g. C:\Python33\python.exe C:\pyReScene\bin\srr %*
.. [1] If .exe files are placed in C:\Windows\System32\ and they fail to run, move them to C:\Windows\SysWOW64\. Even better would be to use your own folder you've added to the PATH!
Make sure you can run the 32 bit rar binaries when you try to reconstruct compressed rar archives: http://rescene.wikidot.com/faq#x64
Do tool_name --help to see all the available options.
A one stop solution to create SRR files is the following command:
python pyrescene.py -r --best /root/directory/to/check
This command will recursively check /root/directory/to/check for scene releases. Sample files are checked against the main movie files (-s) and SRR files for compressed RARs are also created (-c). An SRR file for vobsubs will be created recursively if unrar can be found (-v). --best: -c -s -v
To create a .srr file for vobsubs, do:
python pyrescene.py --vobsubs file.sfv
Pointing to the .rar file works too and Windows users can use the vs.bat shortcut.
http://rescene.wikidot.com/tutorials has some more tutorials.
This is a list of security considerations someone reluctant to use pyReScene to create SRR files should know about.
tempfile.mkdtemp() provides. On Windows systems this is somewhere in the
AppData folder and "The directory is readable, writable, and searchable
only by the creating user." A custom temporary directory can be provided with
the -t parameter. Due to unknown bugs, "SRR-xxxxxx" folders could be
left behind in the temporary folder when the tool crashes. Tell me about this!--skip-regex to skip over custom files and folders.Whatever your objections, create SRRs now. In time all will become irrelevant anyway ;)
Read the NEWS file.
Check the AUTHORS file.
FAQ_ tutorials_ Forum_#srrdb_ on EFNet.. _FAQ: http://rescene.wikidot.com/faq .. _tutorials: http://rescene.wikidot.com/tutorials .. Forum: http://rescene.wikidot.com/forum:start .. #srrdb: irc://irc.efnet.org/%23srrdb
Do contribute to srrdb.com and help us to motivate the right people! --Gfy