Contributing

We’re excited for all contributions to the Software Index!

Content

The index is built from content uploaded to the Internet Archive. If you have a suggestion for an item we should add, please raise a GitHub issue, send an email, or propose a change.

We’re also starting to explore adding content from live websites, and Wayback Machine archives. If you have suggestions for this type of content, please raise a GitHub issue or send an email.

If you have archives of Psion software that aren’t already on the Internet archive, please consider uploading them. ❤️

Screenshots and Metadata

The Software Index incorporates manually created content, stored in the ‘overlays’ directory. We would love help generating this content; please consider raising a PR, or getting in touch.

Program-specific content is grouped into a folder named with the program’s UID1. For example, the current overlay directory structure looks like this:

Note

The indexer will ignore all text after a space in the top-level folder names allowing you to add comments, as seen in the ‘PacMan’ folder above.

Screenshots

All images in a program’s overlay directory will automatically be treated as screenshots and are alphabetically ordered by filename.

Metadata

Metadata is stored in ‘index.md’ Markdown files with Frontmatter, and is limited to specific known keys.

For example, the metadata for PacMan is as follows:

---
subtitle: PacMan clone
category: games/arcade
publishers:
- Neuon
authors:
- Jérôme Dern
developer_url: https://neuon.com
---

Published by Neuon, PacMan is a clone. It's let down a little by EPOC’s redraw and animation speed, and the difficulty ramps quite unexpectedly.

Supported metadata fields are as follows:

All fields are optional.

  1. You can find program UIDs under the title of program-specific pages in the index. They are an 8-digit hexadecimal number, beginning 0x. ↩