🖱️ RazerBattery for macOS

A lightweight macOS utility that restores Razer mouse battery monitoring — built natively for Mac users.

---

🧩 Overview

RazerBattery is a macOS menu bar utility designed to solve a long-standing issue:
Razer Synapse, the official Razer configuration software, is no longer supported on macOS.
As a result, users cannot check the battery status of their Razer wireless devices.

This project provides a minimal and native Swift solution, allowing Mac users to view their Razer mouse battery level directly in the system menu bar, without any background daemons or third-party frameworks.

---

🎯 Motivation

As a Razer peripheral user on macOS, I found it inconvenient that Razer Synapse was unavailable, leaving no way to monitor the battery level of my mouse.
This project originated from that frustration — to build a small, efficient, and polished tool that seamlessly integrates with the macOS ecosystem.

---

✨ Features

• 🔋 Real-time battery status for Razer wireless mice
• 🍎 Native Swift implementation, lightweight and efficient
• 🧠 No dependencies — works without Razer Synapse
• 💡 Automatic refresh and background update
• 🎛️ Minimal menu bar interface, integrated with macOS design

---

🧰 Technical Details

• Language: Swift
• Frameworks: Foundation, IOKit, AppKit
• Architecture: macOS Menu Bar App
• Device Communication: Reads battery data from HID device descriptors via IOKit
• Project Type: Xcode (Swift App)

---

📸 Preview

---

🔧 Installation

git clone https://github.com/marktsai333/RazerBattery.git  
cd RazerBattery  
open RazerBattery.xcodeproj  

Build and run directly in Xcode.
The app will appear as an icon in your macOS menu bar.

---

🧠 Future Improvements

• [ ] Support multiple Razer devices simultaneously
• [ ] Add low-battery notification system
• [ ] Integrate with macOS Shortcuts or AppleScript

---

🧑‍💻 Author

Mark Tsai (蔡宇炫)
Department of Computer Science
National Yang Ming Chiao Tung University

📧 Email: marktsai333@gmail.com
🐙 GitHub: @marktsai333

---

💬 Personal Reflection

Developing RazerBattery strengthened my understanding of macOS system-level programming,
particularly in handling hardware communication (IOKit) and UI integration (NSStatusBar).
It also inspired me to explore how everyday frustrations can be solved elegantly through software —
a philosophy I hope to carry into my future research in Human-Computer Interaction and interactive systems.

---

🧠 “Bridging the gap between hardware and user experience — one click at a time.”