# MacBook ALS: mapping five HID color channels

> MacBook ALS maps the 122-byte HID report of an Apple Silicon MacBook ambient-light sensor. Python scripts read five raw channels, lux and color temperature, while recorded CSV runs and colored-light tests support the reported field positions and channel responses.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/8rulerstar/macbook-als-spectral>
- Primary source: <https://github.com/8rulerstar/macbook-als-spectral/blob/2770ec7f4105b6f7cd0afd8bdda4757ebff21373/README.md>
- Catalog page: <https://awesomerea.org/resources/macbook-als-spectral-case/>
- Record JSON: <https://awesomerea.org/resources/macbook-als-spectral-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/macbook-als-spectral-case/index.md)

## Requirements & limits

- **Prerequisites:** Python 3.8+ and an Apple Silicon MacBook ambient-light sensor.
- **Limits:** The author measured one MacBook Pro Mac16,8; decoding on other models remains unconfirmed.
- **License:** MIT License.

## Primary sources

1. <https://github.com/8rulerstar/macbook-als-spectral/blob/2770ec7f4105b6f7cd0afd8bdda4757ebff21373/README.md>

## More in Protocols

- [SteelSeries Apex 3: reconstructing RGB control over USB HID](https://awesomerea.org/resources/apex3-rgb-controller-case/index.md) · Case study
- [rfserver: reconstructing a 433 MHz light remote](https://awesomerea.org/resources/rfserver-light-remote-case/index.md) · Case study
- [ro: a client for the LB-Link BL-WR2000 repeater](https://awesomerea.org/resources/ro-bl-wr2000-case/index.md) · Case study
- [dvf3060: reconstructing Kenwood DVF-3060 front-panel control](https://awesomerea.org/resources/dvf3060-front-panel-case/index.md) · Case study
- [galaxy-buds-plus: controlling Buds Plus through RFCOMM](https://awesomerea.org/resources/galaxy-buds-plus-perl-case/index.md) · Case study
- [DT No.1 F2: reconstructing smartwatch communication](https://awesomerea.org/resources/dt-no1-f2-watch-protocol-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.