Use cases

The main reasons to use mediacurator would be the following:

• Print information on a video library such as:

  • How many videos of the lot are in HD vs standard or substandard definitions

  • What videos are in older codecs

  • Are there videos in the library with encoding or corruption errors

• Purge selected videos in a media library

• Batch repair encoding errors on selected videos in a media library

• Batch re-encode videos from an old codec to High Efficiency Video Coding

Print information

List all videos with old codec in formatted output

mediacurator list --filters old --printop formatted --dirs "/mnt/media/" "/mnt/media2/"

List all videos with substandard definitions with a formatted output

mediacurator list --filters subsd --printop formatted --dirs "/mnt/media/" "/mnt/media2/"

Purge

Please see Warnings

List and delete all videos using the Windows Media Video codecs

mediacurator list --delete --filters wmv --dirs "/mnt/media/" "/mnt/media2/"

List and delete all videos using Audio Video Interleave

mediacurator list --delete --inputs avi --dirs "/mnt/media/" "/mnt/media2/"

List and delete any videos with encoding errors

mediacurator list --delete --filters fferror --dirs "/mnt/media/" "/mnt/media2/"

Batch repair encoding errors

List all videos with encoding errors

mediacurator list --filters fferror --dirs "/mnt/media/" "/mnt/media2/"

List and delete any videos with encoding errors

mediacurator list --delete --filters fferror --dirs "/mnt/media/" "/mnt/media2/"

Convert all videos with encoding errors to High Efficiency Video Coding and delete the originals

mediacurator convert --delete --filters fferror --dirs "/mnt/media/" "/mnt/media2/"

Batch re-encode

Convert all videos with old codecs to High Efficiency Video Coding to save space and delete the originals

mediacurator convert --delete --filters old --dirs "/mnt/media/" "/mnt/media2/"

Convert all videos with the codec mpeg4 to an mkv container using the av1 video codec

mediacurator convert --filters mpeg4 --outputs av1,mkv --dirs "/mnt/media/" "/mnt/media2/"

Convert any video with avi or mpg extensions, print formatted text including ffmpeg’s output, and then delete the originals

mediacurator convert --delete --inputs avi,mpg --printop formatted,verbose --dirs "/mnt/media/" "/mnt/media2/"