From 6595d6d4766063c3967b280b5c2c78ac5f103462 Mon Sep 17 00:00:00 2001 From: Fabrice Quenneville Date: Sat, 21 Nov 2020 14:38:36 -0500 Subject: [PATCH] Working on doc errors --- docs/_sources/usage/errors.rst.txt | 36 ++++++++++++--- docs/index.html | 7 ++- docs/searchindex.js | 2 +- docs/usage/errors.html | 43 ++++++++++++++---- docsource/build/doctrees/environment.pickle | Bin 14437 -> 15810 bytes docsource/build/doctrees/usage/errors.doctree | Bin 2790 -> 8688 bytes .../build/html/_sources/usage/errors.rst.txt | 36 ++++++++++++--- docsource/build/html/index.html | 7 ++- docsource/build/html/searchindex.js | 2 +- docsource/build/html/usage/errors.html | 43 ++++++++++++++---- docsource/source/usage/errors.rst | 36 ++++++++++++--- 11 files changed, 171 insertions(+), 41 deletions(-) diff --git a/docs/_sources/usage/errors.rst.txt b/docs/_sources/usage/errors.rst.txt index c27ea6c..773b184 100644 --- a/docs/_sources/usage/errors.rst.txt +++ b/docs/_sources/usage/errors.rst.txt @@ -3,12 +3,34 @@ Errors ====== +FFmpeg can detect quite a few errors in the encoding of your source video's encoding. It can also be used to repair errors. +Repairable encoding errors +-------------------------- -"Referenced QT chapter track not found", -"Error, header damaged or not MPEG-4 header", -"Header missing", -"SEI type", -"no frame!", -"Error while decoding MPEG audio frame.", -"big_values too big" \ No newline at end of file +Here are some example errors that mediacurator will print and can possibly repair by re-encoding: + +* "Referenced QT chapter track not found" +* "Error, header damaged or not MPEG-4 header" +* "Header missing" +* "SEI type" +* "no frame!" +* "Error while decoding MPEG audio frame." +* "big_values too big" +* ... + +FFmpeg issues +------------- + +While using FFmpeg depending on your version you may also face other errors like segfaults. MediaCurator will also print information when that occurs and move on to the next video after cleaning up after failure. + +If that happens there are a few steps you can take: + +* Update FFmpeg to its latest version as it is a very active project and most distributions serve old versions in their repositories +* Run MediaCurator with the verbose print option wich will print the raw FFmpeg output +* Try again: In my experience some errors don't necessarly recur... + +Other bugs +---------- + +If you face other bugs, issues or want to suggest features feel free to open a bug report on `GitHub `_ \ No newline at end of file diff --git a/docs/index.html b/docs/index.html index 8e973c7..4269237 100644 --- a/docs/index.html +++ b/docs/index.html @@ -51,7 +51,12 @@
  • Quickstart
  • Use cases
    • -
  • Errors
    • +
  • Errors +
    • diff --git a/docs/searchindex.js b/docs/searchindex.js index 8277941..3b1a137 100644 --- a/docs/searchindex.js +++ b/docs/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["index","usage/errors","usage/installation","usage/quickstart","usage/use_cases"],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/quickstart.rst","usage/use_cases.rst"],objects:{},objnames:{},objtypes:{},terms:{"1080p":3,"720p":3,"case":0,"default":3,"while":1,For:2,The:0,Use:0,all:0,ani:3,audio:1,av1:[0,3],avi:3,base:0,bash:[],batch:0,big:1,big_valu:1,can:0,chapter:1,clone:2,code:0,codec:0,com:2,comma:3,command:0,content:0,convert:3,curat:3,damag:1,databas:0,decod:1,del:3,dir:3,distribut:2,doubl:3,download:2,error:0,exampl:3,extent:0,fabquennevil:2,fferror:3,ffmpeg:0,file:3,filenam:3,filter:[0,3],flv:3,format:3,found:[0,1],frame:1,from:0,git:2,github:0,gnu:2,header:1,http:2,index:[],instal:0,line:0,linux:2,list:[0,3],lowr:3,m4v:3,manag:0,media2:3,media:[0,3],mediacur:2,medlist:3,miss:1,mkv:3,mnt:3,modern:0,modul:[],more:0,movi:3,mp4:3,mpeg4:3,mpeg:[1,3],mpg:3,multipl:3,now:2,old:3,onli:2,option:3,out:3,packag:2,page:[],pip:2,print:3,python:0,quickstart:0,recod:0,referenc:1,requir:2,search:[],sei:1,separ:3,sourc:0,thi:2,too:1,tool:0,track:1,txt:[2,3],type:1,uhd:3,use:3,valu:3,verbos:3,vid:3,video:0,without:0,wmv3:3,wmv:3,work:2,x264:3,x265:[0,3]},titles:["Welcome to MediaCurator\u2019s documentation!","Errors","Installation","Quickstart","Use cases"],titleterms:{"case":4,Use:4,document:0,error:1,ffmpeg:2,from:2,github:2,indic:[],instal:2,mediacur:0,quickstart:3,tabl:[],welcom:0}}) \ No newline at end of file +Search.setIndex({docnames:["index","usage/errors","usage/installation","usage/quickstart","usage/use_cases"],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/quickstart.rst","usage/use_cases.rst"],objects:{},objnames:{},objtypes:{},terms:{"1080p":3,"720p":3,"case":0,"default":3,"try":1,"while":1,For:2,The:0,Use:0,activ:1,after:1,again:1,all:0,also:1,ani:3,audio:1,av1:[0,3],avi:3,base:0,bash:[],batch:0,big:1,big_valu:1,bug:0,can:[0,1],chapter:1,clean:1,clone:2,code:0,codec:0,com:2,comma:3,command:0,content:0,convert:3,curat:3,damag:1,databas:0,decod:1,del:3,depend:1,detect:1,dir:3,distribut:[1,2],don:1,doubl:3,download:2,encod:0,error:0,exampl:[1,3],experi:1,extent:0,fabquennevil:2,face:1,failur:1,featur:1,feel:1,few:1,fferror:3,ffmpeg:0,file:3,filenam:3,filter:[0,3],flv:3,format:3,found:[0,1],frame:1,free:1,from:0,git:2,github:[0,1],gnu:2,happen:1,header:1,here:1,http:2,index:[],inform:1,instal:0,issu:0,its:1,latest:1,like:1,line:0,linux:2,list:[0,3],lowr:3,m4v:3,mai:1,manag:0,media2:3,media:[0,3],mediacur:[1,2],medlist:3,miss:1,mkv:3,mnt:3,modern:0,modul:[],more:0,most:1,move:1,movi:3,mp4:3,mpeg4:3,mpeg:[1,3],mpg:3,multipl:3,necessarli:1,next:1,now:2,occur:1,old:[1,3],onli:2,open:1,option:[1,3],other:0,out:3,output:1,packag:2,page:[],pip:2,possibl:1,print:[1,3],project:1,python:0,quickstart:0,quit:1,raw:1,recod:0,recur:1,referenc:1,repair:0,report:1,repositori:1,requir:2,run:1,search:[],segfault:1,sei:1,separ:3,serv:1,some:1,sourc:[0,1],step:1,suggest:1,take:1,thi:2,too:1,tool:0,track:1,txt:[2,3],type:1,uhd:3,updat:1,use:3,used:1,using:1,valu:3,verbos:[1,3],veri:1,version:1,vid:3,video:[0,1],want:1,when:1,wich:1,without:0,wmv3:3,wmv:3,work:2,x264:3,x265:[0,3],you:1,your:1},titles:["Welcome to MediaCurator\u2019s documentation!","Errors","Installation","Quickstart","Use cases"],titleterms:{"case":4,Use:4,bug:1,document:0,encod:1,error:1,ffmpeg:[1,2],from:2,github:2,indic:[],instal:2,issu:1,mediacur:0,other:1,quickstart:3,repair:1,tabl:[],welcom:0}}) \ No newline at end of file diff --git a/docs/usage/errors.html b/docs/usage/errors.html index e5993e4..e0187d3 100644 --- a/docs/usage/errors.html +++ b/docs/usage/errors.html @@ -35,13 +35,35 @@

    Errors

    -

    “Referenced QT chapter track not found”, -“Error, header damaged or not MPEG-4 header”, -“Header missing”, -“SEI type”, -“no frame!”, -“Error while decoding MPEG audio frame.”, -“big_values too big”

    +

    FFmpeg can detect quite a few errors in the encoding of your source video’s encoding. It can also be used to repair errors.

    +
    +

    Repairable encoding errors

    +

    Here are some example errors that mediacurator will print and can possibly repair by re-encoding:

    +
      +

    • “Referenced QT chapter track not found”

      • +

    • “Error, header damaged or not MPEG-4 header”

      • +

    • “Header missing”

      • +

    • “SEI type”

      • +

    • “no frame!”

      • +

    • “Error while decoding MPEG audio frame.”

      • +

    • “big_values too big”

      • +

    • …

      • +
    +
    +
    +

    FFmpeg issues

    +

    While using FFmpeg depending on your version you may also face other errors like segfaults. MediaCurator will also print information when that occurs and move on to the next video after cleaning up after failure.

    +

    If that happens there are a few steps you can take:

    +
      +

    • Update FFmpeg to its latest version as it is a very active project and most distributions serve old versions in their repositories

      • +

    • Run MediaCurator with the verbose print option wich will print the raw FFmpeg output

      • +

    • Try again: In my experience some errors don’t necessarly recur…

      • +
    +
    +
    +

    Other bugs

    +

    If you face other bugs, issues or want to suggest features feel free to open a bug report on GitHub

    +
    @@ -69,7 +91,12 @@
  • Installation
  • Quickstart
  • Use cases
    • -
  • Errors
    • +
  • Errors +
    • diff --git a/docsource/build/doctrees/environment.pickle b/docsource/build/doctrees/environment.pickle index e709e46c50d80eed57e025e95af2853d9497d6c7..b6d77bb22d4f4e5bde8ece2d3805a28432045470 100644 GIT binary patch delta 3656 zcmbtXZ%kWN6z8=(#wdS=Yey+7JSg25`w|zU z75|J(UV`B~^qU!eHgmcJvdoRl5dGkcF2=Z+CB~TfC(#*QjG1PM=ib}Wu2jaGU+#JL zoqK-goZmh7-1lxpK6+k!Nt|2U`@R@(z?%*UUUpbFh@tRt~0`Aom!@-(a@NRd2CfS7Z&{Ve{Zc7&MOD@=28xoe2Z<=T8b_zFAYM~Pb zq&k>(S)sRP;|4O1Udb=0ebKf|A5}WspaYEuHA{8Z(4ig9x{6FTGn7jnxasN;HbJD` z2ZQyMLJ>ao2qK&RQEwCSq1Np&H;^)vcEJi04Ni=*s(q2-F?Uaz^YYYSfV_imUeFuJ zMU+Q$a*2z}Tr6>M6_(t4z*7H+++oOSU%k8VF=jz%Ko#)!wkjbV(txZOf?IMofn!Hy z;vib_B!WilSuQF$hmss#fjDLu0ycZ>1;0!f{N@m!D3@| zMq*P&>~kmfs$qyklAKr2lJm>6RMuA{8DVIapgK0D#E*@IVsV{g@j_S&YXs{rRdE?$ zBpuJAhI2}$bdDL4INkePXJc!v&qqF`T6Q>=v;2I^|}>GQzja z#nz@1{f_U>_gviK;zuriW?R-Q@02A&R=8!d(~w1}$LV(%v0wq_+5+T(T?VAN{^8;tWdg6G`R(>WvYD0-tAD={2!@nAXQe9;`x!*ezVA#p z4k(d8C>jWkDUuQ%8b2Nik4Q>1Iv$Pbuj!LIy^!8QTy3p|Jk$xpp=yQjvD=!UY-&Y; z@X+XZG#ogo=vtL4x)PS03QJCgl}s?rQP{BK`#9=D_vFOGVid0MJjx)lFQTI*U0o+5 z%7_$-#Z)DW)GQt6an496v}$q?Sn3)cre5Ww*HxU&8gY`lu4YmYkE5Q}$(rSziSZ!L z4i)+1qe@f?sv}v1WhyvZ7gJHJCy4)G%iqoANIpf?|eTlQAcFM}gk zO{*`{4_m6d^z964>8dx_U7McKOE*2clbS)1_XGSOzwABl&J*#d`_YsL_yqb6-r#7b z?I$9>>L&#v%XKPkfJGsJ=;ejJsE@WY;in`zibbXC<%B*t20nFxKY zE)$AqtH(#xXH>EeMQs@ z98tpjM~ZZdAhk7_dPL}NYb)==wWOa8emV?@FxTc*dhxk|+^^G$`^Jx}*z9}Q4_O>r zeAWtb2+gMS(|T}9*9u}vAUZUvlcV@@w41Dkgqn6+w*O-ybhbaeyPL*BhtclSIvJ$1 aXHqkYmjp$fLTAGweA3=$iiohq=l>T5`Yb^J delta 2478 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 N1iH>Q2r3~*`8PK2V*3C9 delta 241 zcmez1{7jU!fpzL_u8piy85s{ue$S%Ltiz==S(Z&pUkS+YNKH&hEmFwMEH2K>O9zPr zyLu{=R2HOy*m?O1X+?>-sfr-ZWNA({W*}qoeoiT7v7S4V^;xx`_ \ No newline at end of file diff --git a/docsource/build/html/index.html b/docsource/build/html/index.html index 8e973c7..4269237 100644 --- a/docsource/build/html/index.html +++ b/docsource/build/html/index.html @@ -51,7 +51,12 @@
  • Quickstart
  • Use cases
    • -
  • Errors
    • +
  • Errors +
    • diff --git a/docsource/build/html/searchindex.js b/docsource/build/html/searchindex.js index 8277941..3b1a137 100644 --- a/docsource/build/html/searchindex.js +++ b/docsource/build/html/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["index","usage/errors","usage/installation","usage/quickstart","usage/use_cases"],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/quickstart.rst","usage/use_cases.rst"],objects:{},objnames:{},objtypes:{},terms:{"1080p":3,"720p":3,"case":0,"default":3,"while":1,For:2,The:0,Use:0,all:0,ani:3,audio:1,av1:[0,3],avi:3,base:0,bash:[],batch:0,big:1,big_valu:1,can:0,chapter:1,clone:2,code:0,codec:0,com:2,comma:3,command:0,content:0,convert:3,curat:3,damag:1,databas:0,decod:1,del:3,dir:3,distribut:2,doubl:3,download:2,error:0,exampl:3,extent:0,fabquennevil:2,fferror:3,ffmpeg:0,file:3,filenam:3,filter:[0,3],flv:3,format:3,found:[0,1],frame:1,from:0,git:2,github:0,gnu:2,header:1,http:2,index:[],instal:0,line:0,linux:2,list:[0,3],lowr:3,m4v:3,manag:0,media2:3,media:[0,3],mediacur:2,medlist:3,miss:1,mkv:3,mnt:3,modern:0,modul:[],more:0,movi:3,mp4:3,mpeg4:3,mpeg:[1,3],mpg:3,multipl:3,now:2,old:3,onli:2,option:3,out:3,packag:2,page:[],pip:2,print:3,python:0,quickstart:0,recod:0,referenc:1,requir:2,search:[],sei:1,separ:3,sourc:0,thi:2,too:1,tool:0,track:1,txt:[2,3],type:1,uhd:3,use:3,valu:3,verbos:3,vid:3,video:0,without:0,wmv3:3,wmv:3,work:2,x264:3,x265:[0,3]},titles:["Welcome to MediaCurator\u2019s documentation!","Errors","Installation","Quickstart","Use cases"],titleterms:{"case":4,Use:4,document:0,error:1,ffmpeg:2,from:2,github:2,indic:[],instal:2,mediacur:0,quickstart:3,tabl:[],welcom:0}}) \ No newline at end of file +Search.setIndex({docnames:["index","usage/errors","usage/installation","usage/quickstart","usage/use_cases"],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/quickstart.rst","usage/use_cases.rst"],objects:{},objnames:{},objtypes:{},terms:{"1080p":3,"720p":3,"case":0,"default":3,"try":1,"while":1,For:2,The:0,Use:0,activ:1,after:1,again:1,all:0,also:1,ani:3,audio:1,av1:[0,3],avi:3,base:0,bash:[],batch:0,big:1,big_valu:1,bug:0,can:[0,1],chapter:1,clean:1,clone:2,code:0,codec:0,com:2,comma:3,command:0,content:0,convert:3,curat:3,damag:1,databas:0,decod:1,del:3,depend:1,detect:1,dir:3,distribut:[1,2],don:1,doubl:3,download:2,encod:0,error:0,exampl:[1,3],experi:1,extent:0,fabquennevil:2,face:1,failur:1,featur:1,feel:1,few:1,fferror:3,ffmpeg:0,file:3,filenam:3,filter:[0,3],flv:3,format:3,found:[0,1],frame:1,free:1,from:0,git:2,github:[0,1],gnu:2,happen:1,header:1,here:1,http:2,index:[],inform:1,instal:0,issu:0,its:1,latest:1,like:1,line:0,linux:2,list:[0,3],lowr:3,m4v:3,mai:1,manag:0,media2:3,media:[0,3],mediacur:[1,2],medlist:3,miss:1,mkv:3,mnt:3,modern:0,modul:[],more:0,most:1,move:1,movi:3,mp4:3,mpeg4:3,mpeg:[1,3],mpg:3,multipl:3,necessarli:1,next:1,now:2,occur:1,old:[1,3],onli:2,open:1,option:[1,3],other:0,out:3,output:1,packag:2,page:[],pip:2,possibl:1,print:[1,3],project:1,python:0,quickstart:0,quit:1,raw:1,recod:0,recur:1,referenc:1,repair:0,report:1,repositori:1,requir:2,run:1,search:[],segfault:1,sei:1,separ:3,serv:1,some:1,sourc:[0,1],step:1,suggest:1,take:1,thi:2,too:1,tool:0,track:1,txt:[2,3],type:1,uhd:3,updat:1,use:3,used:1,using:1,valu:3,verbos:[1,3],veri:1,version:1,vid:3,video:[0,1],want:1,when:1,wich:1,without:0,wmv3:3,wmv:3,work:2,x264:3,x265:[0,3],you:1,your:1},titles:["Welcome to MediaCurator\u2019s documentation!","Errors","Installation","Quickstart","Use cases"],titleterms:{"case":4,Use:4,bug:1,document:0,encod:1,error:1,ffmpeg:[1,2],from:2,github:2,indic:[],instal:2,issu:1,mediacur:0,other:1,quickstart:3,repair:1,tabl:[],welcom:0}}) \ No newline at end of file diff --git a/docsource/build/html/usage/errors.html b/docsource/build/html/usage/errors.html index e5993e4..e0187d3 100644 --- a/docsource/build/html/usage/errors.html +++ b/docsource/build/html/usage/errors.html @@ -35,13 +35,35 @@

    Errors

    -

    “Referenced QT chapter track not found”, -“Error, header damaged or not MPEG-4 header”, -“Header missing”, -“SEI type”, -“no frame!”, -“Error while decoding MPEG audio frame.”, -“big_values too big”

    +

    FFmpeg can detect quite a few errors in the encoding of your source video’s encoding. It can also be used to repair errors.

    +
    +

    Repairable encoding errors

    +

    Here are some example errors that mediacurator will print and can possibly repair by re-encoding:

    +
      +

    • “Referenced QT chapter track not found”

      • +

    • “Error, header damaged or not MPEG-4 header”

      • +

    • “Header missing”

      • +

    • “SEI type”

      • +

    • “no frame!”

      • +

    • “Error while decoding MPEG audio frame.”

      • +

    • “big_values too big”

      • +

    • …

      • +
    +
    +
    +

    FFmpeg issues

    +

    While using FFmpeg depending on your version you may also face other errors like segfaults. MediaCurator will also print information when that occurs and move on to the next video after cleaning up after failure.

    +

    If that happens there are a few steps you can take:

    +
      +

    • Update FFmpeg to its latest version as it is a very active project and most distributions serve old versions in their repositories

      • +

    • Run MediaCurator with the verbose print option wich will print the raw FFmpeg output

      • +

    • Try again: In my experience some errors don’t necessarly recur…

      • +
    +
    +
    +

    Other bugs

    +

    If you face other bugs, issues or want to suggest features feel free to open a bug report on GitHub

    +
    @@ -69,7 +91,12 @@
  • Installation
  • Quickstart
  • Use cases
    • -
  • Errors
    • +
  • Errors +
    • diff --git a/docsource/source/usage/errors.rst b/docsource/source/usage/errors.rst index c27ea6c..773b184 100644 --- a/docsource/source/usage/errors.rst +++ b/docsource/source/usage/errors.rst @@ -3,12 +3,34 @@ Errors ====== +FFmpeg can detect quite a few errors in the encoding of your source video's encoding. It can also be used to repair errors. +Repairable encoding errors +-------------------------- -"Referenced QT chapter track not found", -"Error, header damaged or not MPEG-4 header", -"Header missing", -"SEI type", -"no frame!", -"Error while decoding MPEG audio frame.", -"big_values too big" \ No newline at end of file +Here are some example errors that mediacurator will print and can possibly repair by re-encoding: + +* "Referenced QT chapter track not found" +* "Error, header damaged or not MPEG-4 header" +* "Header missing" +* "SEI type" +* "no frame!" +* "Error while decoding MPEG audio frame." +* "big_values too big" +* ... + +FFmpeg issues +------------- + +While using FFmpeg depending on your version you may also face other errors like segfaults. MediaCurator will also print information when that occurs and move on to the next video after cleaning up after failure. + +If that happens there are a few steps you can take: + +* Update FFmpeg to its latest version as it is a very active project and most distributions serve old versions in their repositories +* Run MediaCurator with the verbose print option wich will print the raw FFmpeg output +* Try again: In my experience some errors don't necessarly recur... + +Other bugs +---------- + +If you face other bugs, issues or want to suggest features feel free to open a bug report on `GitHub `_ \ No newline at end of file