xteink-apps/README.md

Xteink Apps

App repository for CrossPoint Reader's Lua AppStore.

Catalog URL:

https://gitea.va.reichard.io/evan/xteink-apps/raw/branch/main/catalog.txt

Layout

catalog.txt
<AppId>/
  manifest.txt
  main.lua
  ...
scripts/update-manifests.py

catalog.txt is line-oriented:

XTEINK-CATALOG|1
<AppId>|<description>|<manifest path>|<manifest bytes>|<manifest SHA-256>

Each generated manifest.txt contains every installable file in that app:

XTEINK-MANIFEST|1
<relative path>|<bytes>|<SHA-256>

App IDs and file paths cannot contain |. App IDs use only letters, numbers, _, and -. Descriptions come from the -- DESCRIPTION: line in each main.lua.

Adding or changing an app

1. Add or edit an app directory containing main.lua.

2. Regenerate metadata:

   scripts/update-manifests.py
   

3. Verify generated files are current:

   scripts/update-manifests.py --check
   

Commit app payloads, manifests, and catalog.txt together.

Included apps

• HomeAssistant — Edit its installed config.txt with your URL, long-lived access token, and entity IDs. The repository contains placeholders only.
• Wordle — Includes its five-letter candidate list in words.txt.