ThirdReality Smart Scale

ThirdReality Smart Scale Integration is a custom component for Home Assistant that works with the ThirdReality Smart Scale (3RKS030Z). It provides a Cocktail Mixing Assistant and a Calorie Tracker with real-time weight feedback and optional voice guidance.

Works best with ThirdReality smart speakers for a fully hands-free experience.

Features

• Cocktail Mixing Assistant — step-by-step guided mixing with real-time weight tracking
• Calorie Tracker — weigh food, log calories per meal, and get daily intake summaries
• Voice guidance — audio prompts for each step (works with ThirdReality smart speakers)
• Auto-creates all helper entities — zero manual setup after installation
• Supported platforms: Zigbee2MQTT, ZHA

Requirements

• Home Assistant >= 2024.1.0
• HACS installed and configured
• A ThirdReality Smart Scale connected via Zigbee2MQTT or ZHA

Installation

Or manually: HACS > Integrations > Search ThirdReality Smart Scale > Click into it > Download

After download, restart Home Assistant.

Configuration

Step 1: Add Integration

After restart, go to Settings > Devices & Services > Add Integration > Search ThirdReality Smart Scale

Step 2: Select Platform and Device

• Platform: select Zigbee2MQTT or ZHA
• Device: select your scale from the dropdown

Step 3: Select Features

Check the features you want to enable:

• Cocktail Mixing Assistant
• Calorie Tracker

Step 4: Voice Settings (Optional)

• TTS Engine: select your TTS entity
• Speaker: select your media_player entity for voice announcements

Step 5: Set Up Dashboards

After configuration, set up the dashboards:

1. Go to Settings > Dashboards > + Add Dashboard
2. Name it (e.g., "Cocktail" or "Calories"), click Create
3. Open the new dashboard, click the ⋮ menu (top right) > Edit Dashboard > ⋮ menu > Raw configuration editor
4. Replace the content with the YAML from one of these files:
   • Cocktail Dashboard: cocktail_dashboard.yaml
   • Calorie Dashboard: calorie_dashboard.yaml
5. Click Save

No modifications needed. The dashboard YAML works directly with the entities created by this integration.

Usage

Calorie Tracker

1. Click Calories in the sidebar
2. Select a food from the "Select Food" dropdown (e.g. Apple, Chicken Breast) or enter a custom food name and calories per 100g
3. Place the food on the scale, the page shows real-time weight and calories
4. Click Add + to log this item to the current meal
5. Repeat steps 2-4 for more foods
6. When the meal is done, click Finish Meal, the meal total is added to today's count
7. To start a new day, click Reset

Voice prompts: confirmation on each Add, high-calorie warnings, meal summaries, daily limit alerts.

Cocktail Mixing

1. Click Cocktail in the sidebar
2. Choose a cocktail from "Choose Your Cocktail" (e.g. Mojito) or select Custom and enter your own recipe
3. Click Start Mixing
4. The page shows "Place glass on scale", place your glass and click Done
5. Follow on-screen prompts: pour each ingredient until the target weight is reached
6. The scale auto-advances to the next step, or click Done manually
7. When all ingredients are added, Cheers! appears and auto-returns to selection after 5 seconds

Voice prompts: start instruction, ingredient guidance for each step, completion celebration.

Adding Custom Cocktail Recipes

1. Go to Developer Tools > Actions
2. Select service thirdreality_scale.add_cocktail
3. Fill in the data and click Execute:

action: thirdreality_scale.add_cocktail
data:
  name: pina_colada
  ingredients: White Rum:50,Pineapple Juice:80,Coconut Cream:30

Format: ingredient:weight_in_grams, separated by commas.

The new cocktail appears in the Cocktail dashboard dropdown immediately.

Troubleshooting

Problem	Solution
Scale not in dropdown	Verify scale is connected in Zigbee2MQTT / ZHA
Voice not working	Check that media_player entity is available and TTS is configured
Weight not updating	Press "Start Report" on the scale's ZHA device page
Dashboard not showing data	Ensure integration is configured and HA restarted

License

This project is open source. See LICENSE for details.