For client developers

The catalogue is a set of static files. One public index describes every menu; a client downloads it and matches it locally against its own library. Nothing about a library is ever sent anywhere.

The index

v1/index.json, described by its JSON Schema. Within format version 1 fields are only ever added, so ignore fields you don't know. A breaking change would appear under /v2/ and leave /v1/ alone.

• entries[].match is the menu's own match block: item type and provider ids to compare with your library.
• entries[].url is relative to baseUrl. A revision's file never changes and never disappears. Check sha256 before you install it.
• minPluginVersion and features say what a client must support. needsLocalArt lists files the user must supply. hostedArt lists openly licensed files the menu links to at v1/art/<menuId>/ (with their CREDITS.txt); nothing to install for those.
• withdrawn lists menus that were removed, so you can tell a user who installed one.

The menu format

Menus follow the plugin's menu schema. Treat every menu as untrusted: render text as text, never as markup, and build URLs only from validated pieces. The plugin's reference renderer and its tests are in the main repository.

The index right now lists 6 menus, generated 2026-10-29T16:43:27Z.