Tracking Your osu! Play Habits Without Losing Your Mind
I spent about six months manually screenshotting my daily playtime, accuracy trends, and ranked score progression across different difficulties just to see if I was actually improving or just grinding harder beatmaps with worse results. That was before I found a tool that automated most of that process. It ended up being called Osu My Chart Your Personal Health Journey Visualized For Better Wellness Decisions, though honestly most people in the community just refer to it as the osu health chart or osumychart for short. Here is what the tool actually does. It connects to your osu! API profile through the official osu! API keys, pulls your match history, performance graphs, and play statistics, then renders them into visual charts that track your journey over time. The "health" aspect isn't about your real medical health -- it is about monitoring whether your osu! playing habits are sustainable or if you are burning out. It shows things like consecutive days played, average combo trends, accuracy drift, and whether your ranked score improvements are plateauing or regressing. The way it works under the hood is straightforward. You generate an API key from your osu! account settings, paste it into the tool, and it caches your data locally on your machine. The caching is important because the osu! API has rate limits. If you request data too frequently without respecting those limits, your key gets temporarily throttled and you lose access for a few hours. The tool handles this by storing a local JSON cache and only making fresh API calls when the cache is stale or you explicitly refresh.
I ran into a specific problem early on where the accuracy charts would show a flat line at 92% for about three weeks, which I thought meant something was broken. The issue turned out to be that my osu! client was set to only save replays for rated scores above SS rank, so the chart only had data points for my best plays. Once I changed the client setting to save replays for all rated scores and let the cache rebuild over a couple of days, the accuracy trend matched what I was actually experiencing in-game. The chart was correct the whole time -- the input data was just incomplete. The export functionality is where this becomes genuinely useful for long-term tracking. You can pull your data into CSV format and cross-reference it with external tools like Excel or Google Sheets. I used this to notice a pattern where my performance on high-difficulty maps dropped significantly on days when my total playtime exceeded four hours. The chart made the correlation visible enough that I started capping my sessions at three hours, and my ranked score consistency improved within a week. There are real limitations to keep in mind. The tool only works with public osu! profiles. If your profile is private or set to unlisted, the API key won't have read access to your match history. Some users try to get around this by using alternative accounts or third-party scrapers, but those approaches violate osu!'s terms of service and can result in account termination. The official API route is the only stable path.
Another limitation is that the health and wellness metrics are entirely self-reported. The tool can show you your playtime trends and performance stability, but it cannot tell you whether you are sleeping enough, eating properly, or taking breaks from screen strain. I learned this the hard way when I saw green checkmarks across every chart metric for a full month while actually burning out from exhaustion. The visualization was clean, but it did not capture the human variables that matter for sustainable gameplay. If you want to set this up yourself, you need a few things before starting. First, you need an osu! account in good standing with no active restrictions. Second, you generate your API key from the account settings page and keep it private -- do not share it publicly or paste it into untrusted websites. Third, you should have at least two weeks of play history for the charts to be meaningful, otherwise the trend lines are just noise. The download link for the official version is available through the osu! forum's tools section or directly from the developer's GitHub repository. Avoid third-party mirrors that bundle extra software or ask for additional account credentials beyond the API key. There have been modified versions circulating that inject ads or log your session tokens, which defeats the purpose of using a legitimate tool.
Get the Full Details
For most people who are serious about tracking their osu! journey over months or years, this kind of visualization is worth the initial setup time. It takes maybe twenty minutes the first time, and then it runs quietly in the background refreshing your cache every few hours. The real value shows up after about six weeks of data, when you can actually see patterns that screenshots and manual tracking never revealed.
