ju1ce/April-Tag-VR-FullBody-Tracker
C++Full-body tracking in VR using AprilTag markers.
This guide is also available in the following languages:
>>Full Tutorial Here<<
For the full setup guide, click on the link above to access the wiki!
Having questions or issues?
Ask in the help channel of our discord server: https://discord.gg/g2ctkXB4bb
April-Tag-VR-FullBody-Tracker
Full-body tracking in VR using AprilTag markers.
This is my second attempt at creating a full-body tracking system using fiducial markers. This should enable people to get fullbody tracking for free, using only a phone and some cardboard. It is possible to get pretty good tracking with trackers of sizes as small as 10cm and a PS eye camera of 640x480 resolution. Increasing the marker size or using a higher resolution and faster phone camera further improves tracking.
NOTE: THIS IS A FREE AND OPEN SOURCE PROJECT. YOU DO NOT NEED DRIVER4VR FOR THIS!
To use, you will have to make three trackers - one for each leg and one for hips. Using only leg trackers will not work in VRChat!
This version uses the much more accurate AprilTag system and includes many improvements to make the system easier to use, such as a GUI interface and a more straightforward calibration.
If you have any issues or encounter any bugs, feel free to open an issue on github or message me on discord: https://discord.gg/g2ctkXB4bb
The program can be downloaded from the releases tab.
Beatsaber demo: https://youtu.be/Akps-dH0EeA
Short setup video:
I am too bad at making actual tutorials, but I did record a short video of me setting up everything. It's not a replacement for the tutorial below, but it may help you understand some of the steps better.
I also have a ko-fi!
Donations are apreciated but not necessary!
Build instructions:
NOTE: THIS IS ONLY FOR DEVELOPERS. IF YOU ONLY WANT TO USE APRILTAGTRACKERS AND NOT WRITE CODE, THE TUTORIAL IS ON THE WIKI
NOTE 2: Building in the current master is a bit broken right now. If you have problems building, refer to this PR. The repo with the fixes is here, with a more detailed build manual here.
The project is a CMake project. You should be able to build it either using CMake and your favourite IDE/compiler, or some IDEs already support opening cmake projects directly.
Linux prerequisites
sudo apt-get update -y
sudo apt-get install -y build-essential tar curl zip unzip pkg-config autoconf libudev-dev freeglut3-dev libgtk-3-dev libsecret-1-dev libgcrypt20-dev libsystemd-dev ffmpeg
OpenCV gstreamer backend
sudo apt-get install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-bad1.0-dev gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-doc gstreamer1.0-tools gstreamer1.0-x gstreamer1.0-alsa gstreamer1.0-gl gstreamer1.0-gtk3 gstreamer1.0-qt5 gstreamer1.0-pulseaudio
Windows prerequisites
Open in Visual Studio, or use the Visual Studio Command Prompt.
Clone and build
git clone https://github.com/ju1ce/April-Tag-VR-FullBody-Tracker
cd April-Tag-VR-FullBody-Tracker
cmake -B build
cmake --build build --config Release --target install
That should be it! In case you try it before a more detailed guide is up, we are always there to help on the discord server! (link above)
Troubleshooting
If anything goes wrong when building, please notify us in the discord/via a github issue!
Sources
Olson, Edwin. "AprilTag: A robust and flexible visual fiducial system." 2011 IEEE International Conference on Robotics and Automation. IEEE, 2011.
https://github.com/AprilRobotics/apriltag
WxWidgets: A Cross-Platform GUI Library