Scene Release Parser

Packagist package version Minimum PHP version: 7.0.0

A library for parsing scene release names into simpler, reusable data.

Like it? I'd appreciate the support :)

Description

This library parses scene release names and splits the data into smaller, simpler, human readable and therefore more reusable data.

The applied rules are mostly based on studying the existing collection of Scene rules and other release examples from a PreDB, since a lot of releases are not named correctly (specially older ones).

The approach was to implement an algorithm that can really parse a variety of scene releases from all decades. The main test file covers some more complex names.

Instructions

I assume you already know some PHP and composer is already installed on your computer. The next steps are:

› Install the library via composer OR download the latest release;

$ composer require propz/release-parser

› Include the composer autoloader file into your project:\

require_once __DIR__ . '/vendor/autoload.php'

› Create a new ReleaseParser Class and pass the release name and (optionally) the release section (for better type parsing) as parameters;\ › You can use the get() function to retrieve an array with all values or just target a specific value with get('name')

Example:

<?php
// Include main composer autoloader file ...
require_once __DIR__ . '/vendor/autoload.php'

// Create class
$release = new \ReleaseParser\ReleaseParser( '24.S02E02.9.00.Uhr.bis.10.00.Uhr.German.DL.TV.Dubbed.DVDRip.SVCD.READ.NFO-c0nFuSed', 'tv' );

// See whats inside
print_r( $release->get() );

=> (
    [release] => 24.S02E02.9.00.Uhr.bis.10.00.Uhr.German.DL.TV.Dubbed.DVDRip.SVCD.READ.NFO-c0nFuSed
    [title] => 24
    [title_extra] => 9 00 Uhr bis 10 00 Uhr
    [group] => c0nFuSed
    [year] =>
    [date] =>
    [season] => 2
    [episode] => 2
    [disc] =>
    [flags] => Array
        (
            [0] => READNFO
            [1] => TV Dubbed
        )

    [source] => DVDRip
    [format] => SVCD
    [resolution] =>
    [audio] =>
    [device] =>
    [os] =>
    [version] =>
    [language] => Array
        (
            [de] => German
            [multi] => Multilingual
        )

    [type] => TV
)

// Other examples
echo $release->get( 'source' );
DVDRip

echo $release->get( 'format' );
SVCD

print_r( $release->get( 'flags' ) );
Array
(
    [0] => READNFO
    [1] => TV Dubbed
)

Found any Bugs?

If you find any bugs/errors, feel free to post an issue.

Similar projects and inspirations

pr0pz/scene-release-parser - Identical to this project but in JavaScript
matiassingers/scene-release (JavaScript)
thcolin/scene-release-parser-php (PHP)
majestixx/scene-release-parser-php-lib (PHP)

License

License: MIT

That's it!

Be excellent to each other. And, Party on, dudes!

pr0pz / scene-release-parser-php