by karelia

karelia / iMedia

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

132 Stars 52 Forks Last release: Not found Other 2.0K Commits 47 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


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.