Scale Integration

Beanstats integrates with Bluetooth Low Energy (BLE) coffee scales for real-time weight and timer readings during brewing.

Supported Scales

Acaia

Timemore

Bookoo

Pairing Your Scale

1. Navigate to Settings > Scales
2. Ensure your scale is powered on and in range
3. Tap Scan for Scales
4. When your scale appears, tap Pair
5. The scale is now saved and will auto-connect

Auto-Connect

By default, paired scales will automatically reconnect when you open the app. You can toggle this per scale in the settings.

Connection Status

The scale connection status is shown throughout the app:

Features

Live Weight Display

When connected, the current weight is displayed:

• In the brew form header
• In the timer overlay during brewing
• In the scale settings for testing

Weight readings include a stability indicator - a filled circle when the reading is stable.

Timer Sync

For scales with timer support:

• The app uses the scale’s timer for accurate readings
• Timer controls (start/stop/reset) send commands to the scale
• Timer display updates in real-time

Tare

Tap the Tare button to zero the scale. This works in:

• The brew timer overlay
• The scale settings debug view

Flow Rate Display

During brewing, you’ll see real-time flow rate:

The peak flow rate is tracked and displayed as a badge.

Weight-Over-Time Chart

During brewing, a live chart shows:

• Weight progression (area and line)
• Flow rate overlay
• Pre-infusion marker for espresso
• Reference line from previous brew (when using Repeat Brew)

This chart is saved with your brew for later review.

Reference Line (Repeat Mode)

When repeating a brew that has scale data, the timer overlay displays the previous brew’s weight curve as a dotted gray reference line. This helps you:

• Match the timing of your previous pour
• Maintain consistent pour rate
• Compare your current extraction to a successful one

See Repeat Brew for more information.

Auto Features

Auto-Start Timer

When enabled, the timer automatically starts when flow is detected (weight increasing at > 0.5 g/s).

Configure in Settings > Scales:

• Auto-Start Timer: Master toggle
• Auto-Start for Filter: Enable for pour-over brews (disabled by default to avoid triggering during bloom)

Auto-Capture Weight (Espresso)

For espresso brews, the app can automatically capture the final weight when flow stops:

1. Enable Auto-Capture Weight in settings
2. Choose your capture delay:
   • Fast: 0.5 seconds
   • Normal: 0.8 seconds
   • Slow: 1.5 seconds

When flow rate drops below 0.2 g/s for the configured duration, the weight is captured and the timer stops.

Pre-Infusion Detection

During espresso extraction, the app automatically detects when pre-infusion ends:

1. Monitors flow rate during the first 15 seconds
2. When flow exceeds 1.5 g/s, marks pre-infusion end
3. Shows the detected time in the brew details
4. Displays as an orange marker on the brew chart

Troubleshooting

Scale Not Found

• Ensure Bluetooth is enabled on your device
• Make sure the scale is powered on
• Check that the scale isn’t connected to another device
• Try power cycling the scale

Connection Drops

• Keep the scale within Bluetooth range
• Ensure the scale battery is charged
• Some scales require periodic connection (heartbeat) - the app handles this automatically

Weight Not Updating

• Verify the scale shows weight on its display
• Try taring the scale
• Disconnect and reconnect the scale

Timer Not Syncing

• Not all scales support timer via Bluetooth
• Timemore scales use the app’s timer instead
• Ensure you’re using a supported scale model

Data Storage

Weight samples are recorded at 10Hz during brewing. You can configure the sample rate saved to the database:

Configure in Settings > Data & Storage > Sample Rate.