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
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:
| Rate | Storage | Detail |
|---|---|---|
| 10 Hz | Full | Best quality (default) |
| 5 Hz | ~50% | Good balance |
| 2 Hz | ~20% | Compact storage |
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.