QuickTime Player on a modern Mac refuses most AVI files. It is not you, and it is not the file. QuickTime X only handles a narrow set of codecs inside the AVI wrapper, and the Xvid or DivX codecs used by most downloaded AVI files, old camera footage, and security-camera exports are not among them. You get a black window or an error. That is a compatibility gap, not a fault. The fix is to use a player that carries its own decoders, or to convert the file to something QuickTime can open.

Why QuickTime Rejects Most AVI Files

The AVI container is just a wrapper. QuickTime only supports a few codecs inside it. Most AVI files you encounter use Xvid or DivX, which are MPEG-4 Part 2 codecs. QuickTime includes no decoders for them. On Windows, codec packs plug into Windows Media Player to fill the gap. No macOS equivalent plugs into QuickTime. You cannot add Xvid or DivX support to QuickTime with a download. Use a player that has its own decoders, or convert the file.

Check If the AVI is Actually Damaged

Spot a Broken Index

Before you play or convert, rule out genuine file damage. If a player that normally handles AVI well fails, the culprit is often a missing or broken idx1 index. That index tells the player where each frame lives. Without it, players refuse to play or show only a few frames.

VLC is free and plays Xvid and DivX AVI files on macOS. When it hits a broken index, it shows a prompt: "broken or missing AVI index." That prompt means the file is damaged, not just unsupported. Choose to rebuild the index. You can watch the video, but the repair is temporary.

Inspect Without Opening

To check the codec without opening the file, use ffprobe in Terminal. Run ffprobe input.avi. It lists the video codec, such as mpeg4 with the XVID tag, and shows readability. If ffprobe reports errors, the file may be truncated or corrupted.

Play AVI on Mac with VLC or IINA

The quickest free fix is a player that includes its own decoders. VLC plays Xvid and DivX AVI files on macOS with no setup. IINA handles the same codecs and uses the mpv engine for a clean, modern interface.

Right-click the file, choose Open With, and select VLC. If VLC is not listed, open VLC first and drag the file onto its window. When the broken-index prompt appears, rebuild the index. That almost always lets you watch.

IINA works the same way. Drag the file in. It plays Xvid and DivX without touching the original.

Convert AVI to MP4 for QuickTime, IPhone, and IPad

Why MP4 with H.264 and AAC

To play the file in QuickTime or on an iPhone or iPad, convert the AVI to an MP4 file with H.264 video and AAC audio. That combination is what Apple devices play most reliably. Use ffmpeg, a free command-line tool.

Step-by-Step Conversion

  1. Install ffmpeg. With Homebrew, run brew install ffmpeg in Terminal. Or download a static build from the official ffmpeg site.
  2. Open Terminal and navigate to the folder holding your AVI file: cd ~/Movies.
  3. Run the command, replacing the file names:

ffmpeg -i input.avi -c:v libx264 -c:a aac output.mp4

This re-encodes video to H.264 and audio to AAC. The result is an MP4 that QuickTime opens. Conversion takes a few minutes for large files. It is free and adds no watermark.

What About IMovie and Photos?

iMovie and Photos do not import Xvid or DivX AVI files. Drag one in and iMovie shows an error or greys it out. Photos will not display it in your library. This is a supported-format limitation. Convert to MP4 first using the ffmpeg command above, then import normally. The quality stays close to the original, though re-encoding introduces a small generation loss. If you only need to watch, VLC or IINA is faster and leaves the original untouched.

When the File is Truly Corrupt

Work Around a Broken Index

If an AVI fails in VLC or IINA and ffprobe reports errors, the file may be beyond simple repair. A missing index is the most common issue, and VLC can often work around it by rebuilding. A truncated file or one with bad sectors will not play fully in any player.

Salvage What You Can

Try copying the undamaged parts with ffmpeg: ffmpeg -i broken.avi -c copy recovered.mp4. This copies streams without re-encoding but stops at the first error. If that fails, re-encoding may help when the source is partially readable. You can also try online repair tools such as avi.repair, which attempts recovery without a watermark. Success is not guaranteed. No tool replaces a good backup.