Your friendly multilateral video toolkit built for artists by artists. It's your best friend.

Available Programs

Program	Description
bad_contrast	Apply a bad constrast effect
blur_pix	Extracting the silence out of a video file
bad_predator	Apply bad Predator heat vision effect
convert	Simple video file convert
double_cup	Apply the effect of purple drank
download_yt	Video ripper
extract_frames	Extract individuals frames from a video file as PNGs
extract_sound	Extract audio from video file
frame_delay_pro1	Apply frame delay effect with parameter input
frame_delay_pro2	Apply frame delay effect with parameter input
looper_pro	Apply video looper effect base on frame size & start frame
lsd_feedback	Apply LSD-like frame delay effect
mirror_delay	Apply a frame delay plus a mirrored effect
nostalgic_stutter	Apply frame stutter akin to a corrupted file
overexposed_stutter	Apply a frame stutter and exposing the video like the file is corrupted
overlay_img_pro	Overlay an image with location & dimension control
pickle_juice	Apply filter like the video was dipped in pickle juice
resize	Resizing the dimensions of a video file
reverse	Reverse video file
scrolling_pro	Apply video scrolling effect with definable parameters
scrolling	Apply static video scrolling effect
silence_extraction	Extracting the silence out of a video file
slight_smear	Slightly smearing RGB color space
speed	Change the video and audio speed of a file
stack_2x	Stack 2 videos on top of each other keeping the original orientation
steel_wash	Apply steel blue filter to video
stutter_pro	Apply frame stutter effect with definable parameters
transraibe	AI-based transcription tool

Dependencies

FFmpeg is required for the project. Install ffmpeg using Homebrew

brew install ffmpeg

Requirements

Install the project requirements

pip install -r requirements.txt

Project setup

Create Python virtual environment

In a nutshell, Python virtual environments help decouple and isolate Python installs and associated pip packages. This allows end-users to install and manage their own set of packages that are independent of those provided by the system or used by other projects.

 cd videobeaux
 python -m venv env

Activate Virtual Environment

This will activate your virtual environment. Immediately, you will notice that your terminal path includes env, signifying an activated virtual environment.

source env/bin/activate

Examples

Using the config file

Use the config file to define the parameters of the function. It acts as a template for the program you'd like to run.

Define parameters in the config file

resize:
  input_file: "input_file.mp4"
  output_file: "output_resized_again.mp4"
  width: 1200
  height: 200

Run the program.

videobeaux.py resize-video

Inline Commands

Define the parameters of the command using inline parameters.

python videobeaux.py resize-video --input_video input_file.mp4 --output_video resized.mp4 --height 400 --width 300

Help

Learn more about a program using the help command

Usage

python videobeaux.py convert-video --help 

Response

Usage: videobeaux.py convert-video [OPTIONS]

  Convert a video to a different format.

Options:
  --input-file TEXT   Input video file
  --output-file TEXT  Output video file
  --format TEXT       Format of the output video
  --help              Show this message and exit.

Video Exaxmples

bad_contrast

bad_contrast.mp4

bad_predator

bad_predator.mp4

blur_pix

blur_pix.mp4

broken_scroll

broken_scroll.mp4

double_cup

double_cup.mp4

fever

fever.mp4

frame_delay_pro1-1

frame_delay_pro1-1.mp4

frame_delay_pro1-2

frame_delay_pro1-2.mp4

frame_delay_pro1-3

frame_delay_pro1-3.mp4

frame_delay_pro2-1

frame_delay_pro2-1.mp4

frame_delay_pro2-2

frame_delay_pro2-2.mp4

frame_delay_pro2-3

frame_delay_pro2-3.mp4

lsd_feedback

lsd_feedback.mp4

looper_pro

looper_pro.mp4

mirror_delay

mirror_delay.mp4

nostalgic

nostalgic.mp4

overexposed_stutter

overexposed_stutter.mp4

overlay_img_pro

overlay_img_pro.mp4

pickle_juice

pickle_juice.mp4

reverse

reverse.mp4

scrolling_pro-1

scrolling_pro-1.mp4

scrolling_pro-2

scrolling_pro-2.mp4

scrolling_pro-3

scrolling_pro-3.mp4

slight_smear

slight_smear.mp4

speed

speed.mp4

stack_2x

stack_2x.mp4

steel_wash

steel_wash.mp4

stutter_pro-1

stutter_pro-1.mp4

stutter_pro-2

stutter_pro-2.mp4

stutter_pro-3

stutter_pro-3.mp4