- Python 92%
- Jinja-like 7%
- HTML <1%
- Shell <1%
Wzrdz accounts #
Application source for the shared wzrdz account page and login broker. Extracted
from emu/jellyfin_oidc and wzrdz-infra/login-theme/templates on 2026-09-19.
The Python package remains jellyfin_oidc to preserve runtime import paths.
This repository owns account behavior, templates, and tests. wzrdz-infra owns
deployment/routing, service configuration, PDS operations, shared theme assets,
and platform requirements. Books and other applications own their integrations.
Current functionality: Jellyfin-backed OIDC for registered clients, the shared apex account session, login/logout, and current-password-verified password changes. AT identity linking, membership storage, invitations, and PDS enrollment are planned; they are not implemented by this extraction.
Development #
Requires Python 3.12+ and uv.
uv sync --locked
uv run --locked pytest
uv run --locked ruff check jellyfin_oidc tests
uv run --locked mypy
uv build
sh scripts/check.sh runs all checks, including an isolated installed-wheel
check. Tangled Spindle uses this same entry point. Mypy checks production code;
the full test suite is executed by pytest.
Tests use mocked Jellyfin requests and temporary signing keys. The optional browser smoke script is documented in validation.
Runtime #
The existing service command continues to work:
uv run --locked --no-dev uvicorn jellyfin_oidc.main:app --host 127.0.0.1 --port 11801 --no-access-log
Load configuration through the service environment, not a committed file:
| Variable | Meaning |
|---|---|
OIDC_ISSUER |
Existing public issuer, https://login.wzrdz.cool/oidc in production |
OIDC_CLIENT_ID, OIDC_CLIENT_SECRET, OIDC_REDIRECT_URIS |
First registered client and exact comma-separated callback allowlist |
OIDC_CLIENTS |
Optional JSON array of additional registered clients |
JELLYFIN_URL |
Jellyfin authentication endpoint origin |
ACCOUNT_ORIGIN |
Shared account origin, https://wzrdz.cool in production |
KEYS_DIR |
Persistent directory containing the existing signing key |
ACCOUNT_SESSIONS_DB |
Optional persistent SQLite path; defaults to KEYS_DIR/account-sessions.sqlite3 |
OIDC_INTERNAL_BASE |
Optional internal endpoint base |
SUBLIB_URL |
Optional legacy Sublib session verification origin |
EMAIL_DOMAIN |
Legacy synthetic email claim domain; not a verified contact address |
The native production service remains under /opt/wzrdz-login. Preserve its
environment, signing key, client registration, issuer, subjects, and authoritative
proxy headers. Central browser sessions now persist across restarts using SQLite.
See session persistence for storage and rollout
requirements. Source changes alone do not deploy the running service.
Source and release ownership #
Edit Python code and account templates here. Do not reapply legacy template overrides from infrastructure after packaging this application. Shared CSS and assets continue to load from the existing wzrdz theme origin.
Tangled is the canonical host selected for this repository:
git@tangled.org:did:plc:onq6zpplpjdichh3fxustyho.
The Spindle workflow invokes the same local validation commands; it does not
deploy the service or receive production credentials.
See extraction provenance for history, source verification, and the remaining deployment cutover. No credentials or live configuration are included in this repository.
Multi-machine setup: development instructions.
Run python3 scripts/check-checkout.py before starting work or pushing.
Production deployment #
Main pushes validate and then invoke the infrastructure-owned Accounts receiver
with the dedicated ACCOUNTS_DEPLOY_SSH_KEY Tangled secret. Missing credentials
are explicitly reported as setup pending. Pull requests validate only.
Ordinary code/template releases preserve central sessions and roll back code on
failed health checks. Dependency or database-schema changes require operator
rollout; see wzrdz-infra/docs/accounts-deployment.md.
The shared header and inline Central StarLines icon are vendored from infra's
theme/components/header.html and theme/v1/link-star.svg. Refresh them with
python3 theme/sync-components.py ../wzrdz-accounts from the infra checkout.