AVCONVERT(1) General Commands Manual AVCONVERT(1)

avconvertmovie conversion tool

avconvert [-hv] -s <source_media> -o <output_movie> -p <preset_name>

avconvert is a tool that converts source media files to different file types for sharing on the web or loading onto devices. The tool will not allow protected content to be converted. Only one video and one audio track is preserved through the conversion, along with metadata tracks. The tool will never resize the video higher than the source dimensions. If the preset internal dimensions are larger than that of the source, the conversion will maintain the source dimensions. The file extension provided for the output movie will determine the output file type.

| file
The source media file to be converted.
| file
The output movie file to be created.
| name
Use the specified preset for file conversion. All presets encode using AVC (H.264) encoding unless otherwise specified in the preset name. Use --help to get the full list.

A 480p Standard Definition preset with H.264 video and AAC audio.
A 540p preset with H.264 video and AAC audio.
A 720p High Definition preset with H.264 video and AAC audio.
A 1080p High Definition preset with H.264 video and AAC audio.
A 2160p Ultra High Definition preset with H.264 video and AAC audio.
An audio-only preset with AAC audio.
A legacy 480p Standard Definition preset with H.264 video and AAC audio suitable for playing on Apple devices.
A legacy 720p High Definition preset with H.264 video and AAC audio suitable for playing on Apple devices.
A legacy 1080p High Definition preset with H.264 video and AAC audio suitable for playing on Apple devices.
A legacy preset with H.264 video and AAC audio suitable for playing on older AppleTV models.
A legacy, smaller than Standard Definition, preset with H.264 video and AAC audio suitable for playing on Apple devices when streamed over a cellular network.
A legacy Standard Definition preset with H.264 video and AAC audio suitable for playing on an iPod.
A legacy, smaller than Standard Definition, preset with H.264 video and AAC audio suitable for playing on Apple devices when streamed over a WiFi network.
A preset with Apple ProRes 422 video and LPCM audio.
A preset with Apple ProRes 4444 video and LPCM audio.
A 1080p High Definition preset with HEVC video and AAC audio.
A 1080p High Definition preset with HEVC alpha video and AAC audio. If a non-alpha source is selected, an error will occur.
A 2160p Ultra High Definition preset with HEVC video and AAC audio.
A 2160p Ultra High Definition preset with HEVC alpha video and AAC audio. If a non-alpha source is selected, an error will occur.
An 8K preset with HEVC video and AAC audio.
A high quality preset with HEVC video and AAC audio.
A high quality preset with HEVC alpha video and AAC audio. If a non-alpha source is selected, an error will occur.
A high quality preset with H.264 video and AAC audio.
A low quality, smaller than Standard Definition, preset with H.264 video and AAC audio.
A medium quality, smaller than Standard Definition, preset with H.264 video and AAC audio.
A preset that passes through the video and audio tracks, without conversion.

Disable fast-start movie creation. Reduces disk accesses if fast-start is not required.
Disable the metadata filter. Use with caution. This will allow privacy sensitive source metadata to be preserved in the output file. This may include information such as the location of the video, time when the video was recorded, video capture device information, etc. If this option is not specified, the aforementioned source metadata is not present in the output file.
num
Trim the output movie to num seconds (decimal allowed). Default is end of file.
|
Print command usage and list available preset names.
Perform a higher quality multi-pass encode in the conversion.
|
Display progress during the conversion (default with -v).
Overwrite the output file, if it already exists.
num
Skip the first num seconds (decimal allowed) of the source movie. Default is beginning of file.
|
Print additional information about the conversion.

Convert the source movie from 4k HEVC to 720p AVC using the 1280x720 encoding preset:

avconvert --source 4k_hevc_movie.mov --output 720p_avc_movie.mov --preset Preset1280x720

Convert the source movie from 4k AVC to 4K HEVC using the HEVCHighestQuality encoding preset:

avconvert -s 4k_avc_movie.mov -o 4k_hevc_movie.mov -p PresetHEVCHighestQuality

Skip the first 3.5 seconds of the source movie and only convert the next 30 seconds:

avconvert --source source_movie.mov --output trimmed_movie.mov -p PresetMediumQuality --start 3.5 --duration 30

Convert the source movie from a QuickTime movie file to an MPEG-4 file:

avconvert -s source_movie.mov -o output_movie.mp4 -p PresetLowQuality

avconvert command first appeared in Mac OS X 10.7.

64-bit implementation introduced in Mac OS X 10.15.

October 8, 2021 macOS