vladelaina / BongoCat

BongoCat 
 💘C × SDL3 × OpenGL — Three Mysterious Forces, United as One! Bong~ Bongocat!!!
 English • 简体中文 • 繁體中文 • Français • Deutsch • 日本語 • 한국어 • Português • Русский • Español • Bahasa Indonesia 
> [!TIP]
> The model featured in this demonstration is from 宇痕冫.
>
> 🎁 Looking for **free** models? We work with talented model creators to bring you a wide variety of free models, while continuously exploring more fun desktop experiences! Visit our official website: bongocat.pet
## 📥 Download
- GitHub Releases
 Download the latest release from GitHub Releases.
## 🛠️ Build From Source
BongoCat uses CMake and requires a C11 compiler, a C++17 compiler, CMake 3.24
or newer, and desktop OpenGL development files. SDL3, yyjson, stb, miniaudio,
and Nuklear are downloaded at configure time by default, so the first
configuration needs network access.
Run the commands below from the project root (the directory containing
`CMakeLists.txt`).
### 📋 Platform Prerequisites
- **Windows:** Visual Studio 2022 with the Desktop C++ workload and CMake.
 Use the MSVC generator; MinGW can build the diagnostic backend but is not
 supported for the Cubism SDK.
- **macOS:** Xcode Command Line Tools, CMake, and Ninja. Select an architecture
 with `CMAKE_OSX_ARCHITECTURES` when it differs from the host default.
- **Linux (Debian/Ubuntu):** GCC or Clang, Ninja, and the OpenGL/X11 headers:
 [code] 
### 🔧 Configure and Build
On Linux and macOS, use a single-configuration generator such as Ninja:
 [code] 
On Windows, run from a Visual Studio 2022 developer shell (or another shell
where MSVC is available):
 [code] 
The executable is written to `build/BongoCat` on Linux, to
`build/BongoCat.app/Contents/MacOS/BongoCat` on macOS, and to
`build/Release/BongoCat.exe` for Visual Studio builds.
### 🧪 Tests
CTest targets are enabled by default. Run them after building:
 [code] 
For a multi-configuration generator such as Visual Studio, select the build
configuration explicitly:
 [code] 
### 🎭 Live2D / Cubism SDK (Optional)
If the Cubism SDK is not present, CMake emits a warning and builds the
diagnostic backend. This backend is intended for startup and platform
diagnostics; it does not provide Live2D model rendering. To build the full
runtime, install a compatible Cubism SDK for Native and either place it at
`vendor/CubismSdkForNative` or pass its location explicitly:
 [code] 
The SDK must contain its Core library, Framework sources, and the OpenGL GLEW
third-party tree in the layout expected by `cmake/Cubism.cmake`. Windows
Cubism builds require Visual Studio 2022. `BONGO_CAT_REQUIRE_CUBISM=ON` makes
configuration fail instead of silently selecting the diagnostic backend.
### ⚙️ CMake Options
| Option | Default | Description |
| --- | --- | --- |
| `BONGO_CAT_FETCH_DEPS` | `ON` | Download the pinned third-party dependencies with CMake `FetchContent`. Set `OFF` only when SDL3, yyjson, stb, miniaudio, and Nuklear are already available to CMake. |
| `BONGO_CAT_CUBISM_SDK` | `vendor/CubismSdkFor