Aumee Oh My

A macOS app and CLI for the Aumi AE1016 Bluetooth nightlight

The Aumi AE1016 is a BLE-controlled RGB nightlight originally made by Humanscope (Toronto). The official app is no longer maintained. Aumee Oh My brings it back to life with a native macOS GUI and command-line tool, built by reverse-engineering the BLE protocol.

Features

• Native macOS GUI with live color picker
• CLI for scripting and automation
• Full RGB color control (16 million colors) with brightness adjustment
• 6 programmable timers to turn the light on or off on a schedule
• Persistent BLE connection (no reconnect delay between commands)
• Zero cloud dependency -- direct Bluetooth, no account needed

Requirements

• macOS 12+ (Monterey or later)
• Bluetooth Low Energy 4.0+
• Python 3.12+ (for CLI/development install)
• An Aumi AE1016 nightlight

Install

GUI (DMG)

1. Download AumeeOhMy.dmg from Releases
2. Drag Aumee Oh My to Applications
3. Open the app and grant Bluetooth permission when prompted

CLI (pip)

python3.12 -m venv .venv && source .venv/bin/activate
pip install -e .
aumee scan          # find your device
aumee on            # turn it on
aumee color ff0000  # set to red

Usage

GUI

1. Launch Aumee Oh My
2. The app auto-connects to your last-used device (or click Scan for Device)
3. Click the color swatch at the top to open the color picker
4. Use the brightness slider to adjust intensity
5. Set up to 6 timers to automate on/off schedules
6. Click Save to Device to write timers to the light's firmware

CLI Commands

Command	Description
aumee scan	Find Aumi devices nearby
aumee on	Turn light on (white, full brightness)
aumee off	Turn light off (preserves color for physical switch)
aumee color FF0000	Set color by hex RGB
aumee color FF0000 -b 50	Set color at 50% brightness
aumee brightness 75	Set brightness (0-100)
aumee status	Show device info and current state
aumee save <address>	Manually save a device BLE address

Use aumee --help or aumee <command> --help for full details.

Compatibility

Confirmed

Aumi AE1016 -- the original Kickstarter nightlight (2015). All production runs use the same BLE protocol. Approximately 10,000 units were shipped via Kickstarter, Indiegogo, and aumilight.com. The same official app (v1.0.1 through v1.2.0) served all units, confirming protocol consistency across manufacturing batches.

This includes units sold under different marketing names: "Aumi Original", "Aumi Classic BLE", and "Aumi Smart Nightlight". They are all the same hardware.

Incompatible

Aumi Mini / Aumi Mini Smart+ -- a WiFi-only device (no Bluetooth radio) announced via Kickstarter in June 2017. This is a fundamentally different architecture and will not work with Aumee Oh My. Note: the Mini almost certainly never shipped at scale (still listed as "Coming Soon" on aumilight.com after 8+ years).

Unknown

No other Aumi models are known to exist. If you have an Aumi device that isn't the AE1016 and want to test, please open an issue.

Protocol

The BLE protocol was reverse-engineered from the original Android APK (ca.humanscope.aumi v1.2.0). See protocol.md for the full specification, including GATT service UUIDs, command formats, and timer programming.

Development

git clone <this-repo>
cd aumee-oh-my
python3.12 -m venv .venv && source .venv/bin/activate
pip install -e .
aumee scan

To build the macOS .app bundle (for development, requires the venv):

bash scripts/build_app.sh
open "Aumee Oh My.app"

To build a distributable DMG:

pip install pyinstaller
bash scripts/build_dmg.sh

License

MIT