Bean Tracking

The Beans feature allows you to manage your coffee bean inventory with detailed tracking of origins, varieties, and consumption.

Overview

Track your coffee beans with:

• Detailed variety information for single-origin and blends
• Automatic weight calculation based on brews
• Archive system for finished beans
• Photo attachments and ratings
• Freeze tracking for storing beans
• Ratings

Adding a Bean

Tap the + button in the Beans list to add a new coffee. Long-press it, or use the Add Bean button on the home screen, for the two automatic options:

See Filling the Form Automatically below. Whichever route you take, you can enter:

Basic Information

Origin Information

For both single-origin coffees and blends you can add detailed variety information:

Purchase Information

Multi-Bag Support

When you buy multiple identical bags (same roast date), enter the number of bags and the weight per bag. The app calculates your total inventory automatically.

Additional Fields

• Tasting Notes: Flavor descriptors
• Personal Notes: Your observations
• Rating: 0-5 star rating
• SCA Score: SCA cupping score (0-100)
• Photo: Attach an image of the bag or beans

Keyboard Toolbar

The bean form shows a toolbar above the keyboard with chevrons that step through the fields in order and a Done button to dismiss the keyboard. The number pad fields, such as weight and price, have no return key of their own, so this is how you leave them.

Filling the Form Automatically

Typing out a bag’s details gets old fast, so Beanstats can read them for you from a product page or a photo of the bag. Both routes show you what was found before anything is saved, and everything stays editable afterwards.

Import from URL

1. Long-press Add Bean and choose Import from URL
2. Paste the link to the roaster’s product page, or tap Paste from Clipboard
3. Tap Extract
4. Review what was found, then tap Use Data to open the bean form pre-filled

Beanstats reads the structured product data most shops publish, which covers name, price, and weight reliably. On devices with Apple Intelligence, the page text is read as well, which usually adds roaster, origin, process, varieties, roast level, and tasting notes.

Scan Coffee Bag

1. Long-press Add Bean and choose Scan Coffee Bag
2. Take a photo of the label, or pick one from your library
3. Tap Extract
4. Review what was found, then tap Use Data

With Apple Intelligence available, the label is interpreted as a whole and the result is marked “Extracted with Apple Intelligence”. Without it, Beanstats falls back to plain text recognition, which picks up less and is marked as basic extraction.

What Gets Filled In

Name, roaster, roast level, whether it’s a blend or decaf, tasting notes, SCA score, price and currency, bag weight, product URL, and per-variety details such as origin country, region, processing method, elevation, farmer, and blend percentage.

Single-Origin vs. Blend

Toggle Is Blend to switch between modes:

Single-Origin

• One variety with detailed origin information
• Full origin details shown in the detail view

Blend

• Multiple varieties, each with their own origin info
• Enter percentage for each component (e.g., 60% Ethiopian, 40% Colombian)
• If no percentages are entered, they’re distributed equally

Bean Detail View

Tapping a bean shows a comprehensive detail view with:

Stats Cards

Remaining weight, usage percentage, and brew count.

Recent Brew Ratings

A line chart showing ratings of your last 5 brews with this bean (only shown if any rated brews exist).

Flavor Profile

An average taste profile shown as a radar chart, based on extraction grid data from your brews.

Best Recipe

Optimal brew parameters computed from your highest-rated brews. Shows dose, ratio, temperature, grind size, and time in a compact grid. When both espresso and filter brews exist, a segmented picker lets you switch between styles.

If the current bean has too few rated brews, the recommendation falls back to similar beans. Includes roast context (e.g., “Typical parameters for light roasts”).

Similar Beans

Shows up to 3 similar beans from your inventory with match percentage and match reason pills (same origin, similar taste, etc.). Only shown when 2+ non-archived beans exist.

Sorting

The bean list supports a Best Match sort option that ranks beans by preference score, using your brewing history and taste data.

Weight Tracking

Your remaining coffee weight is calculated automatically:

Remaining = Initial Weight - Weight Used in Brews - Frozen Weight

Each time you log a brew, the coffee weight is deducted from your inventory. The bean list shows remaining weight with color indicators:

Archiving Beans

When you finish a bag of coffee:

1. Swipe left on the bean and tap Archive
2. Or wait for the prompt when your last brew depletes the bag

Archived beans are hidden from the default list but preserved for your history. Toggle Show Archived to view them again.

Duplicating Beans

When you buy the same coffee again:

1. Swipe left on the bean and tap Duplicate
2. A new entry is created with today’s purchase date
3. Weight resets to the original amount
4. All brews stay with the original bean

Freeze Tracking

For beans you want to freeze for later:

1. Open a bean’s detail view
2. Navigate to the Freezer section
3. Tap Freeze Some Beans
4. Enter the weight and container type

Each freeze entry gets a unique 5-character tag (e.g., “7HK3N”) that you can write on your container for easy identification.

Container Types

• Vacuum Bag
• Tube
• Ziploc Bag
• Container
• Original Bag
• Mason Jar
• Other

Thawing

When you’re ready to use frozen beans:

1. Open the freeze entry
2. Tap Thaw
3. Enter the weight to thaw

You can partially thaw - the remaining frozen amount stays tracked.

Freeze Status Indicators

Thaw All & Start Brew

For single-dose frozen portions, you can quickly thaw and start brewing:

1. Open the thaw form for a freeze entry
2. Tap Thaw All & Start Brew
3. The brew form opens with the bean pre-selected and the thawed weight pre-filled
4. Complete your brew and save

This streamlines the workflow for frozen single-dose portions.

NFC Tags

If your device supports NFC, you can write the freeze entry to an NFC tag:

1. Open the thaw form for a freeze entry
2. Tap Write to NFC Tag
3. Hold your phone near an NFC tag

Scanning the tag later opens the thaw form directly.

NFC Predose Tags

If your device supports NFC, you can write NFC tags with pre-dosed bean weight for quick brew setup:

1. Open a bean’s detail view
2. Tap the … menu
3. Select Write NFC Tag
4. Enter the pre-dosed weight, and optionally a grind size
5. Tap Write to NFC Tag and hold your phone near an NFC tag

Scanning the tag later opens the brew form with the bean, weight, and grind size pre-filled.

The grind size is free-form text, such as Medium-fine or 22 clicks, and is useful when you grind ahead of time. It is optional, so tags written without one keep working as before. With a scale connected, you can weigh the dose straight into the writer instead of typing it.

Swipe Actions