Working on documentation

This commit is contained in:
Fabrice Quenneville 2020-11-21 19:16:17 -05:00
parent 44a222fe8b
commit cb7f9297bb
23 changed files with 403 additions and 181 deletions

View File

@ -22,35 +22,68 @@ Synopsis
Description
-----------
MediaCurator is a Python command line tool to manage a media database.
* List all the video's and their information with or without filters
* Batch find and repair/convert videos with encoding errors
* Batch recode videos to more modern codecs (x265 / AV1) based on filters: extentions, codecs, resolutions ...
Options
-------
list
====
Print information
convert
=======
-del:
=====
-in:
====
[any,avi,mkv,wmv,mpg,mp4,m4v,flv,vid]
-filters:
=========
[fferror,old,lowres,hd,720p,1080p,uhd,mpeg,mpeg4,x264,wmv3,wmv]
-out:
=====
[mkv/mp4,x265/av1]
-print:
=======
[list,formated,verbose]
-dir:
=====
["/mnt/media/",,"/mnt/media2/"]
-files:
=======
["/mnt/media/video.avi",,"/mnt/media2/video2.mp4"]
Examples
--------
.. code-block:: bash
# List all videos with old codec in formated format
./curator.py list -filters:old -print:formated -dir:/mnt/media/ >> ../medlist.txt
# Convert all videos with the codec mpeg4 in a mp4 using the av1 video codec and the delete the originals
./curator.py convert -del -filters:mpeg4 -out:av1,mp4 -dir:"/mnt/media/Movies/"
# Convert any video with avi or mpg extensions, print formated text including ffmpeg's output and then delete the originals
./curator.py convert -del -in:avi,mpg -print:formated,verbose -dir:/mnt/media/
More examples in :doc:`use_cases`
See Also
--------
`FFmpeg <https://ffmpeg.org/>`_
Author
------

View File

@ -30,6 +30,7 @@ Examples:
./curator.py list -filters:old -print:formated -dir:/mnt/media/ >> ../medlist.txt
# Convert all videos with the codec mpeg4 in a mp4 using the av1 video codec and the delete the originals
./curator.py convert -del -filters:mpeg4 -out:av1,mp4 -dir:"/mnt/media/Movies/"
# Convert any video with avi or mpg extensions, print formated text including ffmpeg's output and then delete the originals
./curator.py convert -del -in:avi,mpg -print:formated,verbose -dir:/mnt/media/
More examples in :doc:`use_cases`

View File

