Skip to main content

Tracks game play time.

Project description


Gamest is a tool for keeping a record of time spent playing video games.


Use pip to install gamest:

pip install gamest

Gamest may be launched by calling gamest from the command line. The executable gamest.exe is located in python's Scripts folder, so a shortcut may be placed wherever is convenient.


Out of the box, gamest will track runtime of desired apps. To add an app to be tracked, start the app, then click 'Pick Game`, choose the app from the list, and click 'Pick Game' to select it. In most cases, no advanced settings will be required, so click 'Add Game' to finish adding the app to the database. In the future, the app will be automatically detected whenever it is running.

Gamest settings are stored in %LOCALAPPDATA%\gamest\gamest.conf. The default configuration is:

# Set debug to True to enable logging of additional debug messages for
# troubleshooting.
# debug = False

# Only windows which are visible on the desktop will be shown in the
# 'Pick Games' list. Set visible_only to False if you need to select
# an app which doesn't present a visible window.
# visible_only = True

Plugins may require additional configuration. Included with gamest is a plugin to send notification when game sessions begin or end. Its configuration is located in %LOCALAPPDATA%\gamest\PlaySessionNotificationPlugin.conf. The default configuration is:

# Send notifications when an app is started. This doesn't do anything
# unless a notification service plugin, such as the discord webhook
# notifier, is installed.
# send_begin = True

# Send notifications when an app is closed. This doesn't do anything
# unless a notification service plugin, such as the discord webhook
# notifier, is installed.
# send_end = True


Copyright (C) 2018 Tracy Poff

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gamest-1.0.11.tar.gz (24.8 kB view hashes)

Uploaded source

Built Distribution

gamest-1.0.11-py3-none-any.whl (13.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page