Repository navigation
Releases
Genshin Map Overlay 1.1.5 – Snezhnaya Update
Snezhnaya update
- New Snezhnaya content. 13 new marker types, including Zapolyarny Palace, Fairy Wormwood, Lanternberry and Crystal Flora. They appear in the matching categories.
- Updated map tiles. The new Snezhnaya area now shows its terrain instead of black.
- The first start after the update takes a moment longer, while the tracker builds its map reference.
- Found markers and profiles stay.
Windows: download GenshinMapOverlay-Setup-1.1.5.exe below and run it. It updates your existing installation.
Windows may show "Windows protected your PC" because the app isn't signed yet. Click More info, then Run anyway.
Full guide: see the README · Questions and bug reports: Discord
Genshin Map Overlay 1.1.4 – Click Fix & Panel Settings UI Update
Click fix & panel settings UI update
- Clicks on the overlay work again after F7. After turning the overlay off and on with F7, clicks on markers and the panel could stop reaching the overlay. Now the overlay reloads itself when you turn it back on, so markers take a moment longer to show up after F7. If a click still gets lost (for example after an in-game dialog), the overlay notices and repairs itself.
- Everything disappears when the map closes. Markers no longer hang over the game world for a moment, and the panel, the spot card and an enlarged photo close together with the map. The panel comes back when you open the map again.
- New marker panel. Categories are tiles with a picture, three per row. Click one to unfold its marker types below. "Featured" is now Oculus with all eight oculi.
- Settings at the bottom of the panel: opacity, size, visible in screenshots, markers on the minimap, your keys and the marker data. Change the keys right there: click a key and press the new one.
- Markers on the minimap are now off by default. Switch them on in the panel settings or in the tray menu.
Windows: download GenshinMapOverlay-Setup-1.1.4.exe below and run it. It updates your existing installation, your found markers and profiles stay. If you already installed 1.1.4 before, install it again to get the panel update.
Windows may show "Windows protected your PC" because the app isn't signed yet. Click More info, then Run anyway.
macOS (Apple Silicon, beta): download GenshinMapOverlay-1.1.4-mac-arm64.zip, unzip it and move the app to Applications. On first start open System Settings → Privacy & Security → Open Anyway, then allow Screen Recording for Genshin Map Overlay and restart it. Details in the README.
Full guide: see the README · Questions and bug reports: Discord
Genshin Map Overlay 1.1.3 – Profiles & Backups
Profiles & backups
- Profiles. When the overlay starts, a small window asks which profile you play with. Each profile has its own list of found markers, e.g. for a second account. Your current list is Profile 1, nothing changes for it.
- Add, rename and delete profiles in that window. Switch later in the panel (Switch) or in the tray menu (Profile). Untick Ask on start if one profile is enough.
- Automatic backups. Before the first change after each start the overlay backs up your found markers (the last 20 per profile). If the list ever gets damaged, it loads the newest backup by itself. Tray menu → Advanced → Open backups folder.
- Found markers and settings are now saved so that a crash or power cut can't leave a half-written file.
Windows: download GenshinMapOverlay-Setup-1.1.3.exe below and run it. It updates your existing installation, your found markers stay.
Windows may show "Windows protected your PC" because the app isn't signed yet. Click More info, then Run anyway.
macOS (Apple Silicon, beta): download GenshinMapOverlay-1.1.3-mac-arm64.zip, unzip it and move the app to Applications. On first start open System Settings → Privacy & Security → Open Anyway, then allow Screen Recording for Genshin Map Overlay and restart it. Details in the README.
Full guide: see the README · Questions and bug reports: Discord
Genshin Map Overlay 1.1.2 – Better Map Tracking & Minimap
Better map tracking & minimap
- Markers on the minimap. After starting the overlay (or after a teleport), open the map once with M and close it. The overlay then knows where you are and shows the ticked marker types on the minimap while you explore, in the open world and in cities.
- Mark things as found on the go. Walk close to a marker: it gets a ring on the minimap and a prompt appears next to it. Press Alt+E to mark it as found. The key is only taken while the prompt shows.
- Steadier markers on the map. Markers stay on their spots when you drag and zoom quickly, and the small stutter once per second is gone. In areas with many in-game icons (e.g. Inazuma zoomed out) markers that used to drift off now stay in place.
- New switch Markers on the minimap in the panel and the tray menu.
Minimap markers are tested at 16:9 resolutions in fullscreen or borderless. In window mode or at other aspect ratios they may not show yet; the map markers work everywhere.
Windows: download GenshinMapOverlay-Setup-1.1.2.exe below and run it. It updates your existing installation, your found markers stay.
Windows may show "Windows protected your PC" because the app isn't signed yet. Click More info, then Run anyway.
macOS (Apple Silicon, beta): download GenshinMapOverlay-1.1.2-mac-arm64.zip, unzip it and move the app to Applications. On first start open System Settings → Privacy & Security → Open Anyway, then allow Screen Recording for Genshin Map Overlay and restart it. Details in the README.
Full guide: see the README · Questions and bug reports: Discord
Genshin Map Overlay 1.1.1 – Controller (test version)
The regular version stays 1.1.1.
Windows: download GenshinMapOverlay-Setup-1.1.1-controller.exe below and run it. It replaces your installed overlay, your found markers stay. To go back, install the regular 1.1.1 again.
Windows may show "Windows protected your PC" because the app isn't signed yet. Click More info, then Run anyway.
Controller: Xbox, PlayStation (DualShock 4, DualSense), Switch Pro and most other controllers, over USB or Bluetooth. Genshin reads the same controller, so the overlay only reacts to combinations: hold View (PlayStation: Create/Share) and press a second button. While you hold it, the buttons show at the bottom of the screen and a crosshair marks the middle. The marker closest to it is the selected one, so move the map with the stick until your marker sits in the middle.
| Xbox | PlayStation | What it does |
|---|---|---|
| View + Menu | Create + Options | Overlay on/off |
| View + Y | Create + △ | Open/close the marker panel |
| View + X | Create + □ | Show/hide found markers |
| View + A | Create + ✕ | Open/close the spot card of the selected marker |
| View + B | Create + ○ | Mark the selected marker as found (or not found again) |
If a combination also does something in the game, change it in the settings file (tray menu → Advanced → Open settings file, key gamepad, then Reload settings) and let us know on Discord. The controller can be turned off in the tray menu under Advanced. Mouse and F7–F10 work as before.
macOS: there is no Mac build of this test version, please use 1.1.1.
Full guide: README of the controller version
Genshin Map Overlay 1.1.1 – Resolution Patch
Resolution patch: fixes markers sitting far off their spots (often several hundred pixels too low) at resolutions like 1366×768, and with Windows display scaling such as 125 %. At 1920×1080, 1280×800 and 4K nothing changes.
Windows: download GenshinMapOverlay-Setup-1.1.1.exe below and run it. It updates your existing installation, your found markers stay.
Windows may show "Windows protected your PC" because the app isn't signed yet. Click More info, then Run anyway.
macOS (Apple Silicon, beta): download GenshinMapOverlay-1.1.1-mac-arm64.zip, unzip it and move the app to Applications. On first start open System Settings → Privacy & Security → Open Anyway, then allow Screen Recording for Genshin Map Overlay and restart it. Details in the README.
Full guide: see the README · Questions and bug reports: Discord
Genshin Map Overlay 1.1 – Linux (test version)
Windows and macOS: use the regular 1.1 release.
Linux (x64):
- AppImage: download GenshinMapOverlay-1.1.0-linux-x86_64.AppImage below, make it executable (
chmod +x GenshinMapOverlay-*.AppImage) and start it. AppImages need FUSE 2:sudo apt install libfuse2(Ubuntu 24.04:libfuse2t64). - Debian/Ubuntu: or install GenshinMapOverlay-1.1.0-linux-amd64.deb with
sudo apt install ./GenshinMapOverlay-1.1.0-linux-amd64.deband start it from the app menu.
Genshin runs on Linux only through Wine or Proton, which HoYoverse doesn't support officially, regardless of the overlay. Put the game in window or borderless mode and open the map with M.
Known limits:
- Wayland: the overlay restarts itself on XWayland (X11). Screen capture goes through the system dialog, pick the screen with the game. The dialog comes back at every start.
- The overlay shows up in screenshots and streams, Linux can't hide a window from captures.
- Hotkeys work while the game window has focus. On GNOME the tray icon needs the AppIndicator extension.
- "Start Genshin borderless" and the hotkey helper are Windows-only.
Full Linux guide: README
Genshin Map Overlay 1.1
Windows: download GenshinMapOverlay-Setup-1.1.0.exe below and run it.
Windows may show "Windows protected your PC" because the app isn't signed yet. Click More info, then Run anyway.
macOS (Apple Silicon, beta): download GenshinMapOverlay-1.1.0-mac-arm64.zip, unzip it and move the app to Applications. On first start open System Settings → Privacy & Security → Open Anyway, then allow Screen Recording for Genshin Map Overlay and restart it. Details in the README.
New since the beta:
- Markers, photos and map recognition come from our own server, the first start takes seconds
- Click a marker for the top voted photo of the spot, plus a video where there is one (over 14,800 photos)
- Much smoother tracking: markers show up as soon as the map opens and stay still while the map stands still
- New look in the colors of the Genshin interface, scales up to 4K
- The game's map buttons stay free
- English and German, right click to mark a marker as found
- Simpler tray menu
- New: macOS version for Apple Silicon (beta)
Full guide: see the README · Questions and bug reports: Discord