> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lighting API Overview

> Lighting API Overview

<a id="introductionSection" />

## Introduction

The Microsoft Game Development Kit (GDK) provides lightweight APIs to control RGB lighting on a variety of peripheral devices, including keyboards, mice, headsets, and more.

Compatible devices implement or adapt to the [HID standard for Lighting and Illumination](https://www.usb.org/sites/default/files/hutrr84_-_lighting_and_illumination_page.pdf). In this specification:

* A *Lamp* is a single LED, bulb or other light source that can be manipulated in terms of on/off state, brightness and/or RGB color value.

* A device containing one or more Lamps and conforming to the aforementioned HID lighting standard is called a *LampArray*.

The lighting APIs included in the GDK also carry the name LampArray.

> **Please note:** As of the March 2023 recovery, the GDK Lighting API only supports the following devices on console. Support for additional devices will be added in future recovery releases.
>
> * Razer Turret for XBOX One (keyboard and mouse)
> * Razer BlackWidow Tournament Edition Chroma V2

## Topics

[LampArray Basics](/build/core-features/common/lighting/lighting-basics)
Describes how to obtain and inspect the basic objects that comprise the LampArray API.

[Setting Colors on a LampArray](/build/core-features/common/lighting/lighting-colors)
Describes how to perform basic color operations with the LampArray API.

[LampArray Effects](/build/core-features/common/lighting/lighting-effects)
Provides tips on creating more complex LampArray lighting effects.

<a id="seeAlsoSection" />

## See also

[LampArray API reference](/reference/lighting/gc-reference-lighting-toc)

[Microsoft Game Development Kit](/services/playfab/sdks/platforms/gdk)


## Related topics

- [Lighting API reference for LampArray peripherals](/reference/lighting/gc-reference-lighting-toc.md)
- [ILampInfo interface reference](/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md)
- [ILampArray interface reference](/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)
- [LampArray Effects](/build/core-features/common/lighting/lighting-effects.md)
- [Common GDK features](/build/core-features/common/common-features-overview.md)
