Merge pull request #354 from amiaopensource/weaver-branch

CDDA Emphasis

index.html

@@ -38,6 +38,7 @@
     <a href="#perceptual-similarity"><div class="contents-list">Compare similarity of videos</div></a>
     <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="#cdda"><div class="contents-list">CDDA (Audio CD) Ripping Tools</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>
@@ -118,6 +119,7 @@
         <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>.mxf</code>: Audio Codec: pcm_s16le, Video Codec: mpeg2video</li>
         <li><code>.wav</code>: Audio Codec: pcm_s16le (16 bit PCM)</li>
       </ul>
     </div>
@@ -365,7 +367,7 @@
         <dt>-slicecrc 1</dt><dd>Adds CRC information for each slice. This makes it possible for a decoder to detect errors in the bitstream, rather than blindly decoding a broken slice. (Read more <a href="http://ndsr.nycdigital.org/diving-in-head-first/" target="_blank">here</a>).</dd>
         <dt>-slices 16</dt><dd>Each frame is split into 16 slices. 16 is a good trade-off between filesize and encoding time.</dd>
         <dt>-c:a copy</dt><dd>copies all mapped audio streams.</dd>
-        <dt><em>output_file</em>.mkv</dt><dd>path and name of the output file. Use the <code>.mkv</code> extension to save your file in a Matroska container. Optionally, choose a different extension if you want a different container, such as <code>.mov</code> or <code>.avi</code>.</dd>
+        <dt><em>output_file</em>.mkv</dt><dd>path and name of the output file. Use the <code>.mkv</code> extension to save your file in a Matroska container.</dd>
         <dt>-f framemd5</dt><dd>Decodes video with the framemd5 muxer in order to generate MD5 checksums for every frame of your input file. This allows you to verify losslessness when compared against the framemd5s of the output file.</dd>
         <dt>-an</dt><dd>ignores the audio stream when creating framemd5 (audio no)</dd>
         <dt><em>framemd5_output_file</em></dt><dd>path, name and extension of the framemd5 file.</dd>
@@ -881,6 +883,23 @@
     </div>
     <!-- ends RIAA equalization -->
 
+    <!-- CD De-emphasis -->
+    <label class="recipe" for="cd_eq">Reverse CD Pre-Emphasis</label>
+    <input type="checkbox" id="cd_eq">
+    <div class="hiding">
+      <h3>Reverse CD Pre-Emphasis</h3>
+      <p><code>ffmpeg -i <em>input_file</em> -af aemphasis=type=cd <em>output_file</em></code></p>
+      <p>This will apply de-emphasis to reverse the effects of CD pre-emphasis in the somewhat rare case of CDs that were created with this technology. Use this command to create more accurate listening copies of files that were ripped 'flat' (without any de-emphasis) where the original source utilized emphasis. For more information about CD pre-emphasis see the <a href="https://wiki.hydrogenaud.io/index.php?title=Pre-emphasis" target="_blank">Hydrogen Audio page</a> on this subject.</p>
+      <dl>
+        <dt>ffmpeg</dt><dd>starts the command</dd>
+        <dt><em>input_file</em></dt><dd>path, name and extension of the input file</dd>
+        <dt>-af aemphasis=type=cd</dt><dd>activates the aemphasis filter and sets it to use CD equalization</dd>
+        <dt><em>output_file</em></dt><dd>path and name of output file</dd>
+      </dl>
+      <p class="link"></p>
+    </div>
+    <!-- CD De-emphasis -->
+
     <!-- one pass loudnorm -->
     <label class="recipe" for="loudnorm_one_pass">One Pass Loudness Normalization</label>
     <input type="checkbox" id="loudnorm_one_pass">
@@ -1854,11 +1873,30 @@
         <dt>-c:a copy</dt><dd>ensures that FFmpeg will not transcode the audio to a different codec before generating the MD5 (by default FFmpeg will use 16 bit PCM for audio MD5s).</dd>
         <dt><em>output_file_2</em></dt><dd>is the output file for the audio stream MD5.</dd>
       </dl>
-      <p><strong>Note:</strong>The MD5s generated by running this command on WAV files are compatible with those embedded by the <a href="https://mediaarea.net/BWFMetaEdit" target="_blank">BWF MetaEdit</a> tool and can be compared.</p>
+      <p><strong>Note:</strong> The MD5s generated by running this command on WAV files are compatible with those embedded by the <a href="https://mediaarea.net/BWFMetaEdit" target="_blank">BWF MetaEdit</a> tool and can be compared.</p>
       <p class="link"></p>
     </div>
     <!-- ends Create stream md5s -->
 
