# 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.