Home

Awesome

<img align="right" src="https://raw.githubusercontent.com/artisan-roaster-scope/artisan/master/wiki/screenshots/artisan.png" width="70">

Artisan

Visual scope for coffee roasters

Latest release Pre-release Github Latest Releases License Windows/Mac/Linux build pylint Mypy Ruff pytest coverage pre-commit

WARNING: pre-release builds may not work. Use at your own risk.

Summary

Artisan is a software that helps coffee roasters record, analyze, and control roast profiles. When used in conjunction with a thermocouple data logger or a proportional–integral–derivative controller (PID controller), this software can automate the creation of roasting metrics to help make decisions that influence the final coffee flavor.

Donations

This software is open-source and absolutely free to use, also in commercial settings.

If you think Artisan is useful to you, contribute financially to its further development. Send any amount via my PayPal.Me page. Thanks!

Home roasting enthusiasts often donate 10-100.- (in $ or EUR), while small roasting businesses and consultant that use Artisan in their daily work tend to donate 100-300.- (in $ or EUR). For extra tech support, please inquire.

Download (macOS/Windows/Linux/RPi)

Installation Instructions

Documentation

PLEASE FOLLOW AND TAG US!     <a href="https://www.facebook.com/ArtisanScope"><img src="https://github.com/artisan-roaster-scope/artisan/blob/master/wiki/screenshots/facebook-square.svg?raw=true" width="30"></a>   <a href="https://www.instagram.com/artisanscope/"><img src="https://github.com/artisan-roaster-scope/artisan/blob/master/wiki/screenshots/instagram-square.svg?raw=true" width="30"></a>   <a href="https://www.youtube.com/channel/UCEp-DH_Y7sBR3-X3FWomgog"><img src="https://github.com/artisan-roaster-scope/artisan/blob/master/wiki/screenshots/youtube-svgrepo-com.svg?raw=true" width="30"></a>   <a href="https://masto.ai/@artisan"><img src="https://github.com/artisan-roaster-scope/artisan/blob/master/wiki/screenshots/mastodon-icon-svgrepo-com.svg?raw=true" width="30"></a>   <a href="https://www.linkedin.com/company/artisan-plus"><img src="https://github.com/artisan-roaster-scope/artisan/blob/master/wiki/screenshots/linkedin-svgrepo-com.svg?raw=true" width="30"></a>

Star History Chart

<a id="version_history"></a> Version History

Detailed Release History

