nijigenerate is an open source editor for the nijilive puppet format, which is derived from Inochi2D (v0.8) technology. This application allows you to rig models for use in games or for other real-time applications such as VTubing. Animation is achieved by morphing, transforming and in other ways distorting layered 2D textures in real-time. These distortions can trick the end user in to perciving 3D depth in the 2D art.
If you are a VTuber wanting to use nijilive we highly recommend checking out nijiexpose as well.
No official stable build provided for time being.
We have a nightly build binary and a weekly build Flatpak available, but we do not guarantee stability. These versions may crash unexpectedly, and you are likely to encounter bugs. Be sure to save and back up your work frequently!
We do not officially support packages that we don't officially build ourselves, we ask that you build using the barebones configurations, as the branding assets are copyright the nijigenerate Project.
You may request permission to use our branding assets in your package by submitting an issue.
Barebones builds are more or less equivalent to official builds with the exception that branding is removed,
and that we don't accept support tickets unless a problem can be replicated on an official build.
Links in source/nijigenerate/config.d
should be updated to point to your package's issues list, as we do not accept issues from non-official builds.
We have a quick start guide BUILD.md to help users build nijigenerate. For new contributors and users, it is recommended to refer to this guide.
It's occasionally the case that our dependencies are out of sync with dub, so it's somewhat recommended if you're building from source to clone the tip of main
and dub add-local . "<version matching nijigenerate dep>"
any of our forked dependencies (i18n-d, psd-d, bindbc-imgui, facetrack-d, inmath, nijilive). This will generally keep you up to date with what we're doing, and it's how the primary contributors work. Ideally we'd have a script to help set this up, but currently we do it manually, PRs welcome :)
Because our project has dependencies on C++ through bindbc-imgui, and because there's no common way to get imgui binaries across platforms, we require a C++ toolchain as well as a few extra dependencies installed. These will be listed in their respective platform sections below.
Currently you have to recursively clone bindbc-imgui from git and set its version to 0.7.0
, otherwise the build will fail.
Once the below dependencies are met, building and running nijigenerate should be as simple as calling dub
within this repo.
- Visual Studio 2022 (With "Desktop development with C++" workflow installed)
- In theory, "Build Tools for Visual Studio 2022" should also work, but is untested.
- CMake (Currently 3.16 or higher is needed.)
- Dlang, either dmd or ldc (ldc recommended)
- The equivalent of build-essential on Ubuntu, on centos 7, this was
sudo yum groupinstall 'Development Tools'
, this should get you a working C++ toolchain. - Dlang, either dmd or ldc (ldc recommended)
- CMake (Currently 3.16 or higher is needed.)
- SDL2 (developer package)
- Freetype (developer package)
- appimagetool (for building an AppImage)