Skip to content

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

Notifications You must be signed in to change notification settings

Bas-Man/File-TVShow-Organize

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

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

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages