Files
2025-12-07 22:04:44 -05:00

150 lines
6.6 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!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>convert</title>
<meta name="generator" content="Jekyll v3.10.0" />
<meta property="og:title" content="convert" />
<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/convert.html" />
<meta property="og:url" content="http://localhost:4000/videobeaux/programs/utilities/convert.html" />
<meta property="og:type" content="website" />
<meta name="twitter:card" content="summary" />
<meta property="twitter:title" content="convert" />
<script type="application/ld+json">
{"@context":"https://schema.org","@type":"WebPage","description":"The friendly multilateral video toolkit built for artists by artists.","headline":"convert","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"http://localhost:4000/videobeaux/assets/img/videobeaux.png"}},"url":"http://localhost:4000/videobeaux/programs/utilities/convert.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="convert">convert</h1>
<p>:contentReference[oaicite:1]{index=1}</p>
<h2 id="description">Description</h2>
<p>Performs a simple video file conversion using global Videobeaux encoding settings.<br />
Useful for remuxing, transcoding, codec changes, rewrapping containers, or generating standardized media versions.</p>
<h2 id="purpose">Purpose</h2>
<p><code class="language-plaintext highlighter-rouge">convert</code> exists as a lightweight, universal tool for turning one media container or codec into another.<br />
This is ideal for:</p>
<ul>
<li>converting incompatible formats into editing-friendly files,</li>
<li>rewrapping media without re-encoding,</li>
<li>transcoding to delivery-safe formats,</li>
<li>preparing videos for downstream Videobeaux programs,</li>
<li>batch normalization of mixed-file libraries.</li>
</ul>
<h2 id="how-it-works">How It Works</h2>
<ol>
<li><strong>Input Decoding</strong><br />
The source file is decoded as needed, depending on global codec options.</li>
<li><strong>Re-encode or Stream Copy</strong>
<ul>
<li>If no codec is specified, Videobeaux uses its global defaults.</li>
<li>If codecs are set globally (<code class="language-plaintext highlighter-rouge">vcodec</code>, <code class="language-plaintext highlighter-rouge">acodec</code>), <code class="language-plaintext highlighter-rouge">convert</code> applies them here.</li>
<li>If settings allow stream copy, the video may be remuxed without re-encoding.</li>
</ul>
</li>
<li><strong>Output Writing</strong><br />
The converted or rewrapped video is written to the path specified via <code class="language-plaintext highlighter-rouge">-o</code>.</li>
<li><strong>No Additional Logic</strong><br />
This program intentionally provides a pure conversion operation, without filtering or modification.</li>
</ol>
<h2 id="program-template">Program Template</h2>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>videobeaux -P convert \
-i input.mp4 \
-o output.mp4
</code></pre></div></div>
<h2 id="arguments">Arguments</h2>
<ul>
<li><em>(No program-specific arguments — this module relies entirely on Videobeaux global encoding settings.)</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 convert \
-i myvideo.mp4 \
-o convert_styled.mp4
</code></pre></div></div>
<h2 id="technical-notes">Technical Notes</h2>
<ul>
<li>Rewrapping (e.g., MKV → MP4) is extremely fast when using stream copy.</li>
<li>Full transcoding (e.g., H.264 → ProRes, AAC → WAV) depends on global audio/video codec settings.</li>
<li>File size and transcoding time are directly impacted by CRF, bitrate, and preset settings.</li>
<li>Useful for generating clean, uniform input files before applying more complex Videobeaux processes.</li>
</ul>
<h2 id="recommended-usage">Recommended Usage</h2>
<ul>
<li>Normalizing transcoded footage from varied sources.</li>
<li>Preparing content for editing systems that dislike certain containers/codecs.</li>
<li>Creating proxy versions for offline workflows.</li>
<li>Converting videos to universally compatible formats for distribution, archive, or broadcast.</li>
</ul>
<h2 id="quality-tips">Quality Tips</h2>
<ul>
<li>Use a low CRF (1418) for high-quality archival intermediates.</li>
<li>If the goal is speed, choose faster presets (e.g., <code class="language-plaintext highlighter-rouge">faster</code>, <code class="language-plaintext highlighter-rouge">fast</code>).</li>
<li>For maximum compatibility, output H.264 + AAC in MP4.</li>
<li>For high-end workflows, output ProRes or another mezzanine codec.</li>
<li>Always verify that audio channel layouts survive the conversion correctly.</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>