📦 Quick Installation (Recommended)
For most users, the easiest way to get started:
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.
⚠️ Windows may block the first launch
GameTracker isn't signed with a paid Microsoft certificate, so Windows can flag it as coming from an "unknown publisher." It's a false positive — the app is open source and the code is on GitHub.
- SmartScreen ("Windows protected your PC"): click More info → Run anyway.
- Smart App Control (Windows 11) is stricter and may block unsigned apps with no "Run anyway" option. Right-click
GameTracker.exe → Properties → Unblock, or turn it off under Windows Security → App & browser control → Smart App Control.
🔧 Build from Source
Version 2.0 runs on Flet (Flutter) — no more PySimpleGUI. A plain pip install is all that's needed.
Clone the Project:
git clone <repository-url>
cd GamesList
Set Up a Python Environment (3.10+):
python -m venv .venv
.venv\Scripts\activate # Windows
source .venv/bin/activate # macOS/Linux
Install Dependencies:
pip install -r requirements.txt
Run the Application:
python app_flet.py
To produce a native, self-contained executable, use flet build — see docs/BUILD.md in the repository for the full guide.
System Requirements
Operating System
Windows, macOS, or Linux
Python
3.10+ to build from source — the packaged release bundles its own runtime
Storage
50MB available space
Note: This application has been primarily developed and tested on Windows. macOS and Linux compatibility may require additional configuration.
