Settings

The Settings section allows you to configure app preferences and manage connected devices.

Appearance

Theme

Choose your preferred color scheme:

OptionDescription
LightAlways light mode
DarkAlways dark mode
AutoFollow system setting

Ambient Background

Toggle the subtle gradient background on detail views. When enabled, the background color is extracted from hero images for a cohesive look.

Measurement Units

Choose between metric and imperial units:

SystemWeightTemperature
Metricgrams (g), kilograms (kg)Celsius (°C)
Imperialounces (oz), pounds (lb)Fahrenheit (°F)

This affects all weight displays throughout the app.

Cost Tracking

Track Bean Costs

Toggle to show or hide price fields when adding beans. When enabled:

  • Price field appears in the bean form
  • Cost-per-gram calculations are available
  • Price tier statistics are shown

Currency

Select your currency symbol for price display:

  • $ (US Dollar)
  • € (Euro)
  • £ (British Pound)
  • ¥ (Japanese Yen)
  • ₹ (Indian Rupee)
  • C$ (Canadian Dollar)
  • A$ (Australian Dollar)
  • Fr (Swiss Franc)

Or enter a custom currency symbol.

Features

Freeze Tracking

Toggle to enable or disable the freeze tracking feature for managing frozen coffee beans.

Connected Devices

Scales

You can pair multiple scales with Beanstats, and they will auto-connect when detected. However, only one scale can be connected at a time.

Navigate to scale settings to:

  • View paired scales with connection status
  • Connect/disconnect scales
  • Toggle auto-connect per scale
  • Pair new scales via scanning
  • Unpair scales via swipe-to-delete

When a scale is connected, a debug section shows:

  • Current weight and stability
  • Timer value and running state
  • Battery level (if supported)
  • Connection state
  • Manual control buttons (Tare, Start/Stop Timer, Reset)

Data & Storage

Configure how scale data is stored:

Sample Rate

Choose how many weight samples to save per second:

RateStorageDetail
10 HzFullBest quality (default)
5 Hz~50%Good balance
2 Hz~20%Compact storage
The internal sampling rate remains at 10Hz for real-time display. This setting only affects what’s saved to your database.

Export Data

Access the bulk export feature to export all your brew data as JSON. See Export for details.

Webhooks

Configure webhooks to send notifications to external services when events occur. See Webhooks for details.

Data Sync

Settings sync automatically across your devices via iCloud:

  • Theme preference
  • Currency setting
  • Cost tracking toggle
  • Unit system
  • Archive visibility

This requires iCloud to be enabled on your device.

As of version 2.0.0, paired scale information is no longer synced via iCloud. Scales must be paired separately on each device.