https://github.com/arthurvasseur/glgpuselect
GLGpuSelect is a cross-platform drop-in replacement for opengl32.dll on Windows and libGL.so on Linux that enables per-application GPU selection
https://github.com/arthurvasseur/glgpuselect
egl gpu gpu-affinity gpu-association gpu-selection multi-gpu opengl opengl-context wgl
Last synced: 27 days ago
JSON representation
GLGpuSelect is a cross-platform drop-in replacement for opengl32.dll on Windows and libGL.so on Linux that enables per-application GPU selection
- Host: GitHub
- URL: https://github.com/arthurvasseur/glgpuselect
- Owner: ArthurVasseur
- License: gpl-3.0
- Created: 2025-05-15T20:10:27.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-28T17:14:00.000Z (about 1 year ago)
- Last Synced: 2025-06-22T01:02:54.285Z (12 months ago)
- Topics: egl, gpu, gpu-affinity, gpu-association, gpu-selection, multi-gpu, opengl, opengl-context, wgl
- Language: C++
- Homepage:
- Size: 73.2 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🚀 GLGpuSelect
**OpenGL GPU Selection • Cross-Platform • Drop‑In Shim • Zero Code Changes**
GLGpuSelect is a **drop‑in replacement** for `opengl32.dll` (Windows) and — coming soon — `libGL.so` (Linux), enabling **per‑application GPU routing** for any OpenGL app. No modifications, no global OS tweaks: just swap in the shim and pick your integrated or discrete GPU.
---
## đź“‹ Table of Contents
1. [Installation](#-installation)
2. [Quick Start](#-quick-start)
3. [Usage](#-usage)
4. [Examples & Documentation](#-examples--documentation)
5. [Repository Structure](#-repository-structure)
6. [Contributing](#-contributing)
7. [Releases & Changelog](#-releases--changelog)
8. [License](#-license)
9. [Topics](#-topics)
---
## 🛠️ Installation
### Prerequisites
* **Xmake**: [https://xmake.io/#/](https://xmake.io/#/)
### Clone & Configure
```bash
git clone https://github.com/ArthurVasseur/GLGpuSelect.git
cd GLGpuSelect
```
### Configure Build Options
| Flag | Description | Default |
| ------------- | -------------------------- | :-----: |
| `--examples` | Build example applications | no |
| `--profiling` | Enable profiling hooks | no |
| `--tests` | Build unit tests | no |
| `--asserts` | Enable runtime assertions | no |
| `--logging` | Enable verbose logging | no |
```bash
xmake config -m debug --examples=y --profiling=y --tests=y --asserts=y --logging=y
```
### Build & Install
#### Using CMake
To integrate this project into a CMake-based workflow, refer to [xrepo-cmake](https://github.com/xmake-io/xrepo-cmake)
#### Using Xmake
```bash
xmake # compile
xmake install -o /usr/local # or your chosen path
```
Then copy the `libGLGpuSelect.so` or `opengl32.dll` to your OpenGL app directory.
---
## 🚀 Quick Start
### Environment Variable
```bash
# Select GPU by OS adapter index (0 = first GPU, 1 = second, etc.)
export GLGPUS_ADAPTER_OS_INDEX=1
./your_opengl_app
```
### C API
```c
#include
#include
#include
int main(void)
{
uint32_t deviceCount = 0;
uint32_t result = glgpusEnumerateDevices(&deviceCount, NULL);
if (result != 0)
return EXIT_FAILURE;
AdapterInfo* adapters = malloc(deviceCount * sizeof(AdapterInfo));
result = glgpusEnumerateDevices(&deviceCount, adapters);
if (result != 0)
return EXIT_FAILURE;
printf("Available devices:\n");
for (uint32_t i = 0; i < deviceCount; ++i)
{
printf("\t%s\n", adapters[i].Name);
}
glgpusChooseDevice(adapters[0].Uuid);
free(adapters);
//Then call your OpenGL init code here ChoosePixelFormat, on windows, eglChooseConfig on Linux, etc.
return EXIT_SUCCESS;
}
```
---
## 🤝 Contributing
We welcome contributions!
1. Fork the repo
2. Create a branch (`git checkout -b feat/awesome`)
3. Commit (`git commit -m "Add awesome feature"`)
4. Push (`git push origin feat/awesome`)
5. Open a Pull Request
See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on code style, testing, and reviews.
---
## đź“ś License
Dual‑licensed under:
* **GPL‑3.0** (open‑source): See [LICENSE](LICENSE)
* **Commercial**: See [COMMERCIAL\_LICENSE.txt](COMMERCIAL_LICENSE.txt)
---
## đź”– Topics
`opengl`, `gpu-selection`, `gpu-affinity`, `gpu-routing`, `multi-gpu`, `wgl`, `egl`, `nvoptimus`, `amd-powerxpress`, `cross-platform`, `drop-in`, `shim`, `xmake`, `c-api`, `environment-variables`, `performance`, `hardware-acceleration`, `rendering`, `game-development`, `gpl-3.0`, `dual-license`