Skip to content


Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time


Build Status Contact License: MIT

A library to receive metadata and Open Graph information from URLs.


Hi, we're Awkward. We were looking for a way to visualize information behind links to present these in our iOS reddit client called Beam. We initially used a server to receive metadata, but the server became quite crowded with calls. We built Ocarina as a solution to that problem. Fallbacks for basic HTML tags and Twitter card information make this metadata fetcher unique. We welcome you to use Ocarina for your own projects.


  • Fetching of basic metadata for individual links using the OGP protocol or basic HTML tags (twitter card information also available)
  • Memory cache of metadata for each link
  • Prefetching a set of links to make views more responsive
  • Link information can include: type, title, description, image, image size, favicon, and Apple touch icon


  1. Drag Ocarina.xcodeproj into your project
  2. Go to your project
  3. Select General
  4. Under "Frameworks, Libraries, and Embedded Content" press + and select Ocarina.framework
  5. Select Build Settings
  6. Search for Other Linker Flags and add -lxml2 (Make sure you click "All" at the top instead of "Basic" to see Other Linker Flags)


Fetching information for a single link

let url = URL(string: "")!
url.oca.fetchInformation(completionHandler: { (information, error) in
  if let information = information {
    print(String(describing: information.title))
  } else if let error = error {
    print(String(describing: error))


Prefetching multiple links

OcarinaPrefetcher allows prefetching links into the cache, this allows for the UI to look more responsive.

let urls = [
  URL(string: "")!,
  URL(string: "")!,
  URL(string: "")!,
  URL(string: "")!
let prefetcher = OcarinaPrefetcher(urls: urls, completionHandler: { (errors) in§
  print("Done pre-fetching links")

For other uses, see the example project


Contributing is easy. If you want to report an error of any kind, please create an issue. If you want to propose a change, a pull request is the right way to go.


Ocarina is available under the MIT license. See the LICENSE file for more info.