Skip to content

Home

Jump to bottom
Kavin T edited this page Feb 13, 2026 · 20 revisions

🎬 MPS for SIMKL

GitHub License PyPI Version Python Versions Platform

What is MPS for SIMKL?

MPS for SIMKL (Media Player Scrobbler) is a cross-platform app that tracks what you watch in supported media players and syncs progress to SIMKL. It supports movies, TV shows, and anime. It runs in the background/tray and works on Windows, Linux, and macOS (experimental).

⚡ Quick Start

  • Windows: Use the Windows Guide (EXE installer, tray app, no commands needed).
  • Linux: Use the Linux Guide (pipx recommended, tray app, setup command needed).
  • macOS: Use the macOS Guide (pip install, tray app, setup command needed, experimental).

After installation, authenticate with SIMKL and configure your media players using the Media Players Guide (this step is critical for accurate tracking).

📚 Documentation

🔍 How It Works

graph TD
    A[Media Player] -->|Playback Info| B[MPS for SIMKL]
    B -->|Extract & Parse| C[Identify Media Title]
    C -->|Search| D[SIMKL API]
    D -->|Metadata| E[Track Progress]
    E -->|>80% Complete| F[Mark as Watched]
    F -->|Update| G[SIMKL Profile]
    style A fill:#d5f5e3,stroke:#333,stroke-width:2px
    style G fill:#d5f5e3,stroke:#333,stroke-width:2px
Loading
  1. Detection: Monitors media players via window titles or player APIs.
  2. Identification: Extracts and matches media titles against SIMKL.
  3. Tracking: Monitors playback position (requires player configuration via Media Players Guide).
  4. Completion: Marks as watched when the configured threshold (default 80%) is reached.
  5. Sync: Updates your SIMKL profile automatically.

📝 License

MPS for SIMKL is licensed under the GNU GPL v3 License. See the LICENSE file for details.

Clone this wiki locally