Need help with iMedia?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

131 Stars 52 Forks Other 2.0K Commits 55 Opened issues


The Karelia iMedia Browser, framework and application for browsing media on Mac OS X

Services available


Need anything else?

Contributors list


This is the iMedia Browser framework that is used by a number of applications (and as the basis for a stand-alone utility). Developers are encouraged to include this in their application as long as there is proper attribution.


iMedia 2.6 and later is compatible with common sandboxing setups, with the following notes:

  • Search the headers for
    to make sure your app has the entitlements iMedia needs
  • Users must house their media within the standard Movies, Music and Pictures folders, or grant access to them by dragging in custom folders
  • iMovie Sound Effects have been removed on the basis that Apple doesn't want us poking around another app's resources

There is also a longer-term effort in the

fork to farm out parsing to XPC processes.



The same as 2.6, minus support for Garbage Collection.


Out of the box (the

branch), iMedia supports OS X 10.6 Snow Leopard and later. It is suitable for both 32 and 64 bit apps. See above for sandbox compatibility details.


Basically the same as 2.6, minus sandbox compatibility.


For apps still supporting OS X 10.5 Leopard, we continue to support the existing iMedia 2.1 codebase on the



For the older 1.x branch, which is not being maintained, you can get it from subversion:

svn checkout imedia-read-only

Recent Release Notes


  • The
    +[IMBConfig registerDefaultValues]
    method has been made private. You should have no need to call it in your app as
    automatically runs that routine the first time it is used


  • When dragging or copying iPhoto images, we mimic iPhoto by also including
    on the pasteboard. This allows iPhoto-aware apps to properly handle image metadata without any knowledge of iMedia


  • +[NSImage imb_imageForResource:fromAppWithBundleIdentifier:fallbackName:]
    . Apps likely shouldn't use this method anyway as it's fairly iMedia-specific. The new method nicely returns retina-compatible images if a suitable name is specified, like the other Cocoa image APIs.


  • -[NSWorkspace imb_iconForAppWithBundleIdentifier:]
    has been removed. Its fallback mechanism was buggy and relied on private implementation details in the OS frameworks, which have since broke. If you are using this method in your app, provide your own implementation instead


  • iMedia is now roughly compatible with the OS X app sandbox. See Sandboxing section above for full details
  • A few public APIs have been removed or changed in the process, but chances are you weren't using them, or the replacement is dead obvious in the headers


Developers are welcome to work on enhancements and fixes! Please use the GitHub issue tracker; note that we are not done migrating issues from the old Google Code issue tracker.

There are plenty of things that need to be done, and your help would be appreciated!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.