What is a WEBM file and how do you open it on a Mac

A WEBM file is a video container designed for web browsers, usually holding VP9 or AV1 video with Opus audio. QuickTime Player and Photos cannot open it, but Chrome and Firefox can: drag the file into a browser window and it plays. To edit it, import it into Photos or send it to someone who might not have a browser handy, convert it to MP4.

Where WEBM came from

WEBM was introduced in 2010 as a royalty-free alternative to MP4 for video on web pages. It is a trimmed-down version of the Matroska container (the same family as MKV) restricted to a short list of open codecs: VP8, VP9 and AV1 for video, Vorbis and Opus for audio. Every major browser except Safari adopted it quickly, and because the codecs cost nothing to license, it became the default output for anything that records video inside a browser.

That is why the files turn up on your Mac. Common sources include:

• Screen or webcam recordings made by a web app rather than a native one (the browser’s built-in recorder writes WEBM).
• Video clips downloaded from sites that serve VP9 to save bandwidth.
• Animated stickers, reaction clips and GIF replacements from chat and forum software.
• Exports from browser-based design and animation tools.
• Recordings from online meeting tools that run entirely in a tab.

The file is not unusual or suspicious. It is simply built for the web rather than for Apple’s media frameworks.

Why your Mac says it cannot open it

macOS relies on a system framework called AVFoundation for video, and AVFoundation has never supported VP8 or VP9. QuickTime Player, Preview, Photos, iMovie, Quick Look and Finder thumbnails all sit on top of it, so they all fail together. Double-click a WEBM and you get “The document could not be opened”, or a generic icon and no preview.

AV1 is a partial exception. Newer Apple silicon Macs on recent macOS can decode AV1 in hardware, and Safari can play some AV1 WEBM files, but support is uneven enough that you should not count on it.

The important point: the file is almost certainly fine. This is a missing decoder, not damage. Container vs codec: why an MP4 can still refuse to play explains the distinction in more depth.

The quickest way to watch it: use a browser

Since WEBM was designed for browsers, a browser is the easiest player on a Mac.

1. Open Chrome, Firefox or another non-Safari browser.
2. Drag the WEBM file from Finder into the browser window, or press Command-O and choose the file.
3. The video plays with standard controls. Right-click the video for loop and picture-in-picture options.

Safari supports WEBM playback on recent macOS versions for VP8 and VP9, but not consistently across every file, so try another browser first if Safari shows a blank frame.

A third-party media player that bundles its own decoders will also play WEBM directly. That is worth installing if you meet these files often, but it does not help when the destination is Photos, an editor or a recipient’s phone.

When watching is not enough: convert to MP4

Browsers solve playback. They do not solve sharing, editing or archiving. For those you want an MP4 with H.264 video, which every device plays.

Because VP9 and Opus cannot be placed inside an MP4 that Apple’s frameworks will accept, this conversion has to re-encode both streams rather than simply rewrap them. It takes longer than a remux (roughly real time or faster on Apple silicon) and involves one generation of compression, though at a sensible bitrate the result looks the same as the source.

Manatee does this in one step:

1. Drag the WEBM onto the Manatee icon in the menu bar, or open the window and drop it in the zone.
2. Choose Convert and pick MP4 as the target (MOV is also available if an Apple editor prefers it).
3. Wait for the job in the list to finish. The new MP4 is written next to the original; the WEBM is never modified.
4. Open the MP4 in QuickTime Player to confirm it plays with sound.

If the file also needs to go under an email or chat limit, use Shrink instead: name a size in MB and Manatee finds the quality that fits while producing an MP4. Manatee does not trim clips or remove sections; it converts whole files. The step-by-step article is How to convert WEBM to MP4 on a Mac.

Getting the audio out, or a GIF

Two other common requests for WEBM files:

• Audio only: a WEBM from a voice memo web app or a podcast tool may contain only an Opus audio track. Convert it to MP3 or M4A in Manatee to play it in Music or attach it to a message; WAV and FLAC are available if you want no further loss.
• A GIF for a message or a page: choose GIF as the target. Keep it short, since GIF files grow quickly with every second of footage.

A WEBM that will not play anywhere

If a browser shows nothing, or plays a few seconds and stops, the file is probably incomplete rather than incompatible. Browser recorders write WEBM as they go, and a tab closed before the recording finished can leave a file with no duration in its header. Manatee’s Repair mode accepts WEBM and tries to rebuild the index so the playable portion can be recovered, reporting Fixed, Partial (with how much was saved) or Not fixable. It cannot recover frames that were never written. See Video file is 0 bytes or shows the wrong length: can it be fixed? for the symptoms to look for.

Questions

Is WEBM lower quality than MP4? No. VP9 and AV1 are at least as efficient as H.264 and often better. Quality depends on the bitrate the creator chose, not on the container.

Can I change the extension to .mp4? No. The internal structure is Matroska, and renaming does not change that. Players that read the header will refuse, and those that trust the extension will fail when they reach the VP9 data.

Why does Safari play some WEBM files and not others? Safari’s WEBM support covers VP8 and VP9 but depends on the macOS version and the exact way the file was written. Files from browser recorders sometimes omit details Safari expects. Chrome and Firefox are more forgiving.

Will Photos import a WEBM? No. Convert to MP4 or MOV first; Photos imports either of those.