@ -1 +1 @@
Search.setIndex({docnames:["index","usage/errors","usage/installation","usage/manual","usage/quickstart","usage/use_cases","usage/warnings"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,sphinx:56},filenames:["index.rst","usage/errors.rst","usage/installation.rst","usage/manual.rst","usage/quickstart.rst","usage/use_cases.rst","usage/warnings.rst"],objects:{},objnames:{},objtypes:{},terms:{"1080p":[3,4],"720p":[3,4],"case":[0,4],"default":[3,4],"try":1,"while":1,For:2,The:0,Use:[0,4],acquaint:6,activ:1,after:1,again:[1,6],all:[0,4,6],also:[0,1],ani:[3,4],audio:1,author:0,av1:[0,3,4],avi:[3,4],base:0,bash:[],batch:0,befor:6,behavior:6,big:1,big_valu:1,bug:0,can:[0,1,6],chapter:1,clean:1,clone:2,code:0,codec:[0,4],com:2,comma:[3,4],command:[0,6],content:0,convert:[0,3,4,6],curat:[3,4,6],damag:[1,6],databas:0,decod:1,del:[3,4,6],delet:[4,6],depend:1,descript:0,detect:1,dir:[3,4,6],distribut:[1,2],don:1,done:6,doubl:[3,4],download:2,dry:6,encod:[0,6],error:[0,6],exampl:[0,1,4],expect:6,experi:1,extent:0,fabquennevil:2,fabric:3,face:1,failur:1,featur:[1,6],feel:1,few:[1,6],fferror:[3,4,6],ffmpeg:0,file:[3,4,6],filenam:[3,4],filter:[0,3,4,6],find:0,flag:6,flv:[3,4],folder:6,format:[3,4],found:[0,1],frame:1,free:1,from:0,get:6,git:2,github:[0,1],gnu:2,happen:1,have:6,header:1,here:[1,6],http:2,index:[],inform:[0,1],instal:0,irrecover:6,irrirrepar:6,issu:0,its:1,latest:1,librari:6,like:1,line:0,linux:2,list:[0,3,4,6],lowr:[3,4,6],m4v:[3,4],mai:1,manag:0,manual:0,media2:[3,4],media:[0,3,4,6],mediacur:[1,2,3,6],medlist:[3,4],miss:1,mkv:[3,4],mnt:[3,4,6],modern:0,modul:[],more:[0,4],most:1,move:1,movi:[3,4],mp4:[3,4],mpeg4:[3,4],mpeg:[1,3,4],mpg:[3,4],multipl:[3,4],name:0,necessarli:1,next:1,non:6,now:2,occur:1,old:[1,3,4],onli:2,open:1,option:[0,1,4],origin:4,other:0,out:[3,4],output:1,packag:2,page:[],pip:2,pleas:6,possibl:1,print:[1,3,4],project:1,properli:6,python:0,quennevil:3,quickstart:0,quit:1,raw:1,recod:0,recur:1,referenc:1,repair:[0,6],report:1,repositori:1,requir:2,resolut:0,run:[1,6],search:[],see:0,segfault:1,sei:1,separ:[3,4],serv:1,some:1,sourc:[0,1],step:1,subsd:6,substandard:6,suggest:1,synopsi:0,take:1,thi:2,too:1,tool:0,track:1,txt:[2,3,4],type:1,uhd:[3,4],unintend:6,until:6,updat:1,use:[3,4,6],used:[1,6],using:[1,4,6],valu:[3,4],valuabl:6,verbos:[1,3,4],veri:1,version:1,vid:[3,4],video2:3,video:[0,1,3,4,6],want:1,warn:0,when:[1,6],wich:1,without:0,wmv3:[3,4],wmv:[3,4],work:2,x264:[3,4],x265:[0,3,4],you:[1,6],your:[1,6]},titles:["Welcome to MediaCurator\u2019s documentation!","Errors","Installation","Manual","Quickstart","Use cases","Warnings"],titleterms:{"case":5,Use:5,also:3,author:3,bug:1,descript:3,document:0,encod:1,error:1,exampl:3,ffmpeg:[1,2],from:2,github:2,indic:[],instal:2,issu:1,manual:3,mediacur:0,name:3,option:3,other:1,quickstart:4,repair:1,see:3,synopsi:3,tabl:[],warn:6,welcom:0}})
Search.setIndex({docnames:["index","usage/errors","usage/installation","usage/manual","usage/quickstart","usage/use_cases","usage/warnings"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,sphinx:56},filenames:["index.rst","usage/errors.rst","usage/installation.rst","usage/manual.rst","usage/quickstart.rst","usage/use_cases.rst","usage/warnings.rst"],objects:{},objnames:{},objtypes:{},terms:{"1080p":[3,4],"720p":[3,4],"case":[0,3,4],"default":[3,4],"try":1,"while":1,For:2,The:0,Use:[0,3,4],acquaint:6,activ:1,after:1,again:[1,6],all:[0,3,4,6],also:[0,1],ani:[3,4],audio:1,author:0,av1:[0,3,4],avi:[3,4],base:[0,3],bash:[],batch:[0,3],befor:6,behavior:6,big:1,big_valu:1,bug:0,can:[0,1,6],chapter:1,clean:1,clone:2,code:0,codec:[0,3,4],com:2,comma:[3,4],command:[0,3,6],content:0,convert:[0,4,6],curat:[3,4,6],damag:[1,6],databas:[0,3],decod:1,del:[4,6],delet:[3,4,6],depend:1,descript:0,detect:1,dir:[4,6],distribut:[1,2],don:1,done:6,doubl:[3,4],download:2,dry:6,encod:[0,3,6],error:[0,3,6],exampl:[0,1,4],expect:6,experi:1,extens:[3,4],extent:[0,3],fabquennevil:2,fabric:3,face:1,failur:1,featur:[1,6],feel:1,few:[1,6],fferror:[3,4,6],ffmpeg:[0,3,4],file:[4,6],filenam:[3,4],filter:[0,4,6],find:[0,3],flag:6,flv:[3,4],folder:6,format:[3,4],found:[0,1],frame:1,free:1,from:0,get:6,git:2,github:[0,1],gnu:2,happen:1,have:6,header:1,here:[1,6],http:2,includ:[3,4],index:[],inform:[0,1,3],instal:0,irrecover:6,irrirrepar:6,issu:0,its:1,latest:1,librari:6,like:1,line:[0,3],linux:2,list:[0,4,6],lowr:[3,4,6],m4v:[3,4],mai:1,manag:[0,3],manual:0,media2:[3,4],media:[0,3,4,6],mediacur:[1,2,3,6],medlist:[3,4],miss:1,mkv:[3,4],mnt:[3,4,6],modern:[0,3],modul:[],more:[0,3,4],most:1,move:1,movi:[3,4],mp4:[3,4],mpeg4:[3,4],mpeg:[1,3,4],mpg:[3,4],multipl:[3,4],name:0,necessarli:1,next:1,non:6,now:2,occur:1,old:[1,3,4],onli:2,open:1,option:[0,1,4],origin:[3,4],other:0,out:4,output:[1,3,4],packag:2,page:[],pip:2,pleas:6,possibl:1,print:[1,4],project:1,properli:6,python:[0,3],quennevil:3,quickstart:0,quit:1,raw:1,recod:[0,3],recur:1,referenc:1,repair:[0,3,6],report:1,repositori:1,requir:2,resolut:[0,3],run:[1,6],search:[],see:0,segfault:1,sei:1,separ:[3,4],serv:1,some:1,sourc:[0,1],step:1,subsd:6,substandard:6,suggest:1,synopsi:0,take:1,text:[3,4],thi:2,too:1,tool:[0,3],track:1,txt:[2,3,4],type:1,uhd:[3,4],unintend:6,until:6,updat:1,use:[3,4,6],used:[1,6],using:[1,3,4,6],valu:[3,4],valuabl:6,verbos:[1,3,4],veri:1,version:1,vid:[3,4],video2:3,video:[0,1,3,4,6],want:1,warn:0,when:[1,6],wich:1,without:[0,3],wmv3:[3,4],wmv:[3,4],work:2,x264:[3,4],x265:[0,3,4],you:[1,6],your:[1,6]},titles:["Welcome to MediaCurator\u2019s documentation!","Errors","Installation","Manual","Quickstart","Use cases","Warnings"],titleterms:{"case":5,Use:5,also:3,author:3,bug:1,convert:3,del:3,descript:3,dir:3,document:0,encod:1,error:1,exampl:3,ffmpeg:[1,2],file:3,filter:3,from:2,github:2,indic:[],instal:2,issu:1,list:3,manual:3,mediacur:0,name:3,option:3,other:1,out:3,print:3,quickstart:4,repair:1,see:3,synopsi:3,tabl:[],warn:6,welcom:0}})

View File

