{"id":18611059,"url":"https://github.com/beangreen247/battle.net_linux_install_guide","last_synced_at":"2026-04-27T11:31:34.981Z","repository":{"id":153757037,"uuid":"205657315","full_name":"BeanGreen247/Battle.net_Linux_install_guide","owner":"BeanGreen247","description":null,"archived":false,"fork":false,"pushed_at":"2020-09-20T22:17:58.000Z","size":56,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-04-24T05:41:42.598Z","etag":null,"topics":["arch-linux","battlenet-launcher","beangreen","beangreen247","debian","directx","dxvk","guide","install","wine-staging"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BeanGreen247.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-09-01T09:49:20.000Z","updated_at":"2026-04-16T18:30:37.000Z","dependencies_parsed_at":null,"dependency_job_id":"981b08cd-d861-4543-af7e-96756fcb512a","html_url":"https://github.com/BeanGreen247/Battle.net_Linux_install_guide","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/BeanGreen247/Battle.net_Linux_install_guide","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BeanGreen247%2FBattle.net_Linux_install_guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BeanGreen247%2FBattle.net_Linux_install_guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BeanGreen247%2FBattle.net_Linux_install_guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BeanGreen247%2FBattle.net_Linux_install_guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BeanGreen247","download_url":"https://codeload.github.com/BeanGreen247/Battle.net_Linux_install_guide/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BeanGreen247%2FBattle.net_Linux_install_guide/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32335295,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arch-linux","battlenet-launcher","beangreen","beangreen247","debian","directx","dxvk","guide","install","wine-staging"],"created_at":"2024-11-07T03:12:30.385Z","updated_at":"2026-04-27T11:31:34.955Z","avatar_url":"https://github.com/BeanGreen247.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Battle.net install guide\n## The requirements\n\nInstall wine-staging. To do so follow the guide\n```\nhttps://wiki.winehq.org/Download\n```\n\n### Ubuntu\nFor **Ubuntu** run these commands first\n```\nsudo dpkg --add-architecture i386 \nwget -nc https://dl.winehq.org/wine-builds/winehq.key\nsudo add-apt-repository 'deb https://dl.winehq.org/wine-builds/ubuntu/ focal main'\n```\nNext update your packages\n```\nsudo apt update\n```\nInstall Dependencies\n```\nsudo apt install -y libc6 libgcc1 libglib2.0-0 libgphoto2-6 libgphoto2-port12 libgstreamer-plugins-base1.0-0 libgstreamer1.0-0 liblcms2-2 libldap-2.4-2 libmpg123-0 libopenal1 libpulse0 libudev1 libx11-6 libxext6 libxml2 zlib1g libasound2-plugins libncurses5 libcapi20-3 libcups2 libdbus-1-3 libfontconfig1 libfreetype6 libglu1-mesa libgnutls30 libgsm1 libgssapi-krb5-2 libgtk-3-0 libkrb5-3 libncurses5 libodbc1 libosmesa6 libpcap0.8 libpng16-16 libsane1 libsdl2-2.0-0 libtiff5 libv4l-0 libva-drm2 libva-x11-2 libva2 libvulkan1 libxcomposite1 libxcursor1 libxfixes3 libxi6 libxinerama1 libxrandr2 libxrender1 libxslt1.1 libxxf86vm1 gnutls-bin cabextract\nsudo apt install -y libgnutls30:i386 libldap-2.4-2:i386 libgpg-error0:i386 libxml2:i386 libasound2-plugins:i386 libsdl2-2.0-0:i386 libfreetype6:i386 libdbus-1-3:i386 libsqlite3-0:i386\n```\nInstall wine-staging\n```\nsudo apt install --install-recommends winehq-staging\n```\n\n### Debian 10\nFor **Debian 10** run these commands first\n```\nsudo dpkg --add-architecture i386 \nwget -nc https://dl.winehq.org/wine-builds/winehq.key\nwget -nc https://download.opensuse.org/repositories/Emulators:/Wine:/Debian/Debian_10/Release.key\nsudo apt-key add winehq.key\nsudo apt-key add Release.key\nsudo apt-add-repository contrib\n```\nNext open your /etc/apt/sources.list file and add to the end of the file\n```\ndeb https://dl.winehq.org/wine-builds/debian/ buster main\ndeb-src https://dl.winehq.org/wine-builds/debian/ buster main\ndeb https://download.opensuse.org/repositories/Emulators:/Wine:/Debian/Debian_10 ./\n```\nNext update your packages\n```\nsudo apt update\n```\nInstall Dependencies\n```\nsudo apt install -y libc6 libgcc1 libglib2.0-0 libgphoto2-6 libgphoto2-port12 libgstreamer-plugins-base1.0-0 libgstreamer1.0-0 liblcms2-2 libldap-2.4-2 libmpg123-0 libopenal1 libpulse0 libudev1 libx11-6 libxext6 libxml2 zlib1g libasound2-plugins libncurses5 libcapi20-3 libcups2 libdbus-1-3 libfontconfig1 libfreetype6 libglu1-mesa libgnutls30 libgsm1 libgssapi-krb5-2 libgtk-3-0 libkrb5-3 libncurses5 libodbc1 libosmesa6 libpcap0.8 libpng16-16 libsane1 libsdl2-2.0-0 libtiff5 libv4l-0 libva-drm2 libva-x11-2 libva2 libvulkan1 libxcomposite1 libxcursor1 libxfixes3 libxi6 libxinerama1 libxrandr2 libxrender1 libxslt1.1 libxxf86vm1 gnutls-bin cabextract\nsudo apt install -y libgnutls30:i386 libldap-2.4-2:i386 libgpg-error0:i386 libxml2:i386 libasound2-plugins:i386 libsdl2-2.0-0:i386 libfreetype6:i386 libdbus-1-3:i386 libsqlite3-0:i386\n```\nInstall wine-staging\n```\nsudo apt install --install-recommends winehq-staging\n```\n### Arch Linux\nFor **Arch Linux** go and open your terminal. We will need to edit the pacman.conf file\n```\nsudo nano /etc/pacman.conf\n```\nScroll down and find where it starts saying [testing], [core], [extra], [community] and so on. Make sure to remove \"#\" at he beginning of the line so it looks like this.\n```\n# The testing repositories are disabled by default. To enable, uncomment the\n# repo name header and Include lines. You can add preferred servers immediately\n# after the header, and they will be used before the default mirrors.\n[testing]\nInclude = /etc/pacman.d/mirrorlist\n[core]\nInclude = /etc/pacman.d/mirrorlist\n[extra]\nInclude = /etc/pacman.d/mirrorlist\n[community-testing]\nInclude = /etc/pacman.d/mirrorlist\n[community]\nInclude = /etc/pacman.d/mirrorlist\n# If you want to run 32 bit applications on your x86_64 system,\n# enable the multilib repositories as required here.\n[multilib-testing]\nInclude = /etc/pacman.d/mirrorlist\n[multilib]\nInclude = /etc/pacman.d/mirrorlist\n# An example of a custom package repository.  See the pacman manpage for\n# tips on creating your own repositories.\n#[custom]\n#SigLevel = Optional TrustAll\n#Server = file:///home/custompkgs\n```\nNext update the packages\n```\nsudo pacman -Suy\n```\nAnd install wine-staging\n```\nsudo pacman -Sy wine-staging\n```\nAnd lastly install all of these packages\n```\nsudo pacman -Sy giflib lib32-giflib libpng lib32-libpng libldap lib32-libldap gnutls lib32-gnutls mpg123 lib32-mpg123 openal lib32-openal v4l-utils lib32-v4l-utils libpulse lib32-libpulse libgpg-error lib32-libgpg-error alsa-plugins lib32-alsa-plugins alsa-lib lib32-alsa-lib libjpeg-turbo lib32-libjpeg-turbo sqlite lib32-sqlite libxcomposite lib32-libxcomposite libxinerama lib32-libgcrypt libgcrypt lib32-libxinerama ncurses lib32-ncurses opencl-icd-loader lib32-opencl-icd-loader libxslt lib32-libxslt libva lib32-libva gtk3 lib32-gtk3 gst-plugins-base-libs lib32-gst-plugins-base-libs vulkan-icd-loader lib32-vulkan-icd-loader cups samba alsa alsa-utils alsa-tools gnutls libpng wine-mono lib32-libxml2 lib32-mpg123 lib32-lcms2 lib32-giflib lib32-libpng lib32-gnutls pygtk python2-dbus lib32-libpulse lib32-fontconfig lib32-libxcomposite lib32-libxrender  lib32-libxslt lib32-gnutls lib32-libxi lib32-libxrandr lib32-libxinerama lib32-libcups lib32-freetype2 lib32-libpng lib32-openal python-pyopencl lib32-v4l-utils lib32-libxcursor lib32-mpg123 lib32-sdl xf86-video-intel lib32-mesa-libgl nss-mdns --needed --noconfirm\n```\nWith that please reboot and proceed with the guide\n\n## The guide\n\nCreate the main directory (we will be using this directory for all the configurations and tweaks....may be different in your case)\n```\nsudo mkdir /home/usernamehere/Games/battlenet-wine-prefix\n```\nCreate wine prefix\n```\nsudo WINEPREFIX=/home/usernamehere/Games/battlenet-wine-prefix WINEARCH=win64 winecfg\n```\nInstall winetricks\n```\nwget https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks\nchmod +x winetricks\nsudo mv -v winetricks /usr/local/bin\n```\nInstall .NET Framework\n```\nsudo WINEPREFIX=/home/usernamehere/Games/battlenet-wine-prefix WINEARCH=win64 winetricks -q --force dotnet48 vcrun2003 vcrun2005 vcrun2008 vcrun2012 vcrun2013 directplay \n```\nLower audio latency\n```\nsudo WINEPREFIX=/home/usernamehere/Games/battlenet-wine-prefix WINEARCH=win64 winetricks sound=alsa\ncat \u003e dsound.reg \u003c\u003c \"EOF\"\nWindows Registry Editor Version 5.00\n\n[HKEY_CURRENT_USER\\Software\\Wine\\DirectSound]\n\"HelBuflen\"=\"128\"\n\"SndQueueMax\"=\"1\"\nEOF\nsudo WINEPREFIX=/home/usernamehere/Games/battlenet-wine-prefix WINEARCH=win64 wine regedit dsound.reg\n```\nDownload Battlenet Launcher\n\nhttps://www.battle.net/download/getInstallerForGame?os=win\u0026locale=enUS\u0026version=LIVE\u0026gameProgram=BATTLENET_APP\n\nInstall dxvk 1.7.1\n\nDownload https://github.com/doitsujin/dxvk/releases/download/v1.7.1/dxvk-1.7.1.tar.gz\n\nExtract dxvk-1.7.1.tar.gz and copy its contents\n```\nsudo cp -r dxvk-1.7.1/x64/* /mnt/84C2FF4EC2FF42CA/battlenet-wine-prefix/drive_c/windows/system32/\nsudo cp -r dxvk-1.7.1/x32/* /mnt/84C2FF4EC2FF42CA/battlenet-wine-prefix/drive_c/windows/system/\n```\nOpen winecfg\n```\nsudo WINEPREFIX=/home/usernamehere/Games/battlenet-wine-prefix/ WINEARCH=win64 winecfg\n- Set Windows version to Windows 7 if not done already\n- Go to libraries and add\n\u003e\u003ed3d10\n\u003e\u003ed3d10_1\n\u003e\u003ed3d10core\n\u003e\u003ed3d11\n\u003e\u003ed3d12\n\u003e\u003ed3d8\n\u003e\u003ed3d9\n\u003e\u003edxgi\n- Set them to native and click apply\n- Next go to graphics tick \"Allow the window manager to control the windows\"\n- Next go to Staging and tick the first four\n```\nNext install DirectX\n\nTo do so download the DirectX web installer\nhttps://www.microsoft.com/en-us/download/details.aspx?id=8109\n\nThen launch it using the following command\n```\nsudo WINEPREFIX=/home/usernamehere/Games/battlenet-wine-prefix/ WINEARCH=win64 wine ~/Downloads/directx_Jun2010_redist.exe\n```\nIt will aske where to install. Pick C:\\\n\nOnce done launch the installer\n```\nsudo WINEPREFIX=/home/usernamehere/Games/battlenet-wine-prefix/ WINEARCH=win64 wine /home/usernamehere/Games/battlenet-wine-prefix/drive_c/DXSETUP.exe\n```\n\nOnce finished with the install continue.\n\nInstall the Battlenet Launcher\n```\nsudo WINEPREFIX=/home/usernamehere/Games/battlenet-wine-prefix/ WINEARCH=win64 wine ~/Downloads/Battle.net-Setup.exe\n```\nAfter installing please continue\n\nCreate a custom terminal command for launching Battlenet Launcher!\n```\ncat \u003e battlenet \u003c\u003c \"EOF\"\n#!/bin/sh\nsudo WINEPREFIX=/home/usernamehere/Games/battlenet-wine-prefix/ WINEARCH=win64 wine /home/usernamehere/Games/battlenet-wine-prefix/drive_c/Program\\ Files\\ \\(x86\\)/Battle.net/Battle.net\\ Launcher.exe\n\nEOF\n```\nCreate a custom terminal command for killing Battlenet Launcher!\n```\ncat \u003e battlenetkill \u003c\u003c \"EOF\"\n#!/bin/sh\nsudo WINEPREFIX=/home/usernamehere/Games/battlenet-wine-prefix/ WINEARCH=win64 wineserver -k\nsudo killall -9 /opt/wine-staging/bin/*\nEOF\n```\nMake the commands executable and make them accesable from the terminal\n```\nsudo mv battlenet /usr/bin/\nsudo chmod +x /usr/bin/battlenet\nsudo mv battlenetkill /usr/bin/\nsudo chmod +x /usr/bin/battlenetkill\n```\n## Troubleshooting\nIf you get any error related to Windows, dlls missing or exes missing, just remove the prefix folder and start again\n```\nsudo rm -rf /home/usernamehere/Games/battlenet-wine-prefix\n```\nIf the game refuses to run make sure to test if X11 allows you to open any app as root. \n\nTo do so run\n```\nsudo gedit\n```\nOR\n```\nsudo mousepad\n```\nTo fix run\n```\nxhost +si:localuser:root\n```\nIf you get this error\n```\nX Error of failed request:  BadWindow (invalid Window parameter)\n  Major opcode of failed request:  10 (X_UnmapWindow)\n  Resource id in failed request:  0x1a00001\n  Serial number of failed request:  293\n  Current serial number in output stream:  296\n```\nMake sure to run the game in virtual desktop\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeangreen247%2Fbattle.net_linux_install_guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbeangreen247%2Fbattle.net_linux_install_guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeangreen247%2Fbattle.net_linux_install_guide/lists"}