# Manual — mediacurator documentation

# Manual

## Name

mediacurator

## Synopsis

    mediacurator [list,convert] [-del]
        [-in:any,avi,mkv,wmv,mpg,mp4,m4v,flv,vid,divx,ogm,webm]
        [-filters:fferror,old,lowres,hd,720p,1080p,uhd,mpeg,mpeg4,x264,wmv3,wmv,vob]
        [-out:mkv/mp4,x265/av1]
        [-print:list,formated,verbose]
        [-dirs/-files:"/mnt/media/",,"/mnt/media2/"]

for multiple files or filenames use double comma separated values “,,”

default options are:

    -in:any
    -filters:
    -out:mkv,x265
    -print:list

## 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

Search and list videos filtered by the parameters passed by the user.

### convert

Search and convert all videos filtered by the parameters passed by the user.

### -del:

Delete all original videos once selected operations have been done succefully.

See Warnings

### -in:

[any,avi,mkv,wmv,mpg,mp4,m4v,flv,vid,divx,ogm]

Search all videos of the selected container extensions in the directories. By default it will include any file format.

### -filters:

[fferror,old,lowres,hd,720p,1080p,uhd,mpeg,mpeg4,x264,wmv3,wmv]

Filter the selected videos for parameters:

- fferror: Select all videos with encoding errors (See Errors)

- old: Select all videos using old codecs (Everything except hevc or av1)

- hd: 720p, 1080p, uhd

- lowres: Everything not hd

- uhd: if width >= 2160 or height >= 2160

- 1080p: if less than uhd and width >= 1440 or height >= 1080

- 720p: if less than 1080p and width >= 1280 or height >= 720:

- sd: if less than 720p and if height >= 480

- subsd: Substandard definitions: Everything under 480p

- mpeg,mpeg4,x264,wmv3,wmv,vob: Filter for videos encoded in the requested video codec

### -out:

[mkv/mp4,x265/av1]

Select the outputs for the video conversions

- mkv: (Default) Package the resulting video in a Matroska container.

- mp4: Package the resulting video in a container.

- x265/hevc: (Default) Encode the video using the x265 compression format.

- av1: Encode the video using the AOMedia Video 1 compression format. This will be used as default once the developpers at FFmpeg move it out of experimental .

### -print:

[list,formated,verbose]

- list: (Default) Print the information about the videos on a single line

- formated: Print the information in an aerated format

- verbose: Print the FFmpeg output during the video conversions

### -dirs:

[“/mnt/media/”,,”/mnt/media2/”]

The directories to scan as a double comma separated values list.

### -files:

[“/mnt/media/video.avi”,,”/mnt/media2/video2.mp4”]

Specific videos to include as a double comma separated values list.

## Examples

    # List all videos with old codec in formated format
    mediacurator list -filters:old -print:formated -dirs:/mnt/media/ >> ../medlist.txt
    # Convert all videos with the codec mpeg4 in a mp4 using the av1 video codec and the delete the originals
    mediacurator convert -del -filters:mpeg4 -out:av1,mp4 -dirs:"/mnt/media/Movies/"
    # Convert any video with avi or mpg extensions, print formated text including ffmpeg's output and then delete the originals
    mediacurator convert -del -in:avi,mpg -print:formated,verbose -dirs:/mnt/media/

More examples in Use cases

## See Also

FFmpeg

## Author

Fabrice Quenneville