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

Available Programs

An overview of each program can be find in this YouTube playlist.

Program	Description
bad_contrast	Apply a bad constrast effect
ball_point_pen	Apply a ball point pen style effect
blur_pix	Extracting the silence out of a video file
bad_predator	Apply bad Predator heat vision effect
convert	Simple video file convert
digital_boss	Apply busted gameboy style digital boss effect
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
ghostee	Apply a slight ghost effect
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
zapruder	Apply zapruder-film like effect

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

ball_point_pen

ball_point_pen.mp4

blur_pix

blur_pix.mp4

broken_scroll

broken_scroll.mp4

digital_boss

digital_boss.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

ghostee

ghostee.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

zapruder

zapruder.mp4