Documentation
Features
Settings

Settings

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

Appearance

Theme

Choose your preferred color scheme:

Option Description
Light Always light mode
Dark Always dark mode
Auto Follow 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:

System Weight Temperature
Metric grams (g), kilograms (kg) Celsius (°C)
Imperial ounces (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

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:

Rate Storage Detail
10 Hz Full Best 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.

Experimental Features

Access experimental features by tapping the “Features” section header 5 times:

Beanconqueror Importer

Import data from Beanconqueror app exports:

  1. Export from Beanconqueror (Settings → Maintenance → Export)
  2. Transfer the zip file to your device
  3. Unzip in the Files app
  4. Enable the BC Importer in Settings
  5. Tap “Import from Beanconqueror”
  6. Select the unzipped export folder

Imports beans, brews, grinders, and brew methods with duplicate detection.

Experimental features are stored locally and don’t sync via iCloud.

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.
Statistics