ConsoleEmber

ConsoleEmber is a command-line and TUI (Text User Interface) application written in Go for controlling Ember smart mugs via Bluetooth. It allows you to connect to your Ember mug, monitor its status, and change settings such as target temperature, temperature unit, LED color, and device name.

Note: ConsoleEmber is currently developed and tested on Windows only. Support for other platforms may be added in the future depending on Bluetooth library compatibility.

Features

• Bluetooth Discovery & Connection: Scan for nearby Ember mugs and connect using their MAC address.
• Status Monitoring: View real-time information such as current temperature, target temperature, battery level, liquid state, and more.
• Settings Control: Change the mug's name, target temperature, temperature unit (Celsius/Fahrenheit), and LED color.
• Event Logging: See detailed logs of Bluetooth events, status changes, and errors.
• TUI Interface: Navigate through logs, mug info, and settings using a keyboard-driven text UI.
• Command-Line Support: Pass the mug's MAC address as a command-line argument for direct connection.

Usage

1. Checkout Project:

   git clone https://github.com/waringer/ConsoleEmber.git
   cd ConsoleEmber
   go mod tidy
   

2. Build the project:

   go build
   

3. Run the application:

   .\ConsoleEmber.exe -m AA:BB:CC:DD:EE:FF
   

   or without a MAC address to scan for mugs:

   .\ConsoleEmber.exe
   

4. Navigate the TUI:
   • Use arrow keys to move through menus.
   • Press [TAB] to switch between menu and detail view.
   • Press [c] to copy detail view content to clipboard.
   • Use the settings menu to change mug parameters.

Requirements

• Go 1.24 or newer
• Windows 11

Credits

This project is inspired by and based on the work of:

• python-ember-mug
• ember-mug-controller