GamesList Manager

Powerful Features

🎮

Game Collection Management

Add, edit, and organize your game library
Track ownership status, platforms, and release dates
Color-coded status system
Search and filter capabilities
Excel import support

⏱️

Advanced Time Tracking

Built-in session timer with controls
Automatic time tracking and recording
Detailed session history with timestamps
Session feedback system with notes

🌟

Dual Rating System

Rate individual gaming sessions (1-5 stars)
Rate games overall with comprehensive feedback
50+ predefined tags for categorizing
Custom comments and detailed feedback

📊

Rich Data Visualization

Status distribution pie charts
Games by release year analysis
Playtime distribution graphs
Gaming heatmap showing daily patterns
Session timeline visualization

📈

Statistics & Analytics

Comprehensive gaming statistics
Session analysis and trends
Status change timeline
Tag frequency analysis
Gaming habit insights

🎪

Discord Rich Presence

Real-time Discord status updates
Dynamic status for current activity
Session tracking with elapsed time
Customizable presence messages
Easy toggle on/off functionality

🔄 Auto-Updater System

New in v1.9.0

Stay Always Up-to-Date

GamesList Manager now includes a comprehensive auto-updater system that keeps your application current with the latest features, improvements, and bug fixes.

🎯

One-Click Updates

Download and install updates with a single click. The intelligent staging system handles everything safely in the background.

📊

Smart Progress Tracking

Real-time download progress with the ability to cancel at any time. No more waiting in the dark!

🔒

Safe Installation

Automatic backups are created before any update. If something goes wrong, rollback is automatic.

📋

Rich Release Notes

View detailed release information with images and formatted text right in the application.

⚙️

Flexible Settings

Configure startup checking, manage downloads, or disable entirely. You're in control.

🌐

Cross-Platform

Works seamlessly on Windows, macOS, and Linux with platform-specific updater scripts.

🎛️ Update Settings

Access via Options Menu:

Check for Updates: Manually check for and install updates
Update Settings: Configure startup checking, manage downloads, or disable auto-updates entirely

Auto-updates respect your preferences - they can be configured to check on startup or disabled completely based on your needs.

Installation

📦 Quick Installation (Recommended)

For most users, the easiest way to get started:

Download: Go to the Releases section of the GitHub repository

Extract: Download the latest release zip file and extract it to your preferred folder

Run: Launch the application by running GameTracker.exe (Windows)

That's it! No additional setup, Python installation, or dependency management required.

🔧 Build from Source

⚠️ Important: PySimpleGUI Availability

The required PySimpleGUI version (4.60.5) is no longer officially available. You'll need to use a community fork: PySimpleGUI 4.60.5 Community Fork

Clone the Project:

git clone <repository-url>
cd GamesList

Set Up Python Environment:

python -m venv .venv
.venv\Scripts\activate  # Windows
source .venv/bin/activate  # macOS/Linux

Install PySimpleGUI from Community Fork:

Download the community fork and install manually, then install other dependencies:

pip install matplotlib>=3.5.0 openpyxl>=3.0.0 Pillow>=9.0.0

Run the Application:

python main.py

System Requirements

Operating System

Windows, macOS, or Linux

Python

3.7 or higher

Memory

512MB RAM minimum

Storage

50MB available space

Note: This application has been primarily developed and tested on Windows. macOS and Linux compatibility may require additional configuration.

🎪 Discord Rich Presence Integration

Show your gaming library management activity on Discord! Your status will dynamically update to show what you're doing:

✅ Ready to Use - No Setup Required!

Using the pre-built release? Discord Rich Presence is already fully configured and working out of the box! The release binaries include a verified Discord application integration - just download, run, and enjoy automatic Discord status updates.

The setup instructions below are only needed if you're building from source or want to use your own Discord application.

🎮

Playing Games

Shows current game with elapsed session time

⏸️

Paused Sessions

Displays when gaming session is paused

📝

Browsing Library

Shows when exploring your game collection

📊

Viewing Statistics

Indicates when analyzing gaming data

➕

Adding Games

Shows when adding new titles to library

✏️

Editing Information

Displays when managing game details

🛠️ Developer Setup Instructions

Only follow these steps if you're building from source or want to use your own Discord application

Create Discord Application: Go to the Discord Developer Portal and create a new application

Get Application ID: Copy the Application ID from the General Information tab

Configure GamesList Manager: Edit constants.py and replace the DISCORD_CLIENT_ID placeholder with your Application ID

Install Dependencies: Run pip install pypresence

Test It Out: Launch GamesList Manager with Discord running to see your status update!

Privacy Note: Discord Rich Presence only shares your current activity and general stats. No personal game data, ratings, or notes are shared. You can toggle this feature on/off anytime from the Options menu.

Quick Start Guide

Add Your First Game: Click "Add Entry" and fill in game details

Track Gaming Time: Click on a game → "Track Time" → Use play/pause/stop controls

Rate Your Experience: Add session feedback with ratings, tags, and notes

Explore Analytics: Check the Summary and Statistics tabs for insights

Organize Your Collection: Use search, filters, and sorting to manage your library

Configure Updates: Visit Options → Update Settings to manage auto-updates (can be disabled if preferred)

Legal Documents

Terms of Service

Review the terms and conditions for using GamesList Manager, including GPL-3.0 license rights and Discord integration details.

View Terms of Service

Privacy Policy

Learn how GamesList Manager handles your data, including local storage practices and optional Discord Rich Presence integration.

View Privacy Policy