Merge pull request #414 from amiaopensource/kfrn/tweaks

Tweaks: naming, whitespace, collapse all recipes
Update 'show/hide recipes' (expand/collapse) functionality
2025-10-25 15:10:52 +02:00 · 2019-12-17 11:48:57 -05:00 · 2019-12-18 05:42:29 +13:00 · 2019-12-17 22:36:47 +13:00 · 2019-12-17 22:34:37 +13:00 · 2019-12-11 12:08:30 -05:00
4 changed files with 106 additions and 28 deletions
--- a/index.html
+++ b/index.html
@@ -2,7 +2,8 @@
 <html lang="en">
 <head>
  <title>ffmprovisr</title>
-  <meta name="viewport" charset="utf-8" content="text/html, width=device-width, initial-scale=1">
+  <meta name="viewport" content="text/html, width=device-width, initial-scale=1">
+  <meta charset="utf-8">
  <link rel="stylesheet" href="css/css.css">
  <link rel="icon" href="img/vhs.ico">
  <script src="js/jquery.min.js"></script>
@@ -18,7 +19,7 @@
  <nav class="sidebar well">
    <h2 class="heading">Table of Contents</h2>
    <a href="#about"><div class="contents-list">About this resource</div></a>
-    <div id="open-all" class="contents-list">Show/hide all recipes</div>
+    <div id="toggle-expand-collapse-all" class="contents-list">Expand/collapse all recipes</div>
    <a href="#basics"><div class="contents-list">FFmpeg basics</div></a>
    <a href="#concepts"><div class="contents-list">Advanced FFmpeg concepts</div></a>
    <a href="#rewrap"><div class="contents-list">Change container (rewrap)</div></a>
@@ -218,6 +219,36 @@
    </div>
    <!-- End Basic rewrap command -->

+    <!-- BWF -->
+    <label class="recipe" for="bwf">Convert to (or create) Broadcast WAV</label>
+    <input type="checkbox" id="bwf">
+    <div class="hiding">
+      <h5>Generate Broadcast WAV</h5>
+      <p><code>ffmpeg -i <em>input_file.wav</em> -c copy -write_bext 1 -metadata field_name='Content' <em>output_file.wav</em></code></p>
+      <p>This command will write a file in the Broadcast Wave Format (BWF) containing a BEXT chunk with related metadata.</p>
+      <dl>
+        <dt>ffmpeg</dt><dd>starts the command</dd>
+        <dt>-i <em>input_file.wav</em></dt><dd>path and name of the input file</dd>
+        <dt>-c copy</dt><dd>this will copy the encoding/sample rate etc from the input. If not using a WAV as the input file you will have to specify codec settings in place of this.</dd>
+        <dt>-write_bext 1</dt><dd>tells FFmpeg to write a BEXT chunk, the part of the file where BWF metadata is stored.</dd>
+        <dt>-metadata field_name='Content'</dt><dd>This is where you can specify which BEXT fields to write, and what information to fill them with by replacing <code>field_name</code> and <code>'Content'</code> respectively. See below for additional details.</dd>
+      </dl>
+      <p>Notes: You can choose which fields to write by repeating <code>-metadata field_name='Content'</code> for each desired field. Flags for commonly used fields (such as those recommended by the <a href="http://www.digitizationguidelines.gov/audio-visual/documents/Embed_Guideline_20120423.pdf">FADGI guidelines</a>) are as follows:</p>
+      <ul>
+        <li>description</li>
+        <li>originator</li>
+        <li>originator_reference</li>
+        <li>origination_date</li>
+        <li>origination_time</li>
+        <li>coding_history</li>
+        <li>IARL</li>
+      </ul>
+      <p>Example: <code>-metadata originator='US, UW Libraries'</code></p>
+      <p>Additionally, users should be aware that BWF metadata fields are limited by characters, with some such as OriginatorReference maxing out at 32. Specific information can be found in the <a href="https://tech.ebu.ch/docs/tech/tech3285.pdf">Broadcast Wave Format specification</a>. Additional examples of BWF metadata usage can be found in the <a href="http://www.dlib.indiana.edu/projects/sounddirections/papersPresent/sd_bp_07.pdf">Sound Directions report</a> by Indiana University and Harvard.</p>
+      <p class="link"></p>
+    </div>
+    <!-- ends BWF -->
+
    <!-- Rewrap DV -->
    <label class="recipe" for="rewrap-dv">Rewrap DV video to .dv file</label>
    <input type="checkbox" id="rewrap-dv">
