253 lines
12 KiB
HTML
253 lines
12 KiB
HTML
|
||
<!DOCTYPE html>
|
||
|
||
<html>
|
||
<head>
|
||
<meta charset="utf-8" />
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||
<title>Manual — MediaCurator documentation</title>
|
||
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
|
||
<link rel="stylesheet" href="../_static/alabaster.css" type="text/css" />
|
||
<script id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
|
||
<script src="../_static/jquery.js"></script>
|
||
<script src="../_static/underscore.js"></script>
|
||
<script src="../_static/doctools.js"></script>
|
||
<script src="../_static/language_data.js"></script>
|
||
<link rel="shortcut icon" href="../_static/favicon.ico"/>
|
||
<link rel="index" title="Index" href="../genindex.html" />
|
||
<link rel="search" title="Search" href="../search.html" />
|
||
<link rel="next" title="Use cases" href="use_cases.html" />
|
||
<link rel="prev" title="Quickstart" href="quickstart.html" />
|
||
|
||
<link rel="stylesheet" href="../_static/custom.css" type="text/css" />
|
||
|
||
|
||
<meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
|
||
|
||
</head><body>
|
||
|
||
|
||
<div class="document">
|
||
<div class="documentwrapper">
|
||
<div class="bodywrapper">
|
||
|
||
|
||
<div class="body" role="main">
|
||
|
||
<div class="section" id="manual">
|
||
<h1>Manual<a class="headerlink" href="#manual" title="Permalink to this headline">¶</a></h1>
|
||
<div class="section" id="name">
|
||
<h2>Name<a class="headerlink" href="#name" title="Permalink to this headline">¶</a></h2>
|
||
<p>MediaCurator</p>
|
||
</div>
|
||
<div class="section" id="synopsis">
|
||
<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
|
||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>./curator.py <span class="o">[</span>list,convert<span class="o">]</span> <span class="o">[</span>-del<span class="o">]</span>
|
||
<span class="o">[</span>-in:any,avi,mkv,wmv,mpg,mp4,m4v,flv,vid<span class="o">]</span>
|
||
<span class="o">[</span>-filters:fferror,old,lowres,hd,720p,1080p,uhd,mpeg,mpeg4,x264,wmv3,wmv<span class="o">]</span>
|
||
<span class="o">[</span>-out:mkv/mp4,x265/av1<span class="o">]</span>
|
||
<span class="o">[</span>-print:list,formated,verbose<span class="o">]</span>
|
||
<span class="o">[</span>-dir/-files:<span class="s2">"/mnt/media/"</span>,,<span class="s2">"/mnt/media2/"</span><span class="o">]</span>
|
||
</pre></div>
|
||
</div>
|
||
<p><strong>for multiple files or filenames use double comma separated values “,,”</strong></p>
|
||
<p>default options are:</p>
|
||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>-in:any
|
||
-filters:
|
||
-out:mkv,x265
|
||
-print:list
|
||
</pre></div>
|
||
</div>
|
||
</div>
|
||
<div class="section" id="description">
|
||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
||
<p>MediaCurator is a Python command line tool to manage a media database.</p>
|
||
<ul class="simple">
|
||
<li><p>List all the video’s and their information with or without filters</p></li>
|
||
<li><p>Batch find and repair/convert videos with encoding errors</p></li>
|
||
<li><p>Batch recode videos to more modern codecs (x265 / AV1) based on filters: extentions, codecs, resolutions …</p></li>
|
||
</ul>
|
||
</div>
|
||
<div class="section" id="options">
|
||
<h2>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h2>
|
||
<div class="section" id="list">
|
||
<h3>list<a class="headerlink" href="#list" title="Permalink to this headline">¶</a></h3>
|
||
<p>Search and list videos filtered by the parameters passed by the user.</p>
|
||
</div>
|
||
<div class="section" id="convert">
|
||
<h3>convert<a class="headerlink" href="#convert" title="Permalink to this headline">¶</a></h3>
|
||
<p>Search and convert all videos filtered by the parameters passed by the user.</p>
|
||
</div>
|
||
<div class="section" id="del">
|
||
<h3>-del:<a class="headerlink" href="#del" title="Permalink to this headline">¶</a></h3>
|
||
<p>Delete all original videos once selected operations have been done succefully.</p>
|
||
<p>See <a class="reference internal" href="warnings.html"><span class="doc">Warnings</span></a></p>
|
||
</div>
|
||
<div class="section" id="in">
|
||
<h3>-in:<a class="headerlink" href="#in" title="Permalink to this headline">¶</a></h3>
|
||
<p>[<strong>any</strong>,avi,mkv,wmv,mpg,mp4,m4v,flv,vid]</p>
|
||
<p>Search all videos of the selected container <strong>extensions</strong> in the directories. By default it will include any file format.</p>
|
||
</div>
|
||
<div class="section" id="filters">
|
||
<h3>-filters:<a class="headerlink" href="#filters" title="Permalink to this headline">¶</a></h3>
|
||
<p>[fferror,old,lowres,hd,720p,1080p,uhd,mpeg,mpeg4,x264,wmv3,wmv]</p>
|
||
<p>Filter the selected videos for parameters:</p>
|
||
<ul class="simple">
|
||
<li><p>fferror: Select all videos with encoding errors (See <a class="reference internal" href="errors.html"><span class="doc">Errors</span></a>)</p></li>
|
||
<li><p>old: Select all videos using old codecs (Everything except hevc or av1)</p></li>
|
||
<li><p>hd: 720p, 1080p, uhd</p></li>
|
||
<li><p>lowres: Everything not hd</p></li>
|
||
<li><p>uhd: if width >= 2160 or height >= 2160</p></li>
|
||
<li><p>1080p: if less than uhd and width >= 1440 or height >= 1080</p></li>
|
||
<li><p>720p: if less than 1080p and width >= 1280 or height >= 720:</p></li>
|
||
<li><p>sd: if less than 720p and if height >= 480</p></li>
|
||
<li><p>subsd: Substandard definitions: Everything under 480p</p></li>
|
||
<li><p>mpeg,mpeg4,x264,wmv3,wmv: Filter for videos encoded in the requested video codec</p></li>
|
||
</ul>
|
||
</div>
|
||
<div class="section" id="out">
|
||
<h3>-out:<a class="headerlink" href="#out" title="Permalink to this headline">¶</a></h3>
|
||
<p>[<strong>mkv</strong>/mp4,x265/av1]</p>
|
||
<p>Select the outputs for the video conversions</p>
|
||
<ul class="simple">
|
||
<li><p>mkv: (<strong>Default</strong>) Package the resulting video in a <a class="reference external" href="https://en.wikipedia.org/wiki/Matroska">Matroska</a> container.</p></li>
|
||
<li><p>mp4: Package the resulting video in a container.</p></li>
|
||
<li><p>x265/hevc: (<strong>Default</strong>) Encode the video using the <a class="reference external" href="https://en.wikipedia.org/wiki/X265">x265</a> compression format.</p></li>
|
||
<li><p>av1: Encode the video using the <a class="reference external" href="https://en.wikipedia.org/wiki/AV1">AOMedia Video 1</a> compression format. This will be used as default once the developpers at FFmpeg move it out of <a class="reference external" href="https://trac.ffmpeg.org/wiki/Encode/AV1">experimental</a> .</p></li>
|
||
</ul>
|
||
</div>
|
||
<div class="section" id="print">
|
||
<h3>-print:<a class="headerlink" href="#print" title="Permalink to this headline">¶</a></h3>
|
||
<p>[<strong>list</strong>,formated,verbose]</p>
|
||
<ul class="simple">
|
||
<li><p>list: (<strong>Default</strong>) Print the information about the videos on a single line</p></li>
|
||
</ul>
|
||
<a class="reference internal image-reference" href="../_images/Screenshot-print_list-single.png"><img alt="Deleting videos" src="../_images/Screenshot-print_list-single.png" style="width: 600px;" /></a>
|
||
<ul class="simple">
|
||
<li><p>formated: Print the information in an aerated format</p></li>
|
||
</ul>
|
||
<a class="reference internal image-reference" href="../_images/Screenshot-print_formated-single.png"><img alt="Deleting videos" src="../_images/Screenshot-print_formated-single.png" style="width: 400px;" /></a>
|
||
<ul class="simple">
|
||
<li><p>verbose: Print the FFmpeg output during the video conversions</p></li>
|
||
</ul>
|
||
</div>
|
||
<div class="section" id="dir">
|
||
<h3>-dir:<a class="headerlink" href="#dir" title="Permalink to this headline">¶</a></h3>
|
||
<p>[“/mnt/media/”,,”/mnt/media2/”]</p>
|
||
<p>The directories to scan as a <strong>double comma</strong> separated values list.</p>
|
||
</div>
|
||
<div class="section" id="files">
|
||
<h3>-files:<a class="headerlink" href="#files" title="Permalink to this headline">¶</a></h3>
|
||
<p>[“/mnt/media/video.avi”,,”/mnt/media2/video2.mp4”]</p>
|
||
<p>Specific videos to include as a <strong>double comma</strong> separated values list.</p>
|
||
</div>
|
||
</div>
|
||
<div class="section" id="examples">
|
||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># List all videos with old codec in formated format</span>
|
||
./curator.py list -filters:old -print:formated -dir:/mnt/media/ >> ../medlist.txt
|
||
<span class="c1"># Convert all videos with the codec mpeg4 in a mp4 using the av1 video codec and the delete the originals</span>
|
||
./curator.py convert -del -filters:mpeg4 -out:av1,mp4 -dir:<span class="s2">"/mnt/media/Movies/"</span>
|
||
<span class="c1"># Convert any video with avi or mpg extensions, print formated text including ffmpeg's output and then delete the originals</span>
|
||
./curator.py convert -del -in:avi,mpg -print:formated,verbose -dir:/mnt/media/
|
||
</pre></div>
|
||
</div>
|
||
<p>More examples in <a class="reference internal" href="use_cases.html"><span class="doc">Use cases</span></a></p>
|
||
</div>
|
||
<div class="section" id="see-also">
|
||
<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
|
||
<p><a class="reference external" href="https://ffmpeg.org/">FFmpeg</a></p>
|
||
</div>
|
||
<div class="section" id="author">
|
||
<h2>Author<a class="headerlink" href="#author" title="Permalink to this headline">¶</a></h2>
|
||
<p>Fabrice Quenneville</p>
|
||
</div>
|
||
</div>
|
||
|
||
|
||
</div>
|
||
|
||
</div>
|
||
</div>
|
||
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
|
||
<div class="sphinxsidebarwrapper">
|
||
<p class="logo"><a href="../index.html">
|
||
<img class="logo" src="../_static/mclogo4x.png" alt="Logo"/>
|
||
</a></p>
|
||
<h1 class="logo"><a href="../index.html">MediaCurator</a></h1>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<h3>Navigation</h3>
|
||
<p class="caption"><span class="caption-text">Contents:</span></p>
|
||
<ul class="current">
|
||
<li class="toctree-l1"><a class="reference internal" href="warnings.html">Warnings</a></li>
|
||
<li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>
|
||
<li class="toctree-l1"><a class="reference internal" href="quickstart.html">Quickstart</a></li>
|
||
<li class="toctree-l1 current"><a class="current reference internal" href="#">Manual</a><ul>
|
||
<li class="toctree-l2"><a class="reference internal" href="#name">Name</a></li>
|
||
<li class="toctree-l2"><a class="reference internal" href="#synopsis">Synopsis</a></li>
|
||
<li class="toctree-l2"><a class="reference internal" href="#description">Description</a></li>
|
||
<li class="toctree-l2"><a class="reference internal" href="#options">Options</a></li>
|
||
<li class="toctree-l2"><a class="reference internal" href="#examples">Examples</a></li>
|
||
<li class="toctree-l2"><a class="reference internal" href="#see-also">See Also</a></li>
|
||
<li class="toctree-l2"><a class="reference internal" href="#author">Author</a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toctree-l1"><a class="reference internal" href="use_cases.html">Use cases</a></li>
|
||
<li class="toctree-l1"><a class="reference internal" href="errors.html">Errors</a></li>
|
||
</ul>
|
||
|
||
<div class="relations">
|
||
<h3>Related Topics</h3>
|
||
<ul>
|
||
<li><a href="../index.html">Documentation overview</a><ul>
|
||
<li>Previous: <a href="quickstart.html" title="previous chapter">Quickstart</a></li>
|
||
<li>Next: <a href="use_cases.html" title="next chapter">Use cases</a></li>
|
||
</ul></li>
|
||
</ul>
|
||
</div>
|
||
<div id="searchbox" style="display: none" role="search">
|
||
<h3 id="searchlabel">Quick search</h3>
|
||
<div class="searchformwrapper">
|
||
<form class="search" action="../search.html" method="get">
|
||
<input type="text" name="q" aria-labelledby="searchlabel" />
|
||
<input type="submit" value="Go" />
|
||
</form>
|
||
</div>
|
||
</div>
|
||
<script>$('#searchbox').show(0);</script>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
</div>
|
||
</div>
|
||
<div class="clearer"></div>
|
||
</div>
|
||
<div class="footer">
|
||
©2020, Fabrice Quenneville.
|
||
|
||
|
|
||
Powered by <a href="http://sphinx-doc.org/">Sphinx 3.3.1</a>
|
||
& <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
|
||
|
||
|
|
||
<a href="../_sources/usage/manual.rst.txt"
|
||
rel="nofollow">Page source</a>
|
||
</div>
|
||
|
||
|
||
|
||
|
||
</body>
|
||
</html> |