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.