mirror of
https://github.com/vondas-network/videobeaux.git
synced 2026-01-25 16:21:10 +01:00
69 lines
2.8 KiB
Markdown
69 lines
2.8 KiB
Markdown
# looper_pro
|
|
|
|
## Description
|
|
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.
|
|
|
|
## Purpose
|
|
`looper_pro` is intended for creators who want to:
|
|
- loop a specific segment of a clip cleanly,
|
|
- create infinitely repeating video moments,
|
|
- build rhythmic or hypnotic playback sequences,
|
|
- generate raw loop assets for VJ systems or social loops,
|
|
- prepare seamless animations for montage or collage workflows.
|
|
|
|
## How It Works
|
|
1. **Frame Region Selection**
|
|
Internally selects frames based on:
|
|
- detected cadence,
|
|
- frame count,
|
|
- optional start and end logic defined by the program version.
|
|
2. **Loop Construction**
|
|
The selected block is repeated a specified number of cycles or for the full video duration.
|
|
3. **Seam Handling**
|
|
Basic smoothing or overlap blending may be used to reduce visible jumps at the start/end of each loop (implementation dependent).
|
|
4. **Encoding**
|
|
Output uses global Videobeaux settings (codec, CRF, pixel format, preset).
|
|
|
|
## Program Template
|
|
```bash
|
|
videobeaux -P looper_pro \
|
|
-i input.mp4 \
|
|
-o output.mp4
|
|
```
|
|
|
|
## Arguments
|
|
- *(No additional program-specific arguments; uses global videobeaux options only.)*
|
|
|
|
## Real World Example
|
|
```bash
|
|
videobeaux -P looper_pro \
|
|
-i myvideo.mp4 \
|
|
-o looper_pro_styled.mp4
|
|
```
|
|
|
|
## Program Output
|
|
<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>
|
|
|
|
## Technical Notes
|
|
- Works best when source footage includes repeating or rhythmic motion.
|
|
- Compression artifacts may accumulate across loop boundaries; use lower CRF if loop clarity is important.
|
|
- Shorter loops feel more “GIF-like,” while longer loops create subtle ambient motion ideal for installations.
|
|
- Loop start point may be governed by internal heuristics or user version behavior.
|
|
|
|
## Recommended Usage
|
|
- Ambient loops for projection mapping or VJ sets.
|
|
- Social-media loops where infinitely repeating visuals are desirable.
|
|
- Narrative interludes or transitions requiring rhythmic repetition.
|
|
- Motion-design elements for collage compositions or layered Lagkage outputs.
|
|
|
|
## Quality Tips
|
|
- Pre-process with `convert_dims` for perfectly square or vertical loop assets.
|
|
- Use `gamma_fix` beforehand to stabilize tonal values across loop boundaries.
|
|
- Pair with `double_cup` or `ghostee` for dreamy, flowing loop aesthetics.
|
|
- For a more extreme perturbation, run `looper_pro` before `crossmosh` or `bad_animation` to break the loop structure artistically.
|
|
|