VersionDateComment
v3.1.0Nov 22, 2024Adds support for induction heated Gemma machines by Sweet Coffee Italia, the latest Santoker machines connecting via Bluetooth, Primo roasting machines, ColorTrack sensors, Stronghold profile import, and Phidget stepper controllers and more.<br><b>Release Sponsor: Algrano</b><br/>
v3.0.2Aug 20, 2024Bug fixes
v3.0.0Aug 1, 2024Adds roast scheduling support<br><b>Release Sponsor: artisan.plus</b><br/>
v2.10.4Mar 21, 2024Bug fixes
v2.10.2Feb 29, 2024Adds support for machines from Mill City Roasters, the IKAWA PRO X, the standard WinUSB driver for the Aillio R1 on Windows, the Digi-Sense 20250-07 IR, and the Extech 42570 IR.<br>
v2.10.0Nov 28, 2023Adds support for Bühler Roastmaster, Joper, and Cogen roasting machines, the Phidget DAQ1000, DAQ1200, DAQ1300, DAQ1301, AppleSilicon support to macOS build, a Raspbian Bookworm 64bit build, extra devices to Roast Comparator and many performance and stability improvements.<br><b>Release Sponsor: Paolo Scimone Coffee Consulting</b><br/>
v2.8.4Jun 21, 2023Adds official integration with Kaleido roasters as well as dark mode support on Windows and Linux (last version supporting macOS 11, but newer legacy builds still support macOS 10.13 and newer)<br><b>Release Sponsor: BC Roasters</b><br/>
v2.8.2Dec 21, 2022Adds support for Sivetz fluid bed roasting machines, Santoker Q Series and R Series roasters, the Yocto Watt module, the Phidget DAQ1500, and speeds up the Designer (last version supporting macOS 10.15, but legacy builds of v2.8 still supports macOS 10.13+)
v2.8.0Oct 21, 2022Adds support for new Besca models, Diedrich DR machines, Titanium Roasters, Eurotherm variants of San Franciscan machines, the Plugin Roast 2.0 module and CMS machines from Coffee Machines Sale, adds Roast Comparator phases widget and auto time axis modes<br><b>Release Sponsor: Coffee Machines Sales</b><br/>
v2.6.0Mar 11, 2022Adds support for a number of additional machines, the new Phidget HUB0001 and the Phidget VCP100x modules, the new generation Acaia Pearl-S/Pearl2021/Lunar2021 scales, adds a CHARGE timer, quadratic and RoR projections, an enhanced cursor coordinates widget, LCD cursor function, PDF reports, BBP support to Roast Comparator, some Roast Simulator enhancements, a slider mapping calculator, an artisan.plus custom blend editor, notifications, many keyboard shortcuts, Ukrainian localization, performance and stability improvements as well as macOS and Windows legacy builds<br><b>Release Sponsor: Showroom Coffee</b><br/>
v2.4.6Jul 30, 2021Adds energy and CO2 calculator, new setups for Probat UG and G Series machines with control functionality, the new FZ94 EVO machine by Coffee-Tech, as well as machines of Roastmax, Craftsmith and Carmomaq, updates Giesen setups to control additional actors on larger machines, adds support for the Yoctopuce modules Yocto-0-10V-Rx, Yocto-milliVolt-Rx and Yocto-Serial, extends Chinese and Spanish translations and adds translations for Vietnamese, Danish, Latvian, Slovak and Scottish (last version supporting Windows 8, but legacy build of v2.6.0 supports Windows 8)<br><b>Release Sponsor: Sweet Maria's</b><br/>
v2.4.4Dec 14, 2020Adds machine setups for the Nordic PLC and Fabrica Roasters, importers for Rubasse and Aillio RoastWorld, as well as PID Ramp/Soak pattern actions and templates (last version supporting Raspbian Stretch)
v2.4.2Oct 2, 2020Adds support for machines of over 40 brands including the Probat PIII series, IKAWA v3 CSV and RoastLog profile import, "Source Han Sans" and "WenQuanYi Zen Hei" font options providing complete Chinese, Korean and Japanese character sets, sliders Bernoulli mode, and WebSocket communication (last version supporting macOS 10.13 and 10.14; note that legacy builds of v2.6.0 and v2.8.0 again supports those systems)
v2.4.0Jun 3, 2020Adds Roast Comparator, Roast Simulator, and Profile Transposer, Cropster, IKAWA and Giesen Software profile import, flexible automatic file name generator, special event annotations, large PhasesLCDs, support for Twino/Ozstar roasting machines and the Giesen IR sensor, S7 and MODBUS protocol optimizations and extensions, support for additional Phidgets and Yoctopuce IO modules
v2.1.2Dec 24, 2019Bug fixes
v2.1.1Nov 29, 2019Bug fixes
v2.1.0Nov 26, 2019Adds profile analyzer, extended symbolic formulas, background images, forward looking alarms and alarms triggered by temperature differences, support for the Atilla GOLD plus 7" II, the Besca Bee sample roaster, additional Coffed machines (SR3/5/15/25/60), Coffeetool Rxx machines with control, and popular Phidget sets (incl. the one featured in On Idle Noise)
v2.0.0Jun 4, 2019New icon and new look! Adds support for the artisan.plus inventory management service, Coffee-Tech Engineering Silon ZR7, Has Garanti HGS and HSR series, Kaldi Fortis, and the forthcoming Behmor 1kg
v1.6.2Mar 20, 2019Enables communication with Phidgets under the Mac OS X 10.14 security framework
v1.6.1Mar 10, 2019Adds support for the Sedona Elite 2in1 roaster, the Probat Roaster Middleware, the Aillio R1 v2 firmware incl. the new IBTS IR sensor, the Phidgets REL1000, REL1100, REL1101, and DAQ1400, the Phidget RC Servo API (Phidget RCC 1000, Phidget 1061, and Phidget 1066), the Yocotopuce Meteo ambient sensor and the Yocotopuce IR module, adds Brazilian portuguese translations and updated French translations
v1.5.0Oct 17, 2018Adds ArtisanViewer mode, Phidgets IO VoltageRatio, Program 78 and Program 910 devices, and support for manual Besca roasting machines
v1.4.0Oct 3, 2018Adds time guide, additional PhasesLCD configurations, export/convert to Excel and import/export to Probat Pilot v1.4, channel tare, playback DROP event, always ON mode, support for ambient data and Phidget ambient sensors HUM1000 and PRE1000, PID P-on-Measurement/Input mode, improved curve smoothing, machine support for Atilla GOLD plus 7", Besca roasting machines, Coffee-Tech Engineering Ghibli and Diedrich Roasters
 v1.3.1May 20, 2018Adds support for Fuji PID PXF
 v1.3.0Apr 15, 2018Adds Siemens S7 support, MODBUS BCD decode, color themes, extraction yield calculator, support for machines of Aillio, BC Roasters, Bühler, Coffed, Coffee-Tech, Coffeetool, Giesen, IMF, K+M, Loring, Proaster, San Franciscan, Toper, US Roaster Corp