@ -38,9 +38,7 @@
<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>
<blockquote>
<div><p>MediaCurator</p>
</div></blockquote>
<p>MediaCurator</p>
</div>
<div class="section" id="synopsis">
<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline"></a></h2>
@ -55,32 +53,79 @@
</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 videos 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>
<p>list</p>
<p>convert</p>
<p>-del:</p>
<dl class="simple">
<dt>-in:</dt><dd><p>[any,avi,mkv,wmv,mpg,mp4,m4v,flv,vid]</p>
</dd>
<dt>-filters:</dt><dd><p>[fferror,old,lowres,hd,720p,1080p,uhd,mpeg,mpeg4,x264,wmv3,wmv]</p>
</dd>
<dt>-out:</dt><dd><p>[mkv/mp4,x265/av1]</p>
</dd>
<dt>-print:</dt><dd><p>[list,formated,verbose]</p>
</dd>
<dt>-dir:</dt><dd><p>[“/mnt/media/”,,”/mnt/media2/”]</p>
</dd>
<dt>-files:</dt><dd><p>[“/mnt/media/video.avi”,,”/mnt/media2/video2.mp4”]</p>
</dd>
</dl>
<div class="section" id="list">
<h3>list<a class="headerlink" href="#list" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>Print information</p>
</div></blockquote>
</div>
<div class="section" id="convert">
<h3>convert<a class="headerlink" href="#convert" title="Permalink to this headline"></a></h3>
</div>
<div class="section" id="del">
<h3>-del:<a class="headerlink" href="#del" title="Permalink to this headline"></a></h3>
</div>
<div class="section" id="in">
<h3>-in:<a class="headerlink" href="#in" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[any,avi,mkv,wmv,mpg,mp4,m4v,flv,vid]</p>
</div></blockquote>
</div>
<div class="section" id="filters">
<h3>-filters:<a class="headerlink" href="#filters" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[fferror,old,lowres,hd,720p,1080p,uhd,mpeg,mpeg4,x264,wmv3,wmv]</p>
</div></blockquote>
</div>
<div class="section" id="out">
<h3>-out:<a class="headerlink" href="#out" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[mkv/mp4,x265/av1]</p>
</div></blockquote>
</div>
<div class="section" id="print">
<h3>-print:<a class="headerlink" href="#print" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[list,formated,verbose]</p>
</div></blockquote>
</div>
<div class="section" id="dir">
<h3>-dir:<a class="headerlink" href="#dir" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[“/mnt/media/”,,”/mnt/media2/”]</p>
</div></blockquote>
</div>
<div class="section" id="files">
<h3>-files:<a class="headerlink" href="#files" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[“/mnt/media/video.avi”,,”/mnt/media2/video2.mp4”]</p>
</div></blockquote>
</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/ &gt;&gt; ../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">&quot;/mnt/media/Movies/&quot;</span>
<span class="c1"># Convert any video with avi or mpg extensions, print formated text including ffmpeg&#39;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>

View File

@ -57,6 +57,7 @@
./curator.py list -filters:old -print:formated -dir:/mnt/media/ &gt;&gt; ../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">&quot;/mnt/media/Movies/&quot;</span>
<span class="c1"># Convert any video with avi or mpg extensions, print formated text including ffmpeg&#39;s output and then delete the originals</span>
./curator.py convert -del -in:avi,mpg -print:formated,verbose -dir:/mnt/media/
</pre></div>
</div>

View File

@ -22,35 +22,68 @@ Synopsis
Description
-----------
MediaCurator is a Python command line tool to manage a media database.
* List all the video's and their information with or without filters
* Batch find and repair/convert videos with encoding errors
* Batch recode videos to more modern codecs (x265 / AV1) based on filters: extentions, codecs, resolutions ...
Options
-------
list
====
Print information
convert
=======
-del:
=====
-in:
====
[any,avi,mkv,wmv,mpg,mp4,m4v,flv,vid]
-filters:
=========
[fferror,old,lowres,hd,720p,1080p,uhd,mpeg,mpeg4,x264,wmv3,wmv]
-out:
=====
[mkv/mp4,x265/av1]
-print:
=======
[list,formated,verbose]
-dir:
=====
["/mnt/media/",,"/mnt/media2/"]
-files:
=======
["/mnt/media/video.avi",,"/mnt/media2/video2.mp4"]
Examples
--------
.. code-block:: bash
# List all videos with old codec in formated format
./curator.py list -filters:old -print:formated -dir:/mnt/media/ >> ../medlist.txt
# Convert all videos with the codec mpeg4 in a mp4 using the av1 video codec and the delete the originals
./curator.py convert -del -filters:mpeg4 -out:av1,mp4 -dir:"/mnt/media/Movies/"
# Convert any video with avi or mpg extensions, print formated text including ffmpeg's output and then delete the originals
./curator.py convert -del -in:avi,mpg -print:formated,verbose -dir:/mnt/media/
More examples in :doc:`use_cases`
See Also
--------
`FFmpeg <https://ffmpeg.org/>`_
Author
------

View File

@ -30,6 +30,7 @@ Examples:
./curator.py list -filters:old -print:formated -dir:/mnt/media/ >> ../medlist.txt
# Convert all videos with the codec mpeg4 in a mp4 using the av1 video codec and the delete the originals
./curator.py convert -del -filters:mpeg4 -out:av1,mp4 -dir:"/mnt/media/Movies/"
# Convert any video with avi or mpg extensions, print formated text including ffmpeg's output and then delete the originals
./curator.py convert -del -in:avi,mpg -print:formated,verbose -dir:/mnt/media/
More examples in :doc:`use_cases`

View File

