Modern fork of LinuxTrack with enhanced TrackIR support and modern Linux compatibility.
This fork focuses on TrackIR hardware support and modern Linux distributions, while attempting to maintaining compatibility with the original codebase.
# Download and run the latest AppImage
chmod +x LinuxTrack-X-IR-*.AppImage
./LinuxTrack-X-IR-*.AppImageChoose your installation level below, then see the detailed guides for your distribution.
Choose the level that matches your needs. Each level includes all features from previous levels.
| Level | Use Case | Features |
|---|---|---|
| 1: TrackIR Only | Linux native games only | TrackIR hardware, LinuxTrack server |
| 2: + Wine Support | Windows games via Wine/Proton | Level 1 + Wine bridge, Steam compatibility (requires 32-bit Wine + NSIS) |
⚠️ Important: Level 2 requires 32-bit Wine support for MFC42 library installation and NSIS for Wine bridge installer generation. See your distribution's guide for specific installation commands. | 3: + Webcam | Alternative face tracking | Level 2 + webcam/OpenCV support | | 4: + OSC | External applications/MIDI | Level 3 + Open Sound Control | | 5: + Wiimote | Nintendo Wii Remote | Level 4 + Wiimote support | | 6: + X-Plane | Flight simulator | Level 5 + X-Plane plugin |
# Clone the repository
git clone https://gitlab.com/fwfa123/linuxtrackx-ir.git
cd linuxtrackx-ir
# Create build directory
mkdir build && cd build
# Configure (see level-specific options below)
cmake .. [OPTIONS]
# Build
cmake --build . -j$(nproc)
# Install
sudo cmake --install .
# Verify
ldconfig -p | grep linuxtrack
ltr_gui
#Uninstall from the Build Directory
sudo cmake --build . --target uninstall| Level | CMake Command | Description |
|---|---|---|
| 1 | cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local |
TrackIR only |
| 2 | cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local -DENABLE_LTR_32LIB_ON_X64=ON |
+ Wine support (requires 32-bit Wine installed) |
| 3 | cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local -DENABLE_LTR_32LIB_ON_X64=ON -DENABLE_WEBCAM=ON |
+ Webcam |
| 4 | cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local -DENABLE_LTR_32LIB_ON_X64=ON -DENABLE_WEBCAM=ON -DENABLE_OSC=ON |
+ OSC |
| 5 | cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local -DENABLE_LTR_32LIB_ON_X64=ON -DENABLE_WEBCAM=ON -DENABLE_OSC=ON -DENABLE_WIIMOTE=ON |
+ Wiimote |
| 6 | cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local -DENABLE_LTR_32LIB_ON_X64=ON -DENABLE_WEBCAM=ON -DENABLE_OSC=ON -DENABLE_WIIMOTE=ON -DENABLE_XPLANE=ON -DXPLANE_SDK_PATH=/opt/xplane-sdk/CHeaders |
+ X-Plane |
Each guide includes package installation commands and level-specific build examples.
# For X11 (recommended)
ltr_gui
# For Wayland (force X11 compatibility if needed)
QT_QPA_PLATFORM=xcb ltr_gui- Select your tracking device (TrackIR, webcam, etc.)
- Calibrate tracking points for accurate head tracking
- Set up game profiles for different applications
- Test tracking functionality before gaming
- AntiMicro joystick detection - Convert head tracking to joystick input
- Server approach - Use LinuxTrack server for Wine games
- OSC network - External application integration
- TrackIR 4 & 5 - Primary supported hardware
- Full TrackIR API compatibility
- Webcam + IR LEDs - Build your own IR tracking setup
- Wiimote - Nintendo Wii Remote tracking
- FaceTrackNoIR compatible - Face detection tracking
- PlayStation Eye - USB camera with IR filter removal
- Generic USB cameras - For optical tracking
- DCS World
- War Thunder
- Elite Dangerous
- Euro Truck Simulator 2
- American Truck Simulator
- Microsoft Flight Simulator
- IL-2 Sturmovik series
- Falcon 4
- Commanche vs Havoc
- X-Plane (requires X-Plane SDK)
# Automated recovery script (fixes common issues automatically)
./scripts/install/linuxtrack_quick_recovery.sh
# Or if run from project root:
./linuxtrack_quick_recovery.sh# Check installation
ldconfig -p | grep linuxtrack
ltr_gui
# Check display environment
echo $XDG_SESSION_TYPE
# Check device permissions
groups $USER| Problem | Solution |
|---|---|
| GUI not displaying | Force X11: QT_QPA_PLATFORM=xcb ltr_gui |
| Permission denied | Add to groups: sudo usermod -a -G plugdev,input $USER |
| Library not found | Run: sudo ldconfig |
| TrackIR not detected | Check USB: lsusb | grep Track |
| Wine bridge fails | Check Wine 32-bit installation and MFC42 setup |
Detailed troubleshooting guide - Distribution-specific issues and advanced diagnostics.
For advanced users, combine CMake flags to build exactly what you need:
# Example: TrackIR + X-Plane without Wine/Webcam
cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local -DENABLE_XPLANE=ON -DXPLANE_SDK_PATH=/opt/xplane-sdk/CHeaders
# Example: Wine + OSC without Webcam
cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local -DENABLE_LTR_32LIB_ON_X64=ON -DENABLE_OSC=ONFor advanced users who want to create AppImages:
./scripts/appimage/build_appimage_phase4.sh --cleanFull advanced documentation - CMake options, packaging, and development guides.
LinuxTrack X-IR welcomes contributions! See the GitLab repository for issues and feature requests.
git clone https://gitlab.com/fwfa123/linuxtrackx-ir.git
cd linuxtrackx-ir
mkdir build && cd build
cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local -DENABLE_DEBUG=ON
cmake --build . -j$(nproc)LinuxTrack X-IR is released under the MIT License, maintaining compatibility with the original project's licensing.
This project builds upon the incredible work of the original LinuxTrack developers. Special thanks to uglyDwarf, Tulthix, f.josef, Michal Navratil, and all contributors.
- GitLab Repository: fwfa123/linuxtrackx-ir
- Wiki: GitLab Wiki
- Original Project: uglyDwarf/linuxtrack