Getting Started

Setting up your own client

Download an evaluation copy of Pugpig from, and install the package. Use Xcode to generate new new sample application.

In your AppDelegate.m file, find these lines:

  // TODO: Fill in your OPDS endpoint URL here.
NSURL *url =[NSURL URLWithString:@""];

and replace the URL with your own endpoint. For example:

NSURL *url = [NSURL URLWithString:@""];

Put the edition on your server

This page assumes you are putting static files onto the server. If you want to talk to a content management system, have a look at the existing connectors. The structure of the files on the server must follow the format outlined in the Pugpig API.

As a starting point and to understand the format, download the sample server edition and put it onto your server.

You need to have a web server set up that serves the files. For example, the URL to your editions.xml entry point might be something like:http://localhost/example/editions.xml

It is important to note that you must make your .htaccess file writable in order for this to work.

In order to test from the simulator or an iPad, you will need to be able to access this server. If your development machine and iPad are on the same network, you should be able to use your internal IP address to test. In this case, you'd enter something like this into the endpointURL in your code:

Was this article helpful?
1 out of 2 found this helpful
Have more questions? Submit a request


Powered by Zendesk