Open Source Ecosystems

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.