@ -1 +1 @@
Search.setIndex({docnames:["index","usage/errors","usage/installation","usage/manual","usage/quickstart","usage/use_cases","usage/warnings"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,sphinx:56},filenames:["index.rst","usage/errors.rst","usage/installation.rst","usage/manual.rst","usage/quickstart.rst","usage/use_cases.rst","usage/warnings.rst"],objects:{},objnames:{},objtypes:{},terms:{"1080p":[3,4],"720p":[3,4],"case":[0,4],"default":[3,4],"try":1,"while":1,For:2,The:0,Use:[0,4],acquaint:6,activ:1,after:1,again:[1,6],all:[0,4,6],also:[0,1],ani:[3,4],audio:1,author:0,av1:[0,3,4],avi:[3,4],base:0,bash:[],batch:0,befor:6,behavior:6,big:1,big_valu:1,bug:0,can:[0,1,6],chapter:1,clean:1,clone:2,code:0,codec:[0,4],com:2,comma:[3,4],command:[0,6],content:0,convert:[0,3,4,6],curat:[3,4,6],damag:[1,6],databas:0,decod:1,del:[3,4,6],delet:[4,6],depend:1,descript:0,detect:1,dir:[3,4,6],distribut:[1,2],don:1,done:6,doubl:[3,4],download:2,dry:6,encod:[0,6],error:[0,6],exampl:[0,1,4],expect:6,experi:1,extent:0,fabquennevil:2,fabric:3,face:1,failur:1,featur:[1,6],feel:1,few:[1,6],fferror:[3,4,6],ffmpeg:0,file:[3,4,6],filenam:[3,4],filter:[0,3,4,6],find:0,flag:6,flv:[3,4],folder:6,format:[3,4],found:[0,1],frame:1,free:1,from:0,get:6,git:2,github:[0,1],gnu:2,happen:1,have:6,header:1,here:[1,6],http:2,index:[],inform:[0,1],instal:0,irrecover:6,irrirrepar:6,issu:0,its:1,latest:1,librari:6,like:1,line:0,linux:2,list:[0,3,4,6],lowr:[3,4,6],m4v:[3,4],mai:1,manag:0,manual:0,media2:[3,4],media:[0,3,4,6],mediacur:[1,2,3,6],medlist:[3,4],miss:1,mkv:[3,4],mnt:[3,4,6],modern:0,modul:[],more:[0,4],most:1,move:1,movi:[3,4],mp4:[3,4],mpeg4:[3,4],mpeg:[1,3,4],mpg:[3,4],multipl:[3,4],name:0,necessarli:1,next:1,non:6,now:2,occur:1,old:[1,3,4],onli:2,open:1,option:[0,1,4],origin:4,other:0,out:[3,4],output:1,packag:2,page:[],pip:2,pleas:6,possibl:1,print:[1,3,4],project:1,properli:6,python:0,quennevil:3,quickstart:0,quit:1,raw:1,recod:0,recur:1,referenc:1,repair:[0,6],report:1,repositori:1,requir:2,resolut:0,run:[1,6],search:[],see:0,segfault:1,sei:1,separ:[3,4],serv:1,some:1,sourc:[0,1],step:1,subsd:6,substandard:6,suggest:1,synopsi:0,take:1,thi:2,too:1,tool:0,track:1,txt:[2,3,4],type:1,uhd:[3,4],unintend:6,until:6,updat:1,use:[3,4,6],used:[1,6],using:[1,4,6],valu:[3,4],valuabl:6,verbos:[1,3,4],veri:1,version:1,vid:[3,4],video2:3,video:[0,1,3,4,6],want:1,warn:0,when:[1,6],wich:1,without:0,wmv3:[3,4],wmv:[3,4],work:2,x264:[3,4],x265:[0,3,4],you:[1,6],your:[1,6]},titles:["Welcome to MediaCurator\u2019s documentation!","Errors","Installation","Manual","Quickstart","Use cases","Warnings"],titleterms:{"case":5,Use:5,also:3,author:3,bug:1,descript:3,document:0,encod:1,error:1,exampl:3,ffmpeg:[1,2],from:2,github:2,indic:[],instal:2,issu:1,manual:3,mediacur:0,name:3,option:3,other:1,quickstart:4,repair:1,see:3,synopsi:3,tabl:[],warn:6,welcom:0}})
Search.setIndex({docnames:["index","usage/errors","usage/installation","usage/manual","usage/quickstart","usage/use_cases","usage/warnings"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,sphinx:56},filenames:["index.rst","usage/errors.rst","usage/installation.rst","usage/manual.rst","usage/quickstart.rst","usage/use_cases.rst","usage/warnings.rst"],objects:{},objnames:{},objtypes:{},terms:{"1080p":[3,4],"720p":[3,4],"case":[0,3,4],"default":[3,4],"try":1,"while":1,For:2,The:0,Use:[0,3,4],acquaint:6,activ:1,after:1,again:[1,6],all:[0,3,4,6],also:[0,1],ani:[3,4],audio:1,author:0,av1:[0,3,4],avi:[3,4],base:[0,3],bash:[],batch:[0,3],befor:6,behavior:6,big:1,big_valu:1,bug:0,can:[0,1,6],chapter:1,clean:1,clone:2,code:0,codec:[0,3,4],com:2,comma:[3,4],command:[0,3,6],content:0,convert:[0,4,6],curat:[3,4,6],damag:[1,6],databas:[0,3],decod:1,del:[4,6],delet:[3,4,6],depend:1,descript:0,detect:1,dir:[4,6],distribut:[1,2],don:1,done:6,doubl:[3,4],download:2,dry:6,encod:[0,3,6],error:[0,3,6],exampl:[0,1,4],expect:6,experi:1,extens:[3,4],extent:[0,3],fabquennevil:2,fabric:3,face:1,failur:1,featur:[1,6],feel:1,few:[1,6],fferror:[3,4,6],ffmpeg:[0,3,4],file:[4,6],filenam:[3,4],filter:[0,4,6],find:[0,3],flag:6,flv:[3,4],folder:6,format:[3,4],found:[0,1],frame:1,free:1,from:0,get:6,git:2,github:[0,1],gnu:2,happen:1,have:6,header:1,here:[1,6],http:2,includ:[3,4],index:[],inform:[0,1,3],instal:0,irrecover:6,irrirrepar:6,issu:0,its:1,latest:1,librari:6,like:1,line:[0,3],linux:2,list:[0,4,6],lowr:[3,4,6],m4v:[3,4],mai:1,manag:[0,3],manual:0,media2:[3,4],media:[0,3,4,6],mediacur:[1,2,3,6],medlist:[3,4],miss:1,mkv:[3,4],mnt:[3,4,6],modern:[0,3],modul:[],more:[0,3,4],most:1,move:1,movi:[3,4],mp4:[3,4],mpeg4:[3,4],mpeg:[1,3,4],mpg:[3,4],multipl:[3,4],name:0,necessarli:1,next:1,non:6,now:2,occur:1,old:[1,3,4],onli:2,open:1,option:[0,1,4],origin:[3,4],other:0,out:4,output:[1,3,4],packag:2,page:[],pip:2,pleas:6,possibl:1,print:[1,4],project:1,properli:6,python:[0,3],quennevil:3,quickstart:0,quit:1,raw:1,recod:[0,3],recur:1,referenc:1,repair:[0,3,6],report:1,repositori:1,requir:2,resolut:[0,3],run:[1,6],search:[],see:0,segfault:1,sei:1,separ:[3,4],serv:1,some:1,sourc:[0,1],step:1,subsd:6,substandard:6,suggest:1,synopsi:0,take:1,text:[3,4],thi:2,too:1,tool:[0,3],track:1,txt:[2,3,4],type:1,uhd:[3,4],unintend:6,until:6,updat:1,use:[3,4,6],used:[1,6],using:[1,3,4,6],valu:[3,4],valuabl:6,verbos:[1,3,4],veri:1,version:1,vid:[3,4],video2:3,video:[0,1,3,4,6],want:1,warn:0,when:[1,6],wich:1,without:[0,3],wmv3:[3,4],wmv:[3,4],work:2,x264:[3,4],x265:[0,3,4],you:[1,6],your:[1,6]},titles:["Welcome to MediaCurator\u2019s documentation!","Errors","Installation","Manual","Quickstart","Use cases","Warnings"],titleterms:{"case":5,Use:5,also:3,author:3,bug:1,convert:3,del:3,descript:3,dir:3,document:0,encod:1,error:1,exampl:3,ffmpeg:[1,2],file:3,filter:3,from:2,github:2,indic:[],instal:2,issu:1,list:3,manual:3,mediacur:0,name:3,option:3,other:1,out:3,print:3,quickstart:4,repair:1,see:3,synopsi:3,tabl:[],warn:6,welcom:0}})