v1.2.0Dec 21, 2017Adds replay by temperature, support for Phidgets API v22, Phidgets USB devices USB 1002, 1014, 1017 and VINT devices HUB0000, TMP1100, TMP1101, TMP1200, OUT1000,OUT1001, OUT1002, OUT1100, VOLTCRAFT PL-125-T2, as well as the VOLTCRAFT PL-125-T4, improved RoR and dropout handling (last version supporting Mac OS X 10.12 and Linux glibc 2.17; first version requiring the Phidget v22 driver)
v1.1.0Jun 10, 2017Adds Recent Roast Properties, Aillio Bullet R1 profile import and support for Probat Probatone 2 (last version supporting OS X 10.9, Windows XP/7 and 32bit OS versions; last version supporting the Phidget v21 driver)
v1.0.0Feb 24, 2017Adds internal software PID, external MODBUS PID control, Apollo DT301, Extech 755, fast MODBUS RTU, AUC, RPi build, and additional translations
v0.9.9Mar 14, 2016Adds batch and ranking reports, batch conversions, follow-background for Fuji PIDs, additional keyboard short cuts, and designer improvements (last version supporting OS X 10.7 and 10.8)
v0.9.8Oct 21, 2015Adds US weight and volume units and extended symbolic expressions and plotter, ln()/x^2 approximations
v0.9.7Jul 29, 2015Bug fixes
v0.9.6Jul 20, 2015Bug fixes
v0.9.5Jul 6, 2015Adds Batch counter and app settings export/import (last Windows Celeron and Mac OS X 10.6 version)
v0.9.4Jun, 6, 2015Bug fixes
v0.9.3May 15, 2015Adds Phidget 1051, Hottop KN-8828B-2K+, and one extra background curve
v0.9.2Jan 16, 2015Bug fixes
v0.9.1Jan, 3, 2015Adds Acaia scale support and WebLCD QR code
v0.9.0Nov 17, 2014MODBUS ASCII/TCP/UDP, Yocto Thermocouple and PT100, Phidget 1045 IR, Phidget 1046 Wheatstone Bridge wiring, Phidgets async mode, Polish translations, LargeLCDs, WebLCDs, 2nd set of roast phases, volume calculator, moisture loss and organic loss, container tare, RoR delta span, phasesLCDs showing Rao's development ratio
v0.8.0May 25, 2014Phidget IO, Phidget remote, Arduino TC4 PID, Mastech MS6514
v0.7.5Apr 6, 2014Bug fixes
v0.7.4Jan 13, 2014Bug fixes
v0.7.3Jan 12, 2014Bug fixes
v0.7.2Dec 19, 2013Bug fixes
v0.7.1Dec 2, 2013Bug fixes
v0.7.0Nov 30, 2013Phidget 1046/1048, phases LCDs, xkcd style, extended alarms, Tonino support
v0.6.0Jun 14, 2013Monitoring-only mode, sliders, extended alarms, Modbus RTU, Amprobe TMD-56, spike filter, additional localizations
v0.5.6Nov 8, 2012Bug fixes  (last Mac OS X 10.4/10.5 version)
v0.5.2Jul 23, 2011Delta DTA PID support, automatic CHARGE/DROP
v0.5.0Jun 10, 2011HHM28, wheel graph, math plotter, multiple and virtual devices, symbolic expressions, custom buttons
v0.4.0Apr 10, 2011Localization, events replay, alarms, profile designer
v0.3.4Feb 28, 2011Arduino TC4, TE VA18B, delta filter
v0.3.3Feb 13, 2011Fuji PXR5/PXG5, manual device, keyboard shortcuts, Linux
v0.3.0Jan 11, 2011New profile file format
v0.2.0 Dec 31, 2010CENTER 300, 301, 302, 303, 304, 305, 306, VOLTCRAFT K202, K204 300K, 302KJ, EXTECH 421509
v0.1.0 Dec 20, 2010Initial release

License