Christopher Konopka 5b46818e5f fixed image for readme
2025-07-21 02:46:37 -04:00
2025-07-21 02:46:37 -04:00
2025-07-21 02:39:31 -04:00
2025-07-21 02:39:31 -04:00
2025-07-21 02:46:05 -04:00
2025-07-21 02:46:05 -04:00
2025-07-21 02:39:31 -04:00
2025-07-21 02:39:31 -04:00

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_animation Apply a bad animation effect
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
recalled_sensor Apply filter like a sensor was broken and to-be recalled
repainting Apply filter like repainting the same image while smudged with alcohol
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
septic Apply filter like a person in septic shock
silence_extraction Extracting the silence out of a video file
slight_smear Slightly smearing RGB color space
smudge Smudging image slightly
soapblind Apply filter like soap blinded eyes
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
t1000 Apply filter from the perspective of liquid T-1000
transraibe AI-based transcription tool
twociz Apply filter from the perspective of a zombie on TC-1 hallucinogens
wbflare Apply filter with a blown out white-balance flare
zapruder Apply zapruder-film like effect
xrgb Extreme RGB adjustment

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

Inline Commands

Define the parameters of the command using inline parameters.

python videobeaux.py resize [INPUT_FILE] [OUTPUT_FILE] [WIDTH] [HEIGHT]
python videobeaux.py resize input_file.mp4 resized.mp4 1200 200

Help

Learn more about a program using the help command

Usage

python videobeaux.py resize --help 

Response

Usage: videobeaux.py resize [INPUT_FILE] [OUTPUT_FILE] [OPTIONS]

  Resize a video to the given width and height.

Options:
  --input_file  FILE    Input video file
  --output_file FILE    Output video file
  --width       INT     Format of the output video
  --height      INT     Show this message and exit.
  --help                Show this message and exit.

Video Exaxmples

bad_animation

https://github.com/user-attachments/assets/1fa8de04-98ef-49f7-9415-616e07210f0e

bad_contrast

https://github.com/vondas-network/videobeaux/assets/7625379/9ba59b08-79a8-4a09-8b18-c0fe90a6c5e2

bad_predator

https://github.com/vondas-network/videobeaux/assets/7625379/0968ad50-cc97-4336-938f-01b47d86a7bd

ball_point_pen

https://github.com/user-attachments/assets/10e703a5-5036-4c3e-83f6-be04476ad089

blur_pix

https://github.com/vondas-network/videobeaux/assets/7625379/65403294-3e34-4ff8-816a-5de7c80c811d

broken_scroll

https://github.com/vondas-network/videobeaux/assets/7625379/4cdebccc-8519-45c6-aded-089db73d20d2

digital_boss

https://github.com/user-attachments/assets/23958066-f384-4801-9d91-5b2df6081a31

double_cup

https://github.com/vondas-network/videobeaux/assets/7625379/83d30a18-40d1-42e4-aff3-dbd50d67a7d1

fever

https://github.com/vondas-network/videobeaux/assets/7625379/b476426f-0ca6-4667-be40-97df932b9909

frame_delay_pro1-1

https://github.com/vondas-network/videobeaux/assets/7625379/871ccdb9-ae2b-46e1-8b0f-0514eb92e1aa

frame_delay_pro1-2

https://github.com/vondas-network/videobeaux/assets/7625379/0a727474-25cf-42ab-a717-583e12b4a04d

frame_delay_pro1-3

https://github.com/vondas-network/videobeaux/assets/7625379/5ab60f24-b4e2-4e0e-abc0-cfab62e09cda

frame_delay_pro2-1

https://github.com/vondas-network/videobeaux/assets/7625379/a88284bc-ca7e-4355-8f95-377434c61d13

frame_delay_pro2-2

https://github.com/vondas-network/videobeaux/assets/7625379/acf571e7-7162-413f-80f8-769815093267

frame_delay_pro2-3

https://github.com/vondas-network/videobeaux/assets/7625379/f717d419-687b-4cc3-ac07-64f45c763531

ghostee

