Gosumemory Save

Cross-Platform memory reader for osu!

Project README

Yet another memory reader for osu! Supports both Linux and Windows. (requires sudo on Linux though since only root can read /proc)

Build custom pp counters with ease!
You can contact us here: https://discord.gg/8enr4qD

Real-World examples:

cpol FlyingTuna Alumetri Sotarks Mrekk Mathi RyuK

Usage

  1. Download the latest Release

    • Unzip files anywhere

    In the root folder of the program, you can find the static directory. It contains all of the available counters. Those are getting streamed via HTTP-File server

  2. Run gosumemory & osu!

    • Visit this link in your browser: http://localhost:24050 and choose the counter that you like.
    • Add a browser source in OBS (Width and Height could be found in the Included counters spoiler)
  3. If using built-in counters covers all of your needs, then you are done here.

Please note that auto-updates only cover the executable itself, however, if a new counter gets released, we will mention it in the Release Notes.
If you want to make your own, just create a new directory in the static folder.

Does this work in-game?

Yes! see this

Included counters:

Click ME

InGame1

Size: 240x133

By: Dartandr

InGame2

Size: 370x120

By: Dartandr

InGame3

Size: 150x70

By: Dartandr

reComfortaa

Size: 1152x245
Song Selection

Gameplay

By: Xynogen

MonokaiPane

Size: 512x150
Song Selection

Gameplay 1

Gameplay 2

By: Xynogen

WaveTournament

Size: 1920x1080
Chat + Warmup (Team score disabled) view

Chat + Warmup (Team score disabled) view

Gameplay

By: VictimCrasher

Classic

Size: 550x300

By: Dartandr

OldClassic

Size: 550x300

By: Dartandr

Simplistic

Size: 750x150
Song Selection

Gameplay 1

By: jassper0

DarkAndWhite

Size: 840x140

By: cyperdark

Kerli1 & Kerli2

Size (1)(2): 794x124 | 353x190

By: Dartandr

Luscent

Size: 1920x1080
Open-Source Implementation of Siae's Luscent overlay. No elements were stolen. This is a remake. Please consider buying her version!

Remake by: Dartandr

VictimCrasherCompact

Size: 560x150
Song Selection
\

Gameplay

By: VictimCrasher

VictimCrasherOverlay

Size: 1920x1080

By: VictimCrasher

UnstableRate

Size: 300x100
Just a plain number that shows current UnstableRate, could be useful if you want to put it above your UR Bar.
By: Dartandr

MaximalLime

Size: 800x306

By: cyperdark

MinimalLime

Size: 640x130

By: cyperdark

TrafficLight

Size: 458x380

By: cyperdark

How does it work?

gosumemory streams WebSocket data to ws://localhost:24050/ws that you can use in any programming language to develop a frontend. We recommend JavaScript though, as it's much easier to make something pretty with the Web framework. All of the included counters are good starting points. There is also http://localhost:24050/json that you can open in a web browser to see the available data. We strongly recommend against sending GET requests to that address in production, please use WebSocket instead.

Example JSON and a little wiki of it's values

What if I don't know any programming languages but still want to output data to OBS?

https://www.youtube.com/watch?v=8ApXBEO5bes

How do I submit a pp counter?

Head over to static and create a pull request there. If it's good quality, then it will get approved and included in the next release.

Tournament Client

When operating in tourney mode, real-time pp counters for each client, leaderboard and grades don't work. Each gameplay object is sorted by tournament client "id", "menu" object is a tournament manager (state 22). Tournament mode works only with Cutting Edge tourney client and is not supported on Linux.

Linux

You have two options. Either run native, but with sudo privileges, or through WINE. Please note that Linux builds are not well tested and could contain crashes. Report them if you encounter any.

Consider supporting

Buy Me A Coffee

This project depends on:

Special Thanks to:

Open Source Agenda is not affiliated with "Gosumemory" Project. README Source: l3lackShark/gosumemory
Stars
612
Open Issues
94
Last Commit
4 months ago
License

Open Source Agenda Badge

Open Source Agenda Rating