View File

@ -38,9 +38,7 @@
<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>
<blockquote>
<div><p>MediaCurator</p>
</div></blockquote>
<p>MediaCurator</p>
</div>
<div class="section" id="synopsis">
<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline"></a></h2>
@ -55,32 +53,79 @@
</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 videos 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>
<p>list</p>
<p>convert</p>
<p>-del:</p>
<dl class="simple">
<dt>-in:</dt><dd><p>[any,avi,mkv,wmv,mpg,mp4,m4v,flv,vid]</p>
</dd>
<dt>-filters:</dt><dd><p>[fferror,old,lowres,hd,720p,1080p,uhd,mpeg,mpeg4,x264,wmv3,wmv]</p>
</dd>
<dt>-out:</dt><dd><p>[mkv/mp4,x265/av1]</p>
</dd>
<dt>-print:</dt><dd><p>[list,formated,verbose]</p>
</dd>
<dt>-dir:</dt><dd><p>[“/mnt/media/”,,”/mnt/media2/”]</p>
</dd>
<dt>-files:</dt><dd><p>[“/mnt/media/video.avi”,,”/mnt/media2/video2.mp4”]</p>
</dd>
</dl>
<div class="section" id="list">
<h3>list<a class="headerlink" href="#list" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>Print information</p>
</div></blockquote>
</div>
<div class="section" id="convert">
<h3>convert<a class="headerlink" href="#convert" title="Permalink to this headline"></a></h3>
</div>
<div class="section" id="del">
<h3>-del:<a class="headerlink" href="#del" title="Permalink to this headline"></a></h3>
</div>
<div class="section" id="in">
<h3>-in:<a class="headerlink" href="#in" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[any,avi,mkv,wmv,mpg,mp4,m4v,flv,vid]</p>
</div></blockquote>
</div>
<div class="section" id="filters">
<h3>-filters:<a class="headerlink" href="#filters" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[fferror,old,lowres,hd,720p,1080p,uhd,mpeg,mpeg4,x264,wmv3,wmv]</p>
</div></blockquote>
</div>
<div class="section" id="out">
<h3>-out:<a class="headerlink" href="#out" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[mkv/mp4,x265/av1]</p>
</div></blockquote>
</div>
<div class="section" id="print">
<h3>-print:<a class="headerlink" href="#print" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[list,formated,verbose]</p>
</div></blockquote>
</div>
<div class="section" id="dir">
<h3>-dir:<a class="headerlink" href="#dir" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[“/mnt/media/”,,”/mnt/media2/”]</p>
</div></blockquote>
</div>
<div class="section" id="files">
<h3>-files:<a class="headerlink" href="#files" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[“/mnt/media/video.avi”,,”/mnt/media2/video2.mp4”]</p>
</div></blockquote>
</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/ &gt;&gt; ../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">&quot;/mnt/media/Movies/&quot;</span>
<span class="c1"># Convert any video with avi or mpg extensions, print formated text including ffmpeg&#39;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>

View File

@ -57,6 +57,7 @@
./curator.py list -filters:old -print:formated -dir:/mnt/media/ &gt;&gt; ../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">&quot;/mnt/media/Movies/&quot;</span>
<span class="c1"># Convert any video with avi or mpg extensions, print formated text including ffmpeg&#39;s output and then delete the originals</span>
./curator.py convert -del -in:avi,mpg -print:formated,verbose -dir:/mnt/media/
</pre></div>
</div>

View File

@ -19,47 +19,6 @@ Synopsis
[-print:list,formated,verbose]
[-dir/-files:"/mnt/media/",,"/mnt/media2/"]
Description
-----------
Options
-------
list
convert
-del:
-in:
[any,avi,mkv,wmv,mpg,mp4,m4v,flv,vid]
-filters:
[fferror,old,lowres,hd,720p,1080p,uhd,mpeg,mpeg4,x264,wmv3,wmv]
-out:
[mkv/mp4,x265/av1]
-print:
[list,formated,verbose]
-dir:
["/mnt/media/",,"/mnt/media2/"]
-files:
["/mnt/media/video.avi",,"/mnt/media2/video2.mp4"]
Examples
--------
See Also
--------
Author
------
Fabrice Quenneville
**for multiple files or filenames use double comma separated values ",,"**
@ -72,20 +31,72 @@ default options are:
-out:mkv,x265
-print:list
Examples:
Description
-----------
MediaCurator is a Python command line tool to manage a media database.
* List all the video's and their information with or without filters
* Batch find and repair/convert videos with encoding errors
* Batch recode videos to more modern codecs (x265 / AV1) based on filters: extentions, codecs, resolutions ...
Options
-------
list
====
Print information
convert
=======
-del:
=====
-in:
====
[any,avi,mkv,wmv,mpg,mp4,m4v,flv,vid]
-filters:
=========
[fferror,old,lowres,hd,720p,1080p,uhd,mpeg,mpeg4,x264,wmv3,wmv]
-out:
=====
[mkv/mp4,x265/av1]
-print:
=======
[list,formated,verbose]
-dir:
=====
["/mnt/media/",,"/mnt/media2/"]
-files:
=======
["/mnt/media/video.avi",,"/mnt/media2/video2.mp4"]
Examples
--------
.. code-block:: bash
# List all videos with old codec in formated format
./curator.py list -filters:old -print:formated -dir:/mnt/media/ >> ../medlist.txt
# Convert all videos with the codec mpeg4 in a mp4 using the av1 video codec and the delete the originals
./curator.py convert -del -filters:mpeg4 -out:av1,mp4 -dir:"/mnt/media/Movies/"
# Convert any video with avi or mpg extensions, print formated text including ffmpeg's output and then delete the originals
./curator.py convert -del -in:avi,mpg -print:formated,verbose -dir:/mnt/media/
More examples in :doc:`use_cases`
See Also
--------
Synopsis
Description
`FFmpeg <https://ffmpeg.org/>`_
Author
------
Fabrice Quenneville

