This guide helps you solve common problems with MPS for SIMKL.

• For installation issues, see the Windows Guide, Linux Guide, or Mac Guide.
• For player setup, see the Media Players Guide.

• Run simkl-mps init --force to reset authentication.
• Check your internet connection.
• For Windows EXE: restart app from Start menu.

• Use clear filenames: Movie Title (Year).ext.
• Configure your player (Media Players Guide).
• Some players may hide titles in fullscreen.
• Run with debug logging: simkl-mps tray --debug.

• See Media Players Guide for all player setup steps.
• For VLC, MPV, MPC-HC/BE, etc: follow the exact configuration steps.

• Tray icon missing: check hidden icons or restart app.
• For Windows, see Win Guide for common errors
• For Linux, see Linux Guide for tray troubleshooting.
• For Mac, see Mac Guide for permissions and tray info.

• Run installer as Administrator.
• Check antivirus if blocked.
• Try reinstalling if issues persist.

• Ensure all dependencies are installed (see guides).
• For tray issues, see desktop environment notes in Linux Guide or Mac Guide.

• Run with debug logging: simkl-mps tray --debug.
• Check logs for errors:
  • Windows: %APPDATA%\kavinthangavel\simkl-mps\simkl_mps.log
  • macOS: ~/Library/Application Support/kavinthangavel/simkl-mps/simkl_mps.log
  • Linux: ~/.local/share/kavinthangavel/simkl-mps/simkl_mps.log

• Check GitHub Issues.
• Open a new issue with OS, app version, logs, and steps to reproduce.