@@ -697,7 +728,7 @@
      <p class="link"></p>
    </div>
    <!-- ends Modify speed -->
-      
+
    <!-- Synchronize video and audio streams -->
    <label class="recipe" for="sync_streams">Synchronize video and audio streams</label>
    <input type="checkbox" id="sync_streams">
@@ -773,13 +804,13 @@
      <p>It's also possible to specify the crop position by adding the x and y coordinates representing the top left of your cropped area to your crop filter, as such:</p>
      <p><code>ffmpeg -i <em>input_file</em> -vf "crop=<em>width</em>:<em>height</em>[:<em>x_position</em>:<em>y_position</em>]" <em>output_file</em></code></p>
      <h5>Examples</h5>
-      <p>The original frame, a screenshot of the SMPTE colorbars:</p>
+      <p>The original frame, a screenshot of Maggie Cheung in the film <i>Hero</i>:</p>
      <img class="sample-image" src="img/crop_example_orig.png" alt="VLC screenshot of Maggie Cheung">
-      <p>Result of the command <code>ffmpeg -i <em>smpte_colorsbars.mov</em> -vf "crop=500:500" <em>output_file</em></code>:</p>
+      <p>Result of the command <code>ffmpeg -i <em>maggie.mov</em> -vf "crop=500:500" <em>output_file</em></code>:</p>
      <img class="sample-image-small" src="img/crop_example_aftercrop1.png" alt="VLC screenshot of Maggie Cheung, cropped from original">
-      <p>Result of the command <code>ffmpeg -i <em>smpte_colorsbars.mov</em> -vf "crop=500:500:0:0" <em>output_file</em></code>, appending <code>:0:0</code> to crop from the top left corner:</p>
+      <p>Result of the command <code>ffmpeg -i <em>maggie.mov</em> -vf "crop=500:500:0:0" <em>output_file</em></code>, appending <code>:0:0</code> to crop from the top left corner:</p>
      <img class="sample-image-small" src="img/crop_example_aftercrop2.png" alt="VLC screenshot of Maggie Cheung, cropped from original">
-      <p>Result of the command <code>ffmpeg -i <em>smpte_colousbars.mov</em> -vf "crop=500:300:500:30" <em>output_file</em></code>:</p>
+      <p>Result of the command <code>ffmpeg -i <em>maggie.mov</em> -vf "crop=500:300:500:30" <em>output_file</em></code>:</p>
      <img class="sample-image-small" src="img/crop_example_aftercrop3.png" alt="VLC screenshot of Maggie Cheung, cropped from original">
      <p class="link"></p>
    </div>
@@ -813,7 +844,7 @@
      <p class="link"></p>
    </div>
    <!-- ends Change video color to black and white -->
-      
+
    </div>
    <div class="well">
    <h2 id="audio-files">Change or view audio properties</h2>
@@ -1867,7 +1898,7 @@
        <dt>$output</dt><dd>The output file is set to the value of the <code>$output</code> variable declared above: i.e., the current file name with an .mkv extension.</dd>
        <dt>}</dt><dd>Closes the code block.</dd>
      </dl>
-      <p><strong>Note:</strong> the PowerShell script (.ps1 file) and all .mp4 files to be rewrapped must be contained within the same directory, and the script must be run from that directory.<p>
+      <p><strong>Note:</strong> the PowerShell script (.ps1 file) and all .mp4 files to be rewrapped must be contained within the same directory, and the script must be run from that directory.</p>
      <p>Execute the .ps1 file by typing <code>.\rewrap-mp4.ps1</code> in PowerShell.</p>
      <p>Modify the script as needed to perform different transcodes, or to use with ffprobe. :)</p>
      <p class="link"></p>
