Building
August 9, 2025 ยท View on GitHub
Tested platforms
ImGUi Hydra has been developed on MacOS Sonora 14.5 (Macbook Air 2022 - M2).
Dependencies
Required:
- gcc compiler
- cmake v3.27 or newer
- OpenUSD v25.08 or newer
Embedded:
Optional (if OpenGL enabled):
Getting Started
Install dependencies
Make sure gcc and cmake are installed
gcc --version
cmake --version
If some version and info are printed after running the previous commands, gcc and cmake are installed. If you get command not found error, please be sure to install them first.
Download OpenUSD
The easy way to get a pre-built version of USD is to download the one from the Nvidia website.
To build USD manually, go to the OpenUSD release page, download the last release available and build it (build info in the OpenUSD README.md).
Don't forget to add the --embree flag to the build command if you wish to have access to the Embree renderer from ImGui Hydra Editor.
python3 USD/build_scripts/build_usd.py --embree /path/to/install
Clone ImGuiHydraEditor
Clone the git project using the following command:
git clone --recurse-submodules https://github.com/raph080/ImGuiHydraEditor.git
The recursive flag will automatically include the following projects: glew, glfw, imgui, ImGuiColorTextEdit, ImGuiFileDialog, ImGuizmo
Build ImGuiHydraEditor
Within the cloned ImGuiHydraEditor, create a build folder and run cmake from this newly created folder by specifying the root path to OpenUSD build:
mkdir build
cd build
cmake -Dpxr_DIR=/path/to/OpenUSD/build/folder -DOpenSubdiv_DIR=/path/to/OpenUSD/build/folder/lib/cmake/OpenSubdiv -DCMAKE_INSTALL_PREFIX=/path/to/install/folder ..
make
make install
You can also use the following flag to force the use of OpenGL (e.g. on Mac instead of Metal):
-DFORCE_OPENGL=ON
Note: Color Correction and Multi Viewports are currently disabled with Metal backend. Make sure to use the -DFORCE_OPENGL=ON flag to enable those on Mac.
Run ImGuiHydraEditor
if everything went well, 3 new folders are created in your /path/to/install/folder: bin, include and lib.
You can then run the ImGuiHydraEditor application as follow:
/path/to/install/folder/bin/ImGuiHydraEditor