README install section: AUR (bnetctl-bin / bnetctl-git) first, release archives for other distros, go install as alternative.
#6 docs(readme): install from the AUR first
M .goreleaser.yaml +2 -2
| @@ -100,8 +100,8 @@ aurs: | |||
| 100 | 100 | - bnema <b at bnema dot dev> | |
| 101 | 101 | license: MIT | |
| 102 | 102 | optdepends: | |
| 103 | - | - 'wine-staging: Wine runtime (>= 11.19 for Wayland)' | |
| 104 | - | - 'wine: alternative Wine runtime' | |
| 103 | + | - 'wine-staging: recommended Wine runtime (launcher crash fix, >= 11.19 for Wayland HDR)' | |
| 104 | + | - 'wine: alternative Wine runtime (launcher may crash at startup)' | |
| 105 | 105 | - 'wine-cachyos-opt: fallback Wine runtime' | |
| 106 | 106 | - 'dxvk-mingw-git: Direct3D 8/9/10/11 translation to Vulkan' | |
| 107 | 107 | - 'vkd3d-proton-mingw-git: Direct3D 12 translation to Vulkan' | |
| @@ -100,8 +100,8 @@ aurs: | |||||
| 100 | - bnema <b at bnema dot dev> | 100 | - bnema <b at bnema dot dev> | ||
| 101 | license: MIT | 101 | license: MIT | ||
| 102 | optdepends: | 102 | optdepends: | ||
| 103 | - | - 'wine-staging: Wine runtime (>= 11.19 for Wayland)' | 103 | + | - 'wine-staging: recommended Wine runtime (launcher crash fix, >= 11.19 for Wayland HDR)' |
| 104 | - | - 'wine: alternative Wine runtime' | 104 | + | - 'wine: alternative Wine runtime (launcher may crash at startup)' |
| 105 | - 'wine-cachyos-opt: fallback Wine runtime' | 105 | - 'wine-cachyos-opt: fallback Wine runtime' | ||
| 106 | - 'dxvk-mingw-git: Direct3D 8/9/10/11 translation to Vulkan' | 106 | - 'dxvk-mingw-git: Direct3D 8/9/10/11 translation to Vulkan' | ||
| 107 | - 'vkd3d-proton-mingw-git: Direct3D 12 translation to Vulkan' | 107 | - 'vkd3d-proton-mingw-git: Direct3D 12 translation to Vulkan' | ||
M README.md +41 -4
| @@ -6,11 +6,18 @@ GPU-specific settings are applied automatically for AMD, NVIDIA, and Intel. | |||
| 6 | 6 | ||
| 7 | 7 | ## Requirements | |
| 8 | 8 | ||
| 9 | - | - Wine, **>= 11.19 for Wayland**. On Arch Linux, install either: | |
| 9 | + | - **Wine Staging >= 11.19**. On Arch Linux: | |
| 10 | 10 | ```bash | |
| 11 | 11 | sudo pacman -S wine-staging | |
| 12 | - | # Or: sudo pacman -S wine | |
| 13 | 12 | ``` | |
| 13 | + | - *Staging:* upstream Wine crashes the Battle.net launcher at startup | |
| 14 | + | ([Wine bug 56486](https://bugs.winehq.org/show_bug.cgi?id=56486)). The | |
| 15 | + | fix is the `dcomp-DCompositionCreateDevice2` patchset, which is only in | |
| 16 | + | Wine Staging so far. | |
| 17 | + | - *11.19:* minimum version for HDR on native Wayland. With older Wine, | |
| 18 | + | bnetctl warns and HDR is unavailable. | |
| 19 | + | - CachyOS Wine (`wine-cachyos-opt`) currently ships 10.x and does not meet | |
| 20 | + | either requirement. | |
| 14 | 21 | - Vulkan drivers for your GPU, plus DXVK and VKD3D-proton package data. | |
| 15 | 22 | On CachyOS these are available as `dxvk-mingw-git` and | |
| 16 | 23 | `vkd3d-proton-mingw-git`; other distributions may package them differently. | |
| @@ -19,7 +26,17 @@ GPU-specific settings are applied automatically for AMD, NVIDIA, and Intel. | |||
| 19 | 26 | ||
| 20 | 27 | ## Install | |
| 21 | 28 | ||
| 22 | - | With Go installed: | |
| 29 | + | On Arch Linux, install from the AUR: | |
| 30 | + | ||
| 31 | + | ```bash | |
| 32 | + | paru -S bnetctl-bin # Prebuilt release binary | |
| 33 | + | paru -S bnetctl-git # Built from the latest source | |
| 34 | + | ``` | |
| 35 | + | ||
| 36 | + | Other distributions can download a prebuilt archive (amd64 or arm64) from the | |
| 37 | + | [releases page](https://git.bnema.dev/bnetctl/releases). | |
| 38 | + | ||
| 39 | + | Alternatively, with Go installed: | |
| 23 | 40 | ||
| 24 | 41 | ```bash | |
| 25 | 42 | go install github.com/bnema/bnetctl@latest | |
| @@ -48,7 +65,7 @@ bnetctl clean -a # Also remove desktop entries and data | |||
| 48 | 65 | 1. `BNETCTL_WINE`, when set, selects the Wine executable for every display mode. | |
| 49 | 66 | 2. Otherwise, use `wine` on `PATH`, falling back to `/opt/wine-cachyos/bin/wine`. | |
| 50 | 67 | 3. A tracked prefix requires Wine at least as new as its recorded version, including for stop; an older explicit override is rejected. | |
| 51 | - | 4. `wineboot` and `wineserver` must be beside the resolved Wine binary; Wayland warns below 11.19. | |
| 68 | + | 4. `wineboot` and `wineserver` must be beside the resolved Wine binary; Wayland warns below 11.19 (HDR). | |
| 52 | 69 | ||
| 53 | 70 | For example: `BNETCTL_WINE=/usr/bin/wine bnetctl launch`. | |
| 54 | 71 | ||
| @@ -63,6 +80,26 @@ An existing `DXVK_HDR` takes precedence. `--no-hdr` disables automatic settings | |||
| 63 | 80 | and unsets inherited `DXVK_HDR`, but leaves user-provided `DXVK_CONFIG` intact. | |
| 64 | 81 | X11 mode leaves the user's HDR environment untouched. | |
| 65 | 82 | ||
| 83 | + | ## Known issues | |
| 84 | + | ||
| 85 | + | - **Launcher crash loop with upstream Wine:** the Battle.net launcher crashes | |
| 86 | + | in `libcef` at startup and keeps restarting | |
| 87 | + | ([Wine bug 56486](https://bugs.winehq.org/show_bug.cgi?id=56486), still | |
| 88 | + | open upstream). Use Wine Staging, which carries the fix. | |
| 89 | + | - **Battle.net UI under native Wayland:** Wine's Wayland driver cannot render | |
| 90 | + | the cross-process GPU surface used by Battle.net's embedded Chromium (CEF). | |
| 91 | + | bnetctl keeps CEF GPU rendering in-process and disables Chromium's background | |
| 92 | + | throttling; without that, the login popup loads but never returns, leaving | |
| 93 | + | the launcher on a spinner. If the UI still misbehaves, use | |
| 94 | + | `--display-driver x11`. | |
| 95 | + | - **HDR:** only on native Wayland with Wine >= 11.19, and only for World of | |
| 96 | + | Warcraft. The Battle.net launcher itself never runs in HDR. | |
| 97 | + | - **Wine systray:** disabled on every launch; on Wayland tiling compositors it | |
| 98 | + | shows up as an orphan floating window. | |
| 99 | + | - **Login certificate check:** Battle.net's backend certificate validation fails | |
| 100 | + | under Wine. bnetctl seeds the cached login address so the sign-in flow can | |
| 101 | + | recover. | |
| 102 | + | ||
| 66 | 103 | ## Troubleshooting | |
| 67 | 104 | ||
| 68 | 105 | - **Wayland rendering or login problems:** try `--display-driver x11` and check | |
| @@ -6,11 +6,18 @@ GPU-specific settings are applied automatically for AMD, NVIDIA, and Intel. | |||||
| 6 | 6 | ||||
| 7 | ## Requirements | 7 | ## Requirements | ||
| 8 | 8 | ||||
| 9 | - | - Wine, **>= 11.19 for Wayland**. On Arch Linux, install either: | 9 | + | - **Wine Staging >= 11.19**. On Arch Linux: |
| 10 | ```bash | 10 | ```bash | ||
| 11 | sudo pacman -S wine-staging | 11 | sudo pacman -S wine-staging | ||
| 12 | - | # Or: sudo pacman -S wine | |||
| 13 | ``` | 12 | ``` | ||
| 13 | + | - *Staging:* upstream Wine crashes the Battle.net launcher at startup | |||
| 14 | + | ([Wine bug 56486](https://bugs.winehq.org/show_bug.cgi?id=56486)). The | |||
| 15 | + | fix is the `dcomp-DCompositionCreateDevice2` patchset, which is only in | |||
| 16 | + | Wine Staging so far. | |||
| 17 | + | - *11.19:* minimum version for HDR on native Wayland. With older Wine, | |||
| 18 | + | bnetctl warns and HDR is unavailable. | |||
| 19 | + | - CachyOS Wine (`wine-cachyos-opt`) currently ships 10.x and does not meet | |||
| 20 | + | either requirement. | |||
| 14 | - Vulkan drivers for your GPU, plus DXVK and VKD3D-proton package data. | 21 | - Vulkan drivers for your GPU, plus DXVK and VKD3D-proton package data. | ||
| 15 | On CachyOS these are available as `dxvk-mingw-git` and | 22 | On CachyOS these are available as `dxvk-mingw-git` and | ||
| 16 | `vkd3d-proton-mingw-git`; other distributions may package them differently. | 23 | `vkd3d-proton-mingw-git`; other distributions may package them differently. | ||
| @@ -19,7 +26,17 @@ GPU-specific settings are applied automatically for AMD, NVIDIA, and Intel. | |||||
| 19 | 26 | ||||
| 20 | ## Install | 27 | ## Install | ||
| 21 | 28 | ||||
| 22 | - | With Go installed: | 29 | + | On Arch Linux, install from the AUR: |
| 30 | + | ||||
| 31 | + | ```bash | |||
| 32 | + | paru -S bnetctl-bin # Prebuilt release binary | |||
| 33 | + | paru -S bnetctl-git # Built from the latest source | |||
| 34 | + | ``` | |||
| 35 | + | ||||
| 36 | + | Other distributions can download a prebuilt archive (amd64 or arm64) from the | |||
| 37 | + | [releases page](https://git.bnema.dev/bnetctl/releases). | |||
| 38 | + | ||||
| 39 | + | Alternatively, with Go installed: | |||
| 23 | 40 | ||||
| 24 | ```bash | 41 | ```bash | ||
| 25 | go install github.com/bnema/bnetctl@latest | 42 | go install github.com/bnema/bnetctl@latest | ||
| @@ -48,7 +65,7 @@ bnetctl clean -a # Also remove desktop entries and data | |||||
| 48 | 1. `BNETCTL_WINE`, when set, selects the Wine executable for every display mode. | 65 | 1. `BNETCTL_WINE`, when set, selects the Wine executable for every display mode. | ||
| 49 | 2. Otherwise, use `wine` on `PATH`, falling back to `/opt/wine-cachyos/bin/wine`. | 66 | 2. Otherwise, use `wine` on `PATH`, falling back to `/opt/wine-cachyos/bin/wine`. | ||
| 50 | 3. A tracked prefix requires Wine at least as new as its recorded version, including for stop; an older explicit override is rejected. | 67 | 3. A tracked prefix requires Wine at least as new as its recorded version, including for stop; an older explicit override is rejected. | ||
| 51 | - | 4. `wineboot` and `wineserver` must be beside the resolved Wine binary; Wayland warns below 11.19. | 68 | + | 4. `wineboot` and `wineserver` must be beside the resolved Wine binary; Wayland warns below 11.19 (HDR). |
| 52 | 69 | ||||
| 53 | For example: `BNETCTL_WINE=/usr/bin/wine bnetctl launch`. | 70 | For example: `BNETCTL_WINE=/usr/bin/wine bnetctl launch`. | ||
| 54 | 71 | ||||
| @@ -63,6 +80,26 @@ An existing `DXVK_HDR` takes precedence. `--no-hdr` disables automatic settings | |||||
| 63 | and unsets inherited `DXVK_HDR`, but leaves user-provided `DXVK_CONFIG` intact. | 80 | and unsets inherited `DXVK_HDR`, but leaves user-provided `DXVK_CONFIG` intact. | ||
| 64 | X11 mode leaves the user's HDR environment untouched. | 81 | X11 mode leaves the user's HDR environment untouched. | ||
| 65 | 82 | ||||
| 83 | + | ## Known issues | |||
| 84 | + | ||||
| 85 | + | - **Launcher crash loop with upstream Wine:** the Battle.net launcher crashes | |||
| 86 | + | in `libcef` at startup and keeps restarting | |||
| 87 | + | ([Wine bug 56486](https://bugs.winehq.org/show_bug.cgi?id=56486), still | |||
| 88 | + | open upstream). Use Wine Staging, which carries the fix. | |||
| 89 | + | - **Battle.net UI under native Wayland:** Wine's Wayland driver cannot render | |||
| 90 | + | the cross-process GPU surface used by Battle.net's embedded Chromium (CEF). | |||
| 91 | + | bnetctl keeps CEF GPU rendering in-process and disables Chromium's background | |||
| 92 | + | throttling; without that, the login popup loads but never returns, leaving | |||
| 93 | + | the launcher on a spinner. If the UI still misbehaves, use | |||
| 94 | + | `--display-driver x11`. | |||
| 95 | + | - **HDR:** only on native Wayland with Wine >= 11.19, and only for World of | |||
| 96 | + | Warcraft. The Battle.net launcher itself never runs in HDR. | |||
| 97 | + | - **Wine systray:** disabled on every launch; on Wayland tiling compositors it | |||
| 98 | + | shows up as an orphan floating window. | |||
| 99 | + | - **Login certificate check:** Battle.net's backend certificate validation fails | |||
| 100 | + | under Wine. bnetctl seeds the cached login address so the sign-in flow can | |||
| 101 | + | recover. | |||
| 102 | + | ||||
| 66 | ## Troubleshooting | 103 | ## Troubleshooting | ||
| 67 | 104 | ||||
| 68 | - **Wayland rendering or login problems:** try `--display-driver x11` and check | 105 | - **Wayland rendering or login problems:** try `--display-driver x11` and check | ||
M packaging/aur/bnetctl-git/PKGBUILD +2 -2
| @@ -7,8 +7,8 @@ arch=('x86_64' 'aarch64') | |||
| 7 | 7 | url='https://git.bnema.dev/bnetctl' | |
| 8 | 8 | license=('MIT') | |
| 9 | 9 | makedepends=('go>=2:1.26.0' 'git') | |
| 10 | - | optdepends=('wine-staging: Wine runtime (>= 11.19 for Wayland)' | |
| 11 | - | 'wine: alternative Wine runtime' | |
| 10 | + | optdepends=('wine-staging: recommended Wine runtime (launcher crash fix, >= 11.19 for Wayland HDR)' | |
| 11 | + | 'wine: alternative Wine runtime (launcher may crash at startup)' | |
| 12 | 12 | 'wine-cachyos-opt: fallback Wine runtime' | |
| 13 | 13 | 'dxvk-mingw-git: Direct3D 8/9/10/11 translation to Vulkan' | |
| 14 | 14 | 'vkd3d-proton-mingw-git: Direct3D 12 translation to Vulkan' | |
| @@ -7,8 +7,8 @@ arch=('x86_64' 'aarch64') | |||||
| 7 | url='https://git.bnema.dev/bnetctl' | 7 | url='https://git.bnema.dev/bnetctl' | ||
| 8 | license=('MIT') | 8 | license=('MIT') | ||
| 9 | makedepends=('go>=2:1.26.0' 'git') | 9 | makedepends=('go>=2:1.26.0' 'git') | ||
| 10 | - | optdepends=('wine-staging: Wine runtime (>= 11.19 for Wayland)' | 10 | + | optdepends=('wine-staging: recommended Wine runtime (launcher crash fix, >= 11.19 for Wayland HDR)' |
| 11 | - | 'wine: alternative Wine runtime' | 11 | + | 'wine: alternative Wine runtime (launcher may crash at startup)' |
| 12 | 'wine-cachyos-opt: fallback Wine runtime' | 12 | 'wine-cachyos-opt: fallback Wine runtime' | ||
| 13 | 'dxvk-mingw-git: Direct3D 8/9/10/11 translation to Vulkan' | 13 | 'dxvk-mingw-git: Direct3D 8/9/10/11 translation to Vulkan' | ||
| 14 | 'vkd3d-proton-mingw-git: Direct3D 12 translation to Vulkan' | 14 | 'vkd3d-proton-mingw-git: Direct3D 12 translation to Vulkan' | ||
Comments00 unresolved
no comments yet.