Repository navigation
Pixiv Menu Background English
Ez2Lazer can use illustrations from your Pixiv follow feed as the main menu background. On song change, a random cached image from EzResources/BG_PIXIV is shown immediately while one new illustration may download in the background. A badge in the lower-left shows the artist and work ID; click it to open the artwork on Pixiv.
Credentials and images are stored locally only and are not sent to osu! servers.
- Main menu → Settings → Background
- Set the background source to Pixiv follow feed
- Use the Pixiv section below for login and filters
Use the standalone EzPixivAuth tool (double-click the .bat file):
- Download EzPixivAuth Releases (v1.0.3+ recommended for script encoding fixes on localized Windows)
- Run
GetPixivRefreshToken.batand sign in inside the WebView2 window - The tool writes
pixiv_auth.jsonnext toclient.realm - In-game, click Check login
If you already have a refresh_token, expand Enter refresh_token manually, paste it, and click Save.
| Setting | Default | Description |
|---|---|---|
| Check login / Clear | — | Verify or delete local pixiv_auth.json
|
| Pixiv auto-download | Off | Keeps prefetching; fetches another feed page when fewer than 10 images are cached |
| Allow R-18 works | Off | Filters sanity_level ≥ 4 or R-18 tags when disabled |
| Landscape only | On | Only pages wider than tall; multi-page works pick from landscape pages only |
| Artist account whitelist | Empty | When set, only listed @account handles are allowed |
| Artist account blacklist | Empty | Matching accounts are skipped |
| Tag include (any) | Empty | Work must include at least one listed tag |
| Tag exclude | Empty | Works with any listed tag are skipped |
AI-generated works (Pixiv flags or common AI tags) are filtered when building the follow feed catalog.
Separate list entries with spaces, or commas/semicolons. For tags containing spaces, use commas: e.g. 女の子,AI Generated.
-
Immediate: random pick from cached
EzResources/BG_PIXIV(non-blocking) - Background: at most one new download per song change when logged in
- Dedup by illust ID + page; files are named
{artist}_{illustId}_p{page}.png
- Folder:
EzResources/BG_PIXIVunder the Ez2Lazer data root - Filters apply when fetching the follow feed; only catalog entries are downloaded
- No
.pixiv.jsonsidecar files
Lower-left label {user.name}_{illustId}; click to open Pixiv.
- A Pixiv account with followed artists (empty follow feed = no backgrounds)
- Network access to Pixiv APIs (proxy may be required in some regions)
- WebView2 is only required for EzPixivAuth, not for in-game backgrounds
| Issue | Suggestion |
|---|---|
| Check login fails | Re-run EzPixivAuth; ensure pixiv_auth.json is next to client.realm
|
| Blank background | Confirm Pixiv source is selected; follow feed may be empty; enable auto-download or change songs to trigger downloads |
| Passkey login unavailable | Use email + password in EzPixivAuth |
| Garbled script text | Upgrade EzPixivAuth to v1.0.3+ |
| Error 918 / invalid OAuth client | Use the latest EzPixivAuth release |