# Razer Nari Battery Level: recovering a USB battery-voltage exchange

> Razer Nari Battery Level implements a USB HID exchange to read the headset's reported battery voltage through its dongle. The author captured SET_REPORT and GET_REPORT traffic and infers that two response bytes encode battery voltage in millivolts. A C program using libusb sends the requests and decodes those bytes.

- 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/Modzeleczek/RazerNariBatteryLevel>
- Primary source: <https://github.com/Modzeleczek/RazerNariBatteryLevel/blob/0540d423cddae3f2cd01297754670b6aea9206f9/README.md>
- Catalog page: <https://awesomerea.org/resources/razer-nari-battery-level-case/>
- Record JSON: <https://awesomerea.org/resources/razer-nari-battery-level-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/razer-nari-battery-level-case/index.md)

## Requirements & limits

- **Prerequisites:** A connected Razer Nari USB dongle, libusb and GCC are required.
- **Prerequisites:** The documented run command uses elevated privileges.
- **License:** No licence file in the repository.

## Primary sources

1. <https://github.com/Modzeleczek/RazerNariBatteryLevel/blob/0540d423cddae3f2cd01297754670b6aea9206f9/README.md>

## More in Protocols

- [Pix Backpack Go: reconstructing PIX display control over BLE](https://awesomerea.org/resources/pix-backpack-go-case/index.md) · Case study
- [VFS495 fingerprint reader on Linux: reconstructing capture and login](https://awesomerea.org/resources/vfs495-linux-case/index.md) · Case study
- [VTech VM901: reconstructing camera authentication and media access](https://awesomerea.org/resources/vtech-vm901-home-assistant-case/index.md) · Case study
- [KATASYMBOL E12 Lab: reconstructing BLE label printing](https://awesomerea.org/resources/katasymbol-e12-lab-case/index.md) · Case study
- [GE Opal 2: ice maker hardware and I2C interface research](https://awesomerea.org/resources/ge-opal-2-research-case/index.md) · Case study
- [magicJack HOME: a Linux phone system from USB and SIP protocol research](https://awesomerea.org/resources/magicjack-home-linux-phone-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.