View File

@ -30,6 +30,7 @@ Examples:
./curator.py list -filters:old -print:formated -dir:/mnt/media/ >> ../medlist.txt
# Convert all videos with the codec mpeg4 in a mp4 using the av1 video codec and the delete the originals
./curator.py convert -del -filters:mpeg4 -out:av1,mp4 -dir:"/mnt/media/Movies/"
# Convert any video with avi or mpg extensions, print formated text including ffmpeg's output and then delete the originals
./curator.py convert -del -in:avi,mpg -print:formated,verbose -dir:/mnt/media/
More examples in :doc:`use_cases`

View File

@ -1 +1 @@
Search.setIndex({docnames:["index","usage/errors","usage/installation","usage/manual","usage/quickstart","usage/use_cases","usage/warnings"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,sphinx:56},filenames:["index.rst","usage/errors.rst","usage/installation.rst","usage/manual.rst","usage/quickstart.rst","usage/use_cases.rst","usage/warnings.rst"],objects:{},objnames:{},objtypes:{},terms:{"1080p":[3,4],"720p":[3,4],"case":[0,4],"default":[3,4],"try":1,"while":1,For:2,The:0,Use:[0,4],acquaint:6,activ:1,after:1,again:[1,6],all:[0,4,6],also:[0,1],ani:[3,4],audio:1,author:0,av1:[0,3,4],avi:[3,4],base:0,batch:0,befor:6,behavior:6,big:1,big_valu:1,bug:0,can:[0,1,6],chapter:1,clean:1,clone:2,code:0,codec:[0,4],com:2,comma:[3,4],command:[0,6],content:0,convert:[0,3,4,6],curat:[3,4,6],damag:[1,6],databas:0,decod:1,del:[3,4,6],delet:[4,6],depend:1,descript:0,detect:1,dir:[3,4,6],distribut:[1,2],don:1,done:6,doubl:[3,4],download:2,dry:6,encod:[0,6],error:[0,6],exampl:[0,1,4],expect:6,experi:1,extent:0,fabquennevil:2,fabric:3,face:1,failur:1,featur:[1,6],feel:1,few:[1,6],fferror:[3,4,6],ffmpeg:0,file:[3,4,6],filenam:[3,4],filter:[0,3,4,6],find:0,flag:6,flv:[3,4],folder:6,format:[3,4],found:[0,1],frame:1,free:1,from:0,get:6,git:2,github:[0,1],gnu:2,happen:1,have:6,header:1,here:[1,6],http:2,index:[],inform:[0,1],instal:0,irrecover:6,irrirrepar:6,issu:0,its:1,latest:1,librari:6,like:1,line:0,linux:2,list:[0,3,4,6],lowr:[3,4,6],m4v:[3,4],mai:1,manag:0,manual:0,media2:[3,4],media:[0,3,4,6],mediacur:[1,2,3,6],medlist:[3,4],miss:1,mkv:[3,4],mnt:[3,4,6],modern:0,modul:[],more:[0,4],most:1,move:1,movi:[3,4],mp4:[3,4],mpeg4:[3,4],mpeg:[1,3,4],mpg:[3,4],multipl:[3,4],name:0,necessarli:1,next:1,non:6,now:2,occur:1,old:[1,3,4],onli:2,open:1,option:[0,1,4],origin:4,other:0,out:[3,4],output:1,packag:2,page:[],pip:2,pleas:6,possibl:1,print:[1,3,4],project:1,properli:6,python:0,quennevil:3,quickstart:0,quit:1,raw:1,recod:0,recur:1,referenc:1,repair:[0,6],report:1,repositori:1,requir:2,resolut:0,run:[1,6],search:[],see:0,segfault:1,sei:1,separ:[3,4],serv:1,some:1,sourc:[0,1],step:1,subsd:6,substandard:6,suggest:1,synopsi:0,take:1,thi:2,too:1,tool:0,track:1,txt:[2,3,4],type:1,uhd:[3,4],unintend:6,until:6,updat:1,use:[3,4,6],used:[1,6],using:[1,4,6],valu:[3,4],valuabl:6,verbos:[1,3,4],veri:1,version:1,vid:[3,4],video2:3,video:[0,1,3,4,6],want:1,warn:0,when:[1,6],wich:1,without:0,wmv3:[3,4],wmv:[3,4],work:2,x264:[3,4],x265:[0,3,4],you:[1,6],your:[1,6]},titles:["Welcome to MediaCurator\u2019s documentation!","Errors","Installation","Manual","Quickstart","Use cases","Warnings"],titleterms:{"case":5,For:[],Use:5,also:3,author:3,bug:1,descript:3,distribut:[],document:0,download:[],encod:1,error:1,exampl:3,ffmpeg:[1,2],from:2,github:2,gnu:[],indic:[],instal:2,issu:1,linux:[],manual:3,mediacur:0,name:3,now:[],onli:[],option:3,other:1,packag:[],quickstart:4,repair:1,requir:[],see:3,synopsi:3,tabl:[],thi:[],warn:6,welcom:0,work:[]}})
Search.setIndex({docnames:["index","usage/errors","usage/installation","usage/manual","usage/quickstart","usage/use_cases","usage/warnings"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,sphinx:56},filenames:["index.rst","usage/errors.rst","usage/installation.rst","usage/manual.rst","usage/quickstart.rst","usage/use_cases.rst","usage/warnings.rst"],objects:{},objnames:{},objtypes:{},terms:{"1080p":[3,4],"720p":[3,4],"case":[0,3,4],"default":[3,4],"try":1,"while":1,For:2,The:0,Use:[0,3,4],acquaint:6,activ:1,after:1,again:[1,6],all:[0,3,4,6],also:[0,1],ani:[3,4],audio:1,author:0,av1:[0,3,4],avi:[3,4],base:[0,3],bash:[],batch:[0,3],befor:6,behavior:6,big:1,big_valu:1,block:[],bug:0,can:[0,1,6],chapter:1,clean:1,clone:2,code:0,codec:[0,3,4],com:2,comma:[3,4],command:[0,3,6],content:0,convert:[0,4,6],curat:[3,4,6],damag:[1,6],databas:[0,3],decod:1,del:[4,6],delet:[3,4,6],depend:1,descript:0,detect:1,dir:[4,6],distribut:[1,2],don:1,done:6,doubl:[3,4],download:2,dry:6,encod:[0,3,6],error:[0,3,6],exampl:[0,1,4],expect:6,experi:1,extens:[3,4],extent:[0,3],fabquennevil:2,fabric:3,face:1,failur:1,featur:[1,6],feel:1,few:[1,6],fferror:[3,4,6],ffmpeg:[0,3,4],file:[4,6],filenam:[3,4],filter:[0,4,6],find:[0,3],flag:6,flv:[3,4],folder:6,format:[3,4],found:[0,1],frame:1,free:1,from:0,get:6,git:2,github:[0,1],gnu:2,happen:1,have:6,header:1,here:[1,6],http:2,includ:[3,4],index:[],inform:[0,1,3],instal:0,irrecover:6,irrirrepar:6,issu:0,its:1,latest:1,librari:6,like:1,line:[0,3],linux:2,list:[0,4,6],lowr:[3,4,6],m4v:[3,4],mai:1,manag:[0,3],manual:0,media2:[3,4],media:[0,3,4,6],mediacur:[1,2,3,6],medlist:[3,4],miss:1,mkv:[3,4],mnt:[3,4,6],modern:[0,3],modul:[],more:[0,3,4],most:1,move:1,movi:[3,4],mp4:[3,4],mpeg4:[3,4],mpeg:[1,3,4],mpg:[3,4],multipl:[3,4],name:0,necessarli:1,next:1,non:6,now:2,occur:1,old:[1,3,4],onli:2,open:1,option:[0,1,4],origin:[3,4],other:0,out:4,output:[1,3,4],packag:2,page:[],pip:2,pleas:6,possibl:1,print:[1,4],project:1,properli:6,python:[0,3],quennevil:3,quickstart:0,quit:1,raw:1,recod:[0,3],recur:1,referenc:1,repair:[0,3,6],report:1,repositori:1,requir:2,resolut:[0,3],run:[1,6],search:[],see:0,segfault:1,sei:1,separ:[3,4],serv:1,some:1,sourc:[0,1],step:1,subsd:6,substandard:6,suggest:1,synopsi:0,take:1,text:[3,4],thi:2,too:1,tool:[0,3],track:1,txt:[2,3,4],type:1,uhd:[3,4],unintend:6,until:6,updat:1,use:[3,4,6],used:[1,6],using:[1,3,4,6],valu:[3,4],valuabl:6,verbos:[1,3,4],veri:1,version:1,vid:[3,4],video2:3,video:[0,1,3,4,6],want:1,warn:0,when:[1,6],wich:1,without:[0,3],wmv3:[3,4],wmv:[3,4],work:2,x264:[3,4],x265:[0,3,4],you:[1,6],your:[1,6]},titles:["Welcome to MediaCurator\u2019s documentation!","Errors","Installation","Manual","Quickstart","Use cases","Warnings"],titleterms:{"case":5,For:[],Use:5,also:3,author:3,bug:1,convert:3,del:3,descript:3,dir:3,distribut:[],document:0,download:[],encod:1,error:1,exampl:3,ffmpeg:[1,2],file:3,filter:3,from:2,github:2,gnu:[],indic:[],instal:2,issu:1,linux:[],list:3,manual:3,mediacur:0,name:3,now:[],onli:[],option:3,other:1,out:3,packag:[],print:3,quickstart:4,repair:1,requir:[],see:3,synopsi:3,tabl:[],thi:[],warn:6,welcom:0,work:[]}})

