Skip to content

MaxPra/GameTimeX

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

GameTimeX

GameTimeX is a desktop application for precise tracking of actual gameplay time.
Unlike platform counters that may continue running while a title is idle, GameTimeX records playtime only when the game is truly active.

Version 2.1.0
Same reliable core, new refinements and yearly playtime statistics in December.

Download the latest installer:
GameTimeXSetup_Latest.msi


Key Features

  • ๐ŸŽฎ Accurate Time Tracking โ€“ records only while the game process is genuinely running.
  • ๐ŸŽ›๏ธ Installed Games Filter (controller + play icon) โ€“ optional toolbar filter that shows only profiles for games that are currently installed (installation folder exists).
    Prerequisite: the installation folder must be specified in each profileโ€™s Properties.
  • ๐Ÿท๏ธ Installed Icon Overlay โ€“ each profile tile shows an indicator icon in the top-right corner of the profile image if the game is installed
    (installation folder set + valid executable detected).
  • ๐Ÿ”„ Automatic Profile Switching โ€“ switches to the correct profile when a game launches.
    • Per-executable selection to prevent conflicts where different games share executables.
    • Smart initial pre-filtering automatically deselects common non-game executables (launchers, crash reporters, helpers, etc.).
  • ๐Ÿ–ผ๏ธ Customizable Profiles โ€“ create, rename, and assign cropped images for each game.
    • New: You can now paste profile pictures directly from the clipboard using CTRL+V in both the Create and Properties windows.
  • ๐ŸŒ™ OLED Care (Blackout Screen) โ€“ toggle with CTRL+B to black out all displays while AFK.
  • ๐Ÿ–ฅ๏ธ Side-Screen Dimming โ€“ optionally dims secondary displays automatically while tracking is active.
  • โŒจ๏ธ Hotkey Monitoring โ€“ start/stop tracking via a configurable hotkey.
  • ๐Ÿ’พ Backup & Restore โ€“ export or import all profiles; optional automatic backup at startup.
  • ๐Ÿ”’ Hardened Database Access โ€“ parameterized SQLite queries for protection against SQL injection.
  • ๐ŸŸฆ Steam Integration โ€“ import Steam games and link them with GameTimeX profiles.
    • Launch Steam games directly from GameTimeX
    • Optionally enable HDR automatically before game launch (only if linked with a Steam profile)
    • Steam Start Parameters โ€“ specify custom Steam launch arguments per game directly inside GameTimeX
  • ๐Ÿ—“๏ธ Todayโ€™s Playtime in Tooltip โ€“ in the details panel, the total time tooltip now also shows how many hours youโ€™ve played today.
  • ๐Ÿ“Š December Yearly Statistics โ€“ every December, GameTimeX shows a summary of how long you played each game during the current year.
    This feature is always active and requires no configuration.
  • ๐ŸŽจ UI Style Refinements โ€“ subtle visual improvements for a cleaner and more consistent experience.

Whatโ€™s New in 2.1.0

  • ๐Ÿ“Š December Yearly Stats โ€“ in December, GameTimeX now displays a clear overview of your total playtime per game for the entire current year.
  • ๐ŸŽจ UI Style Refinements โ€“ minor improvements in visuals, spacing, and consistency across the app.
  • ๐Ÿ–ผ๏ธ Profile picture pasting โ€“ profile images can now be pasted directly from the clipboard using CTRL+V in both the Create and Properties windows.

Overview

GameTimeX is designed for reliability and clarity, with an emphasis on clean interaction and accurate tracking.

Main Window

Initial application view:
image

Key areas:

  1. Profile Search โ€“ quickly locate profiles in larger libraries.
  2. Toolbar Controls โ€“ next to the search field:
    • Installed Games Filter (controller + play icon) โ€“ shows only profiles where the game is currently installed (installation folder exists).
      Prerequisite: define the installation folder in Properties.
    • Create New Profile
    • Delete Profile
    • Properties
    • Settings
      (Properties and Delete are also available via the profile context menu.)
  3. Profile Tiles with Install Indicator โ€“ each game profile shows its image; if the game is installed, a small install icon appears in the top-right corner.
    Example of a profile tile with the install icon:
    image
  4. Information Panel โ€“ details for the selected profile, including thumbnail.
  5. Start/Stop Monitoring โ€“ status indicated by button color (blue = idle, red = active).
  6. Rename Profile โ€“ click the pencil icon next to the profile name.

Example with profiles:
image

Profile names and images are editable at any time. Hover over the โ€œiโ€ icon next to Game Time to view the tracked minutes, as well as the first and last play sessions.
โžก๏ธ The tooltip now also shows how many hours you played today.
โžก๏ธ New in 2.1.0: in December, an automatic yearly summary shows how much time you spent in each game throughout the current year.
โžก๏ธ New: profile pictures can now be pasted directly from the clipboard using CTRL+V in the Create and Properties windows.

If a new playthrough begins after time has already been recorded, use New Playthrough Startpoint. The application saves the current total time and reports playthrough time as the difference from that point forward.

  • Total time remains cumulative.
  • Playthrough time is calculated relative to the saved start point.

Properties & Steam Linking

The Properties window provides central configuration for each profile:

image
  • Define the installation folder for installed game detection
  • Assign profile image, rename profile, and manage monitored executables
  • Paste from Clipboard: profile images can now be inserted directly from the clipboard via CTRL+V.
  • Steam Integration:
    • Shows whether the profile is already linked to a Steam game
    • A dedicated Steam button with link icon allows importing and linking Steam games directly
    • When linked, Steam games can be launched straight from GameTimeX
    • Optional: enable HDR activation before launch
    • Steam Start Parameters: specify custom Steam launch arguments per game profile

Settings

The settings dialog provides granular control:
image image

Options include:

  • Session Time Tracking โ€“ display the current session duration in the information panel while tracking.
  • Automatic Profile Switching โ€“ automatically switches profiles upon game launch (requires the installation folder).
    • Manage the set of executables to monitor and exclude irrelevant processes.
  • Monitor Key โ€“ assign a global hotkey to start/stop monitoring without leaving the game.
  • Backup & Restore โ€“ export or import profiles; the application restarts automatically after import/export. Optional automatic backup on startup.
  • OLED Care (Blackout Screen) โ€“ fully darkens all screens to protect OLED panels (CTRL+B).
  • Side-Screen Dimming (optional) โ€“ dims all secondary displays only while tracking; automatically restores them afterwards.
  • Steam Integration Options โ€“ choose whether HDR should be toggled automatically when launching a Steam-linked game, and configure per-game Steam launch parameters.

Manage Executables

When Automatic Profile Switching is enabled, GameTimeX allows precise control over which executables are monitored.
This prevents launchers, helpers, and engine processes from causing false detections.

image

Capabilities:

  • Enumerates executables in the installation directory
  • Checkboxes to mark executables as active or inactive
  • โ€œSelect Allโ€ for rapid bulk changes
  • Smart defaults: common non-game executables are deselected on initial profile creation
  • Changes can be saved at any time

Profile Image Cropping

When adding a profile image, a cropping dialog enables quick framing:
image

Controls:

  • Resize the crop area with the mouse wheel
  • Reposition the crop area via drag (left mouse button)
  • New: profile images can also be pasted directly from the clipboard using CTRL+V in the Create and Properties windows.

The cropped image is saved and immediately shown in the profile view.


Security

  • All database operations use parameterized SQLite commands to mitigate SQL injection risks.
  • Initial executable pre-filtering reduces noise from non-game processes, improving detection accuracy.

Icon assets by Icons8.

About

GameTimeX allows you to monitor your game time on the pc.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published