Merge pull request #338 from amiaopensource/weaver-branch

Weaver branch

index.html

@@ -39,6 +39,8 @@ <h2 class="heading">Table of Contents</h2>
     <a href="#other"><div class="contents-list">Something else</div></a>
     <a href="#similar-tools"><div class="contents-list">Similar tools: tips &amp; tricks</div></a>
     <a href="#imagemagick"><div class="contents-list">ImageMagick</div></a>
+    <a href="#flac-tool"><div class="contents-list">flac tool</div></a>
+
   </nav>
 
   <div class="content">
@@ -104,6 +106,24 @@ <h3>Streaming vs. Saving</h3>
     <div class="well">
 
     <h2 id="concepts">Learn about more advanced FFmpeg concepts</h2>
+    <!-- Codec Defaults explanation -->
+    <label class="recipe" for="codec-defaults">Codec defaults</label>
+    <input type="checkbox" id="codec-defaults">
+    <div class="hiding">
+      <h3>Codec Defaults</h3>
+      <p>Unless specified, FFmpeg will automatically set codec choices and codec parameters based off of internal defaults. These defaults are applied based on the file type used in the output (for example <code>.mov</code> or <code>.wav</code>).</p>
+      <p>When creating or transcoding files with FFmpeg, it is important to consider codec settings for both audio and video, as the default options may not be desirable in your particular context. The following is a brief list of codec defaults for some common file types:</p>
+      <ul>
+        <li><code>.avi</code>: Audio Codec: mp3, Video Codec: mpeg4</li>
+        <li><code>.mkv</code>: Audio Codec: ac3, Video Codec: h.264</li>
+        <li><code>.mov</code>: Audio Codec: aac, Video Codec: h.264</li>
+        <li><code>.mp4</code>: Audio Codec: aac, Video Codec: h.264</li>
+        <li><code>.mpg</code>: Audio Codec: mp2, Video Codec: mpeg1video</li>
+        <li><code>.wav</code>: Audio Codec: pcm_s16le (16 bit PCM)</li>
+      </ul>
+    </div>
+    <!-- End Codec Defaults -->
+
     <!-- Filtergraph explanation -->
     <label class="recipe" for="filtergraphs">Filtergraphs</label>
     <input type="checkbox" id="filtergraphs">
@@ -2498,8 +2518,32 @@ <h3>Resize to width</h3>
         <p class="link"></p>
       </div>
       <!-- ends Resize to width -->
-
     </div>
+    <div class="well">
+      <h2 id="flac">flac</h2>
+      <!-- flac tool -->
+      <label class="recipe" for="flac-tool">Transcoding to/from FLAC</label>
+      <input type="checkbox" id="flac-tool">
+      <div class="hiding">
+        <h3>About flac tool</h3>
+        <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>
+        <dl>
+          <dt>flac</dt><dd>starts the command</dd>
+          <dt>-i <em>input_file.ext</em></dt><dd>path and name of the input file</dd>
+          <dt>--best</dt><dd>sets the file for the most efficient compression (resulting in a smaller file at the expense of a slower process).</dd>
+          <dt>--keep-foreign-metadata</dt><dd>tells the flac tool to maintain original metadata within the FLAC file.</dd>
+          <dt>--preserve-modtime</dt><dd>preserves the file timestamps of the input file.</dd>
+          <dt>--verify</dt><dd>verifies the validity of the output file.</dd>
+        </dl>
+        <h3>Transcode from FLAC</h3>
+        <p>Use this command to transcode from FLAC to reconstruct original BWF file. Command is the same as the prior command with the exception of substituting <code>--decode</code> for <code>best</code> and changing the input to a <code>.flac</code> file.</p>
+        <p><code>flac --decode --keep-foreign-metadata --preserve-modtime --verify <em>input.flac</em></code></p>
+      <p class="link"></p>
+      </div>
+      <!-- End About flac -->
   </div><!-- ends "content" -->
 
 <!-- sample example -->