# Windows TV Tracker

Keep your watch history accurate without lifting a finger. The **Simkl TV Tracker** app for Windows automatically detects and scrobbles TV episodes and anime you play on your PC’s media players, ensuring your Simkl profile stays up-to-date.

<figure><img src="https://1063116720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkYIJb2JfKN8kBT29bf%2Fuploads%2Fi4rmCMWjywXG46iwakaY%2Fimage.png?alt=media&#x26;token=76e7bbc1-74af-446a-8e0e-46d4899c3890" alt=""><figcaption></figcaption></figure>

{% embed url="<https://simkl.com/apps/windows/simkl-tv-tracker/>" %}

***

### What Is Simkl TV Tracker?

Simkl TV Tracker is a lightweight Windows application (beta) that:

* **Auto-Detects Viewing**: Monitors popular media players to identify TV show and anime episodes.
* **Scrobbles to Simkl**: Sends your watched progress directly to Simkl’s API once you reach defined thresholds.
* **Supports Downloaded Files**: Works with files on your computer—perfect for offline or iTunes content.

***

### Supported Platforms & Players

* **Operating Systems**
  * Windows 7, 8, 10 (32-bit and 64-bit)
* **Media Players**
  * VLC (recommended), KMPlayer, GOM, iTunes, MPlayer, RealPlayer, DivX Plus, Windows Media Player, PowerDVD, BSPlayer, Winamp, MPC-HC, AVS Media Player, FLVPlayer4Free, et al.
* **File Types**
  * Standard: `.avi`, `.mkv`, `.mp4`, `.m4v`
  * Partial Downloads: `.crdownload`, `.part`, `.ts`

{% content-ref url="../../browser-extensions" %}
[browser-extensions](https://docs.simkl.org/how-to-use-simkl/advanced-usage/platform-integration/browser-extensions)
{% endcontent-ref %}

{% embed url="<https://chromewebstore.google.com/detail/enhancer-for-netflix-crun/dbpjfmehfpcgmlpfnfilcnhbckmecmca>" %}

***

### How Does It Works

<figure><img src="https://1063116720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkYIJb2JfKN8kBT29bf%2Fuploads%2FjNvKiCIHI0TnsCkMlpUW%2Fimage.png?alt=media&#x26;token=2d963c06-4ae2-4a79-9c9c-206c7299d984" alt=""><figcaption></figcaption></figure>

1. **Driver & Tracker**
   * A background **driver** monitors all video files opened on your PC.
   * The **Tracker app** reads file metadata (e.g., filename, metadata tags) and matches it against Simkl’s database.
2. **Detection & Scrobbling**
   * When you start an episode, the Tracker displays a small popup (bottom right corner) identifying the show and episode number.
   * If you watch **70%** or more, the Tracker sends a “watched” ping to Simkl’s API.
   * If you close the player before reaching 70%, the episode may still be scrobbled once Playback stops.
3. **Taskbar Icon Indicators**
   * Running, waiting for video file
   * Trying to detect video file
   * Detected TV Show & episode (awaiting 70% watched)
   * &#x20;Could not detect this video file
   * Marked episode as watched

***

### Installation Guide

<figure><img src="https://1063116720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkYIJb2JfKN8kBT29bf%2Fuploads%2FoxKxPkteEJYrgrnlmOa7%2Fimage.png?alt=media&#x26;token=6489d74a-8380-40a1-9fd3-837e740047ae" alt=""><figcaption></figcaption></figure>

1. **Download Personal Installer**
   * Visit **Apps → Automatic Trackers → TV Tracker** on Simkl (<https://simkl.com/apps/windows/simkl-tv-tracker/>)&#x20;
   * Click **Download** (includes your unique account key).
2. **Run Installer**
   * Double-click the downloaded `.exe` file.
   * Wait for it to install and you are done!

<figure><img src="https://1063116720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkYIJb2JfKN8kBT29bf%2Fuploads%2FVh5RX11VWuaX8OdfMyYf%2Fimage.png?alt=media&#x26;token=dd45afb9-372f-4bd9-be3f-00d927b2d11e" alt=""><figcaption></figcaption></figure>

***

### Usage Instructions

<figure><img src="https://1063116720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkYIJb2JfKN8kBT29bf%2Fuploads%2F7Nm5fs00mT7fUVnIRu59%2Fapps_tracker_demo_popup.png?alt=media&#x26;token=edac8260-0ab2-422f-a562-770262e82847" alt=""><figcaption></figcaption></figure>

1. **Open a TV Episode File**
   * Play any supported file in your favorite media player.
   * A detection popup appears after \~7–15 seconds (longer for rare anime).
2. **Watch & Scrobble**
   * Let the episode play until at least **70%** is buffered.
   * Tracker auto-marks the episode as watched on Simkl.
3. **Managing Issues**
   * If no popup appears, ensure:
     * The file name includes the show’s title and episode number (e.g., `Show.Name.S02E05.mkv`).
     * Supported media player and file type.
   * **Driver Freeze Workaround**:
     * Uninstall conflicting **Microsoft Visual C++** versions via Control Panel → Programs & Features.

***

### Known Limitations

* **Movies Not Scrobbled**: Only TV shows and anime episodes are tracked.
* **Beta Version**: May contain bugs—please report any issues on Simkl’s Discord `#bugs-tracker`.
* **Mac, iOS, Android**: Coming soon! For now, Manual and Chrome Extension tracking serve macOS and mobile users.

***

### Troubleshooting Tips

* **No Detection Popup**
  * Rename your file to match `Show.Title.S01E01` format.
  * Switch to VLC for best detection success.
* **App Freezes**
  1. Open **Control Panel → Programs & Features**.
  2. Uninstall all **Microsoft Visual C++** redistributables.
  3. Reinstall the Tracker app.
* **Partial File Detection**
  * If playing `.crdownload` files, ensure they’re >70% complete for correct scrobbling.

***

With Simkl TV Tracker, build a fully automated, accurate watch history without manual checkmarks. Enjoy seamless tracking across your Windows PC!