video-filter

Video Filter

Enhance your video with color filters. This Python project helps you to apply a color filter to your Instagram reel or any other social platforms like TikTok, YouTube, Facebook, etc. All formats are supported (reels, shorts, 4k, etc.). The output video is in mp4 format.

Filter gallery selection

original	grayscale	warm

cool	red_only	invert_red_green

Installation

Run the following command in the terminal to install the package:

pip install video-filter

Usage examples

Example 1: Brightness and saturation

Brightness and saturation are both set to 0.0 by default, meaning the video will be unchanged.

x	Brightness -1.0	Brightness 0.0	Brightness +1.0
Saturation -1.0
Saturation 0.0
Saturation +1.0

from video_filter import VideoFilter

vf = VideoFilter(brightness=1.0, saturation=0.0)
vf.process_video("examples/video_1.mp4", "output.mp4")

Example 2: Color filters

Original	Sepia filter at 50% strength	Sepia filter at 100% strength

from video_filter import VideoFilter

vf = VideoFilter(filter_name="sepia", filter_strength=0.5)
vf.process_video("examples/video_2.mp4", "output.mp4")

Example 3: Custom filter

Original	Custom filter

from video_filter import VideoFilter
import numpy as np

# Matrix (3x3) vector (3x1) [b, g, r]) multiplication
filter_matrix = np.array([
    [0.7, 0.0, 0.1],  # Blue
    [0.2, 1.0, 0.3],  # Green
    [0.4, 0.2, 1.2]   # Red
])

vf = VideoFilter(
    custom_matrix=filter_matrix,
    filter_strength=0.6,
    brightness=0.8
)
vf.process_video("examples/video_1.mp4", "output.mp4")