Skip to content

v1.2.1 — Critical hotfix for v1.2.0 (XML serializer crash)

Choose a tag to compare

@ZL154 ZL154 released this 16 Apr 21:54

CRITICAL FIX — install this if you tried v1.2.0

v1.2.0 had a serialization bug that crashed every HTTP request to Jellyfin (white-screen web UI). Root cause: `PluginConfiguration.UserEmailAddresses` was a `Dictionary<>` and Jellyfin's XML serializer can't handle dictionaries. Adding the new `TotpIssuerName` field in v1.2.0 made Jellyfin try to rewrite the config on every request, hitting the crash inside `RequestBlockerMiddleware`.

Fix: the per-user email storage is now an XML-serializable list. v1.2.0 has been pulled from the catalog.

Recovery steps if you're stuck on v1.2.0

If your Jellyfin is white-screened:

  1. Stop Jellyfin
  2. Delete the v1.2.0 plugin folder under `/plugins/TwoFactorAuth_*`
  3. Start Jellyfin → web UI works again
  4. Plugins → Catalog → install Two-Factor Authentication v1.2.1
  5. Restart Jellyfin

Note on per-user emails

The on-disk storage shape changed (Dictionary → List), so any per-user email addresses you had configured in v1.1.0 may not load. Admins should re-enter them in plugin Settings → Users tab.

All v1.2.0 features (Quick Connect passthrough, Test SMTP, self-service email, recovery warning, custom issuer name, Pairings tab guidance) are included.