https://github.com/user-attachments/assets/87c8b569-5165-485d-ae09-7a8bbbe74051

lsd_feedback

https://github.com/vondas-network/videobeaux/assets/7625379/9653929c-30ad-4c72-81c8-e3777c590783

looper_pro

https://github.com/vondas-network/videobeaux/assets/7625379/01090d49-8626-4fc0-b55c-807d100a78fa

mirror_delay

https://github.com/vondas-network/videobeaux/assets/7625379/a3dea5c6-03a6-4f65-951d-211f50457b63

nostalgic

https://github.com/vondas-network/videobeaux/assets/7625379/3cef37d9-093f-4bd9-850c-4b163e8a3e01

overexposed_stutter

https://github.com/vondas-network/videobeaux/assets/7625379/f7250a1e-3cf5-4826-977a-a5a18b231ddb

overlay_img_pro

https://github.com/vondas-network/videobeaux/assets/7625379/3932d910-b898-4ed7-ba3a-288a708c0d83

pickle_juice

https://github.com/vondas-network/videobeaux/assets/7625379/387bfff5-fbdd-423d-b482-8ab4d5ce744f

recalled_sensor

OMITTED DUE TO SIZE

repainting

https://github.com/user-attachments/assets/1770144d-4448-4719-8ef3-e44b720ec857

reverse

https://github.com/vondas-network/videobeaux/assets/7625379/74367227-6fee-455f-af36-804a1e6d6cb6

scrolling_pro-1

https://github.com/vondas-network/videobeaux/assets/7625379/e84cfb49-f72d-449e-833a-0271903704f4

scrolling_pro-2

https://github.com/vondas-network/videobeaux/assets/7625379/19c6eef1-2bc0-4d84-b531-55f9ca07a912

scrolling_pro-3

https://github.com/vondas-network/videobeaux/assets/7625379/4a4272de-e074-4e37-8c2d-a282f2d8be57

septic

https://github.com/user-attachments/assets/25f65267-60fa-421a-aaf3-02918844a488

slight_smear

https://github.com/vondas-network/videobeaux/assets/7625379/a7bca4c5-46b5-4b51-a827-6b8137d0117d

smudge

https://github.com/user-attachments/assets/9bb80e0b-bf16-49e7-b4e1-6c0c79b59c32

soapblind

https://github.com/user-attachments/assets/28070fe5-52cd-42c9-93b7-a417c83add2d

speed

https://github.com/vondas-network/videobeaux/assets/7625379/c27efdb1-ae81-4d8d-a153-de6294b7fedf

splitting

https://github.com/user-attachments/assets/b6c13707-aaa8-416e-9f80-5ca6a386cd0f

stack_2x

https://github.com/vondas-network/videobeaux/assets/7625379/6f244aba-e741-46c9-9863-7fc43527a8d6

steel_wash

https://github.com/vondas-network/videobeaux/assets/7625379/eea99448-9352-48f1-a1ec-b2cac6ad056d

stutter_pro-1

https://github.com/vondas-network/videobeaux/assets/7625379/03e234fb-d0fe-4d72-a11c-dff1bc59fa83

stutter_pro-2

https://github.com/vondas-network/videobeaux/assets/7625379/e6d8c14a-9f20-4365-bb1f-5f473289a855

stutter_pro-3

https://github.com/vondas-network/videobeaux/assets/7625379/864835ba-dc9d-4392-aa77-2cc062e2b700

t1000

https://github.com/user-attachments/assets/5de6db36-f8d4-426e-9262-b9dbeb2095ae

twociz

OMITTED DUE TO SIZE

wbflare

https://github.com/user-attachments/assets/e2a5f065-163e-4bb9-8fd3-1edbfbdbab2a

zapruder

https://github.com/user-attachments/assets/cad79483-b21f-43b8-a1cd-91ed8406574a

xrgb

https://github.com/user-attachments/assets/c9644cd5-a584-4f0d-ada3-13046e6938a5

Description
Your friendly multilateral video toolkit built for artists by artists.
Readme 405 MiB
Languages
F* 99.5%
Python 0.4%