FAQ

  1. How do I install OPL programs?
  2. Where can I find OPL programs to try out?
  3. Why aren’t databases supported?
  4. How should I go about reporting problems?
  5. What OPX libraries are supported?
  6. Why do the graphics sometimes look wrong?

How do I install programs?

OPL supports open-in-place for Psion installers (SIS files), allowing you to install programs directly from iCloud Drive using the Files app on your iPhone or iPad.

  1. Add the installer to iCloud Drive, or download it directly to your iPhone.

  2. Navigate to the installer in the iOS Files app, and tap on the installer (JUMPY!.SIS in the example):

  3. Select the destination you’d like to install your program to and tap ‘Next’:

  4. If everything has gone to plan 🤞, you should see a summary screen displaying the icon of your newly installed program:

    Tap ‘Done’ to reveal the program in OPL.

  5. Tap the program icon to run it:

If you don’t have an installer for the program and only have eg a ZIP of the app directory, you will have to manually construct the correct filesystem layout to be recognized as an program bundle, copy that bundle to eg an iCloud Drive location, then add that location to OpoLua using the “+” toolbar item on the Library screen. The correct layout for an OPL program bundle is:

<appname>.system
|- c
   |- System
      |- Apps
         |- <appname>
            | files for the app go here, such as <appname>.app, <appname>.aif etc

You must make a separate bundle for each program; installing multiple programs in a single bundle is not currently supported.

Where can I find OPL programs to try out?

There are a number of sites with links and downloads that might be useful, and the Internet Archive hosts copies of a number of publishers’ sites that are no longer available anywhere else online.

Here are some we’ve found useful:

Needless to say, this isn’t a comprehensive list and we would love to hear about sites we’ve missed.

Fortunately, most OPL software was shareware and many authors have made license codes freely available after-the-fact, but please remember that downloading copies of commercial software you have not purchased is illegal. We do not encourage or condone the use of illegally obtained software.

Why aren’t databases supported?

The Psion database format is complex and unfriendly so we’ve decided not to try adding support for it just yet–there are a lot of programs that don’t require database support and we’d like to improve our support for those before tackling this mammoth task. We’re tracking this as issue #203.

If you’re a developer interested in taking on the challenge, please feel free to get in touch; we welcome contributions and pull requests.

How should I go about reporting problems?

GitHub Issues are the best way for us to track and triage problems and feature requests. Please check for any existing issues before raising a new one–if you don’t find one, we’d love to hear your thoughts.

We’re happy to receive issues with as much or as little information as you are able to give (something is better than nothing) but, where possible, please try to provide:

What OPX libraries are supported?

OPX libraries are native C/C++ libraries that OPL programs can use. The following built-in and commonly used OPX libraries are supported:

Why do the graphics sometimes look wrong?

We don’t currently fully support invert draw mode, meaning that programs that make use of this (often to improve performance or simulate transparency) will look a little strange. We’re tracking this on GitHub as issue #121.

You can see this issue clearly in Asteroids by Phil Gooch & Neuon, which uses this mode to draw the asteroids:

Screenshot of Asteroids running in OPL for iOS