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

# Lighting overview

> Lighting API Overview

## 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](https://docs.xbox.com/build/core-features/common/lighting/lighting-basics.md)
Describes how to obtain and inspect the basic objects that comprise the LampArray API.

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

[LampArray Effects](https://docs.xbox.com/build/core-features/common/lighting/lighting-effects.md)
Provides tips on creating more complex LampArray lighting effects.

## See also

[LampArray API reference](https://docs.xbox.com/reference/lighting/gc-reference-lighting-toc.md)

[Microsoft Game Development Kit](https://docs.xbox.com/services/playfab/sdks/platforms/gdk.md)


## Related topics

- [Lighting API reference (API contents)](https://docs.xbox.com/reference/lighting/gc-reference-lighting-toc.md)
- [ILampInfo (Interface contents)](https://docs.xbox.com/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md)
- [ILampArray (Interface contents)](https://docs.xbox.com/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)
- [LampArray Effects](https://docs.xbox.com/build/core-features/common/lighting/lighting-effects.md)
- [GDK features common to all platforms](https://docs.xbox.com/build/core-features/common/common-features-overview.md)