Usage

🎮 Usage Guide

This guide explains how to use MPS for SIMKL to track your movies and sync with your SIMKL profile.

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

🏁 Getting Started

1. Install the app for your platform (see guides above).
2. Authenticate with SIMKL on first run.
3. Configure your media players (see Media Players Guide).
4. Play movies in your configured player. The app tracks and syncs progress automatically.

🖥️ Windows (EXE)

• Just install and launch. The app runs in the tray —no commands needed.
• Use the tray icon for status and controls.

🐧 Linux (pipx)

• Install with pipx (see Linux Guide).
• Start with simkl-mps tray or simkl-mps start.
• Tray icon provides controls and status.

🍏 Mac (pip, untested)

• Install with pip (see Mac Guide).
• Start with simkl-mps tray or simkl-mps start.
• Tray icon provides controls and status.

Note: Mac support is experimental and untested.

🛠️ Common Operations

• Tray: Right-click for menu, status, and tools.
• CLI:

  simkl-mps start        # Start in background
  simkl-mps tray         # Start with tray UI
  simkl-mps status       # Check status
  simkl-mps stop         # Stop the app
  simkl-mps --help       # Help

📝 Tips

• Always configure your media players for best results (Media Players Guide).
• Use clear filenames: Movie Title (Year).ext.
• For troubleshooting, see the Troubleshooting Guide.
• For advanced options, see Advanced & Developer Guide.
• For planned features, see the Todo List.