Skip to content

Commit

Permalink
Added example of creating a video file compatible with BlackMagic Des…
Browse files Browse the repository at this point in the history
…ign HyperDeck Studio Mini recorder.
  • Loading branch information
nicklansley committed Apr 10, 2021
1 parent f478b34 commit 80292e3
Showing 1 changed file with 5 additions and 0 deletions.
5 changes: 5 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,8 @@ Using 'docker run' you attach a volume of any name to a host directory where you
In the examples below, a directory called '/av' is created within the container, which maps to the current directory on your host computer (in this case I am using Windows Powershell and ${PWD} is a variable describing the current working directory).
You then tell FFMPEG or LAME where the input file is and where the output will be saved by using the file path in the format '/av/myfile'.

If you have pulled the docker image instead of building from this repo, use "nicklansley/allav" rather than just "allav" in these comnand line examples.

Take a look at these examples (you are welcome to test
with the video file 'nicklansley-allav-testfile.mp4' included in this repository):

Expand All @@ -53,6 +55,9 @@ with the video file 'nicklansley-allav-testfile.mp4' included in this repository
6 > Here I use FFMPEG to build an MP4 video from an M3U8 playlist file (at a much faster speed than realtime playback!). Note the use of the '-protocol_whitelist' parameter
before the -i input file. M3U8 files will have web links and by default, http and https source file locations are not whitelisted:
<pre>docker run -v C:\Users\nick\Downloads:/av/ allav ffmpeg -protocol_whitelist file,http,https,tcp,tls -i /av/playlist.m3u8 -c copy -bsf:a aac_adtstoasc /av/output.mp4</pre>
7 > This example converts a video file to playback successfully when copied directly (or FTP'd) to an SD card in a BlackMagic Design HyperDeck Studio Mini with it set to Record "Codec: H.264 Low" and "Audio Channels: 2 Channels (AAC)". This enables the creation of a playlist of many video files because each file plays at between 5 and 9 Mbps so uses much less disk space than ProRes and DNxHD/HX formats, and allows the use of slower SD cards.
<pre>docker run -v C:\Users\nick\Downloads:/av/ allav ffmpeg -i /av/nicklansley-allav-testfile.mp4 -c:v libx264 -profile:v main -preset slow -video_track_timescale 60 -crf 22 -c:a libfdk_aac -q:a 192 -ar 48000 -filter:v fps=60,scale="1920:1080" "HyperDeckMiniCompatibleFile.mp4"</pre>

### Which FFMPEG Libraries have been enabled?
As well as the standard libraries for video, audio and image that is native to FFMPEG, the following external
libraries have been compiled into the version used in this image. <a href="https://ffmpeg.org/ffmpeg-codecs.html">For more details - and examples of use - for each of the codecs here</a>.
Expand Down

0 comments on commit 80292e3

Please sign in to comment.