Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


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:

Video AIP Config

  • Option One is to enable synchronizing (copying) 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 for an additional copy of your access files. This enables you to have copies of all access files added to one central folder for more easy management. Enable this by entering Y and a path (or ssh path) following derivative_destination.


Original .MKVs are on HardDrive_A. We want the preservation packages synced to HardDrive_B, and copies of the access files saved to HardDrive_C. We also want the preservation packages on HardDrive_A to be deleted once they are synced to HardDrive_B.

VideoAIP Example

Creating Preservation Packages:

Before you begin:

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

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

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

This will create an archival package for each .mkv 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 [drag each a log file here] -l [drag additional log here] -l [drag additional log here, etc.] [drag associated .mkv here]


videoaip -l auto [drag each .mkv 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 .mkv.



videotools scripts are licensed under a BSD 3-Clause License


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

You can’t perform that action at this time.