• v1.7 a5198d170d

    v1.7 Stable

    kerem released this 2026-02-06 19:01:04 +03:00 | 0 commits to main since this release

    📅 Originally published on GitHub: Fri, 06 Feb 2026 16:09:28 GMT
    🏷️ Git tag created: Fri, 06 Feb 2026 16:01:04 GMT

    Features and Improvements:

    • NEW: Games library change tracking - track when the user's game count (or library set) changes. Enable with GAMES_LIBRARY_CHECK or --check-games (closes #1)
    • NEW: Optional email notifications when the games library changes (GAMES_LIBRARY_NOTIFICATION / --notify-games; requires games library tracking to be enabled)
    • NEW: Games library changes can be logged to the profile CSV
    Downloads
  • v1.6 168029b391

    v1.6 Stable

    kerem released this 2026-01-23 20:11:56 +03:00 | 11 commits to main since this release

    📅 Originally published on GitHub: Fri, 23 Jan 2026 17:17:48 GMT
    🏷️ Git tag created: Fri, 23 Jan 2026 17:11:56 GMT

    Features and Improvements:

    • NEW: Added --no-color flag to disable colored output
    • IMPROVE: Enhanced --generate-config to support writing directly to a file (e.g. steam_monitor --generate-config steam_monitor.conf). This avoids UTF-16 encoding issues on Windows PowerShell
    • IMPROVE: Improved color output initialization for Windows compatibility
    • IMPROVE: Expanded tabs to spaces in output log files to ensure consistent alignment across different viewers
    Downloads
  • v1.5 683d804184

    v1.5 Stable

    kerem released this 2025-12-29 06:23:16 +03:00 | 23 commits to main since this release

    📅 Originally published on GitHub: Mon, 29 Dec 2025 03:35:15 GMT
    🏷️ Git tag created: Mon, 29 Dec 2025 03:23:16 GMT

    Features and Improvements:

    • NEW: Implemented native color output support for terminal, enhancing user experience with customizable color themes (see COLORED_OUTPUT and COLOR_THEME config options). You can still use the old grc method if you prefer
    • NEW: Added inactivity thresholds and estimated last activity tracking for user status changes (see STEAM_AWAY_INACTIVITY_THRESHOLD and STEAM_SNOOZE_INACTIVITY_THRESHOLD config options)
    • NEW: Introduced tracking for Steam level, total XP and friends list changes with optional email notifications and CSV logging
    • NEW: Added signal handlers for toggling Steam level/XP and friends list email notifications
    • NEW: Added optional separate CSV file for profile-related changes (Steam level, total XP, friends changes). See PROFILE_CSV_FILE config option and --profile-csv-file flag
    • IMPROVE: Enhanced user info display mode (-i) to optionally list recent achievements (--achievements) and added CLI flag to force fetching achievements from all owned games (--achievements-all-games)
    • IMPROVE: Implemented fallback for achievement fetching by referring to owned games when recently played list is empty
    • IMPROVE: Enhanced user info display mode (-i) to optionally list friends with detailed information (--list-friends)
    • IMPROVE: Enhanced game playtime display in monitoring and user info display mode
    • IMPROVE: Refactored handling of users with privacy settings set to block friends list

    Dependencies:

    • NEW: Added colorama dependency for Windows platform support
    Downloads
  • v1.4 021514c7fd

    v1.4 Stable

    kerem released this 2025-11-11 05:34:21 +03:00 | 54 commits to main since this release

    📅 Originally published on GitHub: Tue, 11 Nov 2025 02:41:28 GMT
    🏷️ Git tag created: Tue, 11 Nov 2025 02:34:21 GMT

    Features and Improvements:

    • NEW: Added detailed user information display mode (-i / --info flag), providing comprehensive Steam profile insights including Steam level, badges and XP statistics, country/region, ban status (VAC, Community, Economy), profile URL, friends list/count, top games and recently played games with playtime statistics
    • IMPROVE: Enhanced user information display in monitoring mode to include country/region details and profile URL
    Downloads
  • v1.3.1 2a731ad578

    v1.3.1 Stable

    kerem released this 2025-06-13 04:16:48 +03:00 | 62 commits to main since this release

    📅 Originally published on GitHub: Fri, 13 Jun 2025 02:00:17 GMT
    🏷️ Git tag created: Fri, 13 Jun 2025 01:16:48 GMT

    Bug fixes:

    • BUGFIX: Fixed config file generation to work reliably on Windows systems
    Downloads
  • v1.3 30da2302d9

    v1.3 Stable

    kerem released this 2025-05-22 01:01:29 +03:00 | 65 commits to main since this release

    📅 Originally published on GitHub: Wed, 21 May 2025 22:08:51 GMT
    🏷️ Git tag created: Wed, 21 May 2025 22:01:29 GMT

    Features and Improvements:

    • NEW: The tool can now be installed via pip: pip install steam_monitor
    • NEW: Added support for external config files, environment-based secrets and dotenv integration with auto-discovery
    • IMPROVE: Enhanced startup summary to show loaded config and dotenv file paths
    • IMPROVE: Simplified and renamed command-line arguments for improved usability
    • NEW: Implemented SIGHUP handler for dynamic reload of secrets from dotenv files
    • IMPROVE: Added configuration option to control clearing the terminal screen at startup
    • IMPROVE: Changed connectivity check to use Steam API endpoint for reliability
    • IMPROVE: Added check for missing pip dependencies with install guidance
    • IMPROVE: Allow disabling liveness check by setting interval to 0 (default changed to 12h)
    • IMPROVE: Improved handling of log file creation
    • IMPROVE: Refactored CSV file initialization and processing
    • IMPROVE: Added support for ~ path expansion across all file paths
    • IMPROVE: Refactored code structure to support packaging for PyPI
    • IMPROVE: Enforced configuration option precedence: code defaults < config file < env vars < CLI flags
    • IMPROVE: Updated horizontal line for improved output aesthetics
    • IMPROVE: Email notifications now auto-disable if SMTP config is invalid
    • IMPROVE: Removed short option for --send-test-email to avoid ambiguity

    Bug fixes:

    • BUGFIX: Eliminated duplicate Steam API calls
    • BUGFIX: Correctly handle 429 errors by respecting Retry-After headers and suppressing log noise
    Downloads
  • v1.2 066b933a81

    v1.2 Stable

    kerem released this 2024-06-14 23:35:27 +03:00 | 83 commits to main since this release

    📅 Originally published on GitHub: Fri, 14 Jun 2024 20:38:38 GMT
    🏷️ Git tag created: Fri, 14 Jun 2024 20:35:27 GMT

    Features and Improvements:

    • NEW: Added new parameter (-z / --send_test_email_notification) which allows to send test email notification to verify SMTP settings defined in the script
    • IMPROVE: Support for float type of timestamps added in date/time related functions
    • IMPROVE: Function get_short_date_from_ts() rewritten to display year if show_year == True and current year is different, also can omit displaying hour and minutes if show_hours == False
    • IMPROVE: Checking if correct version of Python (>=3.5) is installed
    • IMPROVE: Possibility to define email sending timeout (default set to 15 secs)

    Bug fixes:

    • BUGFIX: Fixed "SyntaxError: f-string: unmatched (" issue in older Python versions
    • BUGFIX: Fixed "SyntaxError: f-string expression part cannot include a backslash" issue in older Python versions
    Downloads
  • v1.1 4fd00b09e9

    v1.1 Stable

    kerem released this 2024-05-23 19:31:59 +03:00 | 91 commits to main since this release

    📅 Originally published on GitHub: Thu, 23 May 2024 16:37:27 GMT
    🏷️ Git tag created: Thu, 23 May 2024 16:31:59 GMT

    Features and Improvements:

    • NEW: Feature counting overall time and number of played games in the session
    • NEW: Possibility to define STEAM_API_KEY via command line argument (-u / --steam_api_key)
    • IMPROVE: Improvements for running the code in Python under Windows
    • NEW: Possibility to define output log file name suffix (-y / --log_file_suffix)
    • IMPROVE: Information about log file name visible in the start screen
    • IMPROVE: Email sending function send_email() has been rewritten to detect invalid SMTP settings
    • IMPROVE: Strings have been converted to f-strings for better code visibility
    • IMPROVE: Better detection of wrong command line arguments
    • IMPROVE: Rewritten get_date_from_ts(), get_short_date_from_ts(), get_hour_min_from_ts() and get_range_of_dates_from_tss() functions to automatically detect if time object is timestamp or datetime
    • IMPROVE: Help screen reorganization
    • IMPROVE: pep8 style convention corrections

    Bug fixes:

    • BUGFIX: Improved exception handling while processing JSON files
    Downloads
  • v1.0 6e43260a7c

    v1.0 Stable

    kerem released this 2024-04-26 02:21:52 +03:00 | 117 commits to main since this release

    📅 Originally published on GitHub: Thu, 25 Apr 2024 23:33:54 GMT
    🏷️ Git tag created: Thu, 25 Apr 2024 23:21:52 GMT

    Initial steam_monitor v1.0 release. Features:

    • Real-time monitoring of Steam users gaming activity (including detection when user gets online/offline or played games)
    • Basics statistics for user activity (how long in different states, how long played game etc.)
    • Email notifications for different events (player gets online/away/snooze/offline, starts/finishes/changes game, errors)
    • Saving all gaming activity with timestamps to the CSV file
    • Possibility to control the running copy of the script via signals

    RELEASE NOTES:

    • NEW: Support for short offline interruption, so if user gets offline and online again (for example due to rebooting the PC) during the next OFFLINE_INTERRUPT seconds (configurable in .py file) then we set online start timestamp back to the previous one
    • IMPROVE: Additional information in the subject of email notifications

    Bug fixes:

    • BUGFIX: Fixes for handling situations where some profile information is not available
    Downloads