# 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="/files/hmGlBcbQ5F5NOSxgVpik" 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="/pages/LWnTj9othi0Uhw9ANvMk" %}
[Browser Extensions](/how-to-use-simkl/advanced-usage/platform-integration/browser-extensions.md)
{% endcontent-ref %}

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

***

### How Does It Works

<figure><img src="/files/xSKBNy8X6rGOqSSv5U6f" 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="/files/IGtJPBRgetKKnu64TlVF" 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="/files/urDcaKQ5Xi37x360iibl" alt=""><figcaption></figcaption></figure>

***

### Usage Instructions

<figure><img src="/files/La6I87zDp9MkFaS2cK3Z" 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!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.simkl.org/how-to-use-simkl/advanced-usage/platform-integration/linking-simkl-with-popular-media-centers/media-player-trackers/windows-tv-tracker.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.