Skip to content

game-scrobbler/gs-playnite

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

325 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GameScrobbler — Playnite Plugin

GitHub license GitHub release GitHub downloads Build GitHub issues GitHub pull-requests GitHub contributors .NET Framework Discord

Track, analyze, and visualize your gaming life — like Last.fm, but for games.

GameScrobbler is the official Playnite plugin for the GameScrobbler platform. It automatically tracks your play sessions, syncs your library, and turns your gaming data into interactive analytics, visual maps, and AI-powered insights.

Instead of a static list of games, your library becomes a living profile of how you actually play — across every platform Playnite manages.

GameScrobbler Demo


Install

Install from Playnite (recommended)

  1. Open Playnite
  2. Go to Addons -> Browse
  3. Search GameScrobbler
  4. Click Install

Manual installation

Download the latest .pext from the releases page, then install via Playnite -> Addons -> Install from file.


Supported Platforms

Playnite aggregates games from many launchers. GameScrobbler tracks everything Playnite sees, including games from:

Steam, GOG, Epic Games, Xbox, PlayStation, Battle.net, Ubisoft Connect, itch.io, Humble, Amazon Games, and more.

You can also link your GameScrobbler account to Steam and Discord at gamescrobbler.com, with more platforms coming soon.


Features

All features are accessible inside Playnite through the embedded sidebar dashboard and on the web at gamescrobbler.com.

Universe

Interactive graph visualizations of your gaming library. Games, genres, platforms, companies, and themes form a force-directed network that reveals your play patterns at a glance.

Play Timeline

Track your gaming sessions over time. See when you were most active, which games dominated specific periods, and how your habits evolve.

Dossier

AI-generated gaming personality profile. GameScrobbler analyzes your play history and produces an archetype, playstyle breakdown, and personality insights.

Chat With Your Library

Ask natural language questions about your gaming habits.

Examples:

  • What genre do I play the most?
  • Which games did I abandon halfway?
  • What should I finish next?

For You

Personalized game recommendations based on your library and play patterns, with similarity scores and reasons for each suggestion.

AI Roast

Humorous AI-generated commentary about your gaming habits.

You own 287 games. You have finished 19. Your backlog now qualifies as a museum.

Stats

17 analytics charts covering genres, themes, platforms, companies, franchises, release years, game modes, playtime trends, and more.

Library

Full game collection view with achievement rarity tracking, sortable by playtime, and switchable between grid and table layouts.

Social

Steam friends, Discord servers, and linked accounts — all visible in one place.


Screenshots

Universe (Mind Map)

Gamer Mind Map

Play Timeline

Play Timeline

Chat With Library

Chat With Library

AI Roast

AI Roast


How It Works

  1. You play a game — the plugin records the session automatically
  2. Your library, playtime, and achievements sync to GameScrobbler
  3. AI and analytics generate insights, visualizations, and recommendations
  4. View everything in Playnite's sidebar or at gamescrobbler.com

Link your GameScrobbler account to connect data from other platforms (Steam, Xbox, PlayStation, etc.) into one unified profile.


Public API & MCP

GameScrobbler exposes a read-only public API and an MCP server for AI agents.

REST API

Base URL: https://api.gamescrobbler.com/api/v1/public

Endpoint Description
GET /library/{token} Paginated game library
GET /insights/{token} Player archetype, stats, top genres
GET /recommendations/{token} Personalized game recommendations
GET /mind-map/{token} Force-directed graph of your gaming profile
GET /docs Interactive API documentation
GET /openapi.json OpenAPI 3.0.3 specification

Authentication is via a profile token (no API key needed). Rate limit: 30 requests per minute.

MCP Server

Endpoint: POST https://api.gamescrobbler.com/api/v1/public/mcp

Provides 5 tools for AI agents: get_game_library, get_player_insights, get_recommendations, get_mind_map, and get_profile_summary. Compatible with Claude, ChatGPT, and other MCP clients.

Auth via x-profile-token header or profile_token parameter.


Achievement Sync

GameScrobbler can aggregate achievement progress from multiple Playnite addons.

Supported providers:

The plugin checks providers in priority order and uses the first one that returns data. If neither addon is installed, achievement fields are sent as unknown, not zero.

You can disable achievement sync in Settings -> Experimental Features -> Sync achievement data.


Localization

The plugin UI is fully localized. Playnite automatically selects the matching language file based on your system locale.

Language Locale Contributors
English en_US Default
Russian ru_RU @godOFslaves
Portuguese (Brazil) pt_BR
German de_DE
French fr_FR
Chinese (Simplified) zh_CN
Hindi hi_IN

Want to add a language or fix a translation? See Localization/ — each file is a standalone XAML resource dictionary with 117 string keys.


Privacy

GameScrobbler is open source — you can audit exactly what data is collected and sent.

Settings allow you to:

  • disable scrobbling entirely
  • disable error reporting
  • disable achievement syncing
  • delete all your data from GameScrobbler servers (permanently removes server-side data and disables the plugin)
  • opt back in at any time after deletion

All options are configurable inside the plugin settings.


Development

Requirements

  • .NET Framework 4.6.2
  • Playnite SDK
  • Visual Studio / MSBuild

Build

MSBuild.exe GsPlugin.sln -p:Configuration=Release -restore

Tests

dotnet test GsPlugin.Tests/GsPlugin.Tests.csproj --configuration Release --no-build

Repository Structure

gs-playnite/
├── Api/
├── Services/
├── Models/
├── Infrastructure/
├── View/
├── Localization/       — en_US, ru_RU, pt_BR, de_DE, fr_FR, zh_CN, hi_IN
└── GsPlugin.Tests/

Release Management

This project uses Release Please with Conventional Commits.

Commit type Version bump
fix patch
feat minor
feat! major

Release Please automatically updates version files, generates changelogs, and publishes .pext plugin releases.


Contributing

  1. Fork the repository
  2. Clone your fork
  3. Run the setup script to install git hooks:
powershell -ExecutionPolicy Bypass -File scripts/setup-hooks.ps1
  1. All commits must follow Conventional Commits (enforced by the commit-msg hook).

Links

About

Visualize Your Playnite Stats

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors