Improved fork of https://github.com/Detanup01/gbe_fork for Goldberg Steam Emulator, originally developed by Mr_Goldberg - https://gitlab.com/Mr_Goldberg/goldber
Improved fork of https://github.com/Detanup01/gbe_fork for Goldberg Steam Emulator, originally developed by Mr_Goldberg - https://gitlab.com/Mr_Goldberg/goldber
Fork of https://gitlab.com/Mr_Goldberg/goldberg_emulator with a lot of fixes, improvements, additional features and a completely reworked file structure.
:red_circle:
This fork is not a takeover, not a resurrection of the original project, and not a replacement.
You are highly encouraged to fork/clone it and do whatever you want with it.
:red_circle:
This fork is incompatible with the original repo, lots of things has changed and might be even broken. If something doesn't work, feel free to create a pull request with the appropriate fix, otherwise ignore this fork and use the original emu.
Thanks to everyone contributing to this project in any way possible, we try to keep the CHANGELOG.md updated with all the changes and their authors.
This project depends on many third-party libraries and tools, credits to them for their amazing work, you can find their listing here in CREDITS.md.
generate_interfaces tool.ColdClientLoader setup.You can find some guides, helper tools and scripts here:
These guides, tools and scripts are maintained by their authors. Before using them, it's always a good idea to first make sure they are updated and designed to support all features of this fork of the emulator.
You can also find instructions here in README.release.md
Tools bundled in this repository:
steam_api(64).dll / libsteam_api.so and writes the required steam_interfaces.txtsteamclient.so / steamclient64.so build, taking the exe path, appid and optional working directory from the command line or ldr_*.txt files; see its READMEClone the repo and its submodules recursively
git clone --recurse-submodules -j8 https://github.com/alex47exe/gse_fork.git The switch -j8 is optional, it allows Git to fetch up to 8 submodules
It is advisable to always checkout submodules every now and then, to make sure they're up to date
git submodule update --init --recursive --remoteYou need Windows 10 or 8.1 + WDK
Using Visual Studio, install Visual Studio 2022 Community: https://visualstudio.microsoft.com/vs/community/
Desktop development with C++Individual components scroll to the bottom and select the latest version of Windows XX SDK (XX.X...)Windows 11 SDK (10.0.22621.0)Using MSYS2 this is currently experimental and will not work due to ABI differences: https://www.msys2.org/
steps
UCRT64 or MINGW64 then install the GCC toolchainUCRT64 pacman -S mingw-w64-ucrt-x86_64-gccMINGW64pacman -S mingw-w64-i686-gccMINGW32 then install the GCC toolchainpacman -S mingw-w64-i686-gccPython 3.10 or above: https://www.python.org/downloads/windows/
After installation, make sure it works
python --version(Optional) Install a GUI for Git like GitHub Desktop, or Sourcetree
sudo apt update -y
sudo apt install -y coreutils # echo, printf, etc...
sudo apt install -y build-essential
sudo apt install -y gcc-multilib # needed for 32-bit builds
sudo apt install -y g++-multilib
sudo apt install -y libglx-dev # needed for overlay build (header files such as GL/glx.h)
sudo apt install -y libgl-dev # needed for overlay build (header files such as GL/gl.h)sudo apt install -y clang # clang compiler
sudo apt install -y binutils # contains the tool 'readelf' mainly, and other usefull binary stuffsudo apt update -y
sudo apt install -y software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa -y
sudo apt update -y
sudo apt install -y "python3.12"
sudo apt install -y "python3.12-dev"
sudo apt install -y "python3.12-venv"
sudo apt install -y python3-dev
# make sure it works
python3.12 --versionThese are third party libraries needed to build the emu later, they are linked with the emu during its build process.
You don't need to build these dependencies every time, they rarely get updated.
The only times you'll need to rebuild them is either when their separate build folder was accidentally deleted, or when the dependencies were updated.
Open CMD in the repo folder, then run the following
To build using Visual Studio
set "CMAKE_GENERATOR=Visual Studio 18 2026"
third-party\common\win\premake\premake5.exe --file=premake5-deps.lua --64-build --32-build --all-ext --all-build --verbose --os=windows vs2026To build using MSYS2 this is currently experimental and will not work due to ABI differences
steps
(Optional) In both cases below, you can use Clang compiler instead of GCC by running these 2 commands in the same terminal instance
export CC="clang"
export CXX="clang++"UCRT64 or MINGW64)export CMAKE_GENERATOR="MSYS Makefiles"
./third-party/common/win/premake/premake5.exe --file=premake5-deps.lua --64-build --all-ext --all-build --verbose --os=windows gmake2MINGW32)export CMAKE_GENERATOR="MSYS Makefiles"
./third-party/common/win/premake/premake5.exe --file=premake5-deps.lua --32-build --all-ext --all-build --verbose --os=windows gmake2This will:
third-party into the folder build\deps\winOpen a terminal in the repo folder
(Optional) You can use Clang compiler instead of GCC by running these 2 commands in the current terminal instance
export CC="clang"
export CXX="clang++"Then run the following
export CMAKE_GENERATOR="Unix Makefiles"
./third-party/common/linux/premake/premake5 --file=premake5-deps.lua --64-build --32-build --all-ext --all-build --verbose --os=linux gmake2This will:
third-party into the folder build/deps/linuxOpen CMD in the repo folder, then run the following
For Visual Studio 2022
third-party\common\win\premake\premake5.exe --file=premake5.lua --genproto --os=windows vs2026You can then go to the folder build\project\vs2026\win and open the produced .sln file in Visual Studio.
Or, if you prefer to do it from command line, open the Developer Command Prompt for VS 2026 inside the above folder, then:
msbuild /nologo /v:n /p:Configuration=release,Platform=Win32 gse.slnx
msbuild /nologo /v:n /p:Configuration=release,Platform=x64 gse.slnxFor MSYS2 this is currently experimental and will not work due to ABI differences
steps
./third-party/common/win/premake/premake5.exe --file=premake5.lua --genproto --os=windows gmake2
cd ./build/project/gmake2/win (Optional) You can use Clang compiler instead of GCC by running these 2 commands in the current terminal instance
export CC="clang"
export CXX="clang++"UCRT64 or MINGW64)make config=release_x64 -j 8 allMINGW32)make config=release_x86 -j 8 allmake helpThis will build a release version of the emu in the folder build\win\\release
An example script build_win_premake.bat is available, check it out
Open a terminal in the repo folder, then run the following
./third-party/common/linux/premake/premake5 --file=premake5.lua --genproto --os=linux gmake2
cd ./build/project/gmake2/linux(Optional) You can use Clang compiler instead of GCC by running these 2 commands in the current terminal instance
export CC="clang"
export CXX="clang++"Then run the following
make config=release_x86 -j 8 all
make config=release_x64 -j 8 allTo see all possible build targets
make helpThis will build a release version of the emu in the folder build/linux//release
An example script build_linux_premake.sh is available, check it out
This is really slow and mainly intended for the CI Workflow scripts, but you can use it as another outlet if you can't build locally. You have to fork the repo first.
In your fork, open the Settings tab from the top, then:
Actions -> GeneralActions permissions select Allow all actions and reusable workflowsWorkflow permissions select Read and write permissionsArtifact and log retention, you can specify the amount of days to keep the build artifacts/archives.
It is recommended to set a reasonable number like 3-4 days, otherwise you may consume your packages storage if you use Github as a builder frequently, more details here: https://docs.github.com/en/get-started/learning-about-github/githubs-plansActions tab in your forkEmu third-party dependencies (Windows) ) and run it on the main branch (ex: dev).
Dependencies not created on the main branch won't be recognized by other branches or subsequent runsBuild all emu variants (Windows)Run workflow -> select the desired branch (for example dev) -> press the button Run workflowNo open issues yet, or sync has not completed.