README

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:

  bash
  sudo apt-get update
  sudo apt-get install -y build-essential cmake ninja-build \
    libgl1-mesa-dev libx11-dev libxi-dev libxfixes-dev libfontconfig1-dev fonts-noto-cjk
  

 🔧 Configure and Build

On Linux and macOS, use a single-configuration generator such as Ninja:

bash
cmake -S . -B build -G Ninja \
  -DCMAKE_BUILD_TYPE=Release \
  -DBONGO_CAT_FETCH_DEPS=ON
cmake --build build --parallel


On Windows, run from a Visual Studio 2022 developer shell (or another shell
where MSVC is available):

powershell
cmake -S . -B build -G "Visual Studio 17 2022" -A x64 
  -DBONGO_CAT_FETCH_DEPS=ON
cmake --build build --config Release --parallel


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:

bash
ctest --test-dir build --output-on-failure


For a multi-configuration generator such as Visual Studio, select the build
configuration explicitly:

powershell
ctest --test-dir build -C Release --output-on-failure


 🎭 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:

bash
cmake -S . -B build -G Ninja \
  -DCMAKE_BUILD_TYPE=Release \
  

Top issues

Discussions

Latest release

[!WARNING]
 The development team has only thoroughly tested the Windows version. If you encounter any issues on macOS or Linux, please be sure to submit an Issue to help us continuously improve cross-platform support. Thank you very much for your understanding and support!


 Download


 GitHub Downloads

- Windows x64 installer
- Windows x64 portable
- Windows x86 installer
- Windows x86 portable
- macOS Apple Silicon
- macOS Intel
- Linux x64
- Linux x64 AppImage


Full Changelog: https://github.com/vladelaina/BongoCat/compare/v1.13.1...v1.14.0