- WebOsz

WebOsz is a sleek browser-based rhythm game inspired by the popular osu!mania game mode. Built with modern web technologies, it lets you play your favorite beatmaps directly in your browser by loading .osz files or searching for maps online — no installation needed.

✨ Features

• No Installation Required
  Simply open index.html in your browser and start playing — no build tools or servers needed.
  Or use this link https://kaanreal.github.io/WebOsz/

• Online Map Search & Download
  Search and instantly load beatmaps from online sources without downloading files to your computer.

• .osz File Support
  Load your existing osu!mania 4-key beatmap archives effortlessly.

• 4K Mania Focus
  Optimized specifically for 4-key osu!mania gameplay.

• Customizable Gameplay

  • Adjustable scroll speed
  • Variable playback rate (with optional pitch preservation)
  • Configurable keybinds
  • Custom note and accent colors

• Performance Tracking
  View your score, combo, and accuracy with detailed post-game stats.

• Modern & Responsive UI
  Clean and intuitive interface that works well on all screen sizes.

🚀 Getting Started

1. Clone or download this repository.
2. Open index.html in your preferred web browser.
3. Enjoy!

🎮 How to Play

1. Open index.html in your web browser or visit this site https://kaanreal.github.io/WebOsz/
2. Click the center circle on the start screen to load an .osz beatmap from your device.
3. Select a difficulty from the list once the map loads.
4. Optionally, adjust scroll speed, playback rate, or keybinds via the bottom navigation bar.
5. Press “Play” and hit the corresponding keys as notes reach the judgment line.

🔧 Customization

Keybinds

Change default keys (D, F, J, K) in the Keybinds menu. Preferences are saved locally in your browser.

Colors

Customize the UI accent color and note lane colors from the Customize menu. Changes are saved locally.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.