This repository is for the legacy Mixed Reality Toolkit (MRTK) v2. For the latest version of the MRTK please visit https://github.com/MixedRealityToolkit/MixedRealityToolkit-Unity
Mixed Reality Toolkit 2.6.1 is a collection of fixes to issues logged against version 2.6.0. For complete details, please see the release notes.
[Recommended] Mixed Reality Feature Tool MRTK is available using the Mixed Reality Feature Tool. For more information, please see Welcome to the Mixed Reality Feature Tool.
Import asset (.unitypackage) files Scroll down to Assets and download to a known location (typically, this is the Downloads folder on Windows 10):
Once downloaded, you can set the target platform and import the desired packages using these instructions.
To help get started using MRTK v2.6.1, please see the the Welcome page, which covers software requirements and the initial steps required to use MRTK.
Please see Release Notes for information on new features, known issues and changes.
There is a known compiler issue that impacts applications built for Microsoft HoloLens 2 using ARM64. This issue is fixed by updating Visual Studio 2019 to version 16.8 or later. If you are unable to update Visual Studio 2019, please import the Tools package to apply a workaround.
Please review the Upgrade Guide for guidance on how to upgrading existing projects.
Note that the Tools package is now required when upgrading to a newer version of MRTK. It includes the migration tool, which automates the updating of projects assets to account for some changes in MRTK.
[Recommended] Mixed Reality Feature Tool MRTK is available using the Mixed Reality Feature Tool. For more information, please see Welcome to the Mixed Reality Feature Tool.
Import asset (.unitypackage) files Scroll down to Assets and download to a known location (typically, this is the Downloads folder on Windows 10):
Once downloaded, you can set the target platform and import the desired packages using these instructions.
To help get started using MRTK v2.6.0, please see the the Welcome page, which covers software requirements and the initial steps required to use MRTK.
Please see Release Notes for information on new features, known issues and changes.
There is a known compiler issue that impacts applications built for Microsoft HoloLens 2 using ARM64. This issue is fixed by updating Visual Studio 2019 to version 16.8 or later. If you are unable to update Visual Studio 2019, please import the Tools package to apply a workaround.
Please review the Upgrade Guide for guidance on how to upgrading existing projects.
Note that the Tools package is now required when upgrading to a newer version of MRTK. It includes the migration tool, which automates the updating of projects assets to account for some changes in MRTK.
Mixed Reality Toolkit 2.5.4 is a collection of fixes to issues logged against version 2.5.3. For complete details, please see the release notes.
[Recommended] Mixed Reality Feature Tool MRTK is available using the Mixed Reality Feature Tool. For more information, please see Mixed Reality Toolkit and Unity Package Manager.
Import asset (.unitypackage) files Scroll down to Assets and download to a known location (typically, this is the Downloads folder on Windows 10):
Once downloaded, you can set the target platform and import the desired packages using these instructions.
To help get started using MRTK v2.5.4, please see the Documentation Portal.
The Welcome page covers software requirements and the initial steps required to use MRTK.
Please see Release Notes for information on new features, known issues and changes.
There is a known compiler issue that impacts applications built for Microsoft HoloLens 2 using ARM64. This issue is fixed by updating Visual Studio 2019 to version 16.8 or later. If you are unable to update Visual Studio 2019, please import the Tools package to apply a workaround.
Please review the Upgrade Guide for guidance on how to upgrade an existing project to 2.5.4.
Note that the Tools package is now required when upgrading to a newer version of MRTK. It includes the migration tool, which automates the updating of projects assets to account for some changes in MRTK.
Mixed Reality Toolkit 2.5.3 is a hotfix, fixing an Oculus regression in 2.5.2. The rest of these release notes match 2.5.2:
In the core layer, Mixed Reality Toolkit 2.5.2 is a minor update that addresses some issues that impact importing via the Unity Package Manager (UPM) on Mac. It also fixes a bug with boundary layers not showing up.
In the provider layer, it adds preview support for HoloLens 2 and Windows Mixed Reality immersive headsets on OpenXR.
Option 1: Unity Package Manager MRTK is available using the Unity Package Manager. For more information, please see Mixed Reality Toolkit and Unity Package Manager.
Option 2: Import asset (.unitypackage) files Scroll down to Assets and download to a known location (typically, this is the Downloads folder on Windows 10):
Once downloaded, you can set the target platform and import the desired packages using these instructions.
To help get started using MRTK v2.5.3, please see the Documentation Portal.
The Welcome page covers software requirements and the initial steps required to use MRTK.
Please see Release Notes for information on new features, known issues and changes.
There is a known compiler issue that impacts applications built for Microsoft HoloLens 2 using ARM64. This issue is fixed by updating Visual Studio 2019 to version 16.8 or later. If you are unable to update Visual Studio 2019, please import the Tools package to apply a workaround.
Please review the Upgrade Guide for guidance on how to upgrade an existing project to 2.5.3.
Note that the Tools package is now required when upgrading to a newer version of MRTK. It includes the migration tool, which automates the updating of projects assets to account for some changes in MRTK.
NOTE: 2.5.2 contains a build regression for Oculus. Please use 2.5.3 instead.
In the core layer, Mixed Reality Toolkit 2.5.2 is a minor update that addresses some issues that impact importing via the Unity Package Manager (UPM) on Mac. It also fixes a bug with boundary layers not showing up.
In the provider layer, it adds preview support for HoloLens 2 and Windows Mixed Reality immersive headsets on OpenXR.
Option 1: Unity Package Manager MRTK is available using the Unity Package Manager. For more information, please see Mixed Reality Toolkit and Unity Package Manager.
Option 2: Import asset (.unitypackage) files Scroll down to Assets and download to a known location (typically, this is the Downloads folder on Windows 10):
Once downloaded, you can set the target platform and import the desired packages using these instructions.
To help get started using MRTK v2.5.2, please see the Documentation Portal.
The Welcome page covers software requirements and the initial steps required to use MRTK.
Please see Release Notes for information on new features, known issues and changes.
There is a known compiler issue that impacts applications built for Microsoft HoloLens 2 using ARM64. This issue is fixed by updating Visual Studio 2019 to version 16.8 or later. If you are unable to update Visual Studio 2019, please import the Tools package to apply a workaround.
Please review the Upgrade Guide for guidance on how to upgrade an existing project to 2.5.2.
Note that the Tools package is now required when upgrading to a newer version of MRTK. It includes the migration tool, which automates the updating of projects assets to account for some changes in MRTK.
Mixed Reality Toolkit 2.5.1 is a minor update that addresses many issues that impact importing via the Unity Package Manager (UPM). Also fixed is an issue in which the teleport cursor appearing near the hand.
Option 1: Unity Package Manager MRTK is available using the Unity Package Manager. For more information, please see Mixed Reality Toolkit and Unity Package Manager.
Option 2: Import asset (.unitypackage) files Scroll down to Assets and download to a known location (typically, this is the Downloads folder on Windows 10):
To help get started using MRTK v2.5.1, please see the Documentation Portal.
The Welcome page covers software requirements and the initial steps required to use MRTK.
Please see Release Notes for information on new features, known issues and changes.
There is a known compiler issue that impacts applications built for Microsoft HoloLens 2 using ARM64. This issue is fixed by updating Visual Studio 2019 to version 16.8 or later. If you are unable to update Visual Studio 2019, please import the Tools package to apply a workaround.
Please review the Upgrade Guide for guidance on how to upgrade an existing project to 2.5.1.
Note that the Tools package is now required when upgrading to a newer version of MRTK. It includes the migration tool, which automates the updating of projects assets to account for some changes in MRTK.
Option 1: NEW Unity Package Manager MRTK is now available using the Unity Package Manager. For more information, please see Mixed Reality Toolkit and Unity Package Manager.
Option 2: Import asset (.unitypackage) files Scroll down to Assets and download to a known location (typically, this is the Downloads folder on Windows 10):
Once downloaded, you can set the target platform and import the desired packages using these instructions.
To help you get started using MRTK v2.5.0, please see the Documentation Portal.
The Welcome page covers software requirements and the initial steps required to use MRTK.
Please see Release Notes for information on new features, known issues and changes.
There is a known compiler issue that impacts applications built for Microsoft HoloLens 2 using ARM64. This issue is addressed in the forthcoming 16.8 update for Visual Studio 2019. Until the update is available, please import the Tools package to apply a workaround.
Please review the Upgrade Guide for guidance on how to upgrade an existing project to 2.5.0.
Note that the Tools package is now required when upgrading to a newer version of MRTK. It includes the migration tool, which automates the updating of projects assets to account for some changes in MRTK.
Scroll down to Assets and download to a known location (typically, this is the Downloads folder on Windows 10):
Once downloaded, you can set the target platform and import the desired packages using these instructions.
To help you get started using MRTK v2.4.0, please see the Documentation Portal.
The Getting Started page covers software requirements and the initial steps required to use MRTK.
Please see Release Notes for information on new features, known issues and changes.
Please review the Upgrade Guide for guidance on how to upgrade an existing project to 2.4.0.
Note that the Tools package is now required when upgrading to a newer version of MRTK. It includes the migration tool, which automates the updating of projects assets to account for some changes in MRTK.
Scroll down to Assets and download to a known location (typically, this is the Downloads folder on Windows 10):
Once downloaded, you can set the target platform and import the desired packages using these instructions.
To help you get started using MRTK v2.3.0, please see the Documentation Portal.
The Getting Started page covers software requirements and the initial steps required to use MRTK.
There have been some functional and architecture changes in this release of MRTK. For those with projects that are currently using version 2.x.x, please review the Upgrade Guide.
Please note that the Microsoft.MixedReality.Toolkit.Providers.UnityAR package has been merged into Microsoft.MixedReality.Toolkit.Foundation in this release.
Please see Release Notes for information on new features, known issues and changes.
This [video](coming soon) demonstrates many of the great features that can be found in MRTK 2.3.0.
Scroll down to Assets and download to a known location (typically, this is the Downloads folder on Windows 10):
Once downloaded, you can set the target platform and import the desired packages using these instructions.
To help you get started using MRTK v2.2, please see the Documentation Portal.
The Getting Started page covers software requirements and the initial steps required to use MRTK.
There have been some functional and architecture changes in this release of MRTK. For those with projects that are currently using version 2.x.x, please review the Upgrade Guide.
Please see Release Notes for information on new features, known issues and changes.
This video demonstrates many of the great features that can be found in MRTK 2.2.0.