@@ -1997,6 +2028,33 @@
    </div>
    <!-- ends Get checksum for video/audio stream -->

+    <!-- Get checksum for all video/audio streams -->
+    <label class="recipe" for="get_streamhash">Get individual checksums for all video/audio streams ("Streamhash")</label>
+    <input type="checkbox" id="get_streamhash">
+    <div class="hiding">
+      <h5>Get individual checksums for all video/audio streams ("Streamhash")</h5>
+      <p><code>ffmpeg -i <em>input_file</em> -map 0 -f streamhash -hash md5 - -v quiet</code></p>
+      <p>The outcome is very similar to that of "-f hash", except you get one hash per-stream, instead of one (summary) hash. Another benefit is that you don't have to know which streams, or how many to expect in the source file. This is very handy for hashing mixed born-digital material.</p>
+      <p>This script will perform a fixity check on all audio and video streams in the file and return one hashcode for each one.  This is useful for e.g. being able to change to container/codec format later on and validate it matches the original source.</p>
+      <p>The output is formatted for easily processing it further in any kind of programming/scripting language.</p>
+      <dl>
+        <dt>ffmpeg</dt><dd>starts the command</dd>
+        <dt>-i <em>input_file</em></dt><dd>path, name and extension of the input file</dd>
+        <dt>-map 0</dt><dd>map ALL streams from input file to output. If you omit this, ffmpeg chooses only the first "best" (*) stream: 1 for audio, 1 for video (not all streams).</dd>
+        <dt>-f streamhash -hash md5</dt><dd>produce a checksum hash per-stream, and set the hash algorithm to md5. See the official <a href="https://www.ffmpeg.org/ffmpeg-formats.html#streamhash-1" target="_blank">documentation on streamhash</a> for other algorithms and more details.</dd>
+        <dt>-</dt><dd>FFmpeg syntax requires a specified output, and <code>-</code> is just a place holder. No file is actually created. Choose an output filename to write the hashcode lines into a textfile.</dd>
+        <dt>-v quiet</dt><dd>(Optional) Disables FFmpeg's processing output. With this option it's easier to see the text output of the hashes.</dd>
+      </dl>
+      <p>The output looks like this, for example (1 video, 2 audio streams):
+      <code>
+      0,v,MD5=89bed8031048d985b48550b6b4cb171c<br>
+      0,a,MD5=36daadb543b63610f63f9dcff11680fb<br>
+      1,a,MD5=f21269116a847f887710cfc67ecc3e6e
+      </code></p>
+      <p class="link"></p>
+    </div>
+    <!-- ends Get checksum for all video/audio streams -->
+
    <!-- QCTools Report -->
    <label class="recipe" for="qctools">QCTools report (with audio)</label>
    <input type="checkbox" id="qctools">
@@ -2743,7 +2801,7 @@
      <input type="checkbox" id="flac-tool">
      <div class="hiding">
        <h5>About flac tool</h5>
-        <p>The flac tool is the tool created by the FLAC project to transcode to/from FLAC and to manipulate metadata in FLAC files. One advantage it has over other tools used to transcode into FLAC is the capability of embedding foreign metadata (such as BWF metadata). This means that it is possible to compress a BWF file into FLAC and maintain the ability to transcode back into an identical BWF, metadata and all. For a more detailed explanation, see <a href="http://dericed.com/2013/flac-in-the-archives/" target="_blank">Dave Rice's article</a> on the topic, from which the following commands are adapted.</p> 
+        <p>The flac tool is the tool created by the FLAC project to transcode to/from FLAC and to manipulate metadata in FLAC files. One advantage it has over other tools used to transcode into FLAC is the capability of embedding foreign metadata (such as BWF metadata). This means that it is possible to compress a BWF file into FLAC and maintain the ability to transcode back into an identical BWF, metadata and all. For a more detailed explanation, see <a href="http://dericed.com/2013/flac-in-the-archives/" target="_blank">Dave Rice's article</a> on the topic, from which the following commands are adapted.</p>
        <h3>Transcode to FLAC</h3>
        <p>Use this command to transcode from WAV to FLAC while maintaining BWF metadata</p>
        <p><code>flac --best --keep-foreign-metadata --preserve-modtime --verify <em>input.wav</em></code></p>
