video_flawer

This python package is create to add artificial defects to videos: camera shake, auto focus blur, and noise simulation.

Installation

Via pip:

pip install video_flawer

Usage as utility

To flaw a video (with path ./test.mp4) with preset defects call:

python -m video_flawer test.mp4

The output (for example /data/out.avi) file can be setup as:

python -m video_flawer test.mp4 /data/out.avi

For customization of video defects you should create your custom config file (JSON format). You can provide the file (for example ./my_config.json as follows:

python -m video_flawer text.mp4 /data/out.avi my_config.json

Usage in script

You can use video_flawer directly in your script with preset defects as follows

import video_flawer

INPUT_PATH = "test.mp4"
OUTPUT_PATH = "out.avi"

video_flawer.run(INPUT_PATH, OUTPUT_PATH)

The defect details can be provided as nested dictionary

import video_flawer

INPUT_PATH = "test.mp4"
OUTPUT_PATH = "out.avi"

CONFIG = {
    "shift_sin_x": {
        "max_shift": 3,
        "frequency": 0.25
    },
}

video_flawer.run(INPUT_PATH, OUTPUT_PATH, config_data=CONFIG)

Or the defects can be described in JSON file:

import video_flawer

INPUT_PATH = "test.mp4"
OUTPUT_PATH = "out.avi"

video_flawer.run(INPUT_PATH, OUTPUT_PATH, config_path="config_example.json")

Known issues

• The output files are way too big. This issue should be addressed in future.
• The implemented effects are not well explained.

Preset defects

The sample JSON file with default settings follows

{
    "crop": {
        "w": 80,
        "h": 20
    },
    "shift_sin_x": {
        "max_shift": 3,
        "frequency": 0.25
    },
    "shift_sin_y": {
        "max_shift": 3,
        "frequency": 0.1
    },
    "shift_random_x": {
        "max_shift": 5,
        "max_duration": 2,
        "min_shift": 1,
        "min_duration": 0.5
    },
    "shift_random_y": {
        "max_shift": 5,
        "max_duration": 2,
        "min_shift": 1,
        "min_duration": 0.5
    },
    "rotation_sin": {
        "max_deg": 1,
        "frequency": 0.1
    },
    "rotation_random": {
        "max_deg": 2,
        "max_duration": 1,
        "min_deg": 1,
        "min_duration": 0.3
    },
    "scale_sin": {
        "max_percentage": 0.5,
        "frequency": 0.1
    },
    "scale_random": {
        "max_percentage": 1,
        "max_duration": 5,
        "min_percentage": 1,
        "min_duration": 3
    },
    "af_blur": {
        "blur_amount": 15,
        "duration": 1,
        "interval": 3
    },
    "white_noise": {
        "noise_min": -50,
        "noise_max": 50,
        "appear_possibility": 0.1
    },
    "line_noise": {
        "appear_possibility": 0.0005,
        "min_line_length": 0.3,
        "max_line_length": 1
    }
}