This repository provides tools, schemas, samples and GitHub Copilot custom instructions to empower game creators that are optimizing their games for Xbox game streaming.

To get started with Xbox game streaming you apply to the ID@Xbox program at http://www.xbox.com/en-us/Developers/id.

To learn more about optimizing your Xbox game for game streaming see the developer documentation.

• Touch Adaptation Kit Command Line Tool (TAK CLI) releases for Windows and MacOS.
• Schema representing the capabilities of the Touch Adaptation Kit that allows for your creation of custom touch layouts for your games.
• Sample touch adaptation layouts to get started.
• Scripts to assist in the development of touch adaptation layouts.
• copilot-instructions to provide customizable guidance for GitHub Copilot when generating and refining touch layouts.

The TAK CLI is a command line tool that allows you to create, validate, and package touch adaptation layouts for your games. It is available for Windows and MacOS and is publicly distributed as a standalone executable for through the releases page of this repository.

You can read more about the TAK CLI in the public documentation.

The CLI is also required for the core functionalities of the Touch Adaptation Kit Editor extension for VS Code. The extension provides a visual editing experience for touch adaptation bundles and is recommended as a starting point for creating touch experiences for Xbox game streaming.

You can read more about setting up the TAK Editor extension in the public documentation.

By referencing custom design rules in copilot-instructions, Copilot can assist in generating and editing touch adaptation layouts based on natural language prompts. This approach serves as an additional option alongside the TAK CLI and Editor extension, enabling a more conversational and flexible editing workflow.

You can read more about setting up GitHub Copilot Custom Instructions to edit touch layout JSON in public documentation.

The TAK CLI can be installed on Windows using WinGet (documentation, download).

winget install Microsoft.Gaming.TAK.CLI

If you have already installed the TAK CLI through WinGet, you can upgrade to the latest version using the following command:

winget upgrade Microsoft.Gaming.TAK.CLI

Alternatively, you can download a single file executable (tak.exe) from the releases page of this repository. The binary can be used immediately from the command line.

Once the CLI executable is downloaded and the TAK Editor extension is installed in VS Code, you must provide its path to the extension, either through the VS Code settings, or by executing the "Set TAK CLI path" command from the command palette.

The TAK CLI can be installed on MacOS using Homebrew. If you have not installed Homebrew, you can do so by following the instructions on the Homebrew website.

brew install microsoft/xbox-game-creator-tools/tak-cli

If you have already installed the TAK CLI through Homebrew, you can upgrade to the latest version using the following command:

brew upgrade tak-cli

Alternatively, you can download a DMG file (tak-<version>.dmg) from the releases page of this repository. The file contains the CLI executable (tak) that can be extracted and used from the command line. This can either be done by double-clicking the DMG file and dragging the executable to a location of your choice, or by using the terminal to extract the executable.

hdiutil attach tak-<version>.dmg
cp /Volumes/tak/tak <destination directory>
hdiutil detach /Volumes/tak

Similar to the Windows installation, you must provide the path to the CLI executable to the TAK Editor extension in VS Code, either through the VS Code settings, or by executing the "Set TAK CLI path" command from the command palette.

This project welcomes contributions and suggestions. For more information see CONTRIBUTING.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.