mirror of
https://github.com/vondas-network/videobeaux.git
synced 2025-12-05 23:40:04 +01:00
61 lines
2.3 KiB
Plaintext
61 lines
2.3 KiB
Plaintext
# videobeaux: convert_mux
|
||
|
||
## Description
|
||
`convert_mux` provides a unified wrapper for re-muxing or transcoding any input media file.
|
||
It’s a high-level black-box converter supporting FFmpeg profiles and custom codec settings.
|
||
|
||
## Features
|
||
- Automatically infers codecs and container from extension.
|
||
- Supports dozens of curated profiles: mp4_h264, mp4_hevc, webm_vp9, prores_422, lossless_ffv1, etc.
|
||
- Stream-copy mode for instant rewraps.
|
||
- Handles audio-only formats (mp3, aac, flac, etc.)
|
||
- Full FFmpeg passthrough via `--` for raw arguments.
|
||
|
||
## Parameters
|
||
| Flag | Type | Description |
|
||
|------|------|--------------|
|
||
| `-i, --input` | str | Input media file |
|
||
| `-o, --output` | str | Output file (container inferred by extension) |
|
||
| `--profile` | str | Use a curated preset (see list below) |
|
||
| `--vcodec` / `--acodec` | str | Manual override codecs |
|
||
| `--crf`, `--bitrate`, etc. | mixed | Control quality, rate, and buffer settings |
|
||
| `--copy` | flag | Stream copy without re-encoding |
|
||
| `--format` | str | Force container format |
|
||
| `--ffmpeg_args` | list | Raw FFmpeg passthrough args |
|
||
| `-F, --force` | flag | Overwrite output |
|
||
|
||
## Common Profiles
|
||
| Profile | Container | Description |
|
||
|----------|------------|-------------|
|
||
| mp4_h264 | MP4 | Web-friendly H.264/AAC |
|
||
| mp4_hevc | MP4 | HEVC (H.265) Apple-ready |
|
||
| webm_vp9 | WebM | VP9 + Opus |
|
||
| prores_422 | MOV | ProRes mezzanine |
|
||
| prores_4444 | MOV | ProRes + Alpha |
|
||
| lossless_ffv1 | MKV | Archival |
|
||
| avi_mjpeg_fast | AVI | Fast MJPEG |
|
||
| avi_mpeg4_fast | AVI | Legacy fast MPEG-4 |
|
||
|
||
## Example Usage
|
||
```bash
|
||
# Simple H.264 conversion
|
||
videobeaux -P convert_mux -i ./media/bbb.mov -o ./out/bbb_h264.mp4 --profile mp4_h264 -F
|
||
|
||
# Convert to WebM VP9 + Opus
|
||
videobeaux -P convert_mux -i ./media/bbb.mov -o ./out/bbb_vp9.webm --profile webm_vp9 -F
|
||
|
||
# Convert to ProRes for post-production
|
||
videobeaux -P convert_mux -i ./media/bbb.mov -o ./out/bbb_prores.mov --profile prores_422 -F
|
||
|
||
# Fast rewrap (no re-encode)
|
||
videobeaux -P convert_mux -i ./media/bbb.mov -o ./out/bbb.mkv --copy -F
|
||
|
||
# Raw FFmpeg flags
|
||
videobeaux -P convert_mux -i ./media/bbb.mov -o ./out/bbb_custom.mp4 --profile mp4_h264 -- --max_muxing_queue_size 9999
|
||
```
|
||
|
||
## Output
|
||
- Encoded or rewrapped video/audio in the specified format.
|
||
- Preserves metadata and timestamps.
|
||
- Ideal for format conversion, web publishing, or broadcast deliverables.
|