Advanced MALClient Features Every Power User Should Know

Troubleshooting MALClient: Common Issues and Quick Fixes

1. App won’t open or crashes on launch

• Clear app cache (Settings → Apps → MALClient → Storage → Clear cache).
• Force stop and reopen the app.
• Reinstall the app (uninstall then install latest version).
• If crash persists, check for OS updates; try running on a different device or Android/iOS emulator to isolate.

2. Login fails or authentication errors

• Confirm username/password via MyAnimeList website.
• If using OAuth, revoke and reauthorize MALClient from your MAL account settings, then re-login.
• Check date/time on device (incorrect system clock can break tokens).
• If 2FA is enabled on MAL, ensure app supports it or use web to obtain required codes.

3. Data not syncing / library changes not saving

• Ensure network connectivity (Wi‑Fi or cellular).
• Manually trigger sync in MALClient settings (if available).
• Check for rate limits or API errors (try after a short delay).
• If items revert, export library from website as backup, then re-import or manually reapply changes.

4. Missing covers, images, or metadata

• Clear image cache in app settings (or clear app cache).
• Toggle image download settings (Wi‑Fi only vs cellular).
• Force a metadata refresh for the specific entry or reinstall to refresh databases.
• Verify MyAnimeList entries haven’t been removed or merged on the website.

5. Notifications not appearing

• Verify app notifications are enabled in device settings.
• Confirm notification settings inside MALClient (sync, reminders, release alerts).
• Check battery optimization / background restrictions and whitelist MALClient.

6. Search returns incomplete or incorrect results

• Update MALClient to latest version (search fixes often included).
• Use exact title or try alternate title/language.
• If results are stale, refresh local cache or clear app data.

7. Playback or streaming (if supported) issues

• Ensure required external player is installed and updated.
• Test link in a browser to confirm source availability.
• Disable VPN or proxy that may block streams.

8. Slow performance or high battery use

• Reduce background sync frequency in settings.
• Disable animations or large image downloads.
• Update app and OS; consider reinstalling to clear accumulated data.

9. API or rate-limit errors (e.g., “429 Too Many Requests”)

• Wait and retry after a minute or two.
• Reduce automated sync frequency.
• If using multiple clients or scripts, stagger requests.

10. Account or list discrepancies vs website

• Force a full resync from app settings or reauthenticate.
• Compare timestamps of last sync; export lists from website for authoritative copy.
• Report suspected bugs with screenshots and logs to the app developer.

When to contact support / what to include

• Provide: app version, OS/version, steps to reproduce, screenshots, exact error messages, and recent changes (e.g., OS update, network change).
• Check official support channels or GitHub issues for known bugs before reporting.

If you want, I can convert this into a concise troubleshooting checklist, step‑by‑step repair script, or a one-page FAQ.