Every guide, example, effect, and utility is collected in this single static page. No Gemfile, Jekyll, Ruby, or build step is required.
videobeaux --help
... outputs the following ...
_ _ _
__ _(_) __| | ___ ___ | |__ ___ __ _ _ ___ __
\ \ / / |/ _` |/ _ \/ _ \| '_ \ / _ \/ _` | | | \ \/ /
\ V /| | (_| | __/ (_) | |_) | __/ (_| | |_| |> <
\_/ |_|\__,_|\___|\___/|_.__/ \___|\__,_|\__,_/_/\_\
📺 The friendly multilateral video toolkit built for artists by artists.
🫂 It's your best friend!
🌐 https://schwwaaa.net
usage: videobeaux --program PROGRAM --input INPUT_FILE --output OUTPUT_FILE [program options]
options:
-P, --program PROGRAM
Name of the effect program to run (e.g. convert, glitch)
-i, --input INPUT Input video file - mp4 only
-o, --output OUTPUT Output file name, no extension. Output will be saved as mp4.
-F, --force Force overwrite output file
-h, --help Show help message and exit
Available Program Modes:
bad_animation download_yt lsd_feedback_pro repainting subs_convert
bad_contrast extract_frames lut_apply resize t1000
bad_predator extract_sound meta_extraction reverse thumbs
ball_point_pen fever mince scrolling_pro tonemap_hdr_sdr
blur_pix frame_delay_pro1 mirror_delay septic transcraibe
broken_scroll frame_delay_pro2 nostalgic_stutter silence_xtraction triptych
captburn frame_interpolate num_edits slight_smear twociz
chain_builder gamma_fix overexposed_stutter smudge twociz_pro
chain_builder_pro ghostee overlay_img_pro soapblind watermark
convert hash_fingerprint pickle_juice speed wbflare
convert_dims lagkage qwikchop splitting wbflare_pro
convert_mux lagkage-old rb_blur splitting_pro wipe_transitions
crossmosh light_snow rb_blur_pro stack_2x xpiritualism
digital_boss looper_pro recalled_sensor steel_wash xrgb
double_cup lsd_feedback recalled_sensor_pro stutter_pro zapruder
In the shell prompt, go to the place where you want the project to live. Paste that in a macOS Terminal or Linux shell prompt & run it.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/schwwaaa/videobeaux/refs/heads/main/install.sh)"
choco install ffmpeg
setx VIDEOBEAUX_PATH "C:\videobeaux"
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
### Check the installation
### Get help and find out more about videobeaux
``` bash
videobeaux --help
... outputs the following ...
_ _ _
__ _(_) __| | ___ ___ | |__ ___ __ _ _ ___ __
\ \ / / |/ _` |/ _ \/ _ \| '_ \ / _ \/ _` | | | \ \/ /
\ V /| | (_| | __/ (_) | |_) | __/ (_| | |_| |> <
\_/ |_|\__,_|\___|\___/|_.__/ \___|\__,_|\__,_/_/\_\
📺 The friendly multilateral video toolkit built for artists by artists.
🫂 It's your best friend!
🌐 https://schwwaaa.net
usage: videobeaux --program PROGRAM --input INPUT_FILE --output OUTPUT_FILE [program options]
options:
-P, --program PROGRAM
Name of the effect program to run (e.g. convert, glitch)
-i, --input INPUT Input video file - mp4 only
-o, --output OUTPUT Output file name, no extension. Output will be saved as mp4.
-F, --force Force overwrite output file
-h, --help Show help message and exit
Available Program Modes:
bad_animation download_yt lsd_feedback_pro repainting subs_convert
bad_contrast extract_frames lut_apply resize t1000
bad_predator extract_sound meta_extraction reverse thumbs
ball_point_pen fever mince scrolling_pro tonemap_hdr_sdr
blur_pix frame_delay_pro1 mirror_delay septic transcraibe
broken_scroll frame_delay_pro2 nostalgic_stutter silence_xtraction triptych
captburn frame_interpolate num_edits slight_smear twociz
chain_builder gamma_fix overexposed_stutter smudge twociz_pro
chain_builder_pro ghostee overlay_img_pro soapblind watermark
convert hash_fingerprint pickle_juice speed wbflare
convert_dims lagkage qwikchop splitting wbflare_pro
convert_mux lagkage-old rb_blur splitting_pro wipe_transitions
crossmosh light_snow rb_blur_pro stack_2x xpiritualism
digital_boss looper_pro recalled_sensor steel_wash xrgb
double_cup lsd_feedback recalled_sensor_pro stutter_pro zapruder
_ _ _
__ _(_) __| | ___ ___ | |__ ___ __ _ _ ___ __
\ \ / / |/ _` |/ _ \/ _ \| '_ \ / _ \/ _` | | | \ \/ /
\ V /| | (_| | __/ (_) | |_) | __/ (_| | |_| |> <
\_/ |_|\__,_|\___|\___/|_.__/ \___|\__,_|\__,_/_/\_\
Your friendly multilateral video toolkit built for artists by artists.
https://schwwaaa.net
--------------------------------------------------
Selected program mode: bad_predator
✅ This program mode does not require additional arguments
usage: python3 -m videobeaux.cli --program PROGRAM [global options] [program options]
📺 Your friendly multilateral video toolkit built for artists by artists.
It's your best friend!
https://schwwaaa.net
options:
-P PROGRAM, --program PROGRAM
Name of the effect program to run (e.g. convert, glitch)
-i INPUT, --input INPUT
Input video file - mp4 only
-o OUTPUT, --output OUTPUT
Output file name, no extension. Output will be saved as mp4.
-F, --force Force overwrite output file
-h, --help Show help message and exit
👁️ 👇 Additional help for program mode 👇 👁️
usage: videobeaux --program bad_predator [-h]
Apply bad Predator heat vision effect
options:
-h, --help show this help message and exit
videobeaux --program PROGRAM --input INPUT_FILE --output OUTPUT_FILE
... translates to ...
videobeaux --program bad_predator --input example.mp4 --output example_bp.mp4
_ _ _
__ _(_) __| | ___ ___ | |__ ___ __ _ _ ___ __
\ \ / / |/ _` |/ _ \/ _ \| '_ \ / _ \/ _` | | | \ \/ /
\ V /| | (_| | __/ (_) | |_) | __/ (_| | |_| |> <
\_/ |_|\__,_|\___|\___/|_.__/ \___|\__,_|\__,_/_/\_\
Your friendly multilateral video toolkit built for artists by artists.
https://schwwaaa.net
--------------------------------------------------
Selected program mode: bad_predator
✅ This program mode does not require additional arguments
Input duration: 10.01 seconds
🔨 Processing example.mp4: 100%|██████████████████████████████████████████████████████ | 10.01/10.01s [00:04<00:00]
📺 Process Complete: example_bp.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/user-attachments/assets/fe45aa80-9878-4d15-bc64-87dd25071855" type="video/mp4"> Your browser does not support the video tag. </video>
_ _ _
__ _(_) __| | ___ ___ | |__ ___ __ _ _ ___ __
\ \ / / |/ _` |/ _ \/ _ \| '_ \ / _ \/ _` | | | \ \/ /
\ V /| | (_| | __/ (_) | |_) | __/ (_| | |_| |> <
\_/ |_|\__,_|\___|\___/|_.__/ \___|\__,_|\__,_/_/\_\
Your friendly multilateral video toolkit built for artists by artists.
https://schwwaaa.net
--------------------------------------------------
Selected program mode: stutter_pro
usage: python3 -m videobeaux.cli --program PROGRAM [global options] [program options]
📺 Your friendly multilateral video toolkit built for artists by artists.
It's your best friend!
https://schwwaaa.net
options:
-P PROGRAM, --program PROGRAM
Name of the effect program to run (e.g. convert, glitch)
-i INPUT, --input INPUT
Input video file - mp4 only
-o OUTPUT, --output OUTPUT
Output file name, no extension. Output will be saved as mp4.
-F, --force Force overwrite output file
-h, --help Show help message and exit
👁️ 👇 Additional help for program mode 👇 👁️
usage: videobeaux --program stutter_pro [-h] --stutter STUTTER
Imagine watching a video where random frames are played instead of a smooth progression.
options:
-h, --help show this help message and exit
--stutter STUTTER Replaces the current video frame with a randomly selected one from the most recent N frames.The larger the value, the larger the variation.
videobeaux --program PROGRAM --input INPUT_FILE --output OUTPUT_FILE --args ARGUMENTS
... translates to ...
videobeaux --program stutter_pro -i example.mp4 -o stutter_example.mp4 --stutter 2
_ _ _
__ _(_) __| | ___ ___ | |__ ___ __ _ _ ___ __
\ \ / / |/ _` |/ _ \/ _ \| '_ \ / _ \/ _` | | | \ \/ /
\ V /| | (_| | __/ (_) | |_) | __/ (_| | |_| |> <
\_/ |_|\__,_|\___|\___/|_.__/ \___|\__,_|\__,_/_/\_\
Your friendly multilateral video toolkit built for artists by artists.
https://schwwaaa.net
--------------------------------------------------
Selected program mode: stutter_pro
Input duration: 10.01 seconds
🔨 Processing example.mp4: 100%|██████████████████████████████████████████████████████████ | 10.01/10.01s [00:00<00:00]
📺 Process Complete: stutter_example.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/user-attachments/assets/fec22179-8e40-49e5-b591-c9d5fb07e31b" type="video/mp4"> Your browser does not support the video tag. </video>
_ _ _
__ _(_) __| | ___ ___ | |__ ___ __ _ _ ___ __
\ \ / / |/ _` |/ _ \/ _ \| '_ \ / _ \/ _` | | | \ \/ /
\ V /| | (_| | __/ (_) | |_) | __/ (_| | |_| |> <
\_/ |_|\__,_|\___|\___/|_.__/ \___|\__,_|\__,_/_/\_\
Your friendly multilateral video toolkit built for artists by artists.
https://schwwaaa.net
--------------------------------------------------
Selected program mode: chain_builder
usage: python3 -m videobeaux.cli --program PROGRAM [global options] [program options]
📺 Your friendly multilateral video toolkit built for artists by artists.
It's your best friend!
https://schwwaaa.net
options:
-P PROGRAM, --program PROGRAM
Name of the effect program to run (e.g. convert, glitch)
-i INPUT, --input INPUT
Input video file - mp4 only
-o OUTPUT, --output OUTPUT
Output file name, no extension. Output will be saved as mp4.
-F, --force Force overwrite output file
-h, --help Show help message and exit
👁️ 👇 Additional help for program mode 👇 👁️
usage: videobeaux --program chain_builder [-h] --chain CHAIN
The output of the first will be used as the input for the next, and so on.
Only supports program modes that do not require their own specific arguments.
options:
-h, --help show this help message and exit
--chain CHAIN A comma separated list of programs to run.
videobeaux --program PROGRAM --input INPUT_FILE --output OUTPUT_FILE --chain CHAIN
... translates to ...
videobeaux --program chain_builder --input example.mp4 --output chainedoutput.mp4 --chain rb_blur,soapblind,lsd_feedback --force
_ _ _
__ _(_) __| | ___ ___ | |__ ___ __ _ _ ___ __
\ \ / / |/ _` |/ _ \/ _ \| '_ \ / _ \/ _` | | | \ \/ /
\ V /| | (_| | __/ (_) | |_) | __/ (_| | |_| |> <
\_/ |_|\__,_|\___|\___/|_.__/ \___|\__,_|\__,_/_/\_\
Your friendly multilateral video toolkit built for artists by artists.
https://schwwaaa.net
--------------------------------------------------
Selected program mode: chain_builder
🔁 Running step 1/3: rb_blur
Input duration: 10.01 seconds
🔨 Processing example.mp4: 100%|██████████████████████████████████████████████████████ | 10.01/10.01s [00:00<00:00]
📺 Process Complete: /var/folders/jv/lp20pdtn4jsgjpxw710m0vkm0000gn/T/videobeaux_chain_z7ixo5cs/step_0_rb_blur.mp4
🔁 Running step 2/3: soapblind
Input duration: 10.03 seconds
🔨 Processing step_0_rb_blur.mp4: 100%|███████████████████████████████████████████████ | 10.03/10.03s [00:46<00:00]
📺 Process Complete: /var/folders/jv/lp20pdtn4jsgjpxw710m0vkm0000gn/T/videobeaux_chain_z7ixo5cs/step_1_soapblind.mp4
🔁 Running step 3/3: lsd_feedback
Input duration: 10.03 seconds
🔨 Processing step_1_soapblind.mp4: 100%|█████████████████████████████████████████████ | 10.03/10.03s [00:03<00:00]
📺 Process Complete: /var/folders/jv/lp20pdtn4jsgjpxw710m0vkm0000gn/T/videobeaux_chain_z7ixo5cs/step_2_lsd_feedback.mp4
✅ Final output written to chainedoutput.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/user-attachments/assets/ac321c77-4757-4846-b838-6847472e7e09" type="video/mp4"> Your browser does not support the video tag. </video>
videobeaux --program PROGRAM --input INPUT_FILE --output OUTPUT_FILE
videobeaux \
--program bad_predator \
--input example.mp4 \
--output example_bp.mp4
<video controls width="50%"> <source src="https://github.com/user-attachments/assets/fe45aa80-9878-4d15-bc64-87dd25071855" type="video/mp4"> </video>
videobeaux --program PROGRAM --input INPUT_FILE --output OUTPUT_FILE --args ARGUMENTS
videobeaux \
--program stutter_pro \
-i example.mp4 \
-o stutter_example.mp4 \
--stutter 2
<video controls width="50%"> <source src="https://github.com/user-attachments/assets/fec22179-8e40-49e5-b591-c9d5fb07e31b" type="video/mp4"> </video>
videobeaux --program PROGRAM --input INPUT_FILE --output OUTPUT_FILE --chain CHAIN
videobeaux \
--program chain_builder \
--input example.mp4 \
--output chainedoutput.mp4 \
--chain rb_blur,soapblind,lsd_feedback \
--force
<video controls width="50%"> <source src="https://github.com/user-attachments/assets/ac321c77-4757-4846-b838-6847472e7e09" type="video/mp4"> </video>
| Program | Description | Arguments | | -------- | ------- | ------- | | 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 | - | | crossmosh | A controlled datamoshing engine that manipulates motion vectors and frame order to create stylized glitch-drift distortions | b_input, outfile, codec, qscale, gop, keep_temp, mode, frames, decay, blend | | digital_boss | Apply busted gameboy style digital boss effect | - | | double_cup | Apply the effect of purple drank | - | | frame_delay_pro1 | Apply frame delay effect with parameter input | frame_quantity, frame_weights | | frame_delay_pro2 | Apply frame delay effect with parameter input | decay, plane | | ghostee | Apply a slight ghost effect | - | | lagkage | A JSON-driven multilayer video compositor that stacks, positions, resizes, and mixes multiple media sources into one unified output | layout_json, sequence_direction, audio_mode, audio_src | | looper_pro | Apply video looper effect base on frame size & start frame | - | | lsd_feedback | Apply LSD-like frame delay effect | - | | mince | A fast, lossless segment-extractor and concatenator that slices videos into parts and recombines them with precision | mode, seed, engine, normalize, size, fit, fps, pixfmt, ar, ac, norm_vcodec, norm_crf, norm_preset, vcodec, acodec, crf, preset, faststart, fallback_reencode, decode_tolerant, hard_trim | | 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 | overlay_img, x_pos, y_pos, img_height, img_width | | 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 | new_height, new_width | | reverse | Reverse video file | - | | scrolling_pro | Apply video scrolling effect with definable parameters | horiz_speed, vert_speed | | scrolling | Apply static video scrolling effect | - | | septic | Apply filter like a person in septic shock | - | | 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 | speed_factor | | splitting | A simple segmentation utility that divides a video into evenly timed chunks or scene-based fragments for modular editing | - | | splitting_pro | Precise segmentation tool that slices a source video into reusable chunks based on time, count, or scene-style rules for downstream editing and recombination. | width, position | | stack_2x | Stack 2 videos on top of each other keeping the original- | orientation | input2 | | steel_wash | Apply steel blue filter to video | - | | stutter_pro | Apply frame stutter effect with definable parameters | stutter | | t1000 | Apply filter from the perspective of liquid T-1000 | - | | 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 | - |
| Program | Description | Arguments |
|---|---|---|
| captburn | Burns subtitles, captions, or transcript text directly into the video with precise styling, timing, and layout control | caption, style, rollup_lines, words_per_line, font, font_size, bold, italic, primary, outline, outline_width, shadow, back, back_opacity, scale_x, scale_y, spacing, rotate, margin_l, margin_r, margin_v, align, border_style, x, y, move, vcodec, crf, preset |
| chain_builder | Assembles a sequence of videobeaux program steps into a single automated workflow, chaining multiple transformations into one output | chain |
| convert | Simple video file convert | - |
| convert_dims | Video file dimensions converter based on industry standards | - |
| convert_mux | Rewraps or converts media streams while copying or re-encoding video/audio, ideal for fixing containers, codecs, or sync issues. | format, profile, vcodec, acodec, crf, bitrate, maxrate, bufsize, preset, profile_v, level, pix_fmt, gop, r, vf, tagv, abitrate, ac, ar, copy |
| download_yt | Video ripper | - |
| extract_frames | Extract individuals frames from a video file as PNGs | - |
| extract_sound | Extract audio from video file | - |
| frame_interpolate | Generates smooth slow-motion or higher-FPS video by creating intermediate frames using motion-compensated interpolation | outfile, engine, fps, multiplier, mi_mode, me_mode, mc_mode, vsbmc, scd, x264_preset, crf, copy_audio, rife_bin, dain_bin |
| gamma_fix | Normalizes gamma, brightness, and exposure levels for broadcast-safe or web-safe consistency across diverse footage | target_yavg, min_contrast, max_contrast, gamma, sat, legalize, vcodec, crf, preset, acodec, ab |
| hash_fingerprint | Creates unique perceptual or checksum-style fingerprints of a video for identification, comparison, or deduplication | recursive, exts, file_hashes, stream_hash, framemd5, phash, phash_fps, phash_size, catalog, stream_kind |
| lut_apply | Applies a 3D or 1D LUT file to recolor a video, enabling film-style grading, color transforms, or creative look development | outfile, vcodec, lut, interp, intensity, brightness, contrast, saturation, gamma, pix_fmt, x264_preset, crf, copy_audio |
| meta_extraction | Extracts detailed metadata—including codecs, bitrates, dimensions, color info, and stream structure—from any media file | outputfile, sample_frames, sample_stride, sample_limit, blackdetect, black_pic_th, black_dur_min, loudness |
| num_edits | Analyzes a timeline or cut structure to count edits, transitions, or shot boundaries for editorial statistics or QC | count |
| qwikchop | Rapidly slices videos into precise segments based on timecodes or cut lists, optimized for speed and batch operations | pieces, recurse, keep_temp, trim_black_front, black_scan, black_thresh, black_pict, edge_pad_pre, edge_pad_post, min_edit |
| silence_extraction | Extracting the silence out of a video file | min_d, max_d, adjuster |
| subs_convert | Converts subtitle files between formats (e.g., SRT, VTT, ASS), preserving timing, text, and style metadata | list, indexes, langs, all, forced_only, exclude_hi, format, outdir, outputfile, time_shift |
| thumbs | Generates thumbnails or contact sheets by sampling frames at chosen intervals for previews, galleries, or QC review | fps, scene, scene_threshold, tile, scale, timestamps, label, fontfile, bg, margin, padding, outdir, outputfile, image_format, jpeg_quality |
| tonemap_hdr_sdr | Converts HDR footage (PQ/HLG) to SDR using tunable tonemapping curves, preserving highlight detail and color accuracy | outfile, algo, desat, peak, dither, pix_fmt, x264_preset, crf, copy_audio |
| transraibe | AI-based transcription tool | stt_model |
| watermark | Applies image or text watermarks onto video with configurable positioning, scaling, opacity, and blend style | watermark, placement, margin, scale, opacity, spin, start, end, wm_loop, ignore_loop, video_crf, video_preset |
| wipe_transitions | Creates directional wipe transitions between clips using customizable timing, edge softness, and motion orientation | input1, input2, output_format, preset, duration, offset |
Applies a “bad animation” effect to the input video — producing jittery, uneven, low-frame-feeling, or intentionally crude animated motion.
This effect simulates broken or poorly interpolated animation, often seen in retro cartoons, limited-animation TV shows, or stylized glitch art.
bad_animation is designed for artists who want to:
videobeaux -P bad_animation \
-i input.mp4 \
-o output.mp4videobeaux -P bad_animation \
-i myvideo.mp4 \
-o bad_animation_styled.mp4<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/user-attachments/assets/1fa8de04-98ef-49f7-9415-616e07210f0e" type="video/mp4"> Your browser does not support the video tag. </video>
frame_interpolate (ironically) to contrast smooth vs broken motion.gamma_fix, lut_apply, or convert_dims for multi-stage stylization chains.chain_builder to apply bad_animation early in a larger creative pipeline.Applies a “bad contrast” visual effect to the video, intentionally degrading tonal balance, highlight rolloff, shadow separation, and midtone neutrality.
The result simulates low-quality analog transfers, misconfigured broadcast equipment, degraded VHS dubs, or broken grading pipelines.
bad_contrast exists as a lightweight, stylized degradation tool for artists who want to:
videobeaux -P bad_contrast \
-i input.mp4 \
-o output.mp4videobeaux -P bad_contrast \
-i myvideo.mp4 \
-o bad_contrast_styled.mp4<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/9ba59b08-79a8-4a09-8b18-c0fe90a6c5e2" type="video/mp4"> Your browser does not support the video tag. </video>
bad_contrast early in a pipeline will influence all later operations.bad_animation, hash_fingerprint).lut_apply to push contrast into more extreme color spaces.bad_contrast + convert_dims (480p or 720hd presets).Applies a stylized “bad Predator heat vision” effect to the input video.
This intentionally degraded thermal-vision look mimics the broken or low-budget interpretation of the thermal-view used in the Predator films — surreal color distortion, thermal-like banding, exaggerated edge detection, and unstable gradients.
bad_predator is designed for creators who want to:
videobeaux -P bad_predator \
-i input.mp4 \
-o output.mp4videobeaux -P bad_predator \
-i myvideo.mp4 \
-o bad_predator_styled.mp4<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/0968ad50-cc97-4336-938f-01b47d86a7bd" type="video/mp4"> Your browser does not support the video tag. </video>
chain_builder to combine with other stylized processes for multi-layer sci-fi or horror visuals.bad_contrast, hash_fingerprint, or bad_animation for a fully degraded sensory aesthetic.gamma_fix to stabilize midtone visibility before applying the effect.Applies a ball-point-pen illustration effect to the input video, simulating hand-drawn line textures, monochrome ink shading, and stylized pen-stroke contrast.
The result evokes sketchbook drawings, technical notebook diagrams, or lo-fi comic-style renderings.
ball_point_pen is intended for artists who want to:
videobeaux -P ball_point_pen \
-i input.mp4 \
-o output.mp4videobeaux -P ball_point_pen \
-i myvideo.mp4 \
-o ball_point_pen_styled.mp4<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/user-attachments/assets/10e703a5-5036-4c3e-83f6-be04476ad089" type="video/mp4"> Your browser does not support the video tag. </video>
convert_dims (square formats like 1080×1080) for Instagram-style sketch loops.gamma_fix or lut_apply before applying the pen effect for clearer edges.Applies a pixelated blur effect to the input video, producing a blocky, low-resolution softening reminiscent of censored footage, retro 8-bit graphics, or lo-fi compression artifacts.
This effect blends coarse pixelation with smooth blur, creating a stylized, abstracted visual aesthetic.
blur_pix is designed for artists who want to:
Because the module has no program-specific arguments, it is simple to use and highly compatible with all Videobeaux pipelines.
videobeaux -P blur_pix \
-i input.mp4 \
-o output.mp4videobeaux -P blur_pix \
-i myvideo.mp4 \
-o blur_pix_styled.mp4<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/65403294-3e34-4ff8-816a-5de7c80c811d" type="video/mp4"> Your browser does not support the video tag. </video>
hash_fingerprint or bad_contrast to stack analog/digital degradation.convert_dims (square or portrait presets) for platform-optimized stylized loops.gamma_fix can improve highlight/midtone visibility inside blocky regions.A controlled datamoshing engine that manipulates motion vectors, frame ordering, and predictive compression structures to create stylized glitch-drift distortions.
Unlike chaotic or accidental datamoshing, crossmosh provides intentional control over how macroblocks bleed, drift, smear, or desynchronize across frames.
crossmosh is designed for artists who want to:
It is ideal for music videos, experimental film, VJ loops, and any stylized glitch aesthetic.
-i--b_input--mode defines the style of the mosh:--decay controls how long corrupted vectors persist.--blend controls how heavily A and B frames influence each other.videobeaux -P crossmosh \
-i input.mp4 \
-o output.mp4 \
--b_input VALUE \
--outfile VALUE \
--codec VALUE \
--qscale VALUE \
--gop VALUE \
--keep_temp VALUE \
--mode VALUE \
--frames VALUE \
--decay VALUE \
--blend VALUEvideobeaux -P crossmosh \
-i myvideo.mp4 \
-o crossmosh_styled.mp4 \
--b_input EXAMPLE \
--outfile EXAMPLE \
--codec EXAMPLE \
--qscale EXAMPLE \
--gop EXAMPLE \
--keep_temp EXAMPLE \
--mode EXAMPLE \
--frames EXAMPLE \
--decay EXAMPLE \
--blend EXAMPLEProgram output video not yet linked.
--b_input), mismatched resolutions may create unpredictable smear patterns.qscale strongly influences macroblock deformation and drift persistence.--keep_temp to preserve them for debugging.qscale (e.g., 2–5) for smoother block smearing; higher (10–20) for chaotic chunking.blend modestly when incorporating a B-source; too high can obliterate A-source contours.frames and decay interactively while testing small clips.gamma_fix or lut_apply before moshing.Applies a “busted Game Boy–style digital boss” effect to the video — producing harsh bitmap artifacts, limited 8-bit tonal mapping, flicker, false edges, and unstable block transitions reminiscent of corrupted handheld-console graphics.
The effect aims to evoke a glitched, retro, boss-fight visual language.
digital_boss is intended for creators who want to:
videobeaux -P digital_boss \
-i input.mp4 \
-o output.mp4videobeaux -P digital_boss \
-i myvideo.mp4 \
-o digital_boss_styled.mp4<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/user-attachments/assets/23958066-f384-4801-9d91-5b2df6081a31" type="video/mp4"> Your browser does not support the video tag. </video>
bad_predator, blur_pix, or hash_fingerprint for extreme digital corruption.convert_dims to produce Game-Boy-like square aspect ratios.gamma_fix for more even tonal distribution before palette reduction.bad_animation for extra jitter or cadence disruption.:contentReference[oaicite:1]{index=1}
Applies a syrupy, slowed, woozy audiovisual effect reminiscent of “purple drank” aesthetics.
The look emphasizes heavy color bleeding, slowed-feeling motion, chromatic haze, and a dreamlike viscosity often associated with chopped-and-screwed culture or psychedelic video distortion.
double_cup is ideal for creators who want to:
videobeaux -P double_cup \
-i input.mp4 \
-o output.mp4videobeaux -P double_cup \
-i myvideo.mp4 \
-o double_cup_styled.mp4<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/83d30a18-40d1-42e4-aff3-dbd50d67a7d1" type="video/mp4"> Your browser does not support the video tag. </video>
gamma_fix.blur_pix or bad_contrast for more degraded, syrup-soaked textures.lut_apply with a magenta-heavy LUT before this effect.gamma_fix for lifted midtones before applying double_cup.Applies an advanced frame-delay effect using a customizable number of delayed frames and weighted blending.
This produces echoing motion trails, temporal smearing, ghosted motion artifacts, and stylized feedback-like delay effects.
frame_delay_pro1 is designed for creators who want:
frame_quantity.frame_weights determines how strongly each delayed frame contributes to the output.videobeaux -P frame_delay_pro1 \
-i input.mp4 \
-o output.mp4 \
--frame_quantity VALUE \
--frame_weights VALUE1,0.8,0.5,0.2).frame_quantity, and values determine the intensity of each delay layer.videobeaux -P frame_delay_pro1 \
-i myvideo.mp4 \
-o frame_delay_pro1_styled.mp4 \
--frame_quantity EXAMPLE \
--frame_weights EXAMPLE<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/871ccdb9-ae2b-46e1-8b0f-0514eb92e1aa" type="video/mp4"> Your browser does not support the video tag. </video>
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/0a727474-25cf-42ab-a717-583e12b4a04d" type="video/mp4"> Your browser does not support the video tag. </video>
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/5ab60f24-b4e2-4e0e-abc0-cfab62e09cda" type="video/mp4"> Your browser does not support the video tag. </video>
frame_quantity may increase render time depending on resolution and codec.1,0.8,0.6,0.4) for smooth decays.1,0,1,0.2) for glitchy motion inconsistencies.double_cup or bad_animation for hallucination-like layered visuals.Applies an advanced analytical frame-delay effect that shifts image planes (luma/chroma) independently while applying temporal decay.
This creates ghost trails, chromatic drifts, smeared movement, and layered motion persistence that evolves across time.
frame_delay_pro2 is for creators seeking:
--plane)--decay)videobeaux -P frame_delay_pro2 \
-i input.mp4 \
-o output.mp4 \
--decay VALUE \
--plane VALUEluma, chroma, or combined modes depending on implementation).videobeaux -P frame_delay_pro2 \
-i myvideo.mp4 \
-o frame_delay_pro2_styled.mp4 \
--decay EXAMPLE \
--plane EXAMPLE<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/a88284bc-ca7e-4355-8f95-377434c61d13" type="video/mp4"> Your browser does not support the video tag. </video>
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/acf571e7-7162-413f-80f8-769815093267" type="video/mp4"> Your browser does not support the video tag. </video>
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/f717d419-687b-4cc3-ac07-64f45c763531" type="video/mp4"> Your browser does not support the video tag. </video>
plane=chroma with moderate decay.plane=luma with high decay.frame_delay_pro1 for multi-layer delay stacks.Applies a soft, subtle ghosting effect to the video by blending frames over time.
This creates a trailing, dreamy afterimage that lightly smears motion and adds a supernatural or ethereal visual mood.
ghostee is designed for artists who want:
videobeaux -P ghostee \
-i input.mp4 \
-o output.mp4videobeaux -P ghostee \
-i myvideo.mp4 \
-o ghostee_styled.mp4<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/user-attachments/assets/87c8b569-5165-485d-ae09-7a8bbbe74051" type="video/mp4"> Your browser does not support the video tag. </video>
frame_delay_pro1 or frame_delay_pro2, which provide more extreme temporal manipulation.double_cup for syrupy dream visuals.blur_pix to soften structure while keeping ghost trails intact.ghostee multiple times or chain with frame_delay_pro1.A JSON-driven multilayer video compositor that stacks, positions, resizes, mixes, sequences, and animates multiple media layers into a single rendered output.
lagkage is the most powerful structural tool in Videobeaux, allowing complex collage-based edits without touching an editor timeline.
lagkage is designed for creators who want to:
--layout_json)--sequence_direction)forwardreverse--audio_mode)base → input -i base video's audioall → mix audio from all layersfirst → only the first layernone → mute output--audio_src)lagkage:videobeaux -P lagkage \
-i input.mp4 \
-o output.mp4 \
--layout_json VALUE \
--sequence_direction VALUE \
--audio_mode VALUE \
--audio_src VALUE
forward, reverse).base, all, first, none, etc.).videobeaux -P lagkage \
-i myvideo.mp4 \
-o lagkage_styled.mp4 \
--layout_json EXAMPLE \
--sequence_direction EXAMPLE \
--audio_mode EXAMPLE \
--audio_src EXAMPLE
Program output video not yet linked.
audio_mode and per-layer mute flags.convert_dims or convert.lut_apply to individual layers before compositing in lagkage.lagkage with moshers (crossmosh, bad_predator, etc.) at layer level.Creates a professional looping effect by selecting a region of frames and replaying them in a seamless or stylized loop.
looper_pro allows the user to choose which part of a video becomes a loop, enabling rhythmic repetition, GIF-like behavior, or precisely timed visual cycles.
looper_pro is intended for creators who want to:
videobeaux -P looper_pro \
-i input.mp4 \
-o output.mp4
videobeaux -P looper_pro \
-i myvideo.mp4 \
-o looper_pro_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/01090d49-8626-4fc0-b55c-807d100a78fa" type="video/mp4"> Your browser does not support the video tag. </video>
convert_dims for perfectly square or vertical loop assets.gamma_fix beforehand to stabilize tonal values across loop boundaries.double_cup or ghostee for dreamy, flowing loop aesthetics.looper_pro before crossmosh or bad_animation to break the loop structure artistically.Applies a psychedelic recursive feedback effect inspired by analog video feedback loops and LSD-style visual hallucination.
The effect blends delayed frames into the live frame stream, producing spiraling trails, melting motion, neon echoes, and evolving kaleidoscopic distortions.
lsd_feedback is designed for creators who want to:
videobeaux -P lsd_feedback -i input.mp4 -o output.mp4
videobeaux -P lsd_feedback \
-i myvideo.mp4 \
-o lsd_feedback_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/9653929c-30ad-4c72-81c8-e3777c590783" type="video/mp4"> Your browser does not support the video tag. </video>
bad_contrast afterward.frame_delay_pro1 or frame_delay_pro2 to produce layered temporal echoes.convert_dims to square formats (e.g., 1080×1080) for symmetrical feedback structures.double_cup or ghostee for dreamlike, syrupy hallucination trails.A fast, precise segment extractor and reassembler that slices video into parts and recombines them with frame accuracy.
mince can cut, shuffle, normalize, re-encode, or stitch segments while preserving sync, enabling procedural editing, glitch slicing, and automated timeline reconstruction.
mince is designed for creators who want to:
--mode)--seed)--engine)--normalize + related options)norm_vcodecnorm_crfnorm_presetvideobeaux -P mince \
-i input.mp4 \
-o output.mp4 \
--mode VALUE \
--seed VALUE \
--engine VALUE \
--normalize VALUE \
--size VALUE \
--fit VALUE \
--fps VALUE \
--pixfmt VALUE \
--ar VALUE \
--ac VALUE \
--norm_vcodec VALUE \
--norm_crf VALUE \
--norm_preset VALUE \
--vcodec VALUE \
--acodec VALUE \
--crf VALUE \
--preset VALUE \
--faststart VALUE \
--fallback_reencode VALUE \
--decode_tolerant VALUE \
--hard_trim VALUE
videobeaux -P mince \
-i myvideo.mp4 \
-o mince_styled.mp4 \
--mode EXAMPLE \
--seed EXAMPLE \
--engine EXAMPLE \
--normalize EXAMPLE \
--size EXAMPLE \
--fit EXAMPLE \
--fps EXAMPLE \
--pixfmt EXAMPLE \
--ar EXAMPLE \
--ac EXAMPLE \
--norm_vcodec EXAMPLE \
--norm_crf EXAMPLE \
--norm_preset EXAMPLE \
--vcodec EXAMPLE \
--acodec EXAMPLE \
--crf EXAMPLE \
--preset EXAMPLE \
--faststart EXAMPLE \
--fallback_reencode EXAMPLE \
--decode_tolerant EXAMPLE \
--hard_trim EXAMPLE
Program output video not yet linked.
mince can create either chaotic glitch edits or clean, broadcast-ready trims depending on parameters.fallback_reencode prevents pipeline breaks when encountering incompatible segments.norm_vcodec + norm_crf to avoid codec mismatch in concat operations.hard_trim.decode_tolerant when working with damaged or odd-format inputs.Applies a mirrored frame-delay effect, blending temporal echoes with reflective symmetry.
The result combines soft motion trailing with a mirrored duplication of the frame, creating hypnotic, kaleidoscopic, or hall-of-mirrors–style distortion.
mirror_delay is ideal for artists who want:
videobeaux -P mirror_delay \
-i input.mp4 \
-o output.mp4
videobeaux -P mirror_delay \
-i myvideo.mp4 \
-o mirror_delay_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/a3dea5c6-03a6-4f65-951d-211f50457b63" type="video/mp4"> Your browser does not support the video tag. </video>
frame_delay_pro1 or lsd_feedback for layered temporal abstraction.convert_dims to square or portrait layouts for perfect symmetry.ghostee for soft spectral reflection trails.lut_apply) if you want the color grade to affect both halves identically.Applies a retro, analog-inspired frame-stutter effect reminiscent of corrupted home movies, aging videotape playback, or dropped-frame digital artifacts.
nostalgic_stutter intentionally disrupts cadence to evoke glitchy playback, uneven frame advancement, or mechanical jitter from vintage camcorders.
nostalgic_stutter is designed for creators who want to:
videobeaux -P nostalgic_stutter \
-i input.mp4 \
-o output.mp4
videobeaux -P nostalgic_stutter \
-i myvideo.mp4 \
-o nostalgic_stutter_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/3cef37d9-093f-4bd9-850c-4b163e8a3e01" type="video/mp4"> Your browser does not support the video tag. </video>
bad_contrast or double_cup for stylized aging or dreamy deterioration.bad_animation or frame_delay_pro1.convert_dims beforehand if building platform-specific loops (square, reels, stories).Applies a harsh overexposure flicker combined with stuttering frame cadence, producing an aggressive “corrupted camera” aesthetic.
The effect mimics the look of damaged digital sensors, broken shutter timing, blown-out highlights, and unstable frame playback.
overexposed_stutter is designed for creators who want to:
videobeaux -P overexposed_stutter -i input.mp4 -o output.mp4
videobeaux -P overexposed_stutter \
-i myvideo.mp4 \
-o overexposed_stutter_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/f7250a1e-3cf5-4826-977a-a5a18b231ddb" type="video/mp4"> Your browser does not support the video tag. </video>
bad_contrast to push black levels down while highlights blow out.frame_delay_pro1 for aggressive echo + stutter hybrids.convert_dims if targeting square or portrait loop formats.lsd_feedback or digital_boss.Overlays an external image onto the input video with explicit control over image position and dimensions.
overlay_img_pro allows precise placement, scaling, and compositing of static images (PNG, JPG, etc.) on top of a video layer.
overlay_img_pro is intended for creators who want to:
--overlay_img is loaded into the FFmpeg filtergraph.img_widthimg_heightx_pos (horizontal placement)y_pos (vertical placement)videobeaux -P overlay_img_pro \
-i input.mp4 \
-o output.mp4 \
--overlay_img VALUE \
--x_pos VALUE \
--y_pos VALUE \
--img_height VALUE \
--img_width VALUE
videobeaux -P overlay_img_pro \
-i myvideo.mp4 \
-o overlay_img_pro_styled.mp4 \
--overlay_img EXAMPLE \
--x_pos EXAMPLE \
--y_pos EXAMPLE \
--img_height EXAMPLE \
--img_width EXAMPLE
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/3932d910-b898-4ed7-ba3a-288a708c0d83" type="video/mp4"> Your browser does not support the video tag. </video>
x_pos / y_pos.convert_dims beforehand to ensure predictable placement on varying aspect ratios.lagkage instead for complex composite pipelines.Applies a stylized color-treatment effect that makes the video appear as if it were “dipped in pickle juice.”
This look often includes green-tinted washes, acidic highlights, sour midtone shifts, and a brined, stained aesthetic reminiscent of aged film submerged in an odd chemical bath.
pickle_juice is designed for creators who want:
videobeaux -P pickle_juice \
-i input.mp4 \
-o output.mp4
videobeaux -P pickle_juice \
-i myvideo.mp4 \
-o pickle_juice_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/387bfff5-fbdd-423d-b482-8ab4d5ce744f" type="video/mp4"> Your browser does not support the video tag. </video>
bad_contrast or nostalgic_stutter.gamma_fix before applying for more consistent pickle coloration across the image.blur_pix for a soft, brined haze effect.convert_dims if producing platform-specific versions (square, reels, etc.).Simulates the look of a malfunctioning digital camera sensor that is defective, failing, or subject to an official recall.
This effect introduces corrupted rows, unstable color channels, dead-pixel clusters, exposure tearing, and chaotic image instability — mimicking catastrophic sensor failure.
recalled_sensor is designed for creators who want:
videobeaux -P recalled_sensor -i input.mp4 -o output.mp4
videobeaux -P recalled_sensor \
-i myvideo.mp4 \
-o recalled_sensor_styled.mp4
Program output video omitted due to size; see repository for reference clips.
crossmosh or overexposed_stutter for extreme destruction.bad_contrast for harsher tonal collapse.lsd_feedback or frame_delay_pro2 to create evolving sensor meltdown effects.gamma_fix to avoid overwhelming bloom in the corrupted channels.Applies an artistic “repainted” effect that makes each frame appear as if it has been smeared, redrawn, or blurred by an alcohol-washed brush.
The result resembles wet ink, soft smudging, streaked pigment, or repeated overpainting — giving the footage a tactile, analog, hand-altered feel.
repainting is designed for creators who want:
videobeaux -P repainting -i input.mp4 -o output.mp4
videobeaux -P repainting \
-i myvideo.mp4 \
-o repainting_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/user-attachments/assets/1770144d-4448-4719-8ef3-e44b720ec857" type="video/mp4"> Your browser does not support the video tag. </video>
double_cup for a liquified wash; combine with blur_pix for soft surface blending.convert_dims can produce smoother brush-like textures.Resizes the dimensions of a video to a specified width and height.
This module performs a direct scale transformation, producing clean, predictable results for platform formatting, layout prep, or visual uniformity.
resize is designed for creators who want to:
new_widthnew_heightvideobeaux -P resize -i input.mp4 -o output.mp4 --new_height VALUE --new_width VALUE
videobeaux -P resize \
-i myvideo.mp4 \
-o resize_styled.mp4 \
--new_height EXAMPLE \
--new_width EXAMPLE
Program output video not yet linked.
convert_dims when you want aspect-ratio intelligence; use resize when you want exact pixel control.gamma_fix or tonemap_hdr_sdr to stabilize tonal fidelity before scaling.:contentReference[oaicite:1]{index=1}
Reverses the playback of the input video, producing a backward-motion effect.
This simple but powerful manipulation can completely change the emotional or aesthetic tone of footage, turning ordinary actions into surreal rewinds, resets, or temporal loops.
reverse is designed for creators who want to:
videobeaux -P reverse -i input.mp4 -o output.mp4
videobeaux -P reverse \
-i myvideo.mp4 \
-o reverse_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/74367227-6fee-455f-af36-804a1e6d6cb6" type="video/mp4"> Your browser does not support the video tag. </video>
looper_pro to generate seamless mirrored loops.bad_contrast or double_cup for stylized retro or dreamy rewinds.reverse before heavy effects if you want the effects themselves to accumulate in reverse order.reverse after stylistic effects if you want the look preserved but motion reversed.:contentReference[oaicite:1]{index=1}
Applies a continuous scrolling motion to the video by shifting the image over time in a single direction.
Unlike scrolling_pro, which allows multi-axis control, this module provides a simple, fixed-direction scroll effect — ideal for lightweight motion or ambient looping.
scrolling is designed for creators who want:
videobeaux -P scrolling -i input.mp4 -o output.mp4
videobeaux -P scrolling \
-i myvideo.mp4 \
-o scrolling_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/4cdebccc-8519-45c6-aded-089db73d20d2" type="video/mp4"> Your browser does not support the video tag. </video>
blur_pix) can reduce visible seams in detailed footage.lsd_feedback for evolving drifting effects.overexposed_stutter or nostalgic_stutter for stylized motion disruption.convert_dims beforehand if preparing platform-specific scrolling backgrounds.:contentReference[oaicite:1]{index=1}
Applies a continuous scrolling effect to the video, allowing the image to move horizontally, vertically, or in both directions simultaneously.
This module is ideal for generating drifting motion, conveyor-like movement, kinetic wallpaper loops, and directional flow effects.
scrolling_pro is designed for creators who want:
videobeaux -P scrolling_pro \
-i input.mp4 \
-o output.mp4 \
--horiz_speed VALUE \
--vert_speed VALUE
videobeaux -P scrolling_pro \
-i myvideo.mp4 \
-o scrolling_pro_styled.mp4 \
--horiz_speed EXAMPLE \
--vert_speed EXAMPLE
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/e84cfb49-f72d-449e-833a-0271903704f4" type="video/mp4"> Your browser does not support the video tag. </video>
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/19c6eef1-2bc0-4d84-b531-55f9ca07a912" type="video/mp4"> Your browser does not support the video tag. </video>
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/4a4272de-e074-4e37-8c2d-a282f2d8be57" type="video/mp4"> Your browser does not support the video tag. </video>
looper_pro.blur_pix) before scrolling can remove hard seams in loop textures.double_cup or lsd_feedback for trippy drifting effects.convert_dims first if you need scroll-safe aspect ratios for looping platforms.Applies an intense, distressed visual filter inspired by the physiological collapse associated with septic shock.
The effect evokes instability, discoloration, plunging contrast, erratic tonal shifts, and an overall sense of visual “failing systems.”
This is a highly stylized effect — not medically literal — meant to express emotional, cinematic, or abstract interpretations of systemic breakdown.
septic is designed for creators who want:
videobeaux -P septic -i input.mp4 -o output.mp4
videobeaux -P septic \
-i myvideo.mp4 \
-o septic_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/user-attachments/assets/25f65267-60fa-421a-aaf3-02918844a488" type="video/mp4"> Your browser does not support the video tag. </video>
bad_contrast for deeper shadows and harsher tonal decay.overexposed_stutter for panic-attack visual rhythms.lut_apply if you want a uniform sickly wash; apply after if you want the LUT to warp the septic palette.Applies a subtle RGB smear effect, gently shifting and bleeding color channels to create a soft distortion.
The look resembles mild chromatic drift, analog smudge, or a barely-there color echo — perfect for adding texture without overwhelming the original image.
slight_smear is designed for creators who want:
videobeaux -P slight_smear \
-i input.mp4 \
-o output.mp4
videobeaux -P slight_smear \
-i myvideo.mp4 \
-o slight_smear_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/a7bca4c5-46b5-4b51-a827-6b8137d0117d" type="video/mp4"> Your browser does not support the video tag. </video>
lsd_feedback, crossmosh, or double_cup.gamma_fix beforehand for more stable channel balancing.blur_pix afterward for a painterly, soft-focus expansion.convert_dims before smearing if resizing footage for a platform-specific format.Applies a gentle smudge effect to the video, softening edges and pulling colors slightly across motion paths.
The result resembles a faint manual smear, as if the image were lightly dragged or brushed while still wet.
smudge is designed for creators who want:
videobeaux -P smudge \
-i input.mp4 \
-o output.mp4
videobeaux -P smudge \
-i myvideo.mp4 \
-o smudge_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/user-attachments/assets/9bb80e0b-bf16-49e7-b4e1-6c0c79b59c32" type="video/mp4"> Your browser does not support the video tag. </video>
slight_smear for layered organic softness.repainting afterward for a “hand-redrawn” effect.resize before smudging if you want especially smooth, flowing distortion.Applies a hazy, washed-over film that resembles the visual blur of “soap-blinded eyes” — a foggy, filmy distortion that softens detail and reduces clarity.
The result is a dreamy, smeared, low-contrast haze that feels like staring through suds, steam, or a semi-opaque membrane.
soapblind is designed for creators who want:
videobeaux -P soapblind \
-i input.mp4 \
-o output.mp4
videobeaux -P soapblind \
-i myvideo.mp4 \
-o soapblind_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/user-attachments/assets/28070fe5-52cd-42c9-93b7-a417c83add2d" type="video/mp4"> Your browser does not support the video tag. </video>
slight_smear for a double-soft aesthetic.repainting for painterly, softened brushlike visuals.Changes the playback speed of the input video and audio simultaneously.
This module is useful for slow motion, fast motion, timelapse, rhythmic edits, and any effect requiring temporal compression or expansion.
speed is designed for creators who want to:
videobeaux -P speed \
-i input.mp4 \
-o output.mp4 \
--speed_factor VALUE
0.5 → half-speed (slow motion)2.0 → double-speed (fast motion)0.25 → quarter-speed4.0 → 4× speedvideobeaux -P speed \
-i myvideo.mp4 \
-o speed_styled.mp4 \
--speed_factor EXAMPLE
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/c27efdb1-ae81-4d8d-a153-de6294b7fedf" type="video/mp4"> Your browser does not support the video tag. </video>
frame_interpolate first).frame_interpolate before speed to create missing frames.looper_pro for smooth motion loops.nostalgic_stutter or bad_animation for stylized cadence distortion.A simple segmentation utility that divides a video into evenly timed chunks or scene-based fragments for modular editing.
Unlike splitting_pro, which slices spatial regions of the frame, splitting operates purely in the time domain, cutting the clip into temporal sections that can be reused, rearranged, or processed individually.
splitting is designed for creators who want:
videobeaux -P splitting \
-i input.mp4 \
-o output.mp4
videobeaux -P splitting \
-i myvideo.mp4 \
-o splitting_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/user-attachments/assets/b6c13707-aaa8-416e-9f80-5ca6a386cd0f" type="video/mp4"> Your browser does not support the video tag. </video>
convert_dims first if you want uniformity across all segments.reverse, speed, or nostalgic_stutter to add temporal variation to each slice.A precise segmentation tool that slices a source video into reusable chunks based on positional slicing rules.
splitting_pro allows creators to extract vertical or horizontal bands of the frame, enabling compositing, collage workflows, displacement patterns, and region-based editing.
Unlike timeline slicing tools, splitting_pro manipulates spatial slices of a single frame, carving out portions of the video image for recombination or further processing.
splitting_pro is designed for creators who want:
width parameter determines how large the slice is (in pixels or proportional units depending on implementation).position parameter determines where the slice begins — allowing sliding-window or fixed-region extraction.videobeaux -P splitting_pro \
-i input.mp4 \
-o output.mp4 \
--width VALUE \
--position VALUE
videobeaux -P splitting_pro \
-i myvideo.mp4 \
-o splitting_pro_styled.mp4 \
--width EXAMPLE \
--position EXAMPLE
Program output video not yet linked.
position based on (frame_size - width) / 2.width may represent horizontal or vertical dimension.blur_pix for soft-edge slicing.scrolling_pro to animate the sliced region across time.Stacks two videos vertically (one on top of the other) while preserving the original orientation and aspect ratio of each source.
This module creates a clean two-layer composite, useful for comparison videos, collage work, diptychs, and multi-view layouts.
stack_2x is designed for creators who want:
-i input.mp4) forms the top (or first) layer.--input2 path loads the second video, which becomes the bottom layer.videobeaux -P stack_2x \
-i input.mp4 \
-o output.mp4 \
--input2 VALUE
videobeaux -P stack_2x \
-i myvideo.mp4 \
-o stack_2x_styled.mp4 \
--input2 EXAMPLE
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/6f244aba-e741-46c9-9863-7fc43527a8d6" type="video/mp4"> Your browser does not support the video tag. </video>
convert_dims or resize.lut_apply, gamma_fix) before stacking.stack_3x or other stacking modules for multi-row layouts.resize to unify widths before stacking for the most predictable results.Applies a cool steel-blue wash across the entire video image.
The effect evokes the feel of industrial lighting, cold metal surfaces, or desaturated cinematic palettes often seen in sci-fi, dystopian, and neo-noir aesthetics.
steel_wash is designed for creators who want:
videobeaux -P steel_wash \
-i input.mp4 \
-o output.mp4
videobeaux -P steel_wash \
-i myvideo.mp4 \
-o steel_wash_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/eea99448-9352-48f1-a1ec-b2cac6ad056d" type="video/mp4"> Your browser does not support the video tag. </video>
bad_contrast for harsher, high-impact steel tones.ghostee or slight_smear for dreamy industrial softness.Applies a customizable frame-stutter effect where playback cadence is intentionally disrupted according to a user-defined stutter intensity.
stutter_pro offers far more control than the simpler nostalgic_stutter or overexposed_stutter modules, allowing the editor to tune how aggressively the timeline “hiccups.”
stutter_pro is designed for creators who want:
Frame Retention / Skipping
Based on the stutter value, certain frames are duplicated or dropped.
Pattern Generation
The effect may repeat, hold, or jitter frames depending on stutter intensity.
Temporal Distortion
Motion becomes erratic, producing:
Encoding
Output is encoded using Videobeaux global codec, pixel format, and CRF settings.
videobeaux -P stutter_pro \
-i input.mp4 \
-o output.mp4 \
--stutter VALUE
videobeaux -P stutter_pro \
-i myvideo.mp4 \
-o stutter_pro_styled.mp4 \
--stutter EXAMPLE
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/03e234fb-d0fe-4d72-a11c-dff1bc59fa83" type="video/mp4"> Your browser does not support the video tag. </video>
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/e6d8c14a-9f20-4365-bb1f-5f473289a855" type="video/mp4"> Your browser does not support the video tag. </video>
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/schwwaaa/videobeaux/assets/7625379/864835ba-dc9d-4392-aa77-2cc062e2b700" type="video/mp4"> Your browser does not support the video tag. </video>
lsd_feedback.reverse or looper_pro.blur_pix) can soften the harshness for dreamy styles.overexposed_stutter for chaotic shockwave motion.speed together with stutter to build complex rhythmic motion systems.frame_interpolate if you want smoother slow-motion stutter artifacts.Applies a liquid-metal distortion effect inspired by the T-1000 from Terminator 2.
This effect simulates molten chromium surfaces, flowing reflections, metallic warping, and fluid reshaping — producing a highly stylized morphing look that feels synthetic, slippery, and impossibly smooth.
t1000 is designed for creators who want:
videobeaux -P t1000 \
-i input.mp4 \
-o output.mp4
videobeaux -P t1000 \
-i myvideo.mp4 \
-o t1000_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/user-attachments/assets/5de6db36-f8d4-426e-9262-b9dbeb2095ae" type="video/mp4"> Your browser does not support the video tag. </video>
reverse or speed for dramatic reformation sequences.steel_wash for a colder, industrial chrome palette.lsd_feedback for evolving metal-fluid feedback tunnels.Applies a distorted, delirious visual effect meant to simulate the hallucinated perspective of a zombie under the fictional TC-1 compound.
The aesthetic is disoriented, chemically corrupted, semi-conscious, and grotesquely vivid — combining abnormal color shifts, lurching motion, and sensory confusion.
twociz is designed for creators who want:
videobeaux -P twociz \
-i input.mp4 \
-o output.mp4
videobeaux -P twociz \
-i myvideo.mp4 \
-o twociz_styled.mp4
Program output video omitted due to size; see repository for reference clips.
septic for medical-shock surrealism.bad_contrast for a bruised, collapsing palette.lsd_feedback for intensifying delirium loops.overexposed_stutter for a chemically panicked final effect.Applies a blown-out white-balance flare that washes the frame in bright, overexposed warmth.
The effect simulates a camera whose white balance has catastrophically failed, producing harsh brightness spikes, color melt, and an unstable exposure cast.
wbflare is designed for creators who want:
videobeaux -P wbflare \
-i input.mp4 \
-o output.mp4
videobeaux -P wbflare \
-i myvideo.mp4 \
-o wbflare_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/user-attachments/assets/e2a5f065-163e-4bb9-8fd3-1edbfbdbab2a" type="video/mp4"> Your browser does not support the video tag. </video>
overexposed_stutter for extreme blown-out instability.bad_contrast to deepen shadows beneath the flare.Applies an extreme RGB color treatment that aggressively remixes channel intensity, contrast, and chromatic balance.
This effect pushes the video into hyper-saturated, unnatural, or neon-driven territory — producing explosive color distortions ideal for glitch, psychedelia, or high-impact stylization.
xrgb is designed for creators who want:
videobeaux -P xrgb \
-i input.mp4 \
-o output.mp4
videobeaux -P xrgb \
-i myvideo.mp4 \
-o xrgb_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/user-attachments/assets/c9644cd5-a584-4f0d-ada3-13046e6938a5" type="video/mp4"> Your browser does not support the video tag. </video>
crossmosh or lsd_feedback.slight_smear for neon-blooming distortion.blur_pix afterward for soft neon haze; apply beforehand for sharpened RGB breaks.steel_wash after xrgb; for warmer neon, chain wbflare.Applies a stylized “Zapruder film” aesthetic inspired by the iconic 1960s 8mm footage.
The effect simulates historical analog film qualities including jitter, grain, contrast instability, chromatic fading, and hand-held mechanical wobble.
The result resembles degraded archival film transferred from aging physical media.
zapruder is designed for creators who want:
videobeaux -P zapruder \
-i input.mp4 \
-o output.mp4
videobeaux -P zapruder \
-i myvideo.mp4 \
-o zapruder_styled.mp4
<video controls preload="metadata" style="max-width:100%; border-radius:8px; margin:1em 0;"> <source src="https://github.com/user-attachments/assets/cad79483-b21f-43b8-a1cd-91ed8406574a" type="video/mp4"> Your browser does not support the video tag. </video>
bad_predator, nostalgic_stutter, or lofi effects for layered retro realism.blur_pix beforehand for softer, more analog edges.reverse and speed for scratched-film temporal irregularity.Burns subtitles, captions, or transcript text directly into the video with precise styling, timing, and layout control
captionstylerollup_lineswords_per_linefontfont_sizebolditalicprimaryoutlineoutline_widthshadowbackback_opacityscale_xscale_yspacingrotatemargin_lmargin_rmargin_valignborder_stylexymovevcodeccrfpresetvideobeaux -P captburn -i input.mp4 -o output.mp4 --caption VALUE --style VALUE --rollup_lines VALUE --words_per_line VALUE --font VALUE --font_size VALUE --bold VALUE --italic VALUE --primary VALUE --outline VALUE --outline_width VALUE --shadow VALUE --back VALUE --back_opacity VALUE --scale_x VALUE --scale_y VALUE --spacing VALUE --rotate VALUE --margin_l VALUE --margin_r VALUE --margin_v VALUE --align VALUE --border_style VALUE --x VALUE --y VALUE --move VALUE --vcodec VALUE --crf VALUE --preset VALUE
videobeaux -P captburn -i myvideo.mp4 -o captburn_styled.mp4 --caption EXAMPLE --style EXAMPLE --rollup_lines EXAMPLE --words_per_line EXAMPLE --font EXAMPLE --font_size EXAMPLE --bold EXAMPLE --italic EXAMPLE --primary EXAMPLE --outline EXAMPLE --outline_width EXAMPLE --shadow EXAMPLE --back EXAMPLE --back_opacity EXAMPLE --scale_x EXAMPLE --scale_y EXAMPLE --spacing EXAMPLE --rotate EXAMPLE --margin_l EXAMPLE --margin_r EXAMPLE --margin_v EXAMPLE --align EXAMPLE --border_style EXAMPLE --x EXAMPLE --y EXAMPLE --move EXAMPLE --vcodec EXAMPLE --crf EXAMPLE --preset EXAMPLE
:contentReference[oaicite:1]{index=1}
Assembles a sequence of Videobeaux program steps into a single automated workflow, chaining multiple transformations into one output.
Allows creators to design multi-stage processing pipelines without running several commands manually.
chain_builder enables complex, multi-step Videobeaux workflows such as:
This tool acts as a meta-controller that executes multiple Videobeaux programs in the specified order.
chain argument accepts a structured definition of steps, typically referencing individual Videobeaux modules.-o.videobeaux -P chain_builder \
-i input.mp4 \
-o output.mp4 \
--chain VALUEvideobeaux -P chain_builder \
-i myvideo.mp4 \
-o chain_builder_styled.mp4 \
--chain EXAMPLE:contentReference[oaicite:1]{index=1}
Performs a simple video file conversion using global Videobeaux encoding settings.
Useful for remuxing, transcoding, codec changes, rewrapping containers, or generating standardized media versions.
convert exists as a lightweight, universal tool for turning one media container or codec into another.
This is ideal for:
vcodec, acodec), convert applies them here.-o.videobeaux -P convert \
-i input.mp4 \
-o output.mp4videobeaux -P convert \
-i myvideo.mp4 \
-o convert_styled.mp4faster, fast).Converts the dimensions of a video to a chosen preset (e.g., 1080p, instagram_reels, tiktok_video) and applies a configurable aspect-ratio handling mode (pad, fit, fill, fill_crop, stretch).
Supports portrait overrides, crop/pad anchoring, custom pad color, and scaling kernel selection.
convert_dims provides a predictable, explicit way to resize video assets into standardized resolutions for:
It gives direct control over how the aspect ratio is treated: padded, stretched, cropped, or fit.
Preset Selection
--preset chooses a named dimension from a predefined list (e.g., 1080p, square1080, instagram_reels, portrait4k, ultrawide1440, etc.).
Each preset maps to a fixed width/height pair.
Portrait Override
--portrait-full forces a 9:16 portrait output based on the preset’s larger side, using a full-frame cover + crop (fill_crop behavior).
Mode Handling
--mode controls aspect-ratio handling:
pad – keep AR, fit inside target, pad with color as needed.fit – keep AR, fit inside target, no padding (may not fill entire frame).fill / fill_crop – cover the frame and center-crop to the target size.stretch – ignore AR, stretch directly to target dimensions.If --mode is not set, --translate (deprecated) chooses between:
yes → stretchno → padAnchor & Padding
--anchor biases where crop or pad happens (center, top, bottom, left, right, top_left, etc.).
--pad-color defines the color of any added borders.
Scaling Quality
--scale-flags selects the FFmpeg scale kernel (lanczos, bicubic, bilinear, neighbor), affecting sharpness and performance.
Encoding & Output
--output-format extension.yuv420p, ~5000k, medium preset) with AAC audio and +faststart for streaming-friendly MP4/MOV.videobeaux -P convert_dims \
-i input.mp4 \
-o output.mp4 \
--output-format VALUE \
--preset VALUE \
--mode VALUE \
--translate VALUE \
--anchor VALUE \
--pad-color VALUE \
--scale-flags VALUE \
--portrait-fullmp4, mov). If the -o path has a different suffix, it is replaced with this.1080p, square1080, instagram_reels, tiktok_video, ultrawide1440, etc.). Each maps to a specific width/height.pad – maintain AR, fit inside target, pad with color.fit – maintain AR, fit inside target, no padding.fill, fill_crop – cover target and center-crop based on anchor.stretch – ignore AR and stretch to the exact width/height.--mode is not set:yes → behaves like stretch.no → behaves like pad.center, top, bottom, left, right,top_left, top_right, bottom_left, bottom_right.pad mode (e.g., #000000, #FFFFFF).lanczos, bicubic, bilinear, or neighbor. Controls quality vs speed.fill_crop).Each preset maps to a (width, height) pair:
sd – 320×240720hd – 640×3601080hd – 960×540widescreen – 320×180portrait1080 – 1080×1620480p – 640×480576p – 720×576720p – 1280×7201080p – 1920×10801440p – 2560×14404k – 3840×21608k – 7680×4320vga – 640×480qvga – 320×240wvga – 800×480svga – 800×600xga – 1024×768wxga – 1280×800sxga – 1280×1024uxga – 1600×1200wuxga – 1920×1200qwxga – 2048×1152qhd – 2560×1440wqxga – 2560×16005k – 5120×2880portrait720 – 720×1280portrait4k – 2160×3840square1080 – 1080×1080square720 – 720×720cinema4k – 4096×2160ultrawide1080 – 2560×1080ultrawide1440 – 3440×1440instagram_feed – 1080×1080instagram_reels – 1080×1920instagram_stories – 1080×1920tiktok_video – 1080×1920youtube_standard – 1920×1080youtube_shorts – 1080×1920facebook_feed – 1080×1080facebook_stories – 1080×1920twitter_video – 1280×720twitter_square – 1080×1080linkedin_video – 1920×1080linkedin_square – 1080×1080snapchat_video – 1080×1920pinterest_video – 1080×1920pinterest_square – 1000×1000videobeaux -P convert_dims \
-i myvideo.mp4 \
-o convert_dims_instareel.mp4 \
--output-format mp4 \
--preset instagram_reels \
--mode fill_crop \
--anchor center \
--pad-color "#000000" \
--scale-flags lanczos \
--portrait-fullportrait-full effectively overrides mode to a full-frame, cover-style portrait crop while honoring the preset’s size.scale-flags=lanczos offers high-quality resizing at the cost of some speed.-c:v libx264, -b:v 5000k, -pix_fmt yuv420p, -preset medium-c:a aac, -b:a 160k, -ar 48000, -movflags +faststart--force (global Videobeaux argument) controls overwrite; if not set, existing files cause an error.anchor.--portrait-full.mode=pad with a neutral pad-color when you want to preserve entire frames without cropping.mode=fill_crop for platform-native aspect ratios where filling the frame is more important than preserving the entire source frame.anchor=top or anchor=bottom for content where the action is biased toward one edge (e.g., heads near the top).scale-flags=lanczos for master/delivery renders; drop to bicubic or bilinear for faster, iterative tests.stretch to avoid unwanted distortion.Rewraps or converts media streams while copying or re-encoding video/audio.
Useful for repairing containers, adjusting codecs, changing formats, resolving sync issues, or preparing files for specific platforms or pipelines.
convert_mux is Videobeaux’s advanced container/codec remuxing and transcoding utility.
Compared to the simpler convert program, convert_mux offers:
vf),--profile.This makes it ideal for delivery specifications, pipeline normalization, or technical media prep.
--format)--profile)--profile is not used, you can explicitly specify:--vcodec, --acodec,--crf, --bitrate, --maxrate, --bufsize, --preset,--pix-fmt, --gop, -r, --vf, --tagv, etc.--copy bypasses re-encoding and performs a container-level remux where streams are compatible.-- are passed directly to FFmpeg (ffmpeg_args).run_ffmpeg_with_progress, echoing the FFmpeg command for transparency.videobeaux -P convert_mux \
-i input.mp4 \
-o output.mp4 \
--format VALUE \
--profile VALUE \
--vcodec VALUE \
--acodec VALUE \
--crf VALUE \
--bitrate VALUE \
--maxrate VALUE \
--bufsize VALUE \
--preset VALUE \
--profile-v VALUE \
--level VALUE \
--pix-fmt VALUE \
--gop VALUE \
-r VALUE \
--vf VALUE \
--tagv VALUE \
--abitrate VALUE \
--ac VALUE \
--ar VALUE \
--copy \
-- FFMPPEG_ARGS...mp4, mov, webm, matroska, mxf, gif, image2, avi, etc.).libx264, libx265, libaom-av1, prores_ks, dnxhd, mpeg2video, mpeg4, mjpeg).aac, libopus, libmp3lame, mp3, pcm_s16le).5M).maxrate.ultrafast, fast, slow).profile_v) — Video codec profile (e.g., high, main, baseline, or ProRes profile index).4.1) for device compatibility.pix_fmt) — Pixel format (e.g., yuv420p, yuv422p10le, yuva444p10le).30000/1001, 25, 24, etc.).hvc1).192k).2).48000).-- passed directly to FFmpeg.These are the curated --profile options defined in the code, with their intent:
libx264, -preset veryfast, -crf 18, yuv420p, +faststart, AAC 192k stereo.libx265, -preset medium, -crf 22, -tag:v hvc1, yuv420p, +faststart, AAC 192k stereo.libaom-av1, -crf 28, -b:v 0, yuv420p, +faststart, AAC 192k stereo.libvpx-vp9, -b:v 0, -crf 30, row-mt enabled, yuv420p, Opus 160k stereo.libaom-av1, -crf 32, -b:v 0, yuv420p, Opus 160k stereo.prores_ks, -profile:v 2, yuv422p10le, PCM s16le audio.prores_ks, -profile:v 4, yuva444p10le, PCM s24le audio.dnxhd, -profile:v dnxhr_hq, yuv422p, PCM s16le audio.mpeg2video at 50M CBR, interlaced, top field first, yuv422p, PCM s24le 48k stereo, -f mxf.ffv1 level 3, intra (g=1), slice CRC, PCM s24le audio.fps=15,scale=iw:-2:flags=lanczos in a filter_complex chain.-c:v png.-qscale:v 2 (high quality JPEG).-vn, libmp3lame, -b:a 320k.-vn, aac, -b:a 192k.-vn, flac.mjpeg with -q:v 3, PCM s16le audio.mpeg4, -qscale:v 3, -bf 0, -mbd 0, MP3 192k audio.videobeaux -P convert_mux \
-i myvideo.mp4 \
-o convert_mux_styled.mp4 \
--format mp4 \
--profile mp4_h264.mp4, certain profiles that expect non-MP4 containers (webm_…, mxf_…, gif, etc.) will cause a fail-fast error to avoid confusing FFmpeg errors.--copy disables most encoding options and simply remuxes streams when possible.-- if you need something not exposed via named arguments.mp4_h264, mp4_hevc, or mp4_av1.prores_422, prores_4444, or dnxhr_hq for editing, grading, or VFX.mxf_xdcamhd50_1080i59.--copy to remux without re-encoding when container changes are sufficient.mp4_av1, webm_av1) are slower to encode but very efficient for distribution.lossless_ffv1 in Matroska with PCM audio.:contentReference[oaicite:1]{index=1}
Downloads or rips video and audio content from YouTube (or other compatible platforms) and prepares it for processing inside Videobeaux workflows.
download_yt is a quick-ingest utility that brings online source media into your local Videobeaux environment.
This is useful when you need:
download_yt has no program-specific arguments, all settings (filename, codecs, mapping, etc.) follow Videobeaux global defaults.-o.videobeaux -P download_yt \
-i input.mp4 \
-o output.mp4videobeaux -P download_yt \
-i myvideo.mp4 \
-o download_yt_styled.mp4:contentReference[oaicite:1]{index=1}
Extracts individual frames from a video file and saves them as image files (typically PNG).
Ideal for analysis, archival, animation workflows, visual debugging, and creating frame-based artwork.
extract_frames gives creators a fast and predictable way to output every frame (or selected frames via global videobeaux options) as standalone image files.
This is useful for:
000001.png, 000002.png, etc.), depending on videobeaux output rules.--outfile, mapping rules, etc.).videobeaux -P extract_frames \
-i input.mp4 \
-o output.mp4videobeaux -P extract_frames \
-i myvideo.mp4 \
-o extract_frames_styled.mp4rgb48le).:contentReference[oaicite:1]{index=1}
Extracts the audio track from a video file and saves it as a standalone audio file, preserving quality and format.
Useful for sound design, transcription workflows, remixing, archival storage, or preparing audio-only deliverables.
extract_sound allows creators to quickly isolate the audio component of any media file.
This is ideal for:
-o.videobeaux -P extract_sound \
-i input.mp4 \
-o output.mp4videobeaux -P extract_sound \
-i myvideo.mp4 \
-o extract_sound_styled.mp4.mp3, .wav, .aac)..wav for lossless extraction..aac or .mp3 for lightweight distribution formats.:contentReference[oaicite:1]{index=1}
Generates smooth slow-motion or higher-FPS video by creating intermediate frames using motion-compensated interpolation.
frame_interpolate creates additional frames between existing frames to produce:
It supports multiple interpolation engines (RIFE, DAIN, FFmpeg Minterpolate), allowing both high-quality deep-learning interpolation and traditional optical-flow methods.
rife (AI-based, fast, high quality)dain (AI-based, depth-aware interpolation)ffmpeg (classical minterpolate optical flow)mi_mode, me_mode, mc_mode configure interpolation, motion estimation, and motion compensation logic.vsbmc enables virtual scene-based motion compensation.scd toggles scene-change detection to prevent warping across hard cuts.rife_bin and dain_bin specify executable paths or binaries for AI interpolation engines.videobeaux -P frame_interpolate \
-i input.mp4 \
-o output.mp4 \
--outfile VALUE \
--engine VALUE \
--fps VALUE \
--multiplier VALUE \
--mi_mode VALUE \
--me_mode VALUE \
--mc_mode VALUE \
--vsbmc VALUE \
--scd VALUE \
--x264_preset VALUE \
--crf VALUE \
--copy_audio VALUE \
--rife_bin VALUE \
--dain_bin VALUErife, dain, ffmpeg).videobeaux -P frame_interpolate \
-i myvideo.mp4 \
-o frame_interpolate_styled.mp4 \
--outfile EXAMPLE \
--engine EXAMPLE \
--fps EXAMPLE \
--multiplier EXAMPLE \
--mi_mode EXAMPLE \
--me_mode EXAMPLE \
--mc_mode EXAMPLE \
--vsbmc EXAMPLE \
--scd EXAMPLE \
--x264_preset EXAMPLE \
--crf EXAMPLE \
--copy_audio EXAMPLE \
--rife_bin EXAMPLE \
--dain_bin EXAMPLEminterpolate can introduce warping around fast motion or scene cuts—use scd=true to reduce artifacts.scd.:contentReference[oaicite:1]{index=1}
Normalizes gamma, brightness, and exposure levels for broadcast-safe or web-safe consistency across diverse footage.
gamma_fix is designed to correct inconsistent exposure, contrast, and gamma shifts that often appear when mixing footage from multiple cameras, phones, archives, or lighting conditions.
It provides predictable luminance normalization suitable for:
target_yavg.min_contrast and max_contrast constrain the allowed contrast stretch, preventing overcorrection.sat provides global saturation control to compensate for washed-out or overly vivid sources.legalize ensures output luminance stays within broadcast-safe IRE ranges.videobeaux -P gamma_fix \
-i input.mp4 \
-o output.mp4 \
--target_yavg VALUE \
--min_contrast VALUE \
--max_contrast VALUE \
--gamma VALUE \
--sat VALUE \
--legalize VALUE \
--vcodec VALUE \
--crf VALUE \
--preset VALUE \
--acodec VALUE \
--ab VALUElibx264).videobeaux -P gamma_fix \
-i myvideo.mp4 \
-o gamma_fix_styled.mp4 \
--target_yavg EXAMPLE \
--min_contrast EXAMPLE \
--max_contrast EXAMPLE \
--gamma EXAMPLE \
--sat EXAMPLE \
--legalize EXAMPLE \
--vcodec EXAMPLE \
--crf EXAMPLE \
--preset EXAMPLE \
--acodec EXAMPLE \
--ab EXAMPLEtarget_yavg close to typical mid-gray values (around 40–55% normalized luma).sat boosts (1.05–1.15) to avoid color clipping.:contentReference[oaicite:0]{index=0}
Creates unique fingerprints of video files using checksums, perceptual hashing, or frame-level hashing.
Useful for deduplication, archival identification, similarity matching, and database cataloging.
hash_fingerprint allows Videobeaux users to generate machine-identifiable signatures from media files.
This supports:
recursive allows walking entire folder trees.exts restricts scanning to specific file types.phash_fps determines how many frames per second are sampled.phash_size sets the resolution of the perceptual hash grid.stream_kind allows selecting video/audio/subtitle streams depending on the hashing method.videobeaux -P hash_fingerprint \
-i input.mp4 \
-o output.mp4 \
--recursive VALUE \
--exts VALUE \
--file_hashes VALUE \
--stream_hash VALUE \
--framemd5 VALUE \
--phash VALUE \
--phash_fps VALUE \
--phash_size VALUE \
--catalog VALUE \
--stream_kind VALUEmp4,mov,mkv).v, a, s).videobeaux -P hash_fingerprint \
-i myvideo.mp4 \
-o hash_fingerprint_styled.mp4 \
--recursive false \
--exts mp4,mov \
--file_hashes true \
--stream_hash true \
--framemd5 false \
--phash true \
--phash_fps 1 \
--phash_size 32 \
--catalog true \
--stream_kind vphash) is ideal for detecting duplicates that differ by transcoding, compression, or scaling.framemd5 is extremely accurate but produces large files; best for forensic comparison.phash_fps and phash_size to balance between accuracy and performance.phash_fps=1–3 for good coverage without heavy overhead.phash_size (e.g., 32–64) improves discrimination of similar videos.framemd5 only when exact frame-level matching is required.catalog=true for batch processing or long-term reference.Applies a 1D or 3D LUT to recolor a video, enabling film-style grading, color transforms, technical conversions, or creative look development.
lut_apply integrates LUT-based color grading into Videobeaux pipelines.
It is useful for:
.cube, .3dl, or other LUT file defined by the lut parameter.interp).intensity controls the LUT’s strength—useful for subtle looks or partial grading mixes.brightnesscontrastsaturationgammavideobeaux -P lut_apply \
-i input.mp4 \
-o output.mp4 \
--outfile VALUE \
--vcodec VALUE \
--lut VALUE \
--interp VALUE \
--intensity VALUE \
--brightness VALUE \
--contrast VALUE \
--saturation VALUE \
--gamma VALUE \
--pix_fmt VALUE \
--x264_preset VALUE \
--crf VALUE \
--copy_audio VALUElibx264, libx265, prores_ks).nearest, trilinear, or other supported methods).yuv420p, yuv422p10le, rgb24).videobeaux -P lut_apply \
-i myvideo.mp4 \
-o lut_apply_styled.mp4 \
--outfile EXAMPLE \
--vcodec EXAMPLE \
--lut EXAMPLE \
--interp EXAMPLE \
--intensity EXAMPLE \
--brightness EXAMPLE \
--contrast EXAMPLE \
--saturation EXAMPLE \
--gamma EXAMPLE \
--pix_fmt EXAMPLE \
--x264_preset EXAMPLE \
--crf EXAMPLE \
--copy_audio EXAMPLEtrilinear is typically best for high-quality grading.intensity is ideal for creative fades or adjustable look-dev.intensity around 0.6–0.85 for balanced results.yuv422p10le.Extracts detailed metadata—such as codecs, bitrates, dimensions, color information, loudness, black-frame metrics, and stream structure—from any media file.
meta_extraction is designed to provide deep insight into media characteristics for:
It can scan frames, detect black segments, analyze loudness, and output structured metadata for additional tools.
sample_frames sets how many frames to analyze.sample_stride controls spacing between sampled frames.sample_limit prevents excessive scanning on long videos.black_pic_th tunes sensitivity.black_dur_min sets minimum black duration to report.blackdetect toggles the feature.videobeaux -P meta_extraction \
-i input.mp4 \
-o output.mp4 \
--outputfile VALUE \
--sample_frames VALUE \
--sample_stride VALUE \
--sample_limit VALUE \
--blackdetect VALUE \
--black_pic_th VALUE \
--black_dur_min VALUE \
--loudness VALUEvideobeaux -P meta_extraction \
-i myvideo.mp4 \
-o meta_extraction_styled.mp4 \
--outputfile EXAMPLE \
--sample_frames EXAMPLE \
--sample_stride EXAMPLE \
--sample_limit EXAMPLE \
--blackdetect EXAMPLE \
--black_pic_th EXAMPLE \
--black_dur_min EXAMPLE \
--loudness EXAMPLEsample_frames or low sample_stride may increase scan time.black_pic_th between 0.05–0.10 for most SDR footage.sample_stride to speed up scans on long files.sample_limit reasonable to avoid unnecessary overhead.loudness for interview, dialog, or broadcast deliverables.Analyzes a timeline or cut structure to count edits, transitions, or shot boundaries for editorial statistics, QC, or structural analysis.
num_edits provides fast editorial metrics by identifying the number of cuts, transitions, or shot boundaries in a video.
This helps with:
videobeaux -P num_edits \
-i input.mp4 \
-o output.mp4 \
--count VALUEtrue or a mode such as basic vs detailed depending on implementation.videobeaux -P num_edits \
-i myvideo.mp4 \
-o num_edits_styled.mp4 \
--count trueRapidly slices videos into precise segments based on timecodes or cut lists, optimized for speed and batch operations.
qwikchop is built for extremely fast segment extraction, allowing you to cut a video into many pieces without re-encoding.
It supports:
pieces argument defines cut points—either explicit timecodes or references to external lists.recurse is enabled, the tool processes all media files inside a directory tree.trim_black_front removes silent/black leader.black_scan, black_thresh, and black_pict tune detection sensitivity.edge_pad_pre and edge_pad_post adjust segment timing to avoid cutting too close to transitions.min_edit prevents creation of fragment edits that are too short to be meaningful.videobeaux -P qwikchop \
-i input.mp4 \
-o output.mp4 \
--pieces VALUE \
--recurse VALUE \
--keep_temp VALUE \
--trim_black_front VALUE \
--black_scan VALUE \
--black_thresh VALUE \
--black_pict VALUE \
--edge_pad_pre VALUE \
--edge_pad_post VALUE \
--min_edit VALUEvideobeaux -P qwikchop \
-i myvideo.mp4 \
-o qwikchop_styled.mp4 \
--pieces EXAMPLE \
--recurse false \
--keep_temp false \
--trim_black_front true \
--black_scan 0.5 \
--black_thresh 0.10 \
--black_pict 0.10 \
--edge_pad_pre 0.25 \
--edge_pad_post 0.25 \
--min_edit 1.0edge_pad_pre and edge_pad_post are helpful for avoiding letterboxing artifacts or abrupt audio cuts.min_edit may create unusable micro-clips.edge_pad_pre/post slightly to avoid accidental content clipping.black_thresh based on the luminance characteristics of your footage.recurse=true) when processing large folder trees.min_edit above 0.5–1.0 seconds for stable outputs.Extracts sections of silence from a video’s audio track based on duration thresholds.
Useful for identifying dead air, isolating non-dialogue segments, or preparing silence-aware edits and analysis.
The silence_extraction program is designed to detect, isolate, or extract moments of silence within a video’s audio.
This is useful for:
min_d defines the minimum silence duration to be considered meaningful.max_d defines the longest segment to extract or label.adjuster parameter allows tuning how tolerant the detection should be, adjusting thresholds or trimming surrounding audio depending on implementation.videobeaux -P silence_extraction \
-i input.mp4 \
-o output.mp4 \
--min_d VALUE \
--max_d VALUE \
--adjuster VALUEvideobeaux -P silence_extraction \
-i myvideo.mp4 \
-o silence_extraction_styled.mp4 \
--min_d 1.5 \
--max_d 12.0 \
--adjuster mediumsilencedetect).min_d is useful for ignoring tiny pauses or breath sounds.max_d values may capture irrelevant long stretches; tune for your content.adjuster may influence thresholding; examples include “strict,” “medium,” or “loose” depending on your implementation.min_d values (0.3–0.7s) for fast speech.min_d (1–2s) for natural conversations or interviews.adjuster to avoid misclassifying quiet music or soft ambience as silence.Converts subtitle files between formats (e.g., SRT, VTT, ASS) while preserving timing, text, and (where possible) style metadata.
The subs_convert program standardizes subtitle workflows by:
It is especially helpful when preparing subtitles for caption-burning, translations, or multi-version deliverables.
list shows all available subtitle tracks with indices and metadata.indexes selects specific tracks by index.langs filters tracks by language codes (e.g., eng, spa).all overrides filters and selects every subtitle track.forced_only restricts output to forced subtitles only (e.g., foreign-language dialogue).exclude_hi strips hearing-impaired (HI) descriptors like sound effects or music tags.time_shift so subtitles can be nudged earlier or later to stay in sync.outputfile path.videobeaux -P subs_convert \
-i input.mp4 \
-o output.mp4 \
--list VALUE \
--indexes VALUE \
--langs VALUE \
--all VALUE \
--forced_only VALUE \
--exclude_hi VALUE \
--format VALUE \
--outdir VALUE \
--outputfile VALUE \
--time_shift VALUE0, 1,2). Accepts a comma-separated list.eng, spa). Accepts one or more languages, usually as a comma-separated list, depending on implementation.indexes and langs filters.[MUSIC], (LAUGHTER), and other non-dialogue notes.srt, vtt, or ass. The exact set of valid formats depends on the underlying subtitle tooling.-0.25 shifts cues 250ms earlier).videobeaux -P subs_convert \
-i documentary.mp4 \
-o documentary_fixed.mp4 \
--langs eng \
--exclude_hi \
--format vtt \
--time_shift -0.25 \
--outdir subs_outputlist is often used alone to inspect subtitle tracks before running a full conversion.indexes and langs are provided, explicit indexes typically take priority.all supersedes both indexes and langs, ensuring every subtitle track is processed.time_shift expects a value in seconds and can be fractional for fine-grained adjustment.list to discover track indices and language tags.langs when targeting a specific language for translation or distribution.exclude_hi for clean, dialogue-only subtitle deliveries.format ass when preparing styled subtitles for tools like captburn.time_shift after trimming or re-cutting your video to quickly re-align subtitles without manual editing.Generates thumbnails or contact sheets by sampling frames at chosen intervals for previews, galleries, or QC review.
The thumbs program creates frame-based preview images from video sources.
It can generate:
fps sampling (uniform intervals), orscene detection (generate thumbnails where major scene changes occur).scene_threshold determines sensitivity to cuts, edits, or brightness shifts.tile controls grid layout (e.g., 5x5 contact sheets).scale sets thumbnail size.timestamps includes frame timestamps.label adds custom text per thumbnail.outdir)outputfile)videobeaux -P thumbs \
-i input.mp4 \
-o output.mp4 \
--fps VALUE \
--scene VALUE \
--scene_threshold VALUE \
--tile VALUE \
--scale VALUE \
--timestamps VALUE \
--label VALUE \
--fontfile VALUE \
--bg VALUE \
--margin VALUE \
--padding VALUE \
--outdir VALUE \
--outputfile VALUE \
--image_format VALUE \
--jpeg_quality VALUEtrue/false).4x4, 6x8).true/false).jpg, png, etc.).videobeaux -P thumbs \
-i myvideo.mp4 \
-o thumbs_styled.mp4 \
--fps 1 \
--scene false \
--scene_threshold 0.4 \
--tile 5x5 \
--scale 320 \
--timestamps true \
--label "Preview Sheet" \
--fontfile /path/to/font.ttf \
--bg "#000000" \
--margin 20 \
--padding 10 \
--outdir thumbs_output \
--outputfile contactsheet \
--image_format jpg \
--jpeg_quality 90select='gt(scene,threshold)' filter logic.tile counts produce dense sheets but increase render time.scale affects memory usage when generating many thumbnails.drawtext filter.scene_threshold to balance between too many vs. too few scene hits.scale values for detailed thumbnails, smaller for overview sheets.Converts HDR footage (PQ/HLG) to SDR using tunable tonemapping curves, preserving highlight detail and color accuracy.
Convert HDR content into display-safe SDR while preserving highlight detail, proper color relationships, and controlled contrast. This module applies filmic or mathematical tonemap curves to ensure smooth highlight rolloff and SDR-safe luminance.
zscale=transfer=linear:npl=PEAKhable, mobius, reinhard, or clip) is applied via:tonemap=algo:desat=valuevideobeaux -P tonemap_hdr_sdr \
-i input.mp4 \
-o output.mp4 \
--outfile VALUE \
--algo VALUE \
--desat VALUE \
--peak VALUE \
--dither VALUE \
--pix_fmt VALUE \
--x264_preset VALUE \
--crf VALUE \
--copy_audio VALUEhable, mobius, reinhard, clip).yuv420p, yuv422p10le).slow, medium, fast, etc.).videobeaux -P tonemap_hdr_sdr \
-i myvideo.mp4 \
-o tonemap_hdr_sdr_styled.mp4 \
--outfile EXAMPLE \
--algo EXAMPLE \
--desat EXAMPLE \
--peak EXAMPLE \
--dither EXAMPLE \
--pix_fmt EXAMPLE \
--x264_preset EXAMPLE \
--crf EXAMPLE \
--copy_audio EXAMPLE--peak significantly affects highlight rolloff; adjust depending on source mastering.hable generally provides the best filmic highlight rolloff.--desat to 0.15–0.35.gamma_fix for refined SDR brightness/contrast normalization.AI-based transcription tool for converting spoken audio within video files into text using configurable speech-to-text models.
transraibe provides automated transcription capabilities inside the videobeaux workflow.
It enables creators to generate subtitles, caption files, analysis transcripts, or searchable text from any video containing dialogue or narration.
The tool is optimized for quick turnaround and supports multiple STT (speech-to-text) model options.
--stt_model.videobeaux -P transraibe \
-i input.mp4 \
-o output.mp4 \
--stt_model VALUEvideobeaux -P transraibe \
-i myvideo.mp4 \
-o transraibe_styled.mp4 \
--stt_model whisper-mediumstt_model chosen.Applies image or text watermarks onto video with configurable positioning, scaling, opacity, and blend style.
The watermark program allows creators to apply branding, artist signatures, copyright marks, or aesthetic overlays to video.
It supports dynamic placement, scaling, opacity control, looping behavior for animated watermarks, and optional spinning for stylized effects.
This tool is designed for flexible, production-ready watermark rendering in both subtle and bold presentation styles.
placement sets anchor position (top-left, top-right, center, etc.).margin offsets the watermark inward from edges.scale determines size relative to the input video.opacity controls transparency for subtle or strong branding.wm_loop determines whether GIF/video watermarks loop.ignore_loop overrides embedded loop metadata for continuous playback.start and end specify when the watermark appears.spin rotates the watermark (none, slow, medium, fast).videobeaux -P watermark \
-i input.mp4 \
-o output.mp4 \
--watermark VALUE \
--placement VALUE \
--margin VALUE \
--scale VALUE \
--opacity VALUE \
--spin VALUE \
--start VALUE \
--end VALUE \
--wm_loop VALUE \
--ignore_loop VALUE \
--video_crf VALUE \
--video_preset VALUEtop-left, top-right, center, etc.).none, slow, etc.).videobeaux -P watermark \
-i myvideo.mp4 \
-o watermark_styled.mp4 \
--watermark logo.png \
--placement bottom-right \
--margin 48 \
--scale 22 \
--opacity 0.85 \
--spin none \
--start 0 \
--end 99999 \
--wm_loop true \
--ignore_loop false \
--video_crf 18 \
--video_preset mediumCreates directional wipe transitions between clips using customizable timing, edge softness, and motion orientation
input1input2output_formatpresetdurationoffsetvideobeaux -P wipe_transitions -i input.mp4 -o output.mp4 --input1 VALUE --input2 VALUE --output_format VALUE --preset VALUE --duration VALUE --offset VALUE
videobeaux -P wipe_transitions -i myvideo.mp4 -o wipe_transitions_styled.mp4 --input1 EXAMPLE --input2 EXAMPLE --output_format EXAMPLE --preset EXAMPLE --duration EXAMPLE --offset EXAMPLE