README.md

videotools

VideoAIP - What it does: For a given video file(s), creates an archival package that adheres to the bagit standard with an mp4 access file, technical metadata and checksums. Once installed, for instructions just type videoaip to see usage information.

This script includes an option to sync package/access copies to a remote or local location for easy backup.

Usage: videoaip [option] [inputfile1] [inputfile2] ... , help: videoaip -h, crop mode: videoaip -c, to include logs: videoaip -l, set up configuration for options videoaip -e

Installation: To install and use these tools in Mac OSX, use the "Terminal" application located in the "Utilities" folder. Use Terminal to install Homebrew (if you don't have it already) and then run the commands:

brew tap pugetsoundandvision/pugetsoundandvision && brew install cask

brew install videotools

Videotools depends on having textmate installed. It will attempt to install this automatically. If for some reason this doesn't work, you can install via:

brew cask install textmate

VideoAIP Configuration:

When you run videoaip -e you will see the following configuration screen:

• Option One is to enable synchronizing your preservation package to a second location. Enable this option by entering Y for sync_choice (between quotation marks) and a path after destination (between parenthesis).

• Option Two: VideoAIP will still create a preservation package at the same location as the original file, even if you have enabled synchronization in Option One. If you wish to delete this package once a copy has been synced to the destination specified above, enter Y after remove_aip.

• Option Three allows you to specify a location to sync an additional copy of your access files. Enable this by entering Y and a path (or ssh path) following derivative_destination.

Creating Preservation Packages:

Before you begin:

• Each video file and it's associated logs should be together in one folder. (I.e., FileA.mkv, FileA.log, FileA.framemd5 should all be in "FileA" folder).

If you only have video files, you can simply run:

videoaip [drag each video file path here, separated by spaces]

This will create an archival package for each file that adheres to the bagit standard with an mp4 access file, technical metadata, and checksums.

If you have logs that are associated with your video files, such as .log or .framemd5 files, you can run:

videoaip -l auto [drag each video file path here, separated by spaces]

This will create an archival package, as above, but will include any logs found in the same folder as the video file.

Licenses

Scripts

videotools scripts are licensed under a BSD 3-Clause License

Documentation

All associated documentation for the videotools scripts are licensed under a Creative Commons Attribution 4.0 International License unless otherwise noted.