Install the Bob-Ddong-Iri-Hoyo Launcher

Download the Launcher

The Bob-Ddong-Iri-Hoyo launcher is distributed as a DMG file on the GitHub Releases page. In most cases, choose the latest release shown at the top and download the .dmg or .zip file.

Version Channels

The app is provided in three channels depending on stability and update cadence.

🟢 Stable The default channel for official and beta releases. Recommended for most users.

🟡 Staging The final verification channel before Stable Beta and official Stable releases.

🔴 Nightly An experimental channel where the latest development changes are built automatically.

Which version should I install?

Unless you have a specific reason, install the Stable version.
Staging and Nightly are intended for testing.

Installation Guide

Video installation guide

Caption notice

This video includes captions. If captions do not appear automatically or appear in another language, click the captions button in the YouTube player and select your language.

The steps below assume you downloaded a DMG file. Replace the example paths with your actual download location and file name.

1. Install Rosetta 2

Note

Rosetta 2 may be required to run x86_64-based components on Apple Silicon Macs. If Rosetta 2 is already installed, you can skip this step.

softwareupdate --install-rosetta --agree-to-license

Open Terminal and run the command. macOS will install Rosetta 2. If it is already installed, the command may finish without making any visible changes.

2. Remove the Quarantine Tag

Caution

This project’s distributed files may not be signed or notarized with an Apple developer certificate. If you run them in that state, macOS Gatekeeper may block the app or show it as damaged.

macOS adds a quarantine tag to files downloaded from the internet. The tag is used for security checks, but for a non-notarized app from a personal project, it can prevent the app from launching. Open Terminal, iTerm, or another terminal app and remove the quarantine tag from the downloaded DMG file with the command below.

xattr -d com.apple.quarantine {save-location}/{downloaded-file-name}.(dmg|zip|app)

For example, if the file is in your Downloads folder, replace {save-location} with ~/Downloads. If you see a message similar to No such xattr, it means the file does not have a quarantine tag to remove.

3. Install the Launcher

After removing the quarantine tag, double-click the downloaded DMG file in Finder. When the DMG is mounted, move the launcher app to the Applications folder as instructed, or follow the installation method provided by the distribution file.

The first time you launch the app, macOS may show another confirmation prompt. In that case, allow the app in System Settings under Privacy & Security, or Control-click the app in Finder and choose Open.

App Setup and Game Installation

After launching the app and waiting for the initial loading to finish, the Bottle list screen appears. A Bottle is an isolated runtime environment used by Wine, where Windows programs and their related settings are stored separately.

To create a new Bottle, click the + button in the lower-right corner, then choose the Wine version and DXMT version to use. If there is a recommended combination for a specific game, use that first and only switch versions when problems occur.

Tip

For Eternal Return, Wine11 or wine-crossover-26.1.0 is recommended.

For HoYoverse games, only Wine 11 and Wine 11.11 work.

Caution

All games may stutter a little on the first launch. This is a natural result of DXMT or Rosetta 2 building caches. After caching is complete, the stuttering should disappear. For that reason, if you are launching Eternal Return for the first time, starting with ranked play immediately is not recommended.

Tip

The Bob-Ddong-Iri-Hoyo launcher mainly targets Eternal Return and HoYoverse games. It does not guarantee successful launch or stability for every other Steam game.

Issues in games outside the supported scope are outside the intended support range. Before reporting a problem, first check whether the game is within the project’s supported targets.