View File

@ -38,9 +38,7 @@
<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>
<blockquote>
<div><p>MediaCurator</p>
</div></blockquote>
<p>MediaCurator</p>
</div>
<div class="section" id="synopsis">
<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline"></a></h2>
@ -52,39 +50,6 @@
<span class="o">[</span>-dir/-files:<span class="s2">&quot;/mnt/media/&quot;</span>,,<span class="s2">&quot;/mnt/media2/&quot;</span><span class="o">]</span>
</pre></div>
</div>
</div>
<div class="section" id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline"></a></h2>
</div>
<div class="section" id="options">
<h2>Options<a class="headerlink" href="#options" title="Permalink to this headline"></a></h2>
<p>list</p>
<p>convert</p>
<p>-del:</p>
<dl class="simple">
<dt>-in:</dt><dd><p>[any,avi,mkv,wmv,mpg,mp4,m4v,flv,vid]</p>
</dd>
<dt>-filters:</dt><dd><p>[fferror,old,lowres,hd,720p,1080p,uhd,mpeg,mpeg4,x264,wmv3,wmv]</p>
</dd>
<dt>-out:</dt><dd><p>[mkv/mp4,x265/av1]</p>
</dd>
<dt>-print:</dt><dd><p>[list,formated,verbose]</p>
</dd>
<dt>-dir:</dt><dd><p>[“/mnt/media/”,,”/mnt/media2/”]</p>
</dd>
<dt>-files:</dt><dd><p>[“/mnt/media/video.avi”,,”/mnt/media2/video2.mp4”]</p>
</dd>
</dl>
</div>
<div class="section" id="examples">
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
</div>
<div class="section" id="see-also">
<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline"></a></h2>
</div>
<div class="section" id="author">
<h2>Author<a class="headerlink" href="#author" title="Permalink to this headline"></a></h2>
<p>Fabrice Quenneville</p>
<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
@ -93,14 +58,86 @@
-print:list
</pre></div>
</div>
<p>Examples:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>./curator.py list -filters:old -print:formated -dir:/mnt/media/ &gt;&gt; ../medlist.txt
</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 videos 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>
<blockquote>
<div><p>Print information</p>
</div></blockquote>
</div>
<div class="section" id="convert">
<h3>convert<a class="headerlink" href="#convert" title="Permalink to this headline"></a></h3>
</div>
<div class="section" id="del">
<h3>-del:<a class="headerlink" href="#del" title="Permalink to this headline"></a></h3>
</div>
<div class="section" id="in">
<h3>-in:<a class="headerlink" href="#in" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[any,avi,mkv,wmv,mpg,mp4,m4v,flv,vid]</p>
</div></blockquote>
</div>
<div class="section" id="filters">
<h3>-filters:<a class="headerlink" href="#filters" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[fferror,old,lowres,hd,720p,1080p,uhd,mpeg,mpeg4,x264,wmv3,wmv]</p>
</div></blockquote>
</div>
<div class="section" id="out">
<h3>-out:<a class="headerlink" href="#out" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[mkv/mp4,x265/av1]</p>
</div></blockquote>
</div>
<div class="section" id="print">
<h3>-print:<a class="headerlink" href="#print" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[list,formated,verbose]</p>
</div></blockquote>
</div>
<div class="section" id="dir">
<h3>-dir:<a class="headerlink" href="#dir" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[“/mnt/media/”,,”/mnt/media2/”]</p>
</div></blockquote>
</div>
<div class="section" id="files">
<h3>-files:<a class="headerlink" href="#files" title="Permalink to this headline"></a></h3>
<blockquote>
<div><p>[“/mnt/media/video.avi”,,”/mnt/media2/video2.mp4”]</p>
</div></blockquote>
</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/ &gt;&gt; ../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">&quot;/mnt/media/Movies/&quot;</span>
<span class="c1"># Convert any video with avi or mpg extensions, print formated text including ffmpeg&#39;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>Synopsis</p>
<p>Description</p>
<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>

