Specification · Version 1

PSPDX standard

Two small JSON files that let a PSP install and update homebrew by itself

Version
1 — schema URLs are permanent
Schemas
https://chriopter.github.io/pspdx/schema/pspdx-v1.json
https://chriopter.github.io/pspdx/schema/catalog-v1.json
Updated
2026-09-16
Source
chriopter/pspdx

→ Read the specification • → Get the PSPDX App

PSP homebrew is scattered over GitHub, forums and old archives, and installing or updating it takes a PC. With PSPDX, apps describe themselves in their repositories and catalogs fill in for the rest, so the PSP can find, install and update them directly.

Overview#

Three parts: an app is a homebrew, ideally with a .pspdx in its repository; a catalog is a catalog.json that lists many apps; and a client such as PSPDX on the PSP reads both.

flowchart RL
  P["PSPDX app<br/>on the PSP"]
  C["catalog.json<br/>apps and their releases"]
  R["App location<br/>with optional .pspdx"]
  P -- browses --> C
  C -- points to --> R
  R -- install and update --> P

How it works

Specification#

.pspdx

One app, in the root of its repository.

Schema

Fields and rules · .pspdx

Loading the fields…

Example · a minimal .pspdx 
{
  "schema": "https://chriopter.github.io/pspdx/schema/pspdx-v1.json",
  "source": "https://github.com/chriopter/pspdx-demo",
  "name": "PSPDX Demo",
  "category": "demo",
  "summary": "Hello, PSP. A demo listing for PSPDX."
}

catalog.json

A list of many apps with their releases and pictures. For an abandoned app, the entry holds the fields its .pspdx would have.

Schema

Fields and rules · catalog.json

Loading the fields…

Example · a catalog.json with one app 
{
  "schema": "https://chriopter.github.io/pspdx/schema/catalog-v1.json",
  "generated_at": "2026-09-14T22:25:44Z",
  "apps": [
    {
      "id": "io.github.chriopter.pspdxdemo",
      "source": "https://github.com/chriopter/pspdx-demo",
      "name": "PSPDX Demo",
      "category": "demo",
      "installdir": "PSP/GAME/PSPDXDemo",
      "summary": "Hello, PSP. A demo listing for PSPDX.",
      "author": "chriopter",
      "license": "MIT",
      "languages": ["en"],
      "description": "A hello world for the PSP, published the way a listed app is: a .pspdx in the repository, a release with the EBOOT.\nX says hello again, HOME leaves.",
      "releases": [
        {
          "tag": "v0.1.2",
          "published_at": "2026-09-12T23:20:26Z",
          "url": "https://github.com/chriopter/pspdx-demo/releases/download/v0.1.2/pspdx-demo.zip",
          "size": 123707,
          "sha256": "cb5737fbf5aae1fcbcfcdbc7dcc85d761559d4c21a83b8366d39c227598273e4",
          "eboot_md5": "5d7f8a921fb99b5df2560ffade01d4b4",
          "changelog": "**Full Changelog**: https://github.com/chriopter/pspdx-demo/compare/v0.1.1...v0.1.2"
        }
      ],
      "media": {
        "icon": "apps/io.github.chriopter.pspdxdemo/icon-f39ad127.png",
        "screenshots": [
          "apps/io.github.chriopter.pspdxdemo/picture-3d60f75d.png"
        ],
        "video": "apps/io.github.chriopter.pspdxdemo/film-a4eb3006.pmf",
        "sound": "apps/io.github.chriopter.pspdxdemo/sound-90636786.at3"
      }
    }
  ]
}

Implementations#