Skip to content
JovannMC edited this page Nov 16, 2024 · 14 revisions

What is SlimeTora?

SlimeTora is a program that connects the HaritoraX trackers to the SlimeVR server. This can be used to replace the HaritoraConfigurator (and in-beta VR Manager) software and even get the trackers working on Linux.

Why would I use SlimeTora?

TL;DR more accurate tracking, more settings, per-tracker settings, use additional trackers with SlimeVR server, and Linux!

There are few reasons this program exists and why you may consider using it, here are a few of the main ones:

  • Tracker accuracy
    • You should see massive improvements in terms of the tracker accuracy with SlimeVR. SlimeVR server implements their own "virtual skeletal system" to estimate the positions of the trackers and thus, is more accurate than HaritoraConfigurator.
  • Easier resets
    • SlimeVR server has different types of resets which might seem confusing (yaw/full/mounting reset), but the main one you would be looking to use is the "Yaw reset".
    • This essentially makes the trackers face the direction you are facing which fixes most drifting issues (as they are usually yaw drift). Not only is this much quicker, this also can be used while laying or sitting down - just two taps on the chest (or one physical button click on the) tracker away!
  • More settings
    • SlimeVR server has many settings to mess with to improve or personalize your tracking - tracker filtering, leg tweaks (like floor clip and toe snapping), etc.
  • Per-tracker settings
    • SlimeTora allows you to change the settings of each tracker individually (for HaritoraX Wireless), mainly for advanced users.
  • Additional trackers
    • If you already have other trackers (e.g. Vive, Mocopi, Joy-Cons, owoTrack, etc), they can be used in pair with the HaritoraX trackers via SlimeVR.
    • If you already have another pair of HaritoraX trackers, you can also make use of them! Just extract two instances of SlimeTora and run each one.
      • It is required you have two separate folders/instances of SlimeTora, as there will be config file conflicts (same MAC address for two separate "rightAnkle" trackers, for example)
  • Linux (and macOS) support
    • As the SlimeVR server supports Linux (and macOS), SlimeTora also allows you to use your trackers on Linux (and macOS)! Linux users rise up (screw you macOS users /j)!

How do I get started/what do I need?

Check out this page.

What are the recommended SlimeTora settings/what do they do?

Check out this page.

How do I perform a reset/how do the resets differ?

Check out this page.

What devices are supported?

Learn more on the haritorax-interpreter repo: https://github.com/JovannMC/haritorax-interpreter

Check the table below for supported devices:

Device Supported Elbow/Hip support
HaritoraX Wireless Y Y
HaritoraX 1.1B Y Y
HaritoraX 1.1 Y Y
HaritoraX 1.0 Y Y
Haritora ? ?

What connection modes are supported?

Learn more on the haritorax-interpreter repo: https://github.com/JovannMC/haritorax-interpreter

Check the table below for the connection modes supported:

Communication mode Supported
Bluetooth (Low Energy) Y
Bluetooth Classic (COM) Y
GX6 Communication Dongle Y
GX2 Communication Dongle Y

Will ankle motion detection ever be added?

Due to how the ankle motion detection feature works, it's very difficult to interpret the sensor data (which only gives one direction, up & down) to create virtual feet trackers on SlimeVR. It's been attempted many times to no avail and requires a lot of advanced math that I honestly don't know.

If anyone would like to try to implement it themselves, you can always open a pull request here - help is always appreciated.

Can I use multiple HaritoraX tracker sets with SlimeTora?

Yes! Because I'm so smart (no I'm not) with how I created the program and haritorax-interpreter, you are able to use multiple of the same (or different) HaritoraX tracker sets with SlimeTora.

While not officially supported, you can create a new instance of SlimeTora by extracting the files into another folder, then run both instances at the same time. It is very important you create a new instance/folder as you will experience a "multi-tracker" issue where SlimeVR will receive tracking data from two (or more) completely different trackers.

I found an issue/bug!

First, check where the program is coming from - is it SlimeTora or SlimeVR server issue?

SlimeTora

Check out the troubleshooting guide to see if your issue can be solved there. Otherwise, create an issue here or join one the following Discord servers listed at the bottom of this page.

SlimeVR

Check out SlimeVR's troubleshooting guide to see if your issue can be solved there. Otherwise, join the SlimeVR Discord server here (or any of the others listed at the bottom of this page).

I have a suggestion/want to add something!

Thanks for wanting to contribute to the project! If you have the coding knowledge, you can clone the project and build the project (learn more here) but if not, create an issue here or join the Discord servers listed at the bottom of this page.

Discord servers