mirror of
https://github.com/vondas-network/videobeaux.git
synced 2025-12-05 15:30:02 +01:00
42 lines
1.8 KiB
Plaintext
42 lines
1.8 KiB
Plaintext
# videobeaux: convert_dims
|
|
|
|
## Description
|
|
`convert_dims` resizes videos according to standardized or platform-specific aspect ratio presets.
|
|
It supports direct scaling, padding to maintain aspect ratio, and an optional “translate/stretch” mode to fill target dimensions exactly.
|
|
|
|
## Features
|
|
- Dozens of predefined presets: HD, 4K, Instagram Reels, YouTube Shorts, TikTok, etc.
|
|
- Stretch (`--translate yes`) or maintain aspect ratio (`--translate no`).
|
|
- New "fill" mode allows uniform scaling with crop to fill the target frame.
|
|
- Automatically sets safe `setdar` and `setsar` filters.
|
|
- Optional forced overwrite with `-F`.
|
|
|
|
## Parameters
|
|
| Flag | Type | Description |
|
|
|------|------|--------------|
|
|
| `-i, --input` | str | Input video file |
|
|
| `--output-format` | str | Output format (e.g. mp4, mov) |
|
|
| `--preset` | str | Target dimension preset (e.g. 1080p, instagram_reels) |
|
|
| `--translate` | yes/no | Stretch to fit or preserve aspect ratio with padding |
|
|
| `--fill` | yes/no | Crop to fill the target frame (centered) |
|
|
| `-F, --force` | flag | Overwrite output file |
|
|
|
|
## Example Usage
|
|
```bash
|
|
# Resize to 1080p maintaining aspect ratio
|
|
videobeaux -P convert_dims -i ./media/bbb.mov --output-format mp4 --preset 1080p -F
|
|
|
|
# Force exact stretch to TikTok format (9:16)
|
|
videobeaux -P convert_dims -i ./media/bbb.mov --output-format mp4 --preset tiktok_video --translate yes -F
|
|
|
|
# Maintain ratio with letterboxing to square
|
|
videobeaux -P convert_dims -i ./media/bbb.mov --output-format mp4 --preset square1080 --translate no -F
|
|
|
|
# Fill target aspect ratio (crop edges to fit)
|
|
videobeaux -P convert_dims -i ./media/bbb.mov --output-format mp4 --preset instagram_reels --fill yes -F
|
|
```
|
|
|
|
## Output
|
|
- Produces scaled MP4 or MOV with proper aspect ratio metadata.
|
|
- Compatible with social platforms and web delivery.
|