Welcome to tosu 👋

Eponymous software for reading osu! memory, accounting for most of gosumemory's issues

Instruction

1. Download tosu
2. Extract tosu.exe to a Folder
3. Run tosu.exe
4. Go to http://127.0.0.1:24050
5. Now you in overlays dashboard, in here you can download counters, or tweek settings of tosu
6. Here you can watch showcase of dashboard: link
7. Have fun!

---

Features

• All Gamemodes are supported
• Gosumemory compatible api
• Brand new api for websocket
• In-game overlay (based on gosumemory closed overlay injection)
• Available websocket data:
  • Settings
  • Gameplay data
  • User ingame data
  • Beatmap data
  • Session (Work in progress)
  • Multiple graphs for different skill sets (aim, speed, etc)
    • Extended starrating stats (per mode)
  • Leaderboards list (array)
  • Folders paths and Files names
  • Direct paths to files
  • Result screen
  • Tourney data (not tested, yet)
• LOW CPU USAGE (I actually checked, this thing has a much lower memory recoil than the gosu)

---

In-game overlay

• To enable it, you need to edit tosu.env, and turn on ENABLE_GOSU_OVERLAY=true (make it equal true)
• Tutorial: link

---

Routes

gosu compatible api

• / - List of all counters you have
• /json - Example of /ws response
• /ws - response example
• /Songs/{path} - Show content of the file, or show list of files for a folder

v2 (tosu own api)

• /json/v2 - Example of /websocket/v2 response
• /websocket/v2 - response example
• /websocket/v2/precise - response example
• /files/beatmap/{path} - same as /Songs/{path}
• /files/skin/{path} - similar as /files/beatmap/{path}, but for a skin

api

• /api/calculate/pp - Calculate pp for beatmap with custom data
  • Response example
  • BY DEFAULT IT USES CURRENT BEATMAP (:))
  • All parameters are optional
  • path - Path to .osu file. Example: C:/osu/Songs/beatmap/file.osu
  • mode - Osu = 0, Taiko = 1, Catch = 2, Mania = 3
  • mods - Mods id. Example: 64 - DT
  • acc - Accuracy % from 0 to 100
  • nGeki - Amount of Geki (300g / MAX)
  • nKatu - Amount of Katu (100k / 200)
  • n300 - Amount of 300
  • n100 - Amount of 100
  • n50 - Amount of 50
  • nMisses - Amount of Misses
  • combo - combo
  • passedObjects - Sum of nGeki, nKatu, n300, n100, n50, nMisses
  • clockRate - Map rate number. Example: 1.5 = DT

---

Support

• Give a ⭐️ if this project helped you!
• If you need help setting up this program or have any suggestions/comissions, feel free to go to the discord channel above in the 🔵 tosu section

---

Author

👤 Mikhail Babynichev

• Website: http://kotrik.ru
• Twitter: @kotrik0
• Github: @KotRikD

Special thanks to @xxCherry, for providing memory reading library

🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page. You can also take a look at the contributing guide.

📝 License

Copyright © 2023-2024 Mikhail Babynichev.
This project is LGPL-3.0 licensed.