An open API service indexing awesome lists of open source software.

https://github.com/bas-man/file-tvshow-organize

Perl Module to move show files into a matching Show/Season folder structure. Optionally place all files into a single Show Folder.
https://github.com/bas-man/file-tvshow-organize

importer manager media organiser organizer plex show tv

Last synced: 21 days ago
JSON representation

Perl Module to move show files into a matching Show/Season folder structure. Optionally place all files into a single Show Folder.

Awesome Lists containing this project

README

          

File-TVShow-Organize version 0.360.1 / 0.36.1
============================

This module makes it easier to move TV Show files into the correct Show
folder and also place them in to the correct season or specials folder.
This may be of use if you have a large media server which you are trying to
keep organised.

It might also be used to move files into season folders if you have merely
dumped these files into a single folder in the beginning.

INSTALLATION

To install this module type the following:

perl Makefile.PL
make
make test
make install

Example Usage:

#!/bin/perl

use strict;
use warnings;

use File::TVShow::Organize;

my $obj = File::TVShow::Organize->new( {
Exceptions => 'S.W.A.T.2017:S.W.A.T 2017|Other:other' }
);

$obj->new_show_folder("/tmp/");
$obj->show_folder("/absolute/path/to/TV Shows");

if((!defined $obj->new_show_folder()) || (!defined $obj->show_folder())) {
print "Verify your paths. Something in wrong\n";
exit;
}

# Create a hash for matching file name to Folders
$obj->create_show_hash();

# Delete files after processing.
The default is to rename the files by appending ".done"
$obj->delete(1);

# Do not create sub folders under the the show's parent folder.
All files should be dumped # into the parent folder. The default is to create
season folders.
$obj->season_folder(0);

# Batch process a folder containing TV Show files
$obj->process_new_shows();

# Report any file names which could not be handled automatically.
$obj->were_there_errors();

#end of program

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the
perldoc command.

perldoc File::TVShow::Organize

You can also look for information at:

GitHub
https://github.com/Bas-Man/File-TVShow-Organize
https://github.com/Bas-Man/File-TVShow-Organize/issues

RT, CPAN's request tracker (report bugs here)
https://rt.cpan.org/NoAuth/Bugs.html?Dist=File-TVShow-Organize

CPAN Ratings
https://cpanratings.perl.org/d/File-TVShow-Organize

Search CPAN
https://metacpan.org/release/File-TVShow-Organize

DEPENDENCIES

This module requires these other modules and libraries:

File::TVShow::Info;
File::Path;
File::Copy;
IPC::Cmd;
Carp;

These files are of course accessible through CPAN

COPYRIGHT AND LICENCE

Copyright (C) 2018-2020 by Adam Spann

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.12.4 or,
at your option, any later version of Perl 5 you may have available.