View File

@ -57,6 +57,7 @@
./curator.py list -filters:old -print:formated -dir:/mnt/media/ &gt;&gt; ../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">&quot;/mnt/media/Movies/&quot;</span>
<span class="c1"># Convert any video with avi or mpg extensions, print formated text including ffmpeg&#39;s output and then delete the originals</span>
./curator.py convert -del -in:avi,mpg -print:formated,verbose -dir:/mnt/media/
</pre></div>
</div>

View File

@ -19,47 +19,6 @@ Synopsis
[-print:list,formated,verbose]
[-dir/-files:"/mnt/media/",,"/mnt/media2/"]
Description
-----------
Options
-------
list
convert
-del:
-in:
[any,avi,mkv,wmv,mpg,mp4,m4v,flv,vid]
-filters:
[fferror,old,lowres,hd,720p,1080p,uhd,mpeg,mpeg4,x264,wmv3,wmv]
-out:
[mkv/mp4,x265/av1]
-print:
[list,formated,verbose]
-dir:
["/mnt/media/",,"/mnt/media2/"]
-files:
["/mnt/media/video.avi",,"/mnt/media2/video2.mp4"]
Examples
--------
See Also
--------
Author
------
Fabrice Quenneville
**for multiple files or filenames use double comma separated values ",,"**
@ -72,20 +31,72 @@ default options are:
-out:mkv,x265
-print:list
Examples:
Description
-----------
MediaCurator is a Python command line tool to manage a media database.
* List all the video's and their information with or without filters
* Batch find and repair/convert videos with encoding errors
* Batch recode videos to more modern codecs (x265 / AV1) based on filters: extentions, codecs, resolutions ...
Options
-------
list
====
Print information
convert
=======
-del:
=====
-in:
====
[any,avi,mkv,wmv,mpg,mp4,m4v,flv,vid]
-filters:
=========
[fferror,old,lowres,hd,720p,1080p,uhd,mpeg,mpeg4,x264,wmv3,wmv]
-out:
=====
[mkv/mp4,x265/av1]
-print:
=======
[list,formated,verbose]
-dir:
=====
["/mnt/media/",,"/mnt/media2/"]
-files:
=======
["/mnt/media/video.avi",,"/mnt/media2/video2.mp4"]
Examples
--------
.. code-block:: bash
# List all videos with old codec in formated format
./curator.py list -filters:old -print:formated -dir:/mnt/media/ >> ../medlist.txt
# Convert all videos with the codec mpeg4 in a mp4 using the av1 video codec and the delete the originals
./curator.py convert -del -filters:mpeg4 -out:av1,mp4 -dir:"/mnt/media/Movies/"
# Convert any video with avi or mpg extensions, print formated text including ffmpeg's output and then delete the originals
./curator.py convert -del -in:avi,mpg -print:formated,verbose -dir:/mnt/media/
More examples in :doc:`use_cases`
See Also
--------
Synopsis
Description
`FFmpeg <https://ffmpeg.org/>`_
Author
------
Fabrice Quenneville

View File

@ -30,6 +30,7 @@ Examples:
./curator.py list -filters:old -print:formated -dir:/mnt/media/ >> ../medlist.txt
# Convert all videos with the codec mpeg4 in a mp4 using the av1 video codec and the delete the originals
./curator.py convert -del -filters:mpeg4 -out:av1,mp4 -dir:"/mnt/media/Movies/"
# Convert any video with avi or mpg extensions, print formated text including ffmpeg's output and then delete the originals
./curator.py convert -del -in:avi,mpg -print:formated,verbose -dir:/mnt/media/
More examples in :doc:`use_cases`