18-LAB / Documentation
vosulay
vosulay renders tosu-compatible counters inside osu! using a native Rust host and one Chromium Embedded Framework (CEF) browser runtime. It manages the layout; a separately running vosu or tosu-compatible backend supplies installed counters and game data.
These docs cover vosulay 1.5.0, including the compact inspector, full placement editor, native vosu settings editor, per-placement settings-profile pins, ruleset-bound profiles and installation as an official vosu tool.
The default backend is http://127.0.0.1:24050/. Change it in Settings → Advanced → vosu URL, then restart vosulay. Compatibility comes from the public counter API, not the backend's product name. vosu remains independent of vosulay.
Install vosulay · First overlay · Set up vosu
What you can do
- Move, resize, scale, crop, rotate, reorder and change overlay opacity; Ctrl+drag scales and Shift+drag crops.
- Disable a placement without deleting it.
- Keep multiple named profiles and switch layouts, or bind profiles to osu!, taiko, catch or mania so they follow vosu's ruleset changes.
- Search installed counters by name, author or folder.
- Edit vosu counter settings and settings profiles natively; pin each placement to a profile.
- Add custom remote URLs or local HTML files.
- Use Chromium GPU compositing, WebGL, WebGPU where supported, and overlay audio.
- Serve view-only profiles to browsers and streaming clients, and the full editor to OBS, a browser or other overlay software on the same computer.
- Run as an overlay server only (
--server-only), and toggle editing or quit from scripts and keybinds (--toggle-edit,--quit). - Use Automatic FPS to divide the attached display's refresh rate down to 120 fps or less.
Platforms and rendering
| Platform | Supported game/rendering routes |
|---|---|
| Linux | Vulkan, EGL/OpenGL and GLX/OpenGL; native Wayland and X11/XWayland games; osu!stable through Wine's X11 driver, including osu-winello. Live attachment or launch-time preload/layer integration. |
| Windows | osu!stable (osu!.exe) and osu!lazer (osulazer.exe) through native asdf-overlay 2.1.0 injection. |
Release downloads target x86_64. Linux binaries require glibc 2.35 or newer. See the Linux and Windows guides before configuring game capture or attachment.
Next steps
| Task | Guide |
|---|---|
| Arrange counters | Editor |
| Save different layouts | Profiles |
| Add or configure content | Overlays |
| Use a browser or OBS source | Remote profiles |
| Change defaults | Settings |
| Fix missing overlays | Troubleshooting |
Source: vosulay 1.5.0 README.