Getting Started
Welcome to the XMapTools documentation! Whether you are a new or returning user, this guide will help you get XMapTools 4.5 up and running.
The installation and update procedures have changed in XMapTools 4.5. XMapTools is now distributed via shell scripts for macOS and Windows, which automate the processes of installation, updating, downloading, extraction and configuration.
Binaries for Apple Silicon Macs now require MATLAB Runtime 25.1, which is installed automatically by the XMapTools installer. Older Runtime versions (e.g. v99 or v912) are no longer required and can be safely deleted after upgrading.
Binaries for Windows and Intel-based Macs require MATLAB Runtime v99.
XMapTools is distributed via shell scripts for macOS and Windows that automate the installation, update, download, extraction, and configuration of the program.
Compatibility
Before installing, make sure your system meets the requirements below:
| Version | Processor | Operating System | Runtime |
|---|---|---|---|
| macOS | Apple Silicon (M1, M2, M3, M4, …) | macOS Tahoe (26), Sequoia (15), Sonoma (14), or Ventura (13) | R2025a (25.1) |
| macOS Intel | Intel | macOS Sequoia (15), Sonoma (14), Ventura (13), Monterey (12), Big Sur (11), Catalina (10.15), or Mojave (10.14) | R2020b (v99) |
| Windows | x86-64 | Windows 10 or Windows 11 | R2020b (v99) |
Note: The macOS version is not compatible with Intel processors, and the macOS Intel version is not stable with Apple Silicon processors. The installer auto-detects your architecture.
Next step
Ready to install? Head over to the Installation & Update Guide for step-by-step instructions.
Is XMapTools already installed? If so, go straight here.