Skip to content
kavinthangavel edited this page Apr 21, 2025 · 19 revisions

SIMKL Movie Tracker

GitHub License PyPI Version Python Versions

SIMKL Movie Tracker is an automatic scrobbler for SIMKL that tracks your media playback activity across various media players and updates your SIMKL account accordingly.

Features

  • Automatic Tracking: Detects when you're watching media and scrobbles it to your SIMKL account
  • Multiple Media Players: Supports VLC, MPV, MPC-HC, and PotPlayer
  • System Tray Integration: Runs quietly in the background with a convenient system tray icon
  • Cross-Platform: Works on Windows, macOS, and Linux
  • Offline Mode: Records your watched media even when offline and syncs later

Quick Start

  1. Install SIMKL Movie Tracker: pip install simkl-scrobbler
  2. Run the application: simkl-scrobbler
  3. Authenticate with your SIMKL account
  4. Play media in your favorite player
  5. Watch your SIMKL profile update automatically!

Documentation

For detailed information, check out the following sections:

License

SIMKL Movie Tracker is licensed under the MIT License. See the LICENSE file for details.

Clone this wiki locally