Add README file with documentation for using scripts
This commit is contained in:
parent
03ab0ee9f4
commit
bb85a87b4c
|
@ -0,0 +1,64 @@
|
||||||
|
README for csc-media
|
||||||
|
Elana Hashman
|
||||||
|
November 3, 2014
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
|
||||||
|
These FFMPEG scripts are intended to help you cut and compress assorted videos:
|
||||||
|
in particular, the MTS raw output from the CSC's video camera.
|
||||||
|
|
||||||
|
|
||||||
|
How to use the scripts
|
||||||
|
======================
|
||||||
|
|
||||||
|
1. First, prepare your video files. To merge files, if you are using MTS
|
||||||
|
format, simply cat the files together, i.e.
|
||||||
|
|
||||||
|
cat vid1.mts vid2.mts vid3.mts > the_whole_vid.mts
|
||||||
|
|
||||||
|
If you need to trim the files, you can use the cut-mts.sh script:
|
||||||
|
|
||||||
|
./cut-mts.sh vid.mts 00:05:00 00:10:00
|
||||||
|
input start-time length
|
||||||
|
|
||||||
|
2. Run encode.sh on the file you're interested in compressing. This will run a
|
||||||
|
two-pass compress and encode to produce a final video file.
|
||||||
|
|
||||||
|
Caveats:
|
||||||
|
- encode.sh must be run in the same directory as the video files
|
||||||
|
- encode.sh's dependencies need to be in the same directory
|
||||||
|
- Therefore, you should clone a copy of csc-media into any directory you
|
||||||
|
want to run the job.
|
||||||
|
- You can only run encode.sh on one file in one directory. Otherwise, the
|
||||||
|
video cues from the first pass will be overwritten. If you want to run
|
||||||
|
simultaneous encoding jobs, clone a copy of the scripts into each
|
||||||
|
directory with each file you want to encode.
|
||||||
|
|
||||||
|
Invoke the script like this, preferably in a screen session due to job
|
||||||
|
length:
|
||||||
|
|
||||||
|
./encode.sh vid.mts vid ""
|
||||||
|
input prefix, output files extra ffmpeg flags (usually null)
|
||||||
|
|
||||||
|
3. Wait.
|
||||||
|
|
||||||
|
4. Wait.
|
||||||
|
|
||||||
|
5. Check htop, keep waiting.
|
||||||
|
|
||||||
|
6. Wait.
|
||||||
|
|
||||||
|
6. Voila, your videos have been compressed and encoded! Additionally, the
|
||||||
|
scripts will even kindly provide you with jpg thumbnails for the website.
|
||||||
|
|
||||||
|
|
||||||
|
Notes
|
||||||
|
=====
|
||||||
|
|
||||||
|
All compression schemes except mp4 are currently disabled in ./encode.sh. None
|
||||||
|
of the other scripts are currently verified to be working.
|
||||||
|
|
||||||
|
These scripts use a copy of ffmpeg in Peter ``BOFH'' Barfuss' home directory.
|
||||||
|
If those become unavailable for some reason, you will need to set it to the
|
||||||
|
system-wide binary.
|
||||||
|
|
Loading…
Reference in New Issue