COFFEE HAZEL | Steam-based first crack detection

COFFEE HAZEL detects first crack during coffee roasting by sensing steam, giving you a reading of the moment that the sound alone cannot.

Steam sensing / Patent pending (JP 2026-177291) / Artisan integration

Please note: our shop and checkout are in Japanese, and we currently ship within Japan only. If you are outside Japan, please get in touch — we would like to hear from you. The Artisan settings file below is free for anyone to download and use.

Introduction to COFFEE HAZEL (3:21)

Reading first crack through steam

Steam inside the drum during a roast (top) and its rate of change (bottom). A clear rise appears at the moment of first crack.

About COFFEE HAZEL

What first crack is

As the water inside the bean’s cells is heated, pressure builds until the cell walls give way. That is first crack, and it comes with a sound. For a roaster that sound is a major landmark. But it is intermittent and often indistinct, and it changes with batch size and the number of beans in the drum, which makes it an unreliable marker. For a small micro roastery the difficulty is greater still.

What first crack really is, is a release of steam. The popping sound is a by-product of it. We wrote about this in Why coffee beans crack.

Our approach

SORAMAME LAB looked instead at the steam in the roaster’s exhaust. Steam leaving the roaster is a direct, unambiguous signal of water leaving the beans. COFFEE HAZEL senses the rise in steam at first crack and alerts you. Using steam alongside the sound lets you place first crack more precisely, and makes a roast easier to repeat.

Beyond first crack

COFFEE HAZEL works with the roasting software Artisan. Steam appears on the same graph as your roast curve, so everything is in one place. No extra software is needed — the unit talks to Artisan directly.

Steam inside the drum matters beyond first crack. It takes part in heat transfer from the hot air, which means seasonal changes in humidity affect your roast in ways you can now observe and control.

What it looks like in Artisan

If you use Artisan, COFFEE HAZEL readings can be drawn on the same screen as your roast curve. The unit communicates with Artisan directly, so there is nothing to install in between. Load a free settings file, type in the unit’s IP address, and you are done.

ΔH2O and its rate of rise drawn over a roast curve in Artisan
A real roast, sampled every 2 seconds. ΔH2O and its rate of rise (ΔH2ORoR) sit alongside bean temperature and RoR. Steam responds clearly at charge, at each damper change, and at first crack. (Click to enlarge.)

What you get to see

Alongside humidity, temperature and water vapour density, Artisan gains ΔH2O — the absolute humidity difference between exhaust and intake — and its rate of rise. Because they share the time axis with bean temperature and RoR, you can read what the heat is doing against what the water is doing.

The rate of rise is calculated inside the unit. There is no virtual device or math expression to set up in Artisan.

What happens at first crack

Across 305 real roasts, the rate of rise climbed about 4.6 g/m³/min above baseline around first crack, and this appeared in 99% of the roasts. Baseline scatter is ±0.50 g/m³/min, so the change stands more than nine times clear of the noise.

Damper moves swing the rate of rise sharply, and that is not a fault. Change the airflow and the amount of steam really does change; the reading is telling you your adjustment landed. You can see this at each damper step in the graph above.

Your thermocouples stay as they are

If you already run Phidget or another probe in Artisan, you do not need to touch that setup. COFFEE HAZEL is layered on as extra sensors, so nothing about the way you record roasts today has to change.

Setting it up

Download the settings file below and load it from Help → Load Settings… in Artisan. Then open Config → Ports → WebSocket and type the IP address shown on the unit’s display into the Host field.

The IP address is the only thing you type by hand; the settings file fills in everything else. There is nothing to install, and no Python or other runtime to add. A step-by-step guide in English is included in the download.

A ZIP file containing the settings file (COFFEE_HAZEL.aset) and setup guides in English and Japanese. The guide also covers what to do if you already use Extra Devices.

Requirements

The procedure is the same on Windows, macOS and Linux. Artisan must be 4.0.2 or later (3.0.0 does not work). The COFFEE HAZEL unit needs firmware V2.3.0 or later, which can be updated from the unit’s own screen.

COFFEE HAZEL in 3D

Drag to rotate / scroll to zoom / right-drag to pan ・ Open full screen

What you need

RoasterA roaster with a chimney or exhaust duct. Exhaust temperature at the sensor position must be below 80°C. Please ask us if you are unsure.
EnvironmentWi-Fi (2.4GHz), a USB Type-C cable, a USB power source, and a PC (macOS on both Intel and Apple silicon / Windows 10 and 11 / Ubuntu)
RadioWi-Fi 2.4GHz band (IEEE 802.11 b/g/n)
Radio certificationCertified for use in Japan (technical conformity number 211-221219). The unit is not certified for use in other countries.

The moment first crack is detected

Screen recordings of COFFEE HAZEL detecting first crack, and the roaster confirming it. The data comes from a real roast of 500 g of green coffee on an Aillio Bullet, replayed in demo mode, which is why the screen says “DEMO”.

When the rate of change of ΔH₂O passes the threshold, the app shows an alert; tap “Yes” and first crack is recorded. The clips include the alert sound, so mind your volume. The interface in the recordings is in Japanese.

Desktop app (about 40 sec, with sound)
Smartphone (about 40 sec, with sound)

Watch the setup

