From ab05f509ebcde92b4fc240480221e0894125382c Mon Sep 17 00:00:00 2001 From: Andrew Weaver Date: Wed, 16 Aug 2017 15:34:21 -0700 Subject: [PATCH] Update README.md --- README.md | 40 +++++++++++++++++++++++++++++++++++++++- 1 file changed, 39 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index b4e51ad..bea2378 100644 --- a/README.md +++ b/README.md @@ -1 +1,39 @@ -# videotools \ No newline at end of file +# videotools + +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` + +Audiotools 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**: For a given video file, 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 [inputfile]`, help: `videoaip -h`, crop mode: `videoaip -c`,set up configuration for options `videoaip -e` + +**VideoAIP Configuration:** + +When you run `videoaip -e` you will see a configuration screen like this: +![AudioAIP Config](https://github.com/pugetsoundandvision/audiotools/blob/master/supplemental/audioaipconfig.png) + +To set your options, simply type them between the respective quotation marks, save the file and quit. + +The options require file paths. An easy way to find the file path for a file or folder is just to drag it into the terminal window and then copy the results. It should looks something like `/Users/username/Desktop/myfolder` + +* The first option is to enable synchronizing your preservation package to a second location. Enable this by entering "Y" and a path (or ssh path) for a destination. Something like: `sync_choice="Y"` and `destination="path to your folder here"` +* The second option allows you to set a location to make an extra copy of your access files (in addition to the ones contained in your package). 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) for a destination. Something like: `derivative_choice="Y"` and `destination="path to your folder here"` + +## Licenses + +Scripts + +videotools scripts are licensed under a [BSD 3-Clause License](https://github.com/pugetsoundandvision/audiotools/blob/master/LICENSE) + +Documentation + +Creative Commons License
All associated documentation for the audiotools scripts are licensed under a Creative Commons Attribution 4.0 International License unless otherwise noted.