Media Support/OS X

From The Document Foundation Wiki
Jump to: navigation, search

This page describes media support provided by LibreOffice on macOS.

HINT: For a summary of supported media types, look at the tables on the Media Support/Summary page.


Extensive testing is the best way to verify media support. If we have any major regressions, we can document our testing here or in Bugzilla.

For the most part, the tables on the main Media Support page can reference the Wiki and Bugzilla. Let's try to use useful identifiers for each test table below so that we can easily link to tests from cells in those tables.

Image Support

Audio and Video Support


On macOS, media support is provided through the QuickTime⁠Wikipedia logo v3.svg multimedia framework up to 10.8, and (potentially?) using AVFoundation framework for 10.9+.

QuickTime default codec support

Apple maintains a list of "media formats and codecs that QuickTime Player can open in macOS v10.6.x or later":

AVFoundation default codec support

Starting in macOS 10.9, tools like QuickTime Player X have moved to use AVFoundation as their backend. As of August 2014, AVFoundation can play all of the default formats supported in QuickTime via the QTMovieModernizer class.

It's unclear how AVFoundation + QuickTime integration will affect LibreOffice.

Adding support for an additional codec

Free/Open Source Codec Support

With the demise of Perian⁠Wikipedia logo v3.svg, there does not appear to be a single QuickTime Component that provides extensive codec support. Some available codec packs include:

Note: These codecs may only work up through macOS 10.8 (see below).

macOS 10.9 Codec Support

Perian appears to work up through macOS 10.8. For 10.9, Apple has made critical changes regarding QuickTime Player X. It appears that QuickTime library/QuickTime Components have been deprecated and are no longer a part of the standard media playback framework.

We've integrated some support for the AVFoundation framework in modern builds. It's unclear what additional work will be necessary to add codecs, etc.

Tor notes in IRC:

the code falls back to the stuff from avmedia/source/macavf if QT
stuff is not available or something like that
IIRC, when I added that AOO code to use AVFoundation, I
explicitly tested removing the QT-related dylibs from the LO
installation, and it then successfully used the AVFoundation ones
instead from my point of view, we could just remove the QT stuff,
if the AVFoundation stuff has the same functionality

(As of August 2014, the AVFoundation codepath does not provide the same functionality)


  • It's possible that Perian and other QuickTime Components may work in 10.9, but we'll need to test this
    • We'll need to make sure that during the test LibreOffice either tries to use QuickTime first, or successfully tries to fall-back and use QuickTime if AVFoundation can't deal with a particular container/codec
  • There's currently no public documentation for adding codecs to AVFoundation. Developers of other products are asking Apple to rectify the problem.
  • Another possible (but temporary) solution would be to use the QTMovieModernizer class to convert media on-the-fly.
    • This is code built-in to QuickTime designed to convert media in a variety of different formats into one of Apple's new 'standard' formats, (e.g. H.264)
    • We haven't done any legwork to see how feasible this conversion might be.
  • Integrating with libvlc is a possibility, but will require more testing and investigation before it can be considered production-ready.

Official Apple-recommended Codec Vendors (Proprietary)

Apple provides detailed instructions for adding new codecs, most (all?) of which are proprietary and cost a fee per device.