Use cases

Warning

The following documentation is for versions prior to 1.0.1. It may contain features and usage instructions that are incompatible with the current version of mediacurator.

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 -print:formated -dirs:"/mnt/media/",,"/mnt/media2/"

List all videos with substandard definitions with a formatted output

mediacurator list -filters:subsd -print:formated -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 -in: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 -out: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 -in:avi,mpg -print:formated,verbose -dirs:"/mnt/media/",,"/mnt/media2/"