gorfreed/sektori-pulse

Sektori Pulse is a companion app for a video game called Sektori. It solves one specific problem: Sektori's own save file only keeps track of lifetime totals and personal best scores, and never records anything about an individual run. Once you leave the results screen after a run, those numbers are gone for good. Pulse fixes that by watching your screen and saving the details of every run yourself. When a run ends, Pulse detects the results screen and automatically pages through all four of its pages, which cover the campaign challenge, two statistics pages, and a score breakdown. Since the game only lets you move between these pages using a controller and not a keyboard, Pulse plugs in a virtual Xbox controller to flip through them for you, so you never have to touch anything yourself. It then reads every number off the screen using on-device OCR, meaning the text recognition happens locally on your own computer rather than being sent anywhere else. Because OCR can misread a digit, Pulse cross-checks the numbers against the score breakdown to make sure they add up correctly, and it will try alternate readings of a misread digit until the totals match before it trusts and saves that run. Once runs are saved, you get a browsable archive you can filter by which ship you were playing, since the three ships play differently enough that each one gets its own personal bests. You can click on any point in a chart or any personal best stat and jump straight to the run that produced it, and view trends over time such as score per minute, kills per minute, and survival time, with an adjustable time window. A small in-game overlay lets you know Pulse is running without getting in the way while you play. Pulse only reads your Sektori save file and never modifies it, and everything it captures stays on your machine unless you manually choose to export it. It currently only tracks the Campaign mode, with a Classic mode tracker planned. It is Windows only, distributed as an installer, and requires Sektori to already be installed through Steam. The project is built with Electron and includes standard npm scripts for developers who want to run or build it themselves.