https://github.com/vondas-network/videobeaux
Your friendly multilateral video toolkit built for artists by artists.
https://github.com/vondas-network/videobeaux
cli creative-coding ffmpeg python video-editing video-processing
Last synced: about 1 year ago
JSON representation
Your friendly multilateral video toolkit built for artists by artists.
- Host: GitHub
- URL: https://github.com/vondas-network/videobeaux
- Owner: vondas-network
- Created: 2024-06-19T02:49:54.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-19T22:24:58.000Z (almost 2 years ago)
- Last Synced: 2024-10-03T12:18:45.950Z (almost 2 years ago)
- Topics: cli, creative-coding, ffmpeg, python, video-editing, video-processing
- Language: Python
- Homepage:
- Size: 11.9 MB
- Stars: 6
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
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](https://www.youtube.com/watch?v=7i-WaDgBkcI&list=PLmyETqg8KgDcwV3-JnGoAiQyjR764sBI_).
| 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](https://formulae.brew.sh/formula/ffmpeg)
```bash
brew install ffmpeg
```
## Requirements
Install the project requirements
``` bash
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.
```bash
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.
``` bash
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
``` text
resize:
input_file: "input_file.mp4"
output_file: "output_resized_again.mp4"
width: 1200
height: 200
```
Run the program.
``` bash
videobeaux.py resize
```
### Inline Commands
Define the parameters of the command using inline parameters.
``` bash
python videobeaux.py resize [INPUT_FILE] [OUTPUT_FILE] [WIDTH] [HEIGHT]
```
``` bash
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
``` bash
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/user-attachments/assets/e9a7c93c-81cb-4dd5-bb86-0ad73a9d67b4
ball_point_pen
https://github.com/user-attachments/assets/77e9bbb1-b366-4e3e-bac9-6c3db6a3cccb
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/96d147e6-7d1f-4a45-93a9-bc3bd69c4a79
double_cup
https://github.com/vondas-network/videobeaux/assets/7625379/83d30a18-40d1-42e4-aff3-dbd50d67a7d1
fever
https://github.com/user-attachments/assets/3622d6d4-b44c-4e8d-9e70-3b12a6da40c5
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/a3a2d152-8f78-4e77-a3c3-bed9110bdac4
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/user-attachments/assets/721972e0-b3d9-4a8a-8f10-1c4686f3bd2f
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/user-attachments/assets/a3b8fd1a-0d12-448d-8dca-e61c93bc0153
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/user-attachments/assets/180f019f-5e00-4e0a-91aa-4582e4ebd39d
stutter_pro
https://github.com/user-attachments/assets/9652170f-39a2-4aa6-84ef-6b769f559dcc
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/9ff588ab-473d-4b79-a088-13d44a3b754f
xrgb
https://github.com/user-attachments/assets/c9644cd5-a584-4f0d-ada3-13046e6938a5