+    <!-- Get checksum for video/audio stream -->
+    <label class="recipe" for="get_stream_checksum">Get checksum for video/audio stream</label>
+    <input type="checkbox" id="get_stream_checksum">
+    <div class="hiding">
+      <h3>Get checksum for video/audio stream</h3>
+      <p><code>ffmpeg -loglevel error -i <em>input_file</em> -map 0:v:0 -f hash -hash md5 -</code></p>
+      <p>This script will perform a fixity check on a specified audio or video stream of the file, useful for checking that the content within a video has not changed even if the container format has changed.</p>
+      <dl>
+        <dt>ffmpeg</dt><dd>starts the command</dd>
+        <dt>-loglevel error</dt><dd>sets the verbosity of logging to show all errors</dd>
+        <dt>-i <em>input_file</em></dt><dd>path, name and extension of the input file</dd>
+        <dt>-map 0:v:0</dt><dd>designated the first video stream as the stream on which to perform this hash generation operation. <code>-map 0</code> can be used to run the operation on all streams.</dd>
+        <dt>-f hash -hash md5</dt><dd>produce a checksum hash, and set the hash algorithm to md5. See the official <a href="https://ffmpeg.org/ffmpeg-formats.html#hash">documentation on hash</a> for other algorithms.</dd>
+        <dt>-</dt><dd>FFmpeg syntax requires a specified output, and <code>-</code> is just a place holder. No file is actually created.</dd>
+      </dl>
+      <p class="link"></p>
+    </div>
+    <!-- ends Get checksum for video/audio stream -->
+
     <!-- QCTools Report -->
     <label class="recipe" for="qctools">QCTools report (with audio)</label>
     <input type="checkbox" id="qctools">
@@ -2402,13 +2440,49 @@
 
     <div class="well">
       <h2 id="cdda">CDDA (Audio CD) Ripping Tools</h2>
+      <!-- Find Drive Offset for Exact CD Ripping -->
+      <label class="recipe" for="find-offset">Find Drive Offset for Exact CD Ripping</label>
+      <input type="checkbox" id="find-offset">
+      <div class="hiding">
+        <h3>Find Drive Offset for Exact CD Ripping</h3>
+        <p>If you want to make CD rips that can be verified via checksums to other rips of the same content, you need to know the offset of your CD drive. Put simply, different models of CD drives have different offsets, meaning they start reading in slightly different locations. This must be compensated for in order for files created on different (model) drives to generate the same checksum. For a more detailed explanation of drive offsets see the explanation <a href="http://dbpoweramp.com/spoons-audio-guide-cd-ripping.htm">here.</a> In order to find your drive offset, first you will need to know exactly what model your drive is, then you can look it up in the list of drive offsets by Accurate Rip.</p>
+        <p>Often it can be difficult to tell what model your drive is simply by looking at it - it may be housed inside your computer or have external branding that is different from the actual drive manufacturer. For this reason, it can be useful to query your drive with CD ripping software in order to ID it. The following commands should give you a better idea of what drive you have.</p>
+        <p><strong>Cdda2wav:</strong> <code>cdda2wav -scanbus</code> or simply <code>cdda2wav</code></p>
+        <p><strong>CD Paranoia:</strong> <code>cdparanoia -vsQ</code></p>
+        <p>Once you have IDed your drive, you can search the <a href="http://www.accuraterip.com/driveoffsets.htm">Accurate Rip CD drive offset list</a> to find the correct offset for your drive as sourced by the community.</p>
+        <p><strong>Note:</strong> A very effective GUI based tool (macOS specific) for both for discovering drive offset as well as accurately ripping CDDAs is <a href="https://tmkk.undo.jp/xld/index_e.html">XLD</a>. Instructions for calibrating XLD can be found at <a href="https://wiki.hydrogenaud.io/index.php?title=XLD_Configuration">this page</a>.</p>
+        <p class="link"></p>
+      </div>
+      <!-- Find Drive Offset for Exact CD Ripping -->
+
+      <!-- Rip with CD Paranoia -->
+        <label class="recipe" for="cdparanoia">Rip a CD with CD Paranoia</label>
+        <input type="checkbox" id="cdparanoia">
+        <div class="hiding">
+          <h3>Rip a CD with CD Paranoia</h3>
+          <p><code>cdparanoia -L -B -O <em>[Drive Offset]</em> <em>[Starting Track Number]</em>-<em>[Ending Track Number]</em> <em>output_file.wav</em></code></p>
+          <p>This command will use CD Paranoia to rip a CD into separate tracks while compensating for the sample offset of the CD drive. (For more information about drive offset see <a href="#find-offset">the related ffmprovisr command.</a>)</p>
+          <dl>
+            <dt>cdparanoia</dt><dd>begins the cdparanoia command.</dd>
+            <dt>-L</dt><dd>creates verbose logfile.</dd>
+            <dt>-B</dt><dd>puts CD Paranoia into 'batch' mode, which will automatically split tracks into separate files.</dd>
+            <dt>-O [Drive Offset]</dt><dd>allows you to specify the sample offset of your drive. Skip this flag to rip without offset correction.</dd>
+            <dt>[Starting Track Number]-[Ending Track Number]</dt><dd>specifies which tracks to write. For example <code>1-4</code> would rip tracks one through four.</dd>
+            <dt><em>output_file.wav</em></dt><dd>the desired name for your output file(s) (for example the CD name). CD Paranoia will prepend this with track numbers.</dd>
+          </dl>
+          <p class="link"></p>
+        </div>
+      <!-- ends Rip with CD Paranoia -->
+
       <!-- Rip with CDDA2WAV -->
       <label class="recipe" for="cdda2wav">Rip a CD with Cdda2wav</label>
       <input type="checkbox" id="cdda2wav">
       <div class="hiding">
         <h3>Rip a CD with Cdda2wav</h3>
         <p><code>cdda2wav -L0 -t all -cuefile -paranoia paraopts=retries=200,readahead=600,minoverlap=sectors-per-request-1 -verbose-level all <em>output.wav</em></code></p>
-        <p>Cdda2wav is a tool that uses the <a href="https://www.xiph.org/paranoia/">Paranoia library</a> to facilitate accurate ripping of audio CDs (CDDA). It can be installed via Homebrew with the command <code> brew install cdrtools</code>. This command will accurately rip an audio CD into a single wave file, while querying the CDDB database for track information and creating a cue sheet. This cue sheet can then be used either for playback of the WAV file or to split it into individual access files. Any <a href="https://en.wikipedia.org/wiki/CD-Text">cdtext</a> information that is discovered will be stored as a sidecar. For more information about cue sheets see <a href="https://en.wikipedia.org/wiki/Cue_sheet_(computing)">this wikipedia article.</a></p>
+        <p>Cdda2wav is a tool that uses the <a href="https://www.xiph.org/paranoia/">Paranoia library</a> to facilitate accurate ripping of audio CDs (CDDA). It can be installed via Homebrew with the command <code> brew install cdrtools</code>. This command will accurately rip an audio CD into a single wave file, while querying the CDDB database for track information and creating a cue sheet. This cue sheet can then be used either for playback of the WAV file or to split it into individual access files. Any <a href="https://en.wikipedia.org/wiki/CD-Text">cdtext</a> information that is discovered will be stored as a sidecar. For more information about cue sheets see <a href="https://en.wikipedia.org/wiki/Cue_sheet_(computing)">this Wikipedia article.</a></p>
+        <p><strong>Notes: </strong>On macOS the CD must be unmounted before this command is run. This can be done with the command <code>sudo umount '/Volumes/Name_of_CD'</code></p>
+        <p>As of writing, when using the default Homebrew installed version of Cdda2wav some drives will falsely report errors on all rips. If this is occurring, a possible solution is to use the command <code>brew install --devel cdrtools</code> to install a more recent build that incorporates a fix.</p>
         <dl>
           <dt>cdda2wav</dt><dd>begins the Cdda2wav command</dd>
           <dt>-L0</dt><dd>tells Cdda2wav to query the CDDB database for track name information. L0 is 'interactive mode' meaning Cdda2wav will ask you to confirm choices in the event of multiple matches. Change this to <code>-L1</code> to automatically select the first database match.</dd>
@@ -2422,6 +2496,20 @@
         <p class="link"></p>
       </div>
       <!-- ends Rip with CDDA2WAV -->
+
+      <!-- Check for CD Emphasis -->
+        <label class="recipe" for="cd-emph-check">Check/Compensate for CD Emphasis</label>
+        <input type="checkbox" id="cd-emph-check">
+        <div class="hiding">
+          <h3>Check/Compensate for CD Emphasis</h3>
+          <p>While somewhat rare, certain CDs had 'emphasis' applied as a form of noise reduction. This seems to mostly affect early (1980s) era CDs and some CDs pressed in Japan. Emphasis is part of the <a href="https://en.wikipedia.org/wiki/Compact_Disc_Digital_Audio#Standard">Red Book standard</a> and, if present, must be compensated for to ensure accurate playback. CDs that use emphasis contain flags on tracks that tell the CD player to de-emphasize the audio on playback. When ripping a CD with emphasis, it is important to take this into account and either apply de-emphasis while ripping, or if storing a 'flat' copy, create another de-emphasized listening copy.</p>
+          <p>The following commands will output information about the presence of emphasis when run on a target CD:</p>
+          <p><strong>Cdda2wav:</strong> <code>cdda2wav -J</code></p>
+          <p><strong>CD Paranoia:</strong> <code>cdparanoia -Q</code></p>
+          <p>In order to compensate for emphasis during ripping while using Cdda2wav, the <code>-T</code> flag can be added to the <a href="#cdda2wav">standard ripping command</a>. For a recipe to compensate for a flat rip, see the section on <a href="#cd_eq">de-emphasizing with FFmpeg</a>.
+          <p class="link"></p>
+        </div>
+      <!-- Check for CD Emphasis -->
     </div>
     <!-- ends CDDA Tools -->