owncast

This is a known built-in bug of Owncast v0.2.5 affecting both favicon upload and reset functions. The backend incorrectly returns a 401 Unauthorized non-JSON response for these endpoints, which triggers the frontend JSON parsing error, and causes repeated admin credential prompts even if you enter valid login information. The fix has been merged in pull request #4879, upgrade to an official Owncast release newer than v0.2.5 to resolve this issue.

This affects Owncast 0.3.0+ with next-export-i18n up to 2.4.3. Its useSelectedLanguage() reads window.localStorage.getItem("next-export-i18n-lang") without a guard, even when languageDataStore: 'query' is configured. A null localStorage in Android WebView or a SecurityError in a third-party iframe therefore crashes the React tree.

Android WebView workaround:

webView.settings.domStorageEnabled = true

webView.getSettings().setDomStorageEnabled(true);

Permanent Owncast fix: install an in-memory Storage shim before React renders, such as at the top of pages/_app.tsx or in a module imported first:

if (typeof window !== 'undefined') {
  const createMemoryStorage = (): Storage => {
    let data: Record<string, string> = {};
    return {
      getItem: key =>
        Object.prototype.hasOwnProperty.call(data, key) ? data[key] : null,
      setItem: (key, value) => {
        data[key] = String(value);
      },
      removeItem: key => {
        delete data[key];
      },
      clear: () => {
        data = {};
      },
      key: index => Object.keys(data)[index] ?? null,
      get length() {
        return Object.keys(data).length;
      },
    };
  };

  try {
    if (!window.localStorage) throw new Error('localStorage is unavailable');
    window.localStorage.getItem('__owncast_storage_test__');
  } catch {
    Object.defineProperty(window, 'localStorage', {
      configurable: true,
      value: createMemoryStorage(),
    });
  }
}