# SlimeTora
A program that connects the HaritoraX trackers to the [SlimeVR server](https://docs.slimevr.dev/server/index.html), supporting both the `HaritoraX Wireless` and `HaritoraX Wired` (1.1b/1.1/1.0). Supports `Bluetooth` (low energy), `Bluetooth` (classic) (w/ `COM`), and the `GX(6/2)` communication dongles (w/ `COM`).
Read the wiki to get started: https://github.com/OCSYT/SlimeTora/wiki
### For support, join the Discord server: https://discord.gg/XdfnKD9QVM
Screenshots
Connection section |
Tracker info section |
|
|
Global settings section |
Per-tracker settings page (chest) |
|
|
About section |
Debugging section |
|
|
Features
- Support for all currently-released HaritoraX trackers
- Supports
HaritoraX Wireless
and HaritoraX Wired
(1.1b/1.1/1.0)
- Unknown support for
Haritora
(before Shiftall // DIY)
Bluetooth
(LE/Classic) and COM
/GX(6/2)
support (with all at the same time supported on HaritoraX Wireless
)
- Use of haritorax-interpreter package to process tracker data
- Get started with the program (and SlimeVR Server) easily through the guided onboarding process!
- Through the "automatic setup", run auto-detection to let the program set itself up for you!
- Automatically detect your tracker model, connection mode (including COM ports), and tracker settings
- Manage GX(6/2) dongles in-app - tracker pairing & changing 2.4GHz channels
- Set tracker settings per-tracker (
HaritoraX Wireless
only)
- Turn off one or all trackers (
HaritoraX Wireless
w/ GX(6/2)
dongles only)
- Localization support
- You can help translate the program! Clone the repo and make a new file under
/src/static/languages/
with a two-letter language identifier (ending with .json, e.g. jp.json
)!
- Linux support
- This was done as SlimeVR is supported on Linux, making this the first time HaritoraX trackers work on Linux!
- Button bindings to SlimeVR functions (e.g. resets)
- Update checking (for app and translations)
- Tracker visualization
- Magnetometer statuses
- Per-tracker battery information (in-app and SlimeVR/SteamVR)
- Compact view of the trackers
- Censor tracker serial numbers in-app
- Debugging options
- ..and many more improvements coming soon!
Known issues
- On SlimeVR server
v0.13.0
, you cannot pass the "IMU Calibration" setup wizard step
- SlimeVR server
v0.13.1
will exclude Haritora trackers for this calibration step as it isn't needed for these trackers
- Either skip the setup wizard and perform the steps manually via the navbar, or use
0.12.1
(not recommended) until 0.13.1
releases
- Battery information jumps to incorrect percentages/voltage randomly
- Unfortunately this is an issue I can't fix.. because it's literally an issue with the trackers reporting those random values themselves
- This has been slightly mitigated with v1.2.0, which uses a "stable average" of the battery percentage and voltage instead
- Running "auto-detection" more than once without restarting breaks tracker settings auto-detection (device/ports detection still works)
- Running "auto-detection" on HaritoraX Wired (1.1b/1.1/1.0) trackers doesn't work
- Potentially fixed with
v1.3.0
, needs testing
Documentation - getting started & development
Read the wiki to get started on using/developing the program: https://github.com/OCSYT/SlimeTora/wiki
For support, join the Discord server: https://discord.gg/XdfnKD9QVM
Support the project
Love SlimeTora? You can show your support to the developers of SlimeTora through their Ko-Fi links, check them out!
Special thanks to the project's supporters: