File Analyzers

You can add a File Analyzer integration which will run the configured analyzers.

Analyzers

Here is the list of available analyzers:

checksum

This analyzer computes the checksum of a file using a specified hashing algorithm and can check for uniqueness of the file based on its checksum.

-
    module:               checksum # Required
    # Description of the module action
    description:          ~
    # Whether to enable this module
    enabled:              true
    # The hashing algorithm to use.
    algorithm:            sha256
    # Whether to strip metadata from the file before computing the checksum.
    stripMetadata:        true
    # Whether to check for uniqueness of the file based on its checksum.
    findDuplicates:       true
    # The maximum number of duplicates to check for. If more than this number of duplicates are found, only the first N will be returned.
    duplicatesLimit:      10
    # Whether to treat duplicate files as errors instead of warnings.
    treatDuplicateAsError: false

debug

This analyzer is used for debugging purposes. It allows you to specify errors, warnings, and additional data to be returned during the analysis of a file.

-
    module:               debug # Required
    # Description of the module action
    description:          ~
    # Whether to enable this module
    enabled:              true
    # If empty, file will be accepted.
    errors:               []
    warnings:             []
    data:                 []

doc_unique_id

This analyzer checks for a unique identifier in the file's metadata. If you enable this analyzer, the File Analyzer integration must then need a Read Metadata integration to be processed before it.

-
    module:               doc_unique_id # Required
    # Description of the module action
    description:          ~
    # Whether to enable this module
    enabled:              true
    read_from:
        # Defaults:
        - XMP-exif:ImageUniqueID
        - SigmaRaw:ImageUniqueID
        - IPTC:UniqueDocumentID
        - ExifIFD:ImageUniqueID
        - Canon:ImageUniqueID
        - XMP-xmpMM:DocumentID
    write:                true
    write_to:
        # Defaults:
        - XMP-exif:ImageUniqueID
        - SigmaRaw:ImageUniqueID
        - IPTC:UniqueDocumentID
        - ExifIFD:ImageUniqueID
        - Canon:ImageUniqueID
        - XMP-xmpMM:DocumentID
    findDuplicates:       true
    # The maximum number of duplicates to check for. If more than this number of duplicates are found, only the first N will be returned.
    duplicatesLimit:      10
    # Whether to treat duplicate files as errors instead of warnings.
    treatDuplicateAsError: false
    generate:             true

filename

Analyzes the filename of the file and checks it against allowed/disallowed patterns, extensions, and MIME types.

-
    module:               filename # Required
    # Description of the module action
    description:          ~
    # Whether to enable this module
    enabled:              true
    # One or more regex patterns that the filename can match.
    allowed_patterns:     []
    # One or more regex patterns that the filename cannot match.
    disallowed_patterns:  []
    # One or more file extensions that are allowed.
    allowed_extensions:   []
    # One or more file extensions that are not allowed.
    disallowed_extensions: []
    # One or more MIME types that are allowed.
    allowed_mime_types:   []
    # One or more MIME types that are not allowed.
    disallowed_mime_types: []

image_colorspace

Analyzes the colorspace of an image file and rejects it if its colorspace is not in the allowed list or is in the disallowed list. Non-image files are skipped.

-
    module:               image_colorspace # Required
    # Description of the module action
    description:          ~
    # Whether to enable this module
    enabled:              true
    # One or more colorspaces that are allowed (rgb, srgb, cmyk, grayscale, ycbcr, ycck, indexed, cielab, unknown).
    allowed_colorspaces:  []
    # One or more colorspaces that are not allowed.
    disallowed_colorspaces: []

image_dimension

Analyzes the dimensions of an image file and rejects it if its width or height falls outside the configured minimum/maximum bounds. Non-image files are skipped.

-
    module:               image_dimension # Required
    # Description of the module action
    description:          ~
    # Whether to enable this module
    enabled:              true
    # Minimum image width in pixels (inclusive).
    min_width:            ~
    # Maximum image width in pixels (inclusive).
    max_width:            ~
    # Minimum image height in pixels (inclusive).
    min_height:           ~
    # Maximum image height in pixels (inclusive).
    max_height:           ~