OpenStats is a Windows desktop companion for World of Warships. Live Stats, your live PR for the current game, remember people and more
openstats.eu — product visuals, and the official download site.
Discord — community help and feedback.
| You want to… | OpenStats helps by… |
|---|---|
| See who is in the match and on which ship | Monitor reads your WoWS replay folder and builds a live ally/enemy roster with enrichment (PR/WR-style summaries where data exists). |
| Look up one player by name | App runs a name search against your preferred region and can auto-fan-out to other regions when needed. |
| Remember certain accounts across matches | Social lists tag players with notes, highlight them on Monitor, and optional match alerts + sound. |
| Peek at live numbers while playing | Live Game (when enabled and your setup supports it) shows an optional overlay fed from the replay listener. |
| Review past games you have stored | History filters recorded games by region, mode, and time window. |
| Export the roster for spreadsheets or tools | Monitor offers JSON and CSV export of the current snapshot. |
There are no screenshots in this README: openstats.eu already presents OpenStats with layout, feature highlights, and release-oriented copy. Use that as the visual tour.
Enter a player name, press FIND, read the Result block. Your preferred region from Settings is used first; the client can search other regions automatically when the name is not found where you started. Switch NORMAL vs COPYABLE depending on whether you want a pretty layout or something you can paste into Discord or ingame chat. COPY grabs plain text for the active mode.
Point Settings at your real WoWS replay folder (typically …\World_of_Warships\replays). When the game writes a new .wowsreplay, OpenStats builds Allies and Enemies with ship lines, summaries, and per-player cards after enrichment. Export gives JSON/CSV; Screenshot-safe blurs names for streams or screenshots; Update stats forces a refresh when you suspect stale data or want an update after the game. The name stripe colour follows your monitor setting (ship PR, ship WR, or account WR).
Create or join lists with invite codes, add tagged players with free-text notes, and choose which list is active for Monitor highlights. Optional match alert sound and volume live in Settings. Creators can manage members, write access, and kicks; everyone can use local mute options when one list gets noisy.
Optional live metrics overlay while you play, when your replay path and settings allow the listener to run. If something is disabled, the Help tab and Settings explain the prerequisites.
Browse games OpenStats has recorded for you—filter by region, mode, and days, so you can skim recent activity without digging through raw files.
Replay path, preferred region, App display mode, monitor name stripe mode, social alert sound and volume, clear caches, and the on-disk config path footer. Save applies; Reset reloads from disk without saving edits.
Terms, privacy, and operator contact for the online Service are in Help → Legal (and align with what you accept when using live backends). This GitHub repository adds a LICENSE file that governs source and binaries published here—see below.
| OS | Windows 10 or later (64-bit) |
| Game | World of Warships for replay-driven Monitor/Live Game; other tabs may still be useful without a local install |
| Network | Internet for auth, lookups, and social features. |
The client may be published here so players and researchers can inspect what runs on their machine. That does not mean “do anything you want”:
- Personal use: install official builds; clone or read source for yourself.
- Not OK without written permission from the Operator: selling OpenStats, repackaging it for paid download, or commercially redistributing the source or binaries.
cd src
python -m pip install -r requirements.txt
python main.pyKeep the working directory as src so imports and bundled assets/web resolve correctly.
The public source code is provided for transparency and inspection. Access to the official OpenStats backend services is not guaranteed when running or compiling the client from source.
If you make any meaningful modifications to the client, especially changes that affect how it communicates with the backend (such as request patterns, automation, or data handling), you should run your own compatible server instead of using the official one.
Please be considerate when interacting with the official services. Clients that generate excessive, automated, or incompatible requests may be rate-limited or blocked to protect service stability.
Settings and paths stay on your PC. Live features talk to OpenStats backends under the terms in Help → Legal.
Parts of the original codebase were refactored prior to publication to improve readability, structure, and maintainability.
Claude was used to help refactor and clean up the original codebase before publication, which had grown a bit too messy for public consumption.
| Question | Answer |
|---|---|
| Can I download official builds or this repo for myself? | Yes, for personal, non-commercial use, per LICENSE. |
| Can I sell OpenStats or put a paid mirror of the binaries/source? | No, unless the Operator gives written permission. |
Full text: LICENSE
- Website: openstats.eu
- Discord: discord.gg/d3nabwhmYh