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
Toggle experimental and optional features:
Freeze Tracking
Toggle to enable or disable the freeze tracking feature for managing frozen coffee beans.
Water Temperature
Toggle to show the water temperature field in the brew form. Useful for tracking brewing temperature for pour-over and other methods.
RPM Guide
Toggle to show a visual guide for hand grinder pacing. Helps maintain consistent grind speed.
NFC Predose Tags
Toggle to enable writing NFC tags with pre-dosed bean weight for quick brew setup. This option only appears on NFC-capable devices. See Bean Tracking for details.
Notifications
Configure notification preferences for the app.
Rating Reminders
Enable notifications to remind you to rate your brews after you’ve had time to enjoy them.
| Setting | Description | Default |
|---|---|---|
| Rating Reminders | Enable or disable reminder notifications | Off |
| Remind After | How long to wait after brewing | 2 hours |
See Notifications for more details.
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 |
Import Data
Import data from external sources:
- Beanconqueror: Import beans, brews, grinders, and brew methods from Beanconqueror exports
- Beanstats Backup: Restore a full backup from another device. See Import & Backup for details.
Export Data
Access the export features to save your data:
- Bulk Export: Export all your brew data as JSON. See Export for details.
- Full Backup: Create a complete backup of all data. See Import & Backup 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.