This is a beta release. Some bugs are still expected. If you run into any problems, please open an issue so we can investigate.

Install Instructions

https://github.com/fbraz3/GeneralsX/blob/main/docs/BUILD/INSTALL_INSTRUCTIONS.md

What's Changed

• bugfix(linux): Fix Wayland fullscreen by using SDL3 native fullscreen API by @xorza in #89
• build(cmake): Detect libpng portably across Linux distros by @xorza in #90
• fix(flatpak-linux): migrate release pipeline to flatpak by @fbraz3 in #91
• feature: Pillarbox for ultrawide monitors and resizable windows by @xorza in #92
• sync: merge TheSuperHackers main and fix macOS build regressions by @fbraz3 in #93

Full Changelog: GeneralsX-Beta-3...GeneralsX-Beta-4

This is a beta release. Some bugs are still expected. If you run into any problems, please open an issue so we can investigate.

Install Instructions

https://github.com/fbraz3/GeneralsX/blob/main/docs/BUILD/INSTALL_INSTRUCTIONS.md

What's Changed

• Moved OpenAL code into Core shared code folder. by @DMJC in #68
• feat(release): automated GitHub Actions release pipeline by @fbraz3 in #76
• chore(merge): sync TheSuperHackers upstream into GeneralsX by @fbraz3 in #77
• feat(release): automated release pipeline v2 with build orchestration and structured notes by @fbraz3 in #78
• chore(dxvk-macos): align docs with pinned fork flow by @fbraz3 in #79
• build(ci): default Linux pipeline to AppImage artifacts by @fbraz3 in #81
• Sync TheSuperHackers upstream (2026-04-10) - DX8/WW3D2 conflict resolution by @fbraz3 in #82
• fix: animated shadow rendering in Zero Hour (#15) by @fbraz3 in #83
• sync: merge TheSuperHackers main (04-11-2026) by @fbraz3 in #85

Full Changelog: GeneralsX-Beta-2...GeneralsX-Beta-3

This is a beta release. Some bugs are still expected. If you run into any problems, please open an issue so we can investigate.

Install Instructions

https://github.com/fbraz3/GeneralsX/blob/main/docs/BUILD/INSTALL_INSTRUCTIONS.md

What's Changed

• fix(issue-16): skirmish instant-end on Linux + diagnostics docs by @fbraz3 in #45
• fix(view): integrate PR1711 camera defaults and backport to Generals by @fbraz3 in #47
• Sync TheSuperHackers upstream into GeneralsX by @fbraz3 in #48
• fix(macos-runtime): bundle fontconfig and unify user dirs by @fbraz3 in #49
• build(actions): simplify artifact bundle layout and preserve permissions by @fbraz3 in #54
• chore(sync): merge thesuperhackers upstream 2026-03-27 by @fbraz3 in #55
• docs: add missing macOS brew dependencies by @Cellcote in #56
• feat(registry): add cross-platform registry.ini backend and product-path aliasing by @fbraz3 in #61
• fix(compat): honor directory and wildcard in FindFirstFile/FindNextFile by @fbraz3 in #63
• tweak(multiplayer-settings): add larger starting money options (100k,150k,200k) by @fbraz3 in #64
• fix(main-menu): add GeneralsX watermark by @fbraz3 in #65
• fix(network-linux): enumerate LAN interfaces by @fbraz3 in #66
• fix: resolve SDL3 text entry and editing keys (#58) by @fbraz3 in #69
• fix: resolve widechar portability in unicode serialization (issue #59) by @fbraz3 in #67
• merge: sync TheSuperHackers upstream (04-01-2026) by @fbraz3 in #70
• fix: prefer GeneralsZH user-facing runtime path by @fbraz3 in #71
• fix(save-load): restore macos path parity by @fbraz3 in #72

New Contributors

• @Cellcote made their first contribution in #56

Full Changelog: GeneralsX-Beta-1...GeneralsX-Beta-2

This is a beta release. Some bugs are still expected. If you run into any problems, please open an issue so we can investigate.

Changelog

• 🎯 Synced with the latest updates from TheSuperHackers repository.
• 🎯 Improved camera height for widescreen resolutions.
• 🐧 Fixed skirmish mode on Linux.
• 🍎 Added a macOS app bundle.

How to Run

Prerequisites

1. You must own a legitimate copy of the game. We build and test against the Steam version. Other retail releases may work, but are not officially supported.
2. Copy the game data from your existing installation (for example, from C:\Program Files (x86)\Steam\steamapps\common\Command & Conquer Generals - Zero Hour) to a local folder on your Linux or macOS system. A recommended layout is:
   • $HOME/GeneralsX/Generals for Command & Conquer: Generals
   • $HOME/GeneralsX/GeneralsMD for Command & Conquer: Generals – Zero Hour

Linux

1. Download the Linux archive from this release.
2. Extract all files into your Zero Hour directory (for example, $HOME/GeneralsX/GeneralsMD). Overwrite existing files if prompted.
3. Some dependencies (such as DXVK) require specific environment variables. The easiest way to launch the game is to run the provided run.sh script from a terminal.

macOS

1. Download the macOS .zip file from this release.
2. Extract the .zip and copy the app bundle into your Applications folder.
3. Make sure your game assets are placed in the following locations:
   • $HOME/GeneralsX/Generals for Generals
   • $HOME/GeneralsX/GeneralsMD for Zero Hour
4. Because the app is not code-signed, macOS Gatekeeper will initially block it. After the first launch attempt, go to System Settings → Privacy & Security and allow the application to run.

Requirements

GeneralsX has been developed and tested primarily on the following environments:

• Ubuntu 24.04 LTS (x86_64)
• macOS 15 "Tahoe" on Apple Silicon (M1 / ARM64)

Other Linux distributions or macOS versions may work, but you may need to install additional dependencies manually. On some systems, certain libraries might need to be built from source.

Tested Platforms

Current development and test matrix:

Support for other platforms and configurations is possible but not yet officially tested.

Known Issues

Multiplayer

• LAN play has not been tested and is likely broken.
• Online features are not implemented and are only planned for the distant future.

Linux

• Skirmish games currently result in an instant win as soon as the match starts, so this mode is not yet playable.
  • Campaign and Generals Challenge modes are working.
• [Zero Hour] Building and unit shadows do not render correctly. This is a visual issue only and does not affect gameplay logic.
• Stealth units and GLA stealth buildings are visible as normal units/buildings instead of being hidden.
• The sound system is mostly functional, but there are issues with long voice lines and some sound effects cutting out or not playing correctly.
• There may be additional issues that have not yet been identified.

macOS

All items listed in the Linux section apply, except:

• All single-player modes, including Skirmish, Campaign, and Generals Challenge, are currently working on macOS.

Reporting Bugs

If you encounter problems while running the game, please open an issue and include as much detail as possible, such as:

• Operating system and version
• CPU architecture (x86_64 / ARM64)
• Steps to reproduce the issue
• Logs or terminal output (if available)

This information greatly helps us reproduce and fix issues.

Contributing

Contributions of all sizes are welcome.

If you are interested in helping with development, bug fixes, testing on additional platforms, or improving compatibility, feel free to open a pull request or start a discussion in the repository.

Even small contributions—such as testing, documentation improvements, or well-documented bug reports—are very valuable.

Credits

This project exists thanks to the Command & Conquer community and the many tools created around the game over the years.

Special thanks to everyone who has contributed time to testing, debugging, and development.

This is a Beta Release. Since some bugs are expected, please open an issue if you encounter any problems.

How to Run

1. Install the game on Windows (or via Wine/CrossOver, etc.) from Steam. The game may work with other retail installations, but this is not guaranteed.
2. Copy the game contents (usually located at C:\Program Files (x86)\Steam\steamapps\common\Command & Conquer Generals - Zero Hour) to a local folder on your Linux/macOS system. For example, you might use $HOME/GeneralsX/GeneralsMD.
3. Download the release for your operating system and extract all files from the archive into your Zero Hour directory. Replace any existing files if prompted.
4. Some dependencies, such as DXVK, require environment variables to be set. The easiest way to run the game is by executing the run.sh script from your terminal.

Note for macOS Users

macOS has a Gatekeeper feature that may block the execution of applications downloaded from GitHub. In such cases, we recommend compiling from source.

Requirements

GeneralsX has been tested on the following development environments:

• Ubuntu 24.04 LTS (x86_64)
• macOS Tahoe on Apple Silicon (M1 / ARM64)

Other Linux distributions or macOS versions may also work, but additional dependencies might need to be installed manually. Depending on your system configuration, certain libraries may need to be compiled from source.

Tested Platforms

Current development and testing environments:

Support for other platforms is possible but has not been officially tested.

Known Issues

Multiplayer

• Lan playing untested, probably broken
• Online features planned for a far future

Linux

• Skirmish games currently result in an instant win, so this mode is not yet playable.
  • Campaign and Generals Challenge modes are working.
• [Zero Hour] Building and unit shadows do not render correctly, but this does not affect gameplay.
• Stealth units appear as regular units, and the same applies to GLA stealth buildings.
• The sound system is functional, but there are issues with long voice lines and some sound effects.
• There may be additional issues that have not yet been identified.

macOS

All items from the Linux section apply, plus:

• Because the application is not code-signed, macOS Gatekeeper will block its execution. You will need to manually allow it under Settings → Privacy & Security for the GeneralsXZH executable and its libraries (approval may be required multiple times).
  • As a workaround, please compile from source.

Reporting Bugs

If you encounter issues while running the game, please open an issue on the GitHub repository and include as much information as possible, such as:

• Operating system and version
• CPU architecture (x86_64 / ARM64)
• Steps to reproduce the issue
• Logs or terminal output (if available)

This information is very helpful when diagnosing problems.

Contributing

Contributions are welcome!

If you are interested in helping with development, bug fixes, testing on other platforms, or improving compatibility, feel free to open a pull request or start a discussion in the repository.

Even small contributions such as testing, documentation improvements, or bug reports are greatly appreciated.

Credits

This project exists thanks to the Command & Conquer community and the tools developed around the game over the years.

Special thanks to everyone who has helped with testing, debugging, and development.

This is a alpha release. Bugs and rough edges are expected. If you run into any problems, please open an issue so we can investigate.

How to Run

Prerequisites

1. You must own a legitimate copy of the game. We build and test against the Steam version. Other retail releases may work, but are not officially supported.
2. Copy the game data from your existing installation (for example, from C:\Program Files (x86)\Steam\steamapps\common\Command & Conquer Generals - Zero Hour) to a local folder on your Linux or macOS system. A recommended layout is:
   • $HOME/GeneralsX/Generals for Command & Conquer: Generals
   • $HOME/GeneralsX/GeneralsMD for Command & Conquer: Generals – Zero Hour

Linux

1. Download the Linux archive from this release.
2. Extract all files into your Zero Hour directory (for example, $HOME/GeneralsX/GeneralsMD). Overwrite existing files if prompted.
3. Some dependencies (such as DXVK) require specific environment variables. The easiest way to launch the game is to run the provided run.sh script from a terminal.

macOS

1. Download the macOS .zip file from this release.
2. Extract the .zip and copy the app bundle into your Applications folder.
3. Make sure your game assets are placed in the following locations:
   • $HOME/GeneralsX/Generals for Generals
   • $HOME/GeneralsX/GeneralsMD for Zero Hour
4. Because the app is not code-signed, macOS Gatekeeper will initially block it. After the first launch attempt, go to System Settings → Privacy & Security and allow the application to run.

Requirements

GeneralsX has been developed and tested primarily on the following environments:

• Ubuntu 24.04 LTS (x86_64)
• macOS 15 "Tahoe" on Apple Silicon (M1 / ARM64)

Other Linux distributions or macOS versions may work, but you may need to install additional dependencies manually. On some systems, certain libraries might need to be built from source.

Tested Platforms

Current development and test matrix:

Support for other platforms and configurations is possible but not yet officially tested.

Known Issues

Multiplayer

• LAN play has not been tested and is likely broken.
• Online features are not implemented and are only planned for the distant future.

Linux

• Skirmish games currently result in an instant win as soon as the match starts, so this mode is not yet playable.
  • Campaign and Generals Challenge modes are working.
• [Zero Hour] Building and unit shadows do not render correctly. This is a visual issue only and does not affect gameplay logic.
• Stealth units and GLA stealth buildings are visible as normal units/buildings instead of being hidden.
• The sound system is mostly functional, but there are issues with long voice lines and some sound effects cutting out or not playing correctly.
• There may be additional issues that have not yet been identified.

macOS

All items listed in the Linux section apply, except:

• All single-player modes, including Skirmish, Campaign, and Generals Challenge, are currently working on macOS.

Reporting Bugs

If you encounter problems while running the game, please open an issue and include as much detail as possible, such as:

• Operating system and version
• CPU architecture (x86_64 / ARM64)
• Steps to reproduce the issue
• Logs or terminal output (if available)

This information greatly helps us reproduce and fix issues.

Contributing

Contributions of all sizes are welcome.

If you are interested in helping with development, bug fixes, testing on additional platforms, or improving compatibility, feel free to open a pull request or start a discussion in the repository.

Even small contributions—such as testing, documentation improvements, or well-documented bug reports—are very valuable.

Credits

This project exists thanks to the Command & Conquer community and the many tools created around the game over the years.

Special thanks to everyone who has contributed time to testing, debugging, and development.

This is a POC (Proof of Concept) release of Command & Conquer Generals: Zero Hour running on POSIX systems — Linux and macOS.

How to Run

1. Install the game on Windows (or using Wine / CrossOver, etc) from Steam. The game may run with other retail installations, but this is not guaranteed.
2. Copy the game contents (usually located at C:\Program Files (x86)\Steam\steamapps\common\Command & Conquer Generals - Zero Hour) to a local folder on your Linux/macOS system. In my environment, I use the path $HOME/GeneralsX/GeneralsMD.
3. Download the release for your operating system and extract all files from the archive into your Zero Hour directory. Replace any existing files if prompted.
4. Some dependencies, such as DXVK, require environment variables to be set. The easiest way to run the game is by executing the run.sh script from your terminal.

Requirements

GeneralsX was tested on the following development environments:

• Ubuntu 24.04 LTS (x86_64)
• macOS Tahoe on Apple Silicon (M1 / ARM64)

Other Linux distributions or macOS versions may also work, but additional dependencies might need to be installed manually. In some cases, certain libraries may need to be compiled from source depending on your system configuration.

Tested Platforms

Current development and testing environments:

Support for other platforms is possible but not officially tested.

Known Issues

Linux

• Skirmish games result in an instant win, so this mode is not playable yet.
• Campaign and Generals Challenge are working.
• Building and unit shadows are not rendering correctly, but this does not affect gameplay.
• Stealth units appear as regular units, and the same happens with GLA stealth buildings.
• The sound system works, but there are issues with long voice lines and some sound effects.
• There may be additional issues that have not yet been identified.

macOS

Everything from the Linux section applies, plus:

• Because the application is not code-signed, macOS Gatekeeper will block its execution. You will need to allow it manually under Settings → Privacy & Security for the GeneralsXZH executable and its libraries (approval may be required multiple times).
• Terrain textures are not loading, which makes the game basically unplayable.

Reporting Bugs

If you encounter issues while running the game, please open an issue on the GitHub repository and include as much information as possible, such as:

• Operating system and version
• CPU architecture (x86_64 / ARM64)
• Steps to reproduce the issue
• Logs or terminal output (if available)

This information helps a lot when diagnosing problems.

Contributing

Contributions are welcome.

If you are interested in helping with development, bug fixes, testing on other platforms, or improving compatibility, feel free to open a pull request or start a discussion in the repository.

Even small contributions like testing, documentation improvements, or reporting bugs are greatly appreciated.

Roadmap

Planned improvements include:

• Fix Skirmish mode
• Improve shadow rendering
• Fix stealth unit visibility
• Improve sound system stability
• Improve macOS compatibility
• Initial Windows x64 build

Credits

This project exists thanks to the Command & Conquer community and the tools developed around the game over the years.

Special thanks to everyone helping with testing, debugging, and development.