Files
videobeaux/docs/_site/programs/utilities/extract_sound.html
2025-12-07 22:04:44 -05:00

149 lines
6.5 KiB
HTML

<!DOCTYPE html>
<html lang="en-US">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<!-- Begin Jekyll SEO tag v2.8.0 -->
<title>extract_sound</title>
<meta name="generator" content="Jekyll v3.10.0" />
<meta property="og:title" content="extract_sound" />
<meta property="og:locale" content="en_US" />
<meta name="description" content="The friendly multilateral video toolkit built for artists by artists." />
<meta property="og:description" content="The friendly multilateral video toolkit built for artists by artists." />
<link rel="canonical" href="http://localhost:4000/videobeaux/programs/utilities/extract_sound.html" />
<meta property="og:url" content="http://localhost:4000/videobeaux/programs/utilities/extract_sound.html" />
<meta property="og:type" content="website" />
<meta name="twitter:card" content="summary" />
<meta property="twitter:title" content="extract_sound" />
<script type="application/ld+json">
{"@context":"https://schema.org","@type":"WebPage","description":"The friendly multilateral video toolkit built for artists by artists.","headline":"extract_sound","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"http://localhost:4000/videobeaux/assets/img/videobeaux.png"}},"url":"http://localhost:4000/videobeaux/programs/utilities/extract_sound.html"}</script>
<!-- End Jekyll SEO tag -->
<link rel="stylesheet" href="/videobeaux/assets/css/style.css?v=5e23701ed3967d38bab12937d79f95fae74b2a53">
<!--[if lt IE 9]>
<script src="https://cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv.min.js"></script>
<![endif]-->
<!-- start custom head snippets, customize with your own _includes/head-custom.html file -->
<!-- Setup Google Analytics -->
<!-- You can set your favicon here -->
<!-- link rel="shortcut icon" type="image/x-icon" href="/videobeaux/favicon.ico" -->
<!-- end custom head snippets -->
</head>
<body>
<div class="wrapper">
<header>
<h1><a href="http://localhost:4000/videobeaux/">videobeaux</a></h1>
<img src="/videobeaux/assets/img/videobeaux.png" alt="Logo" />
<p>The friendly multilateral video toolkit built for artists by artists.</p>
<p class="view"><a href="https://github.com/schwwaaa/videobeaux">View the Project on GitHub <small>schwwaaa/videobeaux</small></a></p>
</header>
<section>
<h1 id="extract_sound">extract_sound</h1>
<p>:contentReference[oaicite:1]{index=1}</p>
<h2 id="description">Description</h2>
<p>Extracts the audio track from a video file and saves it as a standalone audio file, preserving quality and format.<br />
Useful for sound design, transcription workflows, remixing, archival storage, or preparing audio-only deliverables.</p>
<h2 id="purpose">Purpose</h2>
<p><code class="language-plaintext highlighter-rouge">extract_sound</code> allows creators to quickly isolate the audio component of any media file.<br />
This is ideal for:</p>
<ul>
<li>podcasts derived from video interviews,</li>
<li>music extraction for editing or remixing,</li>
<li>voice-over capture,</li>
<li>archival audio preparation,</li>
<li>preprocessing audio for tools like transcription or captioning.</li>
</ul>
<h2 id="how-it-works">How It Works</h2>
<ol>
<li><strong>Stream Selection</strong><br />
The tool identifies the primary audio stream from the input file.</li>
<li><strong>Direct Copy or Re-encode</strong><br />
Depending on videobeaux global flags, audio is either:
<ul>
<li>copied without re-encoding for perfect fidelity, or</li>
<li>encoded with the user-specified audio codec and bitrate.</li>
</ul>
</li>
<li><strong>Output Rendering</strong><br />
The extracted audio is written to the output file specified with <code class="language-plaintext highlighter-rouge">-o</code>.</li>
<li><strong>No Video Processing</strong><br />
Video streams are ignored; only the audio track is saved.</li>
</ol>
<h2 id="program-template">Program Template</h2>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>videobeaux -P extract_sound \
-i input.mp4 \
-o output.mp4
</code></pre></div></div>
<h2 id="arguments">Arguments</h2>
<ul>
<li><em>(No program-specific arguments — this tool relies entirely on global videobeaux audio settings such as codec, bitrate, and container format.)</em></li>
</ul>
<h2 id="real-world-example">Real World Example</h2>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>videobeaux -P extract_sound \
-i myvideo.mp4 \
-o extract_sound_styled.mp4
</code></pre></div></div>
<h2 id="technical-notes">Technical Notes</h2>
<ul>
<li>The output file extension determines the final audio container (e.g., <code class="language-plaintext highlighter-rouge">.mp3</code>, <code class="language-plaintext highlighter-rouge">.wav</code>, <code class="language-plaintext highlighter-rouge">.aac</code>).</li>
<li>If no re-encode options are given, videobeaux may default to stream copy.</li>
<li>Multi-track audio is not mixed—typically the first audio stream is extracted unless overridden globally.</li>
<li>Useful for batch pipelines when paired with folder recursion or metadata extraction.</li>
</ul>
<h2 id="recommended-usage">Recommended Usage</h2>
<ul>
<li>Extracting dialogue or interviews for transcription.</li>
<li>Creating podcast audio from filmed sessions.</li>
<li>Pulling music or SFX layers from video renders.</li>
<li>Archival workflows where audio must be stored separately.</li>
</ul>
<h2 id="quality-tips">Quality Tips</h2>
<ul>
<li>Use <code class="language-plaintext highlighter-rouge">.wav</code> for lossless extraction.</li>
<li>Use <code class="language-plaintext highlighter-rouge">.aac</code> or <code class="language-plaintext highlighter-rouge">.mp3</code> for lightweight distribution formats.</li>
<li>If audio is distorted or clipped, normalize or limit in a separate audio-processing step.</li>
<li>When exporting from mixed sources, ensure consistent bitrate settings to avoid quality mismatches.</li>
</ul>
</section>
<footer>
<p>This project is maintained by <a href="https://github.com/schwwaaa">schwwaaa</a></p>
<p><small>Hosted on GitHub Pages &mdash; Theme by <a href="https://github.com/orderedlist">orderedlist</a></small></p>
</footer>
</div>
<script src="/videobeaux/assets/js/scale.fix.js"></script>
</body>
</html>