Tool for organizing a bunch of image files into time-lapse "takes."
Perl
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
README.md
takesplit.pl

README.md

takesplit

Perl script for organizing a bunch of image files into time-lapse "takes."

This requires the Perl ExifTool module: http://www.sno.phy.queensu.ca/~phil/exiftool/

NAME
    takesplit.pl -- Organize a bunch of image files into time-lapse "takes."

SYNOPSIS 
    takesplit.pl -i <input_dir> [-o <output_dir>] [-r] [-m <min_frames>] 

DESCRIPTION
    This script is useful for organizing a bunch of images (say, on one card),
    that contain multiple time-lapse sequences. It examines the time intervals
    between them and makes its best guess as to how they should be grouped.
    There may be ambiguous situtations where it's not obvious which image
    belongs to which sequence, in which case it will copy the same image
    to both sequences.

    A subdirectory of the specificed output_dir is created for each take,
    and the images for that take are *copied* to it. Any images not used
    in any of the takes are copied to the "noset" subdirectory.

    A summary of the analysis and resulting directory structure is written
    to STDOUT. It would probably be useful to redirect this output to a 
    file.

    The options are as follows:

    -i <input_dir>  
        Directory containing image files to be grouped.

    -o <output_dir>
        Directory to write grouped files to. Required unless -r flag is used.

    -r  Report only. Produces summary of analysis without copying any files.

    -m <min_frames>
        Minimun number of frames required for a sequence. Default is 3.

    An example usage is:

    takesplit.pl -i /Volumes/CARD1 -o ~/Photos/2014-01-05-TLShoot > ~/Photos/2014-01-05-TLShoot/summary.txt

Here is an example of the report output:

Infile count:   1171

Set count:      7

Directory:  2013-12-23-14-38-55
File count: 101
Starts:     2013:12:23 14:38:55
Ends:       2013:12:23 14:47:14
Interval avg:   4.99
First file: input//IMG_8889.CR2 
Last file:  input//IMG_8989.CR2

Directory:  2013-12-23-14-47-26
File count: 360
Starts:     2013:12:23 14:47:26
Ends:       2013:12:23 15:17:20
Interval avg:   4.99721448467967
First file: input//IMG_8990.CR2 
Last file:  input//IMG_9349.CR2

Directory:  2013-12-23-15-17-29
File count: 251
Starts:     2013:12:23 15:17:29
Ends:       2013:12:23 15:38:18
Interval avg:   4.996
First file: input//IMG_9350.CR2 
Last file:  input//IMG_9600.CR2

Directory:  2013-12-23-15-44-49
File count: 26
Starts:     2013:12:23 15:44:49
Ends:       2013:12:23 15:46:55
Interval avg:   5.04
First file: input//IMG_9606.CR2 
Last file:  input//IMG_9631.CR2

Directory:  2013-12-23-15-51-14
File count: 243
Starts:     2013:12:23 15:51:14
Ends:       2013:12:23 16:11:24
Interval avg:   5
First file: input//IMG_9663.CR2 
Last file:  input//IMG_9905.CR2

Directory:  2013-12-23-16-21-27
File count: 5
Starts:     2013:12:23 16:21:27
Ends:       2013:12:23 16:21:47
Interval avg:   5
First file: input//IMG_9914.CR2 
Last file:  input//IMG_9918.CR2

Directory:  2013-12-23-16-22-02
File count: 182
Starts:     2013:12:23 16:22:02
Ends:       2013:12:23 16:37:06
Interval avg:   4.99444444444444
First file: input//IMG_9919.CR2 
Last file:  input//IMG_0101.CR2

Unusued files:  3
Directory:  noset