• v1.8 c2e43999b3

    v1.8 Stable

    kerem released this 2025-12-14 01:50:46 +03:00 | 5 commits to main since this release

    📅 Originally published on GitHub: Sat, 13 Dec 2025 23:54:31 GMT
    🏷️ Git tag created: Sat, 13 Dec 2025 22:50:46 GMT

    Features and Improvements:

    • NEW: Implemented HTML formatting for email notifications for better readability
    • NEW: Added star marker () to indicate monitored user's team in match reports
    • NEW: Enhanced game information retrieval with comprehensive mappings for game queues, maps and game types
    • NEW: Expanded summoner details retrieval with ranked information (Solo/Duo and Flex) and champion mastery functions
    • NEW: Enhanced CSV logging with additional fields: Level, Role, Lane and Game Mode
    • NEW: Support for custom game snapshots with automatic CSV saving for matches that don't appear in match history
    • NEW: Fallback save mechanism for custom game matches if no completion appears within 5 minutes
    • NEW: Utility tool for converting old CSV format (v1.7.2 and earlier) to new format with additional fields
    • NEW: LoL Match History Comparison Tool for analyzing player similarities based on match data with multiple metrics
    • IMPROVE: Enhanced match processing with caching support and improved error handling for forbidden matches
    • IMPROVE: Optimized match history fetching by removing buffer and implementing incremental fetching for accessibility checks
    • IMPROVE: Implemented pagination for fetching match IDs and added total match count retrieval
    • IMPROVE: Refactored match handling to support any custom game snapshots

    Bug fixes:

    • BUGFIX: Use real match start timestamp from Spectator snapshot for custom game CSV entries
    • BUGFIX: Prevent false 'stopped playing' messages when start was never confirmed
    • BUGFIX: Update default values for kills, deaths and assists to 'N/A' in CSV match logging
    • BUGFIX: Removed fetching of summoner id and account id due to Riot API changes
    Downloads
  • v1.7.2 3ba798cf94

    v1.7.2 Stable

    kerem released this 2025-06-13 04:47:42 +03:00 | 41 commits to main since this release

    📅 Originally published on GitHub: Fri, 13 Jun 2025 02:12:48 GMT
    🏷️ Git tag created: Fri, 13 Jun 2025 01:47:42 GMT

    Bug fixes:

    • BUGFIX: Fixed config file generation to work reliably on Windows systems
    Downloads
  • v1.7.1 e61e1e8ac9

    v1.7.1 Stable

    kerem released this 2025-06-09 04:37:01 +03:00 | 44 commits to main since this release

    📅 Originally published on GitHub: Mon, 09 Jun 2025 01:45:41 GMT
    🏷️ Git tag created: Mon, 09 Jun 2025 01:37:01 GMT

    Features and Improvements:

    • IMPROVE: Tweaked printed message and added missing timestamp output
    Downloads
  • v1.7 7a985b742d

    v1.7 Stable

    kerem released this 2025-05-26 02:57:37 +03:00 | 47 commits to main since this release

    📅 Originally published on GitHub: Mon, 26 May 2025 00:04:25 GMT
    🏷️ Git tag created: Sun, 25 May 2025 23:57:37 GMT

    Features and Improvements:

    • NEW: Overhauled the core logic to detect new matches using unique match IDs instead of fragile timestamp-based mechanism, increasing reliability and robustness
    • NEW: Email notifications for finished forbidden matches (requiring RSO token)
    • IMPROVE: The new ID-based system better handles "forbidden" matches that previously lacked timestamp data
    • IMPROVE: Better handling of "stuck" in-game status
    Downloads
  • v1.6 7fa9802980

    v1.6 Stable

    kerem released this 2025-05-22 03:52:51 +03:00 | 50 commits to main since this release

    📅 Originally published on GitHub: Thu, 22 May 2025 01:00:55 GMT
    🏷️ Git tag created: Thu, 22 May 2025 00:52:51 GMT

    Features and Improvements:

    • NEW: The tool can now be installed via pip: pip install lol_monitor
    • NEW: Added support for external config files, environment-based secrets and dotenv integration with auto-discovery
    • IMPROVE: Updated and centralized region-to-continent mapping in the config section to reflect latest Riot infrastructure changes
    • 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 Riot 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: Fixed handling of forbidden match entries that require RSO token
    Downloads
  • v1.5 c6170d1578

    v1.5 Stable

    kerem released this 2024-06-17 17:08:22 +03:00 | 69 commits to main since this release

    📅 Originally published on GitHub: Mon, 17 Jun 2024 14:12:12 GMT
    🏷️ Git tag created: Mon, 17 Jun 2024 14:08:22 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.12) 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.4 8de8b8c877

    v1.4 Stable

    kerem released this 2024-05-24 20:07:12 +03:00 | 78 commits to main since this release

    📅 Originally published on GitHub: Fri, 24 May 2024 17:24:21 GMT
    🏷️ Git tag created: Fri, 24 May 2024 17:07:12 GMT

    Features and Improvements:

    • IMPROVE: Information about log file name visible in the start screen
    • 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: Code cleanup - duration returned by print_match_history() and print_current_match() was never used in the code, so it has been removed (left-over from the Cassiopeia based code)
    • IMPROVE: Due to recent erratic behavior of Spectator-V5 API, LOL_HANGED_INGAME_INTERVAL value has been decreased to 30 mins
    • IMPROVE: pep8 style convention corrections
    Downloads
  • v1.3 d458a3b6d0

    v1.3 Stable

    kerem released this 2024-05-15 17:57:37 +03:00 | 87 commits to main since this release

    📅 Originally published on GitHub: Wed, 15 May 2024 16:34:23 GMT
    🏷️ Git tag created: Wed, 15 May 2024 14:57:37 GMT

    Features and Improvements:

    • IMPROVE: Improvements for running the code in Python under Windows
    • IMPROVE: Updated mapping of regions & continents (region_to_continent dict)
    • IMPROVE: Better checking for wrong command line arguments

    Bug fixes:

    • BUGFIX: Exception and error handling for Riot IDs in wrong format
    Downloads
  • v1.2 c040d28b03

    v1.2 Stable

    kerem released this 2024-05-08 20:18:40 +03:00 | 95 commits to main since this release

    📅 Originally published on GitHub: Wed, 08 May 2024 17:21:58 GMT
    🏷️ Git tag created: Wed, 08 May 2024 17:18:40 GMT

    Features and Improvements:

    • NEW: Info about player's role & lane added to the match summary
    • NEW: Info about game mode, player's role & lane added to notification emails
    • NEW: Mapping of games modes have been added
    • NEW: Feature to handle cases where active in-game status hangs, so we try to get historical matches in such case (by default after 1 hour)
    • IMPROVE: Updated mapping of regions
    • IMPROVE: Changed logic of checking for new matches
    • 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: Info about CSV file name in the start screen
    • IMPROVE: Error message is displayed in the beginning if the region is not in regions_short_to_long dict or if the PUUID cannot be fetched
    • IMPROVE: print_current_match() function has been rewritten to include more info in the notification emails
    • IMPROVE: Accessing dict items via .get() to avoid errors when key is not available
    • IMPROVE: In case of getting an exception in main loop we will send the error email notification only once (until the issue is resolved)

    Bug fixes:

    • BUGFIX: Match teams structure does not always contain correct team ids (for example for Arena game types), so we switched the method in print_match_history() function to get it from match participants structure instead (the same way as in print_current_match())
    • BUGFIX: Fix for re-fetching the last match in case there was an error reported by RIOT API (in such case timestamps are assigned with value of 0 and it triggered the new duplicated historical match event)
    Downloads
  • v1.1 edf8c796c6

    v1.1 Stable

    kerem released this 2024-04-29 16:45:43 +03:00 | 105 commits to main since this release

    📅 Originally published on GitHub: Mon, 29 Apr 2024 13:53:51 GMT
    🏷️ Git tag created: Mon, 29 Apr 2024 13:45:43 GMT

    This release is based on pulsefire lib.

    Features and Improvements:

    • NEW: Tool has been rewritten to switch to pulsefire library as Cassiopeia still does not support recent RIOT API changes (lack for Spectator-V5 & RIOT IDs support -> calls are still based on Summoner names)
    • NEW: Feature to handle situations when Spectator API is not available (outage); the tool will now notice it and report when new matches show up
    • NEW: If listing mode is used (-l) together with saving to CSV file (-b), the tool will not only list recent matches, but also save it to the CSV file
    • NEW: New parameter (--min_of_recent_matches / -m) which can be used in listing mode (-l) together with --number_of_recent_matches / -n to narrow down the range of matches to print / save
    Downloads