Everything from mounting the sensor to taking the first readings. Worth a look before you buy, to see how much work it is. The narration is in Japanese; English subtitles are switched on by default.

Software

The desktop app “Coffee Hazel” works with the unit and is free, for macOS, Windows and Ubuntu. Download the .dmg, HazelSetup.exe or .deb to suit your system.

The app interface and the user guides are currently in Japanese. The Artisan setup guide is available in English.

Questions

Does it work with any roaster?

It works with roasters that have an exhaust duct or chimney, provided the exhaust temperature at the sensor position is below 80°C. Among our early-access customers it is in use on semi-hot-air roasters (Diedrich, Giesen, Probat and Fuji Royal), on an Aillio, which is not a semi-hot-air machine, and on small roasters such as the WE×SUJI, the SOUYI and hand-crank roasters. We want to build up experience on more machines, so we would be glad to hear what you roast on and how you use it. Guides for each roaster are here (in Japanese).

Do I have to modify my roaster to fit it?

No. The sensor is inserted at a joint in the exhaust duct or chimney. Nothing has to be drilled into the roaster itself.

Can it be used on a small roaster without a chimney, such as a hand-crank roaster?

Yes. It has been used with a hand-crank roaster on 100 g of beans. The hood that comes with the Small Roaster Option (Japanese page) hangs over the roaster to collect the exhaust, and the sensor measures that. If your roaster’s exhaust outlet can take a duct directly, you can measure without the hood. See also the guides for hand-crank roasters and the WE×SUJI Mini Roaster (both in Japanese).

Is first crack detection easy? Any tips?

How much steam comes off varies with the roaster, and with the type and amount of beans. That is why it matters to set the ΔH₂O threshold to suit your own setup.

Also, if you adjust the exhaust just as first crack is about to happen, the steam swings caused by that adjustment get large and make crack detection harder. The tip is to finish your exhaust adjustments beforehand.

To exclude the swings caused by exhaust adjustments, there is a setting called “wait before detection starts”. Setting that is another good tip.

Are there cases where it cannot detect the crack?

Decaf is difficult. It does not apply to every decaf, but we often see steam keep escaping steadily even before first crack, which makes the sharp rise in steam at the crack hard to pick out. We think this is because the bean structure may already have been broken down during decaffeination.

Has it changed how you roast?

The beans often cracked earlier than the crack I had been judging by myself. That means the DTR figure can come out larger. These days I trust HAZEL’s call more when I roast. (This is the experience of one of our developers.)

macOS says “Coffee Hazel” cannot be opened because Apple cannot check it for malicious software

This is the standard macOS warning shown the first time you open an app that has not been notarised by Apple. There is nothing wrong with the app itself.

macOS 15 (Sequoia) and later

  1. Double-click once and dismiss the warning (do not choose “Move to Trash”)
  2. Apple menu → System Settings → Privacy & Security
  3. Scroll down to “Coffee Hazel was blocked” and click “Open Anyway”
  4. Confirm with your password or Touch ID
  5. From then on it opens normally

macOS 14 (Sonoma) and earlier

  1. Right-click Coffee Hazel in the Applications folder and choose “Open”
  2. Click “Open” in the dialog that appears
The app starts on Windows but no window appears

The WebView2 runtime is probably missing. Download the “Evergreen Bootstrapper” from the Microsoft Edge WebView2 page, install it, and restart the app.

Can I buy one outside Japan?

Not at the moment. The unit carries Japanese radio certification only, and we ship within Japan. We are interested in hearing from roasters abroad, so please write to us — it helps us decide where to seek certification next.

I pressed the Wi-Fi reset button and the screen went black and stayed black

Press 1, the display button. The screen comes back in 10–20 seconds, just as it does after a power cycle.

Button 3, the Wi-Fi reset button, clears the Wi-Fi settings and restarts the unit when you insert a thin wire and hold it for 3 seconds. On firmware V2.4.4 and earlier, a short press puts the unit into standby and blanks the screen instead. The Wi-Fi settings are not cleared, but a roast in progress is lost.

This is fixed in firmware V2.4.5. From V2.4.5 a short press only shows a message on the screen, and both the recording and the measurement continue. See “13. Updating the firmware” in the manual.

The roast data has occasional gaps, or the graph jumps for a moment

If your exhaust fan is driven by an inverter (variable-speed drive), its switching noise can reach the sensor wiring and drop a single data point. We hit this on our own roaster, whose exhaust booster fan runs from a Mitsubishi Electric FREQROL FR-D710W.

How to check. Compare the unit with the exhaust fan stopped and running. If the gaps disappear while the fan is off, this is the cause. Opening http://<the unit's IP address>:8080/api/diag in a browser shows sens_retry (reads recovered on a second attempt) and sens_miss (reads lost) as counts.

The fix. Fit a zero-phase reactor (Mitsubishi Electric FR-BSF01 or similar) on the inverter output, with all three phases passed through it together. Any electrician who works with inverters will know the part. Check the earthing of the inverter and motor at the same time. This is work on three-phase 200V wiring — please have a qualified electrician do it.

On our roaster this took the dropouts from dozens a day to none in over 100 hours.

Firmware V2.4.5 and later already limits a dropout to the single affected sample. A better USB power adapter reduces how often it happens, but does not eliminate it.

Anything else

Please get in touch. Our reply may be in simple English, but we will answer.

Scroll to top