Baballonia

Baballonia is a cross-platform, hardware-agnostic XR eye and face tracking application.

Installation

Steam

Baballonia is now on Steam! Download it here!

This is the suggested install method. You will automatically recieve updates with this method.

Windows (Alternative)

Head to the releases tab and download the latest installer.

You may be prompted to download the .NET runtime for desktop apps, install it if need be.

Linux (Alternative)

Head to the releases tab and download the latest tarball.

You may be prompted to download the .NET runtime for desktop apps, install it if need be.

MacOS

Baballonia currently does not have an installer for MacOS. You will need to follow our build instructions and run it from source.

Platform Compatibility

To get started, follow the quickstart guide on our documentation page.

VRChat

VRCFaceTracking

To use Baballonia with VRChat, you will need to use VRCFaceTracking with the VRCFT-Babble module.

1. Download and install the latest version of VRCFaceTracking from Steam.
2. Install the VRCFT-Babble module within VRCFaceTracking.
3. Use Baballonia to set the module mode (eyes, face or both). Restart VRCFaceTracking to see your changes.

More information can be found on the VRCFT Docs

VRC Native Eyelook

Alternatively, Baballonia also supports VRC Native Eyelook.

While this doesn't support lower face tracking, it supports (almost) all VRChat Avatars.

Resonite

Resonite works natively with Baballonia's eye and face tracking - no external tools necessary!

ChilloutVR

ChilloutVR has a mod-based integration for Baballonia's eye and face tracking. Please refer to our docs (below) for installation.

For more game information and setup, refer to our games documentation page.

Supported Hardware

Baballonia supports many kinds of hardware for eye and face tracking:

| Device | Eyes | Face | Notes | |-----------------------------------| ----- | ----- |-------------------------------------------------------------------------------------------| | Official Babble Face Tracker | :x: | ✅ | | | DIY and 3rd party Babble Trackers | :x: | ✅ | | | Vive Facial Tracker | :x: | ✅ | | | DIY EyetrackVR | ✅ | :x: | | | Bigscreen Beyond 2E | ✅ | :x: | On Linux, requires go-bsb-cams | | Vive Pro Eye | ✅ | :x: | Requires Revision | | Varjo Aero | ✅ | :x: | Requires the Varjo Streamer | | HP Reverb G2 Omnicept | ✅ | :x: | Requires BrokenEye | | Pimax Crystal | ✅ | :x: | Requires BrokenEye |

For more hardware information, refer to our hardware documentation page.

---

Build Instructions

Baballonia.Desktop

1. Run the associated download_dependencies script for your given platform (.ps1 on Windows, .sh on Linux).
2. If you are using an IDE, disable these projects:

• VRCFaceTracking
• VRCFaceTracking.Core
• VRCFaceTracking.SDK
• VRCFaceTracking.Baballonia
• Baballonia.iOS
• Baballonia.Android

3. Run dotnet build inside the src/Baballonia.Desktop directory, or build with your IDE

Publishing

If you want to publish a standalone installer for Baballonia, download NSIS here, or use your package manager. Then, run the .nsi script located at src/Baballonia.Desktop/main.nsi

Baballonia.Android/iOS

1. If you are using an IDE, disable these projects:

• VRCFaceTracking
• VRCFaceTracking.Core
• VRCFaceTracking.SDK
• VRCFaceTracking.Baballonia
• Baballonia.Desktop
• Baballonia.iOS, if you are building for Android
• Baballonia.Android, if you are building for iOS

2. Run dotnet build inside the src/Baballonia.Android or src/Baballonia.iOS directory, or build with your IDE

VRCFaceTracking.Baballonia

1. If you are using an IDE, disable all projects except the following:

• VRCFaceTracking.Core
• VRCFaceTracking.SDK
• VRCFaceTracking.Baballonia

2. Run dotnet build inside the src/VRCFaceTracking.Baballonia directory, or build with your IDE

This will create a VRCFaceTracking.Baballonia.zip module which you can install manually.

For more build information, refer to our build documentation page.