--- a/js/js.js
+++ b/js/js.js
@@ -32,11 +32,21 @@ $(document).ready(function() {
    }
  })

-  // open all windows if button is clicked
-  $('#open-all').on("click", function(){
-    $('input[type=checkbox]').each(function(){
-      this.checked = !this.checked;
-    })
-  });
+  // Collapse all recipes when button is clicked
+  $('#toggle-expand-collapse-all').on("click", function(){
+    var checkboxes = $('input[type=checkbox]');
+    var anyRecipesOpen = $(checkboxes).is(':checked');

+    if (anyRecipesOpen) {
+      // Collapse all
+      $('input[type=checkbox]').each(function() {
+        this.checked = false;
+      });
+    } else new Promise(function(resolve, reject) {
+      // Expand all
+      $('input[type=checkbox]').each(function() {
+        this.checked = true;
+      });
+    });
+  });
 });
--- a/readme.md
+++ b/readme.md
@@ -80,34 +80,39 @@ You can read our contributor code of conduct [here](https://github.com/amiaopens

 ## Contributors
 * Gathered using [octohatrack](https://github.com/LABHR/octohatrack)
-
-*Code Contributors*:
+  
+*Code Contributors*:  
 ablwr (Ashley)  
+alavigne12 (A. Lavigne)  
+Anushka-codergirl (Anushka Raj)  
 bastibeckr (Basti Becker)  
-b00giehead (Joanna White)  
 bturkus  
 dericed (Dave Rice)  
+digitensions (Joanna White)  
 edsu (Ed Summers)  
 jamessam (Jim Sam)  
 jfarbowitz (Jonathan Farbowitz)  
 kfrn (Katherine Frances Nagels)  
 kgrons (Kathryn Gronsbell)  
 kieranjol (Kieran O'Leary)  
-llogan (Lou)  
+llogan (Lou Logan)  
+macasaurusrex (Maura)  
 mgiraldo (Mauricio Giraldo)  
 pjotrek-b (Peter B.)  
 privatezero (Andrew Weaver)  
 retokromer (Reto Kromer)  
 rfraimow  
-
-*All Contributors*:
+  
+All Contributors:  
 ablwr (Ashley)  
+alavigne12 (A. Lavigne)  
+Anushka-codergirl (Anushka Raj)  
 audiovisualopen  
 bastibeckr (Basti Becker)  
-b00giehead (Joanna White)  
 brainwane (Sumana Harihareswara)  
 bturkus  
 dericed (Dave Rice)  
+digitensions (Joanna White)  
 drodz11 (Dave Rodriguez)  
 edsu (Ed Summers)  
 EG-tech (Ethan Gates)  
@@ -122,7 +127,9 @@ kellyhaydon (metacynic)
 kfrn (Katherine Frances Nagels)  
 kgrons (Kathryn Gronsbell)  
 kieranjol (Kieran O'Leary)  
-llogan (Lou)  
+llogan (Lou Logan)  
+macasaurusrex (Maura)  
+mercuryswitch  
 mgiraldo (Mauricio Giraldo)  
 mulvya  
 nkrabben (Nick Krabbenhoeft)  
@@ -132,12 +139,13 @@ retokromer (Reto Kromer)
 rfraimow  
 richardpl (Paul B Mahol)  
 ross-spencer (Ross Spencer)  
+taschenbach (Tommy Aschenbach)  
 todrobbins (Tod Robbins)  
-
+  
 Repo: amiaopensource/ffmprovisr  
-Code Contributors: 17  
-All Contributors: 32   
-Last updated: 2019-02-11  
+GitHub Contributors: 20  
+All Contributors: 37  
+Last updated: 2019-12-11 

 ## AVHack Team

--- a/recipes.txt
+++ b/recipes.txt
@@ -141,6 +141,8 @@ ffmpeg -i input_file -af "asetnsamples=n=48000" -f framemd5 -vn output_file
 ffmpeg -i input_file -map 0:v:0 -c:v copy -f md5 output_file_1 -map 0:a:0 -c:a copy -f md5 output_file_2
 # Get checksum for video/audio stream
 ffmpeg -loglevel error -i input_file -map 0:v:0 -f hash -hash md5 -
+# Get individual checksums for all video/audio streams ("Streamhash")
+ffmpeg -i input_file -map 0 -f streamhash -hash md5 - -v quiet
 # QCTools report (with audio)
 ffprobe -f lavfi -i "movie=input_file:s=v+a[in0][in1], [in0]signalstats=stat=tout+vrep+brng, cropdetect=reset=1:round=1, idet=half_life=1, split[a][b];[a]field=top[a1];[b]field=bottom, split[b1][b2];[a1][b1]psnr[c1];[c1][b2]ssim[out0];[in1]ebur128=metadata=1, astats=metadata=1:reset=1:length=0.4[out1]" -show_frames -show_versions -of xml=x=1:q=1 -noprivate | gzip > input_file.qctools.xml.gz
 # QCTools report (no audio)
Author	SHA1	Message	Date
Ashley	e4c327bbac	Merge pull request #414 from amiaopensource/kfrn/tweaks Tweaks: naming, whitespace, collapse all recipes	2019-12-17 11:48:57 -05:00
kfrn	4359d6dd4a	Update 'show/hide recipes' (expand/collapse) functionality Previously, it would expand the recipe if currently collapsed, and vice versa. Now, if any recipes are currently expanded, it will collapse all; otherwise, all recipes will be expanded. The 'expand all' functionality is necessary for full-text searching.	2019-12-18 05:42:29 +13:00
kfrn	d184ed2fe9	Code style: remove trailing whitespace	2019-12-17 22:36:47 +13:00
kfrn	089725a753	Crop video recipe: correct name/description of example images	2019-12-17 22:34:37 +13:00
Ashley	897f1b1616	Merge pull request #413 from amiaopensource/update-contributors Update contributors list with octohatrack	2019-12-11 12:08:30 -05:00
Ashley	358a2ec23b	add "last updated"	2019-12-11 12:04:09 -05:00
Ashley Blewer	de6c08a58d	Update contributors list with octohatrack	2019-12-10 17:56:18 -05:00
Ashley	0d1fc1bfe8	Merge pull request #412 from amiaopensource/BWF_name fix BWF name	2019-12-10 10:41:34 -05:00
Reto Kromer	cbca3ac7ad	fix BWF name	2019-12-10 10:04:07 +01:00
Ashley	bcc425a955	Merge pull request #410 from amiaopensource/add-bext add BWF embedding recipe	2019-12-09 12:15:51 -05:00
weaver	0353c1761e	ch ch ch changes	2019-12-06 08:37:11 -08:00
weaver	e3aa81fb95	add BWF	2019-12-05 16:28:58 -08:00
Ashley	633374f22d	Merge pull request #409 from macasaurusrex/issue-399-meta-tag-validation Update index.html	2019-11-20 10:39:49 -05:00
Maura	1d60060eed	Update index.html fix for ticket 399: meta tag validation error. w3 doesn't like chartset in the same tag as viewport so I split them out based on what was described in the ticket	2019-11-19 18:07:41 -05:00
Reto Kromer	6cfe7f7a47	style cleaning	2019-11-07 10:37:45 +01:00
Reto Kromer	fc63116e2f	Merge pull request #407 (add streamhash to recipe list)	2019-11-07 10:26:06 +01:00
Reto Kromer	f74f0cde93	add streamhash to recipe list	2019-11-06 06:57:37 +01:00
Ashley	832026b57c	Merge pull request #406 from pjotrek-b/gh-pages Added "streamhash" recipe.	2019-11-05 17:25:57 -05:00
Peter Bubestinger-Steindl	db330a3a0c	Indent <p> inwards and add missing </p>.	2019-11-05 08:41:19 +01:00
Peter Bubestinger-Steindl	c88008a68f	Added "streamhash" recipe.	2019-11-04 22:55:07 +01:00