Skip to content

docs: cover 5.1.0-beta.1 and beta.2 env vars and config - #106

Merged
gantoine merged 1 commit into
mainfrom
docs/5.1.0-beta-env-vars
Jul 27, 2026
Merged

docs: cover 5.1.0-beta.1 and beta.2 env vars and config#106
gantoine merged 1 commit into
mainfrom
docs/5.1.0-beta-env-vars

Conversation

@gantoine

Copy link
Copy Markdown
Member

Documents the new environment variables, config options, and platforms introduced across 5.1.0-beta.1 and 5.1.0-beta.2.

Env vars

Bumped the pinned romm ref in scripts/sources.toml (master5.1.0-beta.2) and regenerated env-vars.md. Newly surfaced:

Var Release Section
STREAMING_BROKER_SECRET beta.1 Emulator Streaming
STREAMING_SAVE_TIMEOUT beta.1 Emulator Streaming
ROMM_CORS_ALLOWED_ORIGINS beta.2 Authentication
ROMM_SESSION_SECURE_COOKIE beta.2 Authentication
MAX_ASSET_UPLOAD_SIZE_BYTES beta.2 Assets
MAX_AUTOCLEANUP_LIMIT beta.2 Assets

PLAYMATCH_API_URL is commented out in upstream env.template, so the generator skips it; documented in prose instead.

Hand-written additions where they fit the existing structure

  • Per-field artwork priority (beta.1): scan.priority.cover/screenshot/manual in the configuration-file reference.
  • Self-hosted Playmatch (beta.1): PLAYMATCH_API_URL note in metadata-providers.
  • CORS + secure cookie hardening (beta.2): new section in reverse-proxy.
  • Asset upload cap (beta.2): troubleshooting note in uploads (distinct from chunked ROM uploads).

Platforms

Regenerated supported-platforms.md for win9x (beta.1) and steam. This required updating scripts/gen_platforms.py for the upstream move of the generator from backend/utils/ to backend/tools/. Verified the local romm checkout is at 5.1.0-beta.2 + 3 unrelated commits, so the table matches beta.2.

Notes

  • STREAMING_BROKER_SECRET renders a bare - description because its env.template line has no inline comment upstream. It's fully explained in emulator-streaming.md; an upstream comment would tidy the generated table.
  • New API endpoints (music favorites/playlists, streaming sessions, per-file ROM delete) are not added to api-reference.md in this PR.

🤖 Generated with Claude Code

Bump the pinned romm ref to 5.1.0-beta.2 and regenerate the env-vars and
supported-platforms snippets, then document the new env vars and config
options by hand where they fit the existing structure.

- env-vars: STREAMING_BROKER_SECRET, STREAMING_SAVE_TIMEOUT (beta.1);
  ROMM_CORS_ALLOWED_ORIGINS, ROMM_SESSION_SECURE_COOKIE,
  MAX_ASSET_UPLOAD_SIZE_BYTES, MAX_AUTOCLEANUP_LIMIT (beta.2)
- config: scan.priority.cover/screenshot/manual per-field artwork overrides
- metadata-providers: PLAYMATCH_API_URL for self-hosted Playmatch
- reverse-proxy: cookie/CORS hardening behind HTTPS
- uploads: MAX_ASSET_UPLOAD_SIZE_BYTES troubleshooting note
- platforms: regenerate for win9x and steam; fix gen_platforms.py for the
  upstream utils/ -> tools/ move

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@gantoine
gantoine merged commit dd366d8 into main Jul 27, 2026
4 checks passed
@gantoine
gantoine deleted the docs/5.1.0-beta-env-vars branch July 27, 2026 22:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant