osuWRS - a osu! Wallpaper Replace Script

自定义 osu!stable 主页背景脚本 (无需 Supporter 标签)

Github | 更新日志 | English README

注意

• 仅支持Windows系统下的osu!stable版，不支持lazer。

下载

• Releases (推荐)
• Clone 源码

使用

1. 将背景图片（支持 .jpg, .jpeg, .png）放入 bg/ 文件夹。
2. 运行 osuWRS.exe (推荐) 或 python osuWRS.py。
3. 首次运行会自动寻找 osu! 路径并生成 config.ini，若寻找失败请手动修改配置文件。

功能

• 全自动: 自动寻找路径、同步背景信息、完成替换。
• 零依赖: 纯标准库实现。
• 多图替换: 支持 jpg/jpeg/png 格式多图替换（需少于服务器下发图片数量）。
• 锁定机制: 强力锁定 Data/bg 目录，背景不再失效。
• 代理支持: 支持系统代理及自定义代理。
• 无感启动: 你甚至能当作 osu! 的启动器，osuWRS 会自动检测云端更新并自动替换。

配置

• [osu] path: osu! 安装根目录。
• [osu] quickStart: 替换完成后是否自动启动 osu!。
• [osuWRS] proxy: 代理设置 (off, system, 或具体地址)。
• 其他详见 config.ini 中的说明。

教程

• v0.0 原理解析 (需要手动 控制/还原/删除 Data\bg 文件夹请参考这个视频)
• v1.0 视频教程
• v2.0 视频教程
• v3.0 文字教程 (几乎开箱即用)

关注我

Github | Bilibili

免责声明

本工具涉及对游戏目录权限的操作，请确保你有足够的权限运行。修改游戏文件可能违反某些服务条款，请自行承担风险。

致谢

• Gemini 3 Pro/Flash 和 Roo Code 协助我进行了本次重构。
• 某份 2022 年的存档，感谢B站网友的支持。

许可证

GNU General Public License v3.0