# genshin-wish-export: an Electron tool for pulling your Genshin Impact wish history off Windows

> biuuu/genshin-wish-export reads the game's wish-record API through an authKey grabbed from the game log or a proxy mode, merges new pulls with a local userData folder, and exports Excel. It is Windows 64-bit only, and the last push was on 2026-03-17.

**biuuu/genshin-wish-export** — Easily export the Genshin Impact wish record.

- Repository: https://github.com/biuuu/genshin-wish-export
- Stars: 3,829 · Forks: 382
- Language: JavaScript
- License: MIT
- Published: 2026-09-23 · Updated: 2026-09-23 · Language: en
- Canonical page: https://hysenlabs.com/projects/biuuu-genshin-wish-export

## What genshin-wish-export actually solves, and for whom

Genshin Impact's in-game wish history is a scrolling list. The game shows the last pulls, but it does not hand you a file, and the list is not designed for counting. Anyone who wants to know how many pulls happened since the last 5-star, or how a year of banners was distributed, has to reconstruct that from somewhere else. genshin-wish-export exists to do the reconstruction: it reads the wish-record API the game itself calls, writes the results into a local folder, and produces an Excel file. The README describes it as a small Electron tool that must run on 64-bit Windows. That constraint is the first thing to check against your setup, because it is stated as a requirement rather than a preference. The intended user is a Windows player who wants their own data, not a dashboard someone else hosts. The README points to a separate web project, voderl/genshin-gacha-analyzer, for deeper analysis after the Excel export, which tells you the tool's job ends at getting the data out.

## How the authKey path works: game log or proxy mode

The mechanism is the part worth understanding before you run anything. The wish-record endpoint requires an authKey, and the tool does not ask you to paste one. According to the README, it obtains the key either by reading the game log or by running in a proxy mode. With the key in hand, it calls the wish-record API and pulls the history. New records are merged with whatever is already stored locally, and the merged result is written to a userData folder in the current directory. That merge step is what makes repeated use sensible: you open the in-game wish history, click the load button, and the tool tops up its local copy rather than replacing it. The README also notes that data is saved locally, which means the record lives on your disk in that folder and nowhere else unless you export it. Two details are not documented: how long an authKey stays valid, and what the tool does when the game changes the log format it reads. Both are the kinds of things you find out by running it, not by reading the repository.

## Installing genshin-wish-export and loading your first wish history

There is no package-manager install. The README's usage section starts with downloading a zip and extracting it, with the release asset named Genshin-Wish-Export.zip under the latest release. After extracting, open the game's wish history screen, then click the tool's load-data button. If it works, the README says you will see a reading-data prompt and then a preview of the records. The build scripts in package.json are for people compiling from source, and they assume yarn:

```bash
# install modules
yarn install

# development mode
yarn dev

# build a runnable program
yarn build
```

The README gives those three commands under a heading spelled Devlopment, and they are the only build instructions present. Note the build target scripts: build:win64, build:win32, build:linux and build:mac all exist in package.json, and the electron-builder config sets productName to "Genshin Wish Export" and appId to org.biuuu.genshin-wish-export. The README's user-facing instructions, however, only promise Windows 64-bit. For multiple accounts, the README says to click the plus button next to the load control, switch accounts in the game, open the wish history again, and click load once more. Each account's data goes into the same local store.

## Restoring from Excel, and the UID trap in that workflow

The export is not one-way. The README describes a round trip through a web page at genshin-gacha-export.danmu9.com: you feed it an Excel file, it produces JSON, and you can also pick a cutoff time on the page to strip duplicate records. Copy the downloaded JSON into the tool's userData folder and the data is restored. The README adds a warning that is easy to skim past: you must enter the correct UID and select the language that was used in the Excel file. Get either wrong and the restored record will not line up with what the tool already has, which is a quiet failure rather than an error message. This workflow matters if you ever move machines or lose the userData folder, because the Excel file becomes your only backup. It also matters if you want to trim duplicates before re-importing, which is the one piece of editing the web page supports. The tool itself, per the README, offers no deduplication UI beyond the merge it performs on load.

## Windows-only, and other cases where this is the wrong tool

The clearest limitation is the platform. The README states the tool needs to run on 64-bit Windows, and the usage section gives a Windows zip. If you play on Android, iOS, PlayStation or macOS, this repository is not aimed at you, regardless of what the build scripts can technically target. The related searches around an apk, iOS or Android version do not correspond to anything the README offers. A second limitation is the data store: it lives in a userData folder in the current directory, so where you extract the zip determines where your history lives. Move the folder and the tool starts from nothing until you restore from JSON. A third is the analysis ceiling. The tool exports; it does not chart pity, compare banners over time, or compute averages. The README sends you to a separate web project for that. If what you want is a live counter or a wish simulator, this is the wrong repository entirely, because it only reads records the game has already written. And if the wish-record API or the log format changes, the README documents no fallback path.

## How it compares with the manual alternative and with the analyzer web project

The realistic alternative is not another desktop app. It is copying numbers out of the in-game history by hand into a spreadsheet, or using a hosted tracker that asks for the same authKey. The difference in approach is where the key goes. genshin-wish-export reads the key locally and writes the record to a folder on your machine; a hosted tracker receives the key on someone else's server. That distinction, not any feature list, is the reason to pick this one. The other comparison the README itself draws is with voderl/genshin-gacha-analyzer, which it recommends for more detailed data analysis after exporting Excel. Those two are complementary rather than competing: this project is the extractor, and the analyzer is the viewer. If your goal is charts rather than a file, you still need something like this tool in front of it. If your goal is a file you control, the analyzer alone will not produce one.

## Maintenance, licence and what an upgrade costs you

The repository is not archived, and the last push was on 2026-03-17, which is also the date of release v0.12.1. The release before it, v0.12.0, was on 2025-12-06, and v0.11.9 was on 2024-07-28. That spacing is worth reading plainly: this is a small tool that gets touched when something breaks or a release is needed, not a project with a steady cadence. It is licensed MIT, which permits commercial and private use, modification and redistribution provided the copyright notice and licence text are kept; the LICENSE file sits at the repository root. Nothing in the README describes a breaking change policy, a migration path between versions, or what happens to an existing userData folder when the tool updates. In practice the upgrade cost is low because the data format is a local folder plus Excel, but you should keep a copy of your exported file before replacing the executable. The README does not document rollback to an older release.

## Conclusion

Adopt it if you play Genshin Impact on Windows 64-bit, want your own pull history in a spreadsheet, and are comfortable with a tool that keeps its data in a userData folder next to the executable. Do not adopt it on macOS, Linux, Android or iOS, and do not expect the README to explain what happens when the authKey expires or the log format changes. Before trusting it with a long history, verify two things yourself: that the export contains every pull you expect, and that the JSON you copy back into userData restores the same record. The repository's own build scripts cover win32, linux and mac targets, but the README's usage section only promises Windows 64-bit, so treat the other targets as unverified until you build and run them.

## FAQ

### How does genshin-wish-export get my wish history?

According to the README, it obtains the authKey needed for the wish-record API either by reading the game log or through a proxy mode, then calls the API with that key. New records are merged with the local data in the userData folder.

### Can I restore data into genshin-wish-export from an Excel file?

Yes. The README describes converting Excel to JSON through genshin-gacha-export.danmu9.com, optionally trimming duplicates by cutoff time, then copying the JSON into the tool's userData folder. The README warns that you must enter the correct UID and the language used in the Excel file.

### Does genshin-wish-export analyze or chart my pulls?

No. It exports the record, and the README recommends the separate web project voderl/genshin-gacha-analyzer for more detailed data analysis after the Excel export.

## Sources

- [biuuu/genshin-wish-export on GitHub](https://github.com/biuuu/genshin-wish-export)
- [Issues](https://github.com/biuuu/genshin-wish-export/issues)
- [License: MIT](https://github.com/biuuu/genshin-wish-export/blob/main/LICENSE)
- [README](https://github.com/biuuu/genshin-wish-export/blob/main/README.md)
- [Releases](https://github.com/biuuu/genshin-wish-export/releases)

---

Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/biuuu-genshin-wish-export