| title | layout | published | nav_order |
|---|---|---|---|
Video Processing with FFmpeg |
default |
true |
8 |
Table of contents
{: .text-delta } 1. TOC {:toc}
🚧 This page is currently under construction 🚧
This technical guide was created as part of the archiving workflow for PARADISEC. Some of the content may not be relevant for general users.
Last updated: 9 February 2024
FFmpeg is an efficient and cost-effective way to process video. It is done by using a command line interface (CLI), but once the workflow is set up, it is relatively simple.
1. Installation links fo Mac:
Because this can be a tricky process to install, here are some helpful sites:
- How to install FFmpeg{:target="_blank"}
- Installing ffmpeg and ffprobe on macOS manually{:target="_blank"}
To test if you have installed FFmpeg correctly, just type ffmpeg in Terminal and hit Return. Information about the version of FFmpeg as well as enabled libraries should appear in your terminal window as seen in the image below.
man ffmpeg
2. Installation on Windows
- Download executable file: FFmpeg{:target="_blank"}
Helpful sites for installation on Windows:
- How to install FFmpeg{:target="_blank"}
- How to install FFmpeg on Windows{:target="_blank"}
If you have multiple .MOV files you want to transcode:
Place all .MOV files in one folder and navigate to that folder in Terminal. Then type (or copy) this code into the Terminal:
for i in *.MOV; do ffmpeg -i “$i” -c:v libx264 -pix_fmt yuv420p -preset veryslow -crf 18 -c:a aac “$(basename “$i” .MOV)”.mp4 ; done
If you have a single file:
ffmpeg -i FileName.MOV; -c:v libx264 -pix_fmt yuv420p -preset veryslow -crf 18 -c:a aac FileName.MP4
SCENARIO: Sometimes we receive older, problematic video formats. In this case we had multiple .MOV videos that would not play in QuickTime and could not be opened by Adobe Media Encoder. After a first-pass it was found that some files had audio in only one channel, sometimes left, sometimes right. Also, these were interlaced video and the target was to be progressive.
-af "pan=stereo|FL=FL|FR=FL"
for i in *.mov; do ffmpeg -i "$i" -af "pan=stereo|FL=FL|FR=FL" -c:v libx264 -b:v 50M -vf "yadif,format=yuv420p" "$(basename "$i" .mov)".mp4 ; done
-vf "yadif,format=yuv420p"
for i in *.mov; do ffmpeg -i "$i" -c:a aac -c:v libx264 -b:v 10M -vf "yadif,format=yuv420p" "$(basename "$i" .mov)".mp4 ; done
for i in *.MOV; do ffmpeg -i “$i” -c:v libx264 -pix_fmt yuv420p -preset veryslow -crf 18 -c:a aac “$(basename “$i” .MOV)”.mp4 ; done
| Command | Result |
|---|---|
| for i in *.MOV | points to all of the input files in that directory that are .MOV |
| do ffmpeg | activates ffmpeg |
| -i “$i” | specifically states that for each input file, a variable is created using $ in order to reference it, and “ ” to retain the original filename |
| -c:v libx264 | -c:v is used to make a change to the video codec of the input file; our selected encoder is libx264. This will create an H.264/MPEG-4 AVC file, which is the standard .MP4 format for PARADISEC and generally speaking is an industry standard** |
| -pix_fmt yuv420p | -pix_fmt is used to make a change to the chroma and depth of the input file; our selection is yuv420p. This is the YUV planar colour space with 4:2:0 chroma subsampling. Our chosen encoder libx264 uses chroma/depth subsampling parameters that will yield the closest match to the input file (4:4:4, 4:2:2, or 4:2:0). QuickTime and other players may not be able to decode H.264 files that aren’t 4:2:0, so we overtly specify this in our command |
| -preset veryslow | This sets the preset speed to one of the slowest speeds to create a very high quality compression |
| -crf 18 | The CRF (Constant Rate Factor) for transcoding H.264, 8-bit files using the libx264 encoder is on a scale of 0-51, where 0 is the best and 51 is the worst. If a CRF level isn’t specified, then the default 23 is used. 18 is considered to be virtually visually lossless |
| -c:a aac | -c:a aac is used to re-encode the audio using the AAC audio codec. Note: if you are creating an .MP4, you cannot use the PCM (Pulse-Code Modulation) audio codec |
| “$(basename “$i” .MOV)”.mp4 | “$(basename “$i” .MOV)”.mp4 ensures that all input .MOV files will keep their original names, but will gain the new format extension, .mp4 |
ffmpeg https://ffmpeg.org/documentation.html{:target="_blank"}
ffmprovisor https://amiaopensource.github.io/ffmprovisr/{:target="_blank"}
Blewer, A. (2020). Pragmatic Audiovisual Preservation, DPC Technology Watch Report, p. 45. Digital Preservation Coalition. https://doi.org/10.7207/twr20-10{:target="_blank"}.
Fleischhauer, C., & Bradley, K. (2019). IASA-TC06: Guidelines for the Preservation of Video Recordings, v2019 (IASA Technical Publications IASA-TC06; Technical Committee Standards, Recommended Practices, and Strategies, p. 336). International Association of Sound and Audiovisual Archives. https://www.iasa-web.org/tc06/guidelines-preservation-video-recordings{:target="_blank"}.
⬆️ Back to top
This work was created by Julia Colleen Miller and is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License{:target="_blank"}.
