Artisan Documentation

Visual scope for coffee roasters


Have questions or bugs?

Click to register with the Artisan-User list.
Only questions comments on the Artisan List are answered.

June 15, 2013


The version 0.6 of Artisan, an open-source software that helps coffee roasters to record, analyze, and control roast profiles, is now available for Windows, OS X and Linux.


The most important changes and additions w.r.t. v0.5.x are as follows.

* Monitoring-only mode reporting readings on LCDs without recording
* Event sliders e.g. to control the Hottop heater and fan via the HT Roaster Interface
* Extended alarms triggered by time and temperature on any curve
* Flexible Modbus RTU support allowing temperature reading and device control
* Curve smoothing and spike filtering
* New localizations: Arabic, German, Greek, Spanish, French, Japanese, Norwegian, Portuguese, Turkish, Dutch, Chinese and Hungarian
* Windows installer, and icons on Windows and Linux

See <> for a detailed list of changes and the Artisan blog <> for details on some of the new features.

We are deeply grateful for the extensive support we received from many of you, especially in translating Artisan’s more than 1200 phrases into several languages (more under preparation). We want to thank Frans Goddijn, Brad Collins, Claudia Raddatz, Marcio Carneiro, Ostnes Runar, Yoshida Minoru, David Lahoz, Savvas Kiretsis, Wa’il, Lukas Kolbe, Oliver Schirmer, Kristoffer Johansson, Çetin Barut, Rubens Gardelli, Kyle Iseminger, Kalle Deligeorgakis, Matthew Sewell, Carlito Smith, Rich Helms, Carlos Pascual, Ingo, David Trebilcock, Matt Fischler, Jim Gallt, Gunnar Troll, Alex Fan, Piet Dijk, Bertrand Souville, Zoltán Kis and many others.

We do not take donations. But if you are using Artisan in a commercial setting, it would make us (and some others) happy if you would donate to Coffee Kids <>, a non-profit organization devoted to improving the quality of life for children and families in coffee growing regions around the world.

The Artisan team


Note: Version 0.5.0 reverses the ET and BT probes. ET (Environment Temperature) is now probe 1 while BT (Bean Temperature) is probe 2.

Artisan is 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.

  • runs on Mac OS X 10.5/10.6, Windows, and Linux
  • ET/BT logging and PID control supporting the following devices
    • Fuji PXR/PXG 4 & 5 PID
    • Omega HH309, HH506RA, HH802U, HH806AU
    • CENTER 300, 301, 302, 303, 304, 305, 306, 309
    • VOLTCRAFT K201, K202, K204, 300K, 302KJ
    • EXTECH 421509
    • Arduino TC4
    • TE VA18B
  • Fahrenheit and Celsius display and conversion
  • manual logging of extra events (FCs,FCe,..)
  • large buttons supporting touch panels
  • live ET/BT rate-of-rise curves with filter
  • metric and thermal head-up-display predicting the ET/BT future during logging
  • profile statistics and evaluations based on user configurable roast phases
  • background reference profile
  • user defined cup profiles and cup profile graphs
  • HTML report creation
  • CSV export

Sample Screenshots

Conventions in this manual

Tips and tricks appear in a box like this


Technical material appears in a box like this

175 Responses to “Introduction”

  • Michael Helms says:

    “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.”

  • Fred Bacher says:

    This is very nice. In looking at all of the loggers, it’s unclear how some of them will work. They seem to store the data on the logger (only 1024 points) and then stop. Then they use the USB to download the data to a PC. Can this be made to work to give real time continuous results. Which ones, for instance, can send a reading every sec? I roast with a YM-2 Ambex in a shed in my yard. I’ve been using the MWTC from Omega that you don’t support so would have to buy a new logger to make this work. The Omega logger is really bad and really only records the data. The graphics are not useful to know how the roast is going so I still have to rely on a stopwatch and the watlow display. I would buy one of the less expensive loggers, < $200, if I knew I could make it work with your software. Again, nice job! If you decide to port to the MWTC, I do have a lot of data packet worked out and could share that.

  • says:

    I would be even better to have the ability to add pics. E.g Pre-roast, after roast, after grinded, expresso colour. Then, generate the report including those pics would be very useful.

    Nice work.

  • Weilu says:

    I can’t buy any thermometer supported by Artisan here. Can PID be used as data logger? Or any hints to support a new thermometer, like TES 1307?

  • Runar says:


    I have a Center 309 with 4 channels. I use 2 of them now for ET and BT but would like to assign number 3 to a exhaust temperature probe and plot this on the Artisan. Is this possible now?

  • arpi says:


    To plot the 3th and 4th thermocouples, you need to add an extra device called +309_34


  • Ken says:

    Any chance that NI USB-9211A will be supported ?

  • arpi says:

    Hi Ken.

    The artisan team is always looking to add new devices. Please contact us in the user mailing list to farther discuss this subject.


    • Coffja says:

      Hi, I just joined the user mailing list, and I also wish Artisan can support NI USB-TC01 device~
      Thanks for Artisan team, you really make a great software! 🙂

  • arpi says:


    The NI USB-9211A is not compatible with artisan. The NI USB-TC01 device I don’t know.

    To find out, do this (in Windows) :

    Right click My Computer -> Properties
    click Hardware tab -> Device Manager
    click Ports (COM & LPT)
    plug the device in the computer (in to the USB port)
    Look to see if a new com port has been created in the Device Manager

    If a new com port was created, that means that it uses a RS232- USB converter and it is hardware compatible with artisan (but not yet software compatible).

  • jnvelez says:

    Hi. How do you make the connection between the arduino tc4 and a pc ?

      • jnvelez says:

        Hi JimG. Sorry to bother, I´m a roaster with zero knowledge in electronics! I already bought the TC4 assembled, and have it with me. I don´t know how to make and/or wire the USB connector between the TC4 and the computer. Muchas Gracias !

  • JimG says:

    Hi jnvelez

    First thing to do (if you have not already done so) is to purchase an Arduino Uno board. Visit the site for more information about the Uno and where to buy it. Next, you will need to download and install the “Arduino IDE” software from the site. This IDE will allow you to communicate with the Uno and to program it using the software we have developed for the TC4.

    The TC4 that you have is a “shield” which will connect to the Uno through those long header pins on your TC4.

    The Uno is connected to the PC (it has a USB connector on it).


  • Nicolas says:

    Thank you very much JimG! Got the Uno board and configured it properly, I´ll let you know how it goes.
    If I can give a hand with Artisan, I’ll be happy to help with the spanish version, some terms are not well spelled or used.

    Muchos Saludos

  • Rafael Garay says:

    Where can I purchase a Center 309?

    Thank You

  • Simon says:

    I cannot for the life of me work out how to change from Fahrenheit to Celsius display?


  • RichHelms says:

    The change is made at the data logger, not in the software.

    In the case of the HH506RA it is the top centre button.

  • john says:

    Will the software work with any MODBUS capable PID?

  • nico says:

    How does Artisan physically connect to the Fuji PID’s?

    • Arpi says:

      Artisan only works with the compatible devices listed. Every device and every PID is different.

  • Marinus says:

    Hi There – this software is great, we’ve been using it on our center 309 and can say – wow, well done. Is there any chance you will be expanding the PID support to other devices ?

    • Arpi says:

      Sorry. At the present time only the listed PIDs are compatible. There are no current plans for other PIDs but the software is open source.

      • Marinus says:

        Thanks Arpi,
        have downloaded the read-only source code and looking at making changes to add the shimaden controller, prior to making any changes I have tried building the exe from working code using the py2exe and continue to get the scipy import errors in the resulting exe. Im using all the same versions of the matlib, numpy and scipy as specified in and using the build file. Do you have a work around for this?

        • Arpi says:

          Sorry, the versions listed on the header are outdated. To see what versions where used on the latest release you have to click Help, About. Most libraries, except Python, which was 2.7 or 2.6, were the latest available at the time. You would need to compile the version of the release, not the latest on the trunk, as the latest release was modified for python 3.0 and needs more work.

          Good luck

  • Arpi says:

    Artisan needs an RS485 to RS232 converter to connect to the Fuji PIDs. The Fuji PXG has an RS232 port but it will limit the computer to only one. RS485 allows up to 32.

  • I too would love to see support for the NI USB-TC01. This software looks fantastic, but we’ve already got the hardware setup and would hate to have to throw out what we’ve got. Can’t wait to see how this project develops!

    • Bill says:

      YES~~I can’t agree more
      Love NI USB-TC01

      • Charlie says:

        noticed you use the USB-TC01 from NI. I just received mine from NI. If My Fuji controller shows 400 for a bean temp, the NI software shows 485 degrees. It is always at least 85 degrees higher than the controller. I have sent an email to NI but figure oit will take days.

  • Charlie says:

    Installed the Artisan software using a Fuji PXR-4 controller and a USB-COMi-M adapter. Will have to wait until tomorrow to fire up the roaster to see how it works. Will also try a Two-wire RS485 to USB converter from Picked up one for programming Watlow’s EZ Zone controller.

  • Charlie says:

    Using a Fuji PXR-4 controller with several types of serial converters, Artisan still does not work. It acts like I am checking “No Device” and a window pops up asking for manual temp. The USB-COMi-Com came with the roaster and works with the pxrlite software. I have tried the IPS-con and another brand that is used with watlow and fuji controllers.
    The various converters all show up in the hardware manager as com 3 or com 4 and they work with other programs. When I open configuration and click device, the “PID” buton is already checked and it shows PXG for ET and PXR for BT. There is only one TC for BT in the roaster at this time. Serial then pops up and lists the correct comm port and specs and as soon as I press the on button, the manual temp window comes up. No info on the right side is showing and no graph. only the timer is working.

    • Arpi says:


      1 Make sure each pid was purchased with the extra RS485 option

      2 Make sure you have manually entered the unit ID in each pid (1 and 2).

      3 Make sure you have manually entered the correct serial settings on each pid (they both should be the same)

      4 Make sure you set the same serial settings in the program artisan.

      5 Make sure the RS485-RS232 converter works (I think you mentioned you already did this with the PXRlite software?)

      6 make sure both pids are connected to the same two RS485 wires (like for example in daisy chain). The wires are polarized (they are + and -) and they should be connected properly to the RS485 converter.

      You should not get the “manual” device if you have selected the pid device. If you have done all these steps above and it still does not work, then do a factory reset in the menu Help/Factory reset. Then redo the settings and see if you still have the same problem.

      For further questions, please use this link:

      (Please mention the operating system you have)

      Thanks and good luck

    • Arpi says:

      Artisan always uses a minimum of two temperature readings.

      But if you only have one pid (only one reading), you have to select it in ET (not BT). Drum roasters cannot control BT with the PID because of the very large time lag (ET is closer to the heat source and has less time lag). You would need to set BT to None (zero)

      You can always add another thermocouple meter in the extra devices configuration and expand. That allows you to have one pid (expensive) and a thermocouple meter (cheaper)

  • dan says:

    I’ve got a macbook air and a Quest M3 I’d like to set up to Artisan (already downloaded) & was hoping for some guidance. I was thinking of getting the Delta DTA PID (i have E Type Tcs for BT and ET) to set up the Quest but am hoping to log both BT and ET and dream of logging heat and air settings up as well. I’ll be happy not logging temps manually every 15 seconds and just having BT logged while I input heat & air manually, but I gotta dream!

    I currently use a Fluke 54II, fyi.

    What you all have done here is simply awesome and very generous, btw.

  • Arpi says:


    Delta PIDs will not work. Fluke 54 will not work. Only the meters listed at the top of this page will work. To log ET and BT, you need a compatible dual thermocouple meter (listed above). You can also manually enter Event temperatures (without a compatible meter) with the device called “None”

  • Dave says:

    I recently purchased a Diedrich IR 2.5 and had them install the data logger. It turns out the data logger is a Dataq DI-145 and supports a software called windaq which updates information into an excel spreadsheet. I’m hoping to use your software but don’t believe it supports the DI-145 data logger. Is there any work arounds for this? I really need a software I can track a current roast against a previous roast profile. Let me know if you have any advice or opinions. Thank you!

    • Arpi says:


      The Dataq DI-145 will not work with artisan. You would need a compatible meter. For example, check out on (or google) the low price Amprobe TMD-56 (same as Omega HH806AU but half the price).

  • Dany says:

    Hi, I own an electrical coffee roaster, and would like to improve my roasting, I have seen this card: “TC4C standalone board” that is supposed to be used with your artisan software at this site:

    Could you please tell me what are the steps I should do to make this happen?

    Thanks a lot Danny

  • Brian says:


    I have a HOTTOP KN8828B-2K roaster.

    A question. How have you fitted the thermocouples to the machine to monitor BT and ET?

    Many thanks

    • RichHelms says:

      I just noticed a new generation is out. I have the probes on my HotTop 8828B but have not seen the new -2K model. If the loading chute setup is the same is should work.

      My loading chute cover is 64mm by 84mm.

      Is the key feature of the new model better temp probes or K type probes you can access?

    • RichHelms says:

      I looked in the manual for the new version (Link)

      It looks like they increased the heating element so that the unit can handle 300 grams (fromt 250) and replaced the previous sensor with a K type. The problem I found in mine is in the position. The probe is above the bean mass, not in it. The docs describe the probe as at 3 o’clock which matches where the old one is. With 300 grams in it might cover though. That could be the other reason for upping the capacity.

  • jeremie says:

    Hey i was wondering if you could add support for fan controllers in artisan. I was thinking these gs2 units from automationdirect looked like a good idea. They support r232 and then fan rpm could be recorded and controlled during roast.;jsessionid=5e30a8c3c921e4860ad5d561235b14346911

  • Kelley says:

    can I use BK Precision 710 K-Type Thermocouple Digital Thermometer with Dual Input, -200 to 1370 Degree C Range – made by Test Equipment – with Artisan? I have ordered it from Amazon but will return and get the EXTECH 421509 if necessary. thanks

    • Arpi says:

      Hi. The BK Precision 710 probably won’t work. But it looks suspiciously similar to the Omega HH309. So it “may” work but not sure. You would have to select the Omega 309 as your meter and then try it. Amazon sells the Amprobe TMD-56 (same as Omega HH806AU but half the price).


  • Kelley Hale says:

    Might it be possible to add an option to have any number of the ‘EVENTS’ in the Event row, triggered by either BT or ET reaching an assigned temperature? This at the very least could trigger an automatic ‘ON’ and ‘OFF’. ‘ CHARGE’ also could be triggered by the sudden drop in BT temp.


    • Arpi says:

      To roast by temperatures, you can create alarms instead of events. Alarms also allow you to call other programs, which could potentially turn on/off things (but you have to write your own individual programs, use an external microcontroler, and use a different serial port).

      There is a feature in: Roast/Background/Playback that pops a window with the events of the background profile loaded. It can also adjust temperatures but it is only for the device Fuji PID (and not working all the way. Events in the Fuji PIDs are created automatically when changing temperatures). This could help but it works by time of the background events and not their temperature.

      Look in the Config, Events, for Automatic CHARGE/DROP

  • Kelley says:

    I have an EXTECH 421509 and am finding out that EXTECH 421509 software works only up through Windows XP. I have Windows Vista, and in fact does not work with EXTECH. The error messages are about Com Ports and I have tried many through Device Manager and no selections appear to work. COM3 appears to be the default or only choice for Artisan software. Are there any work arounds for this?

    • Arpi says:


      You have to first press the button ‘Scan for Ports’ and then go back to select other comm port.

  • Simon says:


    I have a Mastech MS6516. WIll it be possible to use this with the program in the future? Cheap and decent Thermometer. The logging program that comes with it sucks big time though..


    • Arpi says:

      sorry. I was not able to find any info about that meter in Google and I doubt it will added in the future.


  • brian says:

    if i push “scan for ports” and get a blank option list under com port, what is my most likely error?
    have a center 304 hooked up to a db9 port on a windows 7 machine.

    • Arpi says:


      That means that your operating system does not have a comm port. You could try a USB serial adapter and install its driver first.

  • Diniz says:

    Hi artisan team.
    I have a device (shinko acs-13A) very similar to the Delta DTA to monitor the bean temperature. It seems it is hardware compatible with artisan software, but I does not work. This device is used for fuji royal roaster machines in Japan. It would be very nice if you could add this device to the artisan software. Anyway, great work!!!

    • MAKOMO says:

      Diniz, I know it has been a while since you asked for Artisan support of the ACS-13A. It seems the one supports MODBUS RTU communication. If this is true for your device, it should work right away with the latest v0.6 of Artisan (still in beta). You would need some configurations, but I could support you with this. Could you contact me via the Artisan user mailing list again on this?


    • Eric says:

      Hi Diniz

      I’m looking for data logging device used for r101. Seems you have experience on it. Would you mind share what device and how you configure to log temperature from R101?

      Thanks in advance!!!

  • Chester says:

    Am I correct in that the 4 channel data logger thermometer I have (YCT YC-747UD ) will not work with Artisan.

    Sorry if this is a stupid question.


  • Stephen says:


    I notice one of the supported thermometers is no longer in production being replaced with the HH309A, will this work with the Artisian software?

    Thank you

    • Arpi says:


      I think Centertek manufactures the Omega HH309. The CENTER 309, the VOLKRAFT K204, and the Omega HH309A are all the same in terms of compatibility with artisan.

  • RichHelms says:


    I looked around and could not find any technical docs on the new unit that described the protocol. It is not listed as compatible to the HH309. No idea if it would work. Anyone have technical docs on it?

  • Luky says:

    about devices VOLTCRAFT K204 – 2 versions of yhem are available on the market. My question is if it must be logger version or simple thermometer version is enough? Both have Rs232. Is it passible with these devices to get 4 different curves/readings from 4 channels at one time?

    • Arpi says:


      I think the two different versions work the same (logger, thermometer) in terms of communicating with the PC.

      You can plot the four curves of the meter at a time (the 4 curves together) by adding the extra device called +204_34

  • Graham says:

    I have just taken delivery of a Proaster which comes with 2 Autonics TK4S Temp PIDS and a Autonics SCM-US48I for USB connection. What are the chances of these being available for Artisan in the future? The Autonics software provides monitoring capability but not designed for roasting.


    • Ian says:

      Graham, i just purchased a proaster 1.5 k and i’m trying configure artisan to work with the autonics pids. Since they new version of of Artisan now works wtih Modbus RTU protocol it theoretically should communicate with the autonics hardware. I spent half the day trying to figure out the configuration, but am still no where. Have you since figured it out at all?

      • Graham Kennedy says:

        I have finally got back to looking at trying to use Artisan, so apologise for the late reply. I have configured the Modbus but having problems getting it to connect. One issue appears to be Artisan is ignoring changes I make to the baud rate so have raised a question about it.

        • Graham says:

          I have managed to get it working. you need to set the Func=4 and the register=1000 for slaves 1 and 2 in the serial setup.

          Having some problems with it sporadically getting an error which ends up with a downward spike in both readings, but at least it is now reading the temps


    • Ian says:

      Hey Graham,

      I have a 1.5k proaster and cannot locate the usb connector from auto tonics, can you help?

  • Alexander says:

    Can I use Amprobe TMD-56
    write that it is analog Omega NN806AU
    are there any that particularly when using Amprobe.
    If you have any drivers or software, will be grateful for the link.
    Best regards

  • Arpi says:

    yes, the Amprobe TMD-56 is the same meter as the Omega HH806AU.

    This is the driver:

    • Alexander says:

      established a Virtual COM Port Drivers 2.8.28
      installed the driver TMD-56
      in Device configuration chose HH806AU
      com port is selected correctly
      Artisan but does not show the temperature thermocouples
      shows -1.0
      If you run the TMD-56 program, the temperatures of thermocouples shown correctly
      What did I do right?

  • David says:

    It is said in the main page of Artisan’s website that it is compatible with Modbus RTU compatible loggers. I have a Novus myPClab wich is compatible with modbus and is serial2usb. It should be compatible with Artisan.
    After Artisan install, I go to look for Modbus RTU units and I do not find it (last Artisan version 0.5.6 for Win). What’s wrong?

  • MAKOMO says:

    Modbus RTU support is available with the upcoming Artisan 0.6.x version. It will allow you to specify two registers were the BT and ET temperature values can be retrieved from via a Modbus readSingleRegister.

  • casinomocca says:


    could you tell me whether Artisan will recognize my Voltcraft 302KJ if I connact it to the PC via USB (jack to USB converter) instead of RS232 (jack to RS232 converter). If the device itself is supported does it matter which port of my PC I use (usb or rs232) ?


    • RichHelms says:

      USB connections are usually seen as an RS232 port. I use an HH506RA with a USB cable and it just looks like an RS232 port.

  • casinomocca says:

    this is good news! At least it worth to buy such a cable and check it.

  • teddy says:

    has anybody ever tried Extech EA15 with artisan? is it compatible?

  • Alexander says:

    established a Virtual COM Port Drivers 2.8.28
    installed the driver TMD-56
    in Device configuration chose HH806AU
    com port is selected correctly
    Artisan but does not show the temperature thermocouples
    shows -1.0
    If you run the TMD-56 program, the temperatures of thermocouples shown correctly
    What did I do right?

    • Arpi says:

      Two things. You need the correct serial settings (comm port etc) And the channel in the meter needs to be zero. Some meters come with a different channel.

      How to RESET the meter to channel zero (you need channel zero or artisan won’t work):

      To SET CH/ID to 00,00, by pressing “T1-T2″ key and
      ” ” power key for more than 6 seconds with the meter
      powered down. The meter will set channel and ID
      to 00,00 status. The second display will show 00,
      which means that the channel and ID has been set to

      How to check the channel number:

      To check the channel and ID of the meter:
      When the meter is off press [C/F] key and [POWER] for 5
      seconds, LCD’s main display will show channel number,
      the second display will show ID number.

      • Alexander says:

        thanks for the reply
        I want to ask you
        what is this the CH and the ID?
        instructions in TMD-56 is only the story of how to install them CH and ID at 00
        and see their data whether to make the data in Artisan? and if you want it to paid CH and ID?
        I am sorry for my English, I use the Google translator

  • Alexander says:

    Aristan writes
    Exception Error:sample() ‘ascii’ codec can’t decode byte 0xce in position 10 : ordinal not in range (128)

  • Alexander says:

    before writing
    HH806AUtemperature(): 0 bytes received but 14 needed

  • Alexander says:

    I want to ask you
    what is this the CH and the ID?
    instructions in TMD-56 is only the story of how to install them CH and ID at 00
    and see their data whether to make the data in Artisan? and if you want it to paid CH and ID?
    I am sorry for my English, I use the Google translator

  • Arpi says:


    Does it work now?

    Is your meter wireless or wired (usb cable)?

    The meter was made so that it could be used wireless (and compatible with other meters on the air). But hopefully you have the one is not wireless.

    • Alexander says:

      thanks for your reply,
      does not work
      did RESET the meter to channel zero
      meter TMD-56 (usb cable)
      established a Virtual COM Port Drivers 2.8.28
      port COM4 in computer
      installed the driver TMD-56
      in Device configuration chose HH806AU
      serial port config et/bt
      comm port COM4
      Baud rate 2400
      Byte size 7
      parity E
      stopbits 1
      timeout 1

      a few seconds

      ET -1.0
      BT -1.0

      HH806AUtemperature(): 0 bytes received but 14 needed

      after reset CH and ID Nothing has changed

      if we use software from TMD-56, the computer shows correct temperature on two channels

      I think. Artisan not connected TMD-56
      you need to enter the installation …
      tell me what and where.

  • Arpi says:


    Those are the incorrect serial settings. I think you got them somehow mixed with the HH506RA.

    You need these:

    baudrate = 19200
    bytesize = 8
    parity= ‘E’
    stopbits = 1
    timeout = 2

    PS: The new beta version download has the amprobe TMD56 device

  • Alexander says:

    sorry, a new question
    retrying profile frying, which already have (done to me, for example – Kenya AA (fancy) – CCM Coffee dec 09, 2012.txt)
    I load it, it loads correctly
    but then, when I want to repeat my measurements are not imposed on him
    my measurements just not happening
    except this time goes from 0 and not from what the other figures
    how to do the one shown here

  • casinomocca says:


    need some more help. Voltcraft temperature meters can be dataloggers ojust normal thermometers (e.g. K202). Are both supported by artisan?

    • Arpi says:

      yes, a thermometer is compatible. As far as I know, both dataloggers and thermometers are internally the same and they should work the same. The difference is the price (thermometer cheaper) because the thermometer does not have internal memory.

  • eviljunglenoodle says:

    Got this running with an amprobe tmd-56 on the beta software(and the previous version), and it seems to read ok except when I turn on my roaster cooling fan and the temperature spikes up and down in artisan- it is however reading just fine on the amprobe itself. Have you seen this type of issue before? Thanks!

  • admin says:

    Link to the development blog has been added to the top right links.

  • casinomocca says:


    Will you release a non-SSE version of the latest beta one?
    It looks like -however, my AMD has SSE built in- the non-celeron versions won’t run 🙁

    Zoltan Kis

    • Marko Luther says:

      I uploaded a non-SSE version of v0.6 beta 6 yesterday. Please report if it works as expected as this is based on a newly created build environment.


      • casinomocca says:

        Thank you Marko!

        The new smoothing feature looks really good, I’ll test it tomorrow.

        However, we experienced a very strange issue this week. During roasting our graphs suffered a “time shift” which I cannot explain. Could you check it on this screen please:
        I see this shift in the raw .txt file as well. How can we prevent this in the future? Have you ever seen such a problem?

        Zoltan Kis

  • Frans says:

    Hi guys, thanks for this great software! I don’t see anything about donations on this website — do you take donations? I’d like to buy you a round of beer 😉

    • MAKOMO says:

      Frans, just donate to coffeekids as indicated now on the main Artisan GoogleCode page or donate your “support” by for example providing localizations (as you just did;)

      Thanks for your “donations”,

  • Yair says:

    I wanted to first thank you guys for making such great software for home roasting.
    My question – If I have a PID which has multiple thermocouple input and rs485 modbus connection, and I get a usb to rs485 converter, if my ET and BT probes are connected to the same PID can I use the same PID in artisan to be my ET and BT readings? Is there an option like that?

    • MAKOMO says:

      Yeah, this is the idea. Check out the Artisan blog at . Consider to subscribe and post to the Artisan mailing list which simplifies the discussion and makes us easier to help in your concrete case.

  • Valerian says:


    Did anyone manage to pair the YC 822 (comes with huky 500) with the Artisan?

  • Leonardo says:

    Hi everybody,

    I read the docs about Artisan and TC4 board to control a Hottop roaster.
    I’m building my own roaster, based on a electric rotisserie oven, almost like a Behmor roaster.
    Do you think I could use Artisan to control, not only monitor, the oven that is set with SSR and osPID?
    osPID is an arduino based PID, just like TC4 but cheaper.

  • GeorgeC says:

    If you are using PID/PIDs to get the ET and BT, how do you auto tune the PID/PIDs and which PID do you use to control the heating element? Since the ET is closer to the heat source, logically you would want to use the ET PID to control the heat, but the end result is you want to control the BT. The other thing is do you need 2 USB converters to be connected to your computer?
    I hope what I said makes sense.

  • Tom W says:

    Back on June 17, 2011 you mentioned that the s/w is not compatible with the National Instruments 9211-A DAC. Is there any new information on that front? If the answer is still not compatible, is there plans to ever make it compatible with the 9211-A? Thanks

  • Blair says:

    Does the myPCLab Data logger work with a Mac Book Pro using Artisan 6? I set it up according to the instructions and choose the Port and id doesn’t see it.

  • Fred says:

    Great work.

    Just to let people in Uk know that the PXR3, 4,5 and PXG series of Pid temperature controllers are available from us.

    We thank you for the great coffee and will certainly make a contribution to coffekids!

  • Coffeebug says:

    very appreciate! it’s great software

  • René says:

    PHIDGET user
    Hi, I have set up with Cropster using Phidget 4 input data bridge (
    ), I would LOVE to use Artisan though, is this possible already?
    or on the list to be done? or are there any threads on how to get them to communicate?

    • Marko Luther says:

      René, sorry for the late reply. The Phidget devices supported by Cropster will be supported by Artisan v0.7 to be released in the next few days. If you drop me a note on the Artisan mailing list, I will respond to you with a link to a beta right away.

  • TomC says:

    Is there a way to enlarge the font size for the time/targets i.e. ( Drying phase, 1C, 1Ce, 2C, 2Ce, Drop, etc) so that when I post a graph on Home-Barista, the temps and times are easier to see? By the time we reduce the image size to 700pixels, the font is extremely small.

    I was hoping to selectively increase these in particular, not every single section of text on the graph.

    Thank you for any help!

    • Marko Luther says:


      go to the extras dialog and select the last tab. There is an option call Resolution where you can set the DPI resolution. Increase that one and press the “Set” button next to it to get the increased font size.

  • marius says:

    Can any bod y help I’m new to this and having trouble getting the temp working on a mac having just purchased Center 301 type k thermometer, getting the message on the roaster scope
    Exception: CENTER303temprature() “none type’ object has no attribute ‘tb_lineo’@line 18414
    any help would be greatly appreciated getting a little stressed as I have promised to roast coffee foe a school fund raiser

  • Keesang says:

    Thanks to this useful program.
    I have a question on Arduino TC4. I can hardly get Arduino TC4 or any other measuring devices for Artisan. YET, I’VE GOT Arduino UNO and Arduino MEGA2560. Is there any way that I can figure out the two Arduinos to make it measure like TC4, OMEGA, et cetera??
    I can make, solder any type of additional necessary circuits if needed,

  • Keesang says:

    Plus, I’d like to know if there’s any way of data logging without the devices the Artisan supports.
    It’s only because I have to make it in a short period of time, and I can’t get ’em in time.

  • Marius says:

    Hi all,
    Can any body help?
    I,m new to the Artisan roast monitor and finding it to be a great tool although I’m geting quit a lot of fluctuation on the environmental bean temp to the point where I’m still using a hand chart to monitor the temp per minute rise.
    Can any one give me some clues as to how to get a more steady read out, I have tried replacing the probe with no real change
    Any help would be greatly appreciated

  • Marius says:

    Hi to all,
    I’m using version 7.1 and finding it a pleasure to use the extra timers are really helpful at the critical stage of the roast
    Can any body help Im getting fluctuating readings on the delta bean temp is there a way to stabilise the readings I’m using a center 301 with a mac
    The readings I’m getting on the bean temp and the environmental temp are stable and the same as the temp reading on the center
    Any advice or tips on how to sort this out would be greatly appreciated

  • Nimrod Gisis says:

    I have a Center 304 with 4 channels. I use 2 of them now for ET and BT but would like to assign number 3 to represent the MET. Is this possible now?

  • Robert says:

    Hi, my controller is Fortek mt48. I got the communication setting form Fortek. Is it possible to modify the artisan to support this device. As I know the artisan has opened the source code. Which soft I can use to modify or change the sourced code of artisan. Actually I just want to record the temperature, Thanks

  • valerian says:

    0.7.4 does not seem to be compatible with Amprobe. I had to go back to 0.6.0 . Did I do something wrong? On 0.7.4 Artisan reads -1

  • Van says:

    Hi, long time reader here! I have the Dierich IR12 machine. I want to use the thermocouple data logger with the artisan software. Can someone give me advice on which thermocouple devices that are easy to set up and good for a beginner? I am using this with the fork probe thing. Thanks in advance!

  • Michael says:

    I just bought a reconditioned 1980s probat, I would like to use a profiling system but they seem very expensive for monthly subscriptions that’s why I found Artisan. I have the app loaded onto my laptop and I need to know what to get installed onto the oven before it leaves the factory in Poland. the oven I believe has one pt100 probe installed. Can someone explain in a dumbed down way what I need to request to be installed on the oven and then when I take delivery what I do next.
    Thanks very much


  • Graham Kennedy says:

    I am attempting to configure Artisan to work with the Modbus (Autonics) connection on a Proaster using Windows XP. I set the Serial Port BAUD rate = 9600 to match the PC. However the message that comes up along the top of the screen “Serial Port Settings” shows a BAUD rate of 115200. I have been unable to connect, and not sure if this is the problem or not. (I am getting an access error).

    Do you think the BAUD rate I set is being ignored by Artisan, and could this be why I cannot connect.


    • ND says:

      I have same problem as your but Mr. Marko tell me that “The standard serial settings are not relevant in MODBUS mode.” And now I can’t run in MODEBUS and it just run in serial mode PID.

      I assume that some value in program didn’t change when we key in new value !? but I’m not sure, because I don’t know about code.

      I try to run Artisan on Windows 7 and also in Debian Linux but it’s the same result.

      Best regards,

    • Graham Kennedy says:

      Managed to get it working – my Modbus setting were wrong for the Autonics. Needed Func=4 and Register=1000 for both slaves.

  • Barrie says:

    Does anyone else have a problem with editing alarm files in the Windows version of Artisan 7.4? Once I have edited and saved a file, I find that I often cannot come out by clicking on OK, and have to exit by clicking on the top-right X. One then has to reload the alarm file that was just saved. I have tried to nail down the circumstances under which this happens but do not have these clear yet. Certainly, if a roast has started and once tries to edit the file, this is what happens but that is not the only circumstance.


  • edenyer says:

    I have scoured the site and had not found much on using this with a Diedrich IR3, but nonetheless I have ventured forward and I have it up and running using a phidget 1048 temp sensor and I connected both the probe leads. The wires to the digital readout I set as channel 0 (BT) and the wires to the high limit i set as channel 1 (ET). In essence it gives me fault resiliency for the digital reader in case of failure. I have a long way to go yet, as I am barely learning, but you deserve the accolades for a great tool which will help us bring our roasting to a new level of consistency and traceability. If anyone out there has a similar set-up, any pointers would me great!


  • JoseRivera says:

    Hello, I have a usb data bridge by RoastLog, the chip is FTDI – FT232R, it can be configured with Artisan?. Thanks
    PS. congrats for the software.

    • MAKOMO says:

      No. The FTDI chip is just converting serial to USB. The protocol implemented by the RoastLog data bridge is not documented and thus not supported by Artisan.

  • Tom Chips says:

    If anyone can help me, I tried reconfiguring and adding a probe that has already worked with Artisan before. Every effort at troubleshooting has failed me, and I’m not programming savvy. I reset Artisan and started over.

    I restarted my Macbook Pro, after noticing my USB wasn’t detecting connected devices, but does now, and I’m still left with this same error message.

    1 16:45:14.202 Exception: ser.ARDUINOTC4temperature(): list index out of range@line 22074

    I don’t have any temp readouts at all.

  • Jeff Peters says:

    Hello all. First off, the Artisan Blog and forum have been very helpful, so thank you to all for posting here and getting me this far.

    Here’s my problem. I have a Watlow EZ Zone PM4 configured with my Windows 7 Laptop, running Artisan ver 0.8. I can successfully communicate with the PID using my USB to RS-485 adapter and Watlow’s configuration sofware with the PID configured to the factory comm settings (9600 baud, no parity, 1 stop bit), data map 2, and plus artisan settings (for use with Watlow) from the blog post at:

    First off, the Artisan PID pulldown menu does not have a Watlow option…just Fuji PXG, Fuji PXR, and Delta DTA. Which one should I use to best work with Watlow?

    Second, despite having configured the USB to RS-485 adapter as virtual COM port 3 (and not having any other active ports on my laptop) the little status field at the upper left in Artisan keep trying to communicate on COM6 at 9600 baud and Odd Parity. When I click the ‘Control’ button, Artisan cannot communicate with the device (duh…it’s trying to do so on COM6) Why? I must my missing some setup menu somewhere.

    Any help would be greatly appreciated! Thanks.

  • Dave Stanton says:

    I came across this interesting article on by Scott Rao discussing DTR Development Time Ratio. in summary, in his experience ‘best’ roast results come from a FC time of 75-80% total roast time, i.e. Development Time is 20-25%.

    Can this DTR be represented as a column displayed once FC has occurred, to give a window of best result to aim for ?


  • I have a Probat L12 with a Omega-375 Temp Reader. I would love to integrate Artisan. Can anyone give me a hand in walking me through the steps?
    Thanks in advance!

  • Hi,

    I am launching the Abacus Pod Rack on kickstarter on Friday the 14th of November. I would love to be featured on your website.
    see promotional video link & website:

    Neil Strohbeck

  • Joel says:

    Hi Marko,

    I’ve got TC4, Artisan 0.8 and the april PID version of Jim’s aArtisan integrated, and its quite intriguing. I have a few questions for you:

    1. How do I output T3 and T4 thermocouples for the TC4. I’ve added the extra device for TC4_34 and set “Y3” and “Y4”, but it doesn’t seem to work… it only outputs 0.0 on the LCD.

    2. When the PID is on, the READ commands outputs, in addition to temp outputs (T1-4), also outputs PID OUT (OT1), Fan out, and SV. How can I get OT1 value set by the PID outputted on the graph?

    3. What does the LookAhead setting do in the PID dialog box?

    4. What does “AT Channel” setting (default is “none”) when configuring the TC4 in the device settings?

    Response appreciated.

  • Grfaham Kennedy says:

    I am attempting to set an Alarm to do a PopUp 3 mins after start of FC. The Alarm works except for the fact it appears to ignore the Time factor. The alarm sounds & the Popup appears immediately after the event. I have tried a variety of other “After” event and different timings, but cannot get a timed event to work.

    Using ARTISAN v8 on a Windows XP pc.

  • Morgan says:

    Very advanced for my comprehension! Haha…What I know is that I discovered this very nice coffeeshop, serving cheap but delicious coffee! Found out about them here: Just thought of sharing, because I like it so much. You must try if you are in area of Melbourne.

  • igor says:

    Hi, i need help. i use Amprobe TMD-56. when i connected to the roster when the power is off the temperature sensors on the computer contains the right . But as soon as I turn on the power , the temperatures on the computer does is raised to 409 C, and then falls again to 24C . and rises again , etc.

  • Hi!
    Our new bought thermometer has a RS-232 port. Do I need an adapter of some kind to hook it up to a computer with VGA port? I believe most computers today have some sort of VGA port and not a RS-232 port. Is the Extech 421509 7compatible with Windows 7 or only with XP? I got a reply from Extech telling me that the 421509 is only compatible with XP but in their drivers CD list I see a long list of other Windows. Can somebody help me with this problem? Is it best just to send it back and buy another brand? Which one do you recommend?

    Best Regards

  • Brett says:

    After just updating my software to 9.2 Artisan and using it with a phidget 1048 with J thermocouples placed 3/4 of an inch from each other at the bottom of the sightglass in my US roaster corp 3k, I get temperatures that start out the same and change when the beans are charged….. any thoughts?

  • David Beegle says:

    I know there is obviously going to be some bias here but does anybody have anybthoughts on Artisan vs Typica? I am awaiting a Phidgets 1048 right now and until it arrives in August have no way of really playing with either. Just curious if anybody has given both an honest test and had thoughts.

  • Jakle says:

    Hello Guys:
    I need some assistance if any one can help out.
    I have a US Roaster Corp, 1 Pound Roaster.
    I am using a Phidgets 1048 and the latest Artisan.
    the computer is a Mac book air.
    here is my situation.
    The Roaster has installed two j Type Probes.
    and if i go into the Phidgets Device control i set my Probe type to J on all boxes.
    i then open Artisan and it does not recognise any temp input it comes up with -0.1 on both BT and ET
    when i then close the Phidgets control, it converts back to K type and gives me readings that are
    out of sequence all the way to 200 degrees.
    Do i need to change anything in Artisan?
    What can i do?
    Any help from any one would be great.
    Thanks Jakle

    • MAKOMO says:

      You need to set the probe types from within Artisan. Menu Config >> Device, Phidgets Tab.

  • Dave says:

    upgraded windows artisan from 9.4 to 9.5 – unable to load background
    Exception:loadbackground() “roastbatchrr’ @line 10708
    tried factory reset – graph loads but no event data shown
    revert back to 9.4 and works – thought i would report this

  • Dave says:

    fixed it by opening and saving profile in 9.5 than i could load as background –

  • George Chow says:

    Hi Marko,
    I have a question about the software.
    Today I did an experiment for a batch with the power turned off a little while into 1st crack and I noticed the temperature decreasing but the ROR stays about the same. I wonder if I did not get the settings right. Can I have declining temperature with positive ROR for quite a length of time???
    Could it be the ROR data is lagging too far behind and how to sync it to the temp so they move more or less in the same direction without too much lagging?
    Or the arduino settings are wrong?

    • MAKOMO says:

      Smoothing generates a time lag. turn of all smoothing (also on the Arduino side) to have a (noisy) close to real-time RoR signal, You cannot have both, realtime and smooth RoR.

      • George says:

        Thanks Marko.
        I just downloaded the latest 9.6 version and have a question about the smooth 2- when do I use the smooth2 and whether you either check smooth spikes or smooth 2 and not both?
        Turns out if I checked smooth2 without turning on heat, the ROR will jump to almost 1,000 and comes back down to 1 (not even zero) after 1 hour.

        • MAKOMO says:

          The smooth2 flag activates an alternative (more complex) smoothing algorithm donated by some user believing it to be more efficient. Its level of smoothing is controlled by the “Window” setting. I am not convinced of that approach. Anyhow, “Smooth spikes” filter is only applied to the temperature curves and activates a rather harmless extra filter before the actually smoothing is applied that will only get active on spikes. This can safely be left activated.

          Regarding your jumping RoR. In general such issues point to a hardware problem, most often resulting from ground loops (often caused by grounded probes or some strong motors inferring), and are almost impossible to treat on the software side. Fix your hardware setup!

  • Seb says:

    Have just installed Artisan, but having a bit of trouble connecting to my previous Cropster databridge/Phidget. Any tips?

    • Arpi says:


      This is not the correct place to trouble shoot such a problem. I would suggest trying the mail list better.


  • Randy says:

    Getting a com port error.

    Any idea how to fix:

    Error says : MODBUS ERROR : READ FLOAT (erroneous 2) no such file or directory ‘COM5’ @line 25124

  • alex says:

    I have a problem I connected the artisan to the pid and the temperature that it reads is only 10%of it. For example 218 on pid is read on artisan 21.8. ca someone tell me flu can i multiply it by 10.

  • Dear Sirs,
    ARTISAN 0.9.8 (OS WINDOWS 8) is monitoring a TMD-56 device datalogger (s/n 15070225, two K-TYPE sensor inputs) for coffee roasting.
    However, the serial port settings (ARTISAN 0.9.8 configuration menu) cannot save despite correct settings ( ARTISAN 0.9.8 & Device Manager) which results in communication errors and thermocouple error readings (ET=-1.0, BT=-1.0) instead of real time values.
    How is it possible to face this problem?

    Thank you in advance for your asap reply!

    Best regards,
    Electra Dedoussi
    MBA Automation Engineer

  • Bazza says:

    Baz here from down under.
    I’ve just tried to get Artisan 0.7.4 working without success butI fear I will be the broken link!
    I use a Toshiba satellite i7 with Windows 10. The version of Arduino is 1.0.5-r2 on a Mega 2560 loaded with REL-aArtisanQ_PIDQ_2_8. I used the TC4-StdLib-REL-300 library sketches.
    I am able to configure the Device and port settings successfully,although I do have to change the Baud rate to 115,200
    All goes well until I press the ON or START. It displays “scope monitoring”for a couple of seconds and then displays “Exception: ser.ARDUINOTC4temperature(): list index out of range@line 20998”
    Prior to using aArtisan 2.8 I was using REL-200.

    Hopefully I have provide sufficient details for the gurus to resolve this for me.
    Many thanks for your courteous response.

  • Jo says:

    I have a Huky with the Center 304 connected.
    I’m having trouble connecting the Center to my MacBook Pro (early 2008, El Capitan).

    I downloaded the driver from Silicon Labs and Installed it.
    Installed Artisan 0.9.8 (7), which I believe is the latest version.
    I selected the Center 304 in the device settings and as a Comm Port it indicates CP2102 USB to UART Bridge Controller.
    But when I start monitoring, Artisan indicates “CENTER309 temperature(): 0 bytes received but 45 needed.

    Then Artisan freezes, I can only force quit and my MacBook Pro will not restart unless I force it to.

    The frustrating thing is that it does work on my MacBook Air, but I’d rather not use that for roasting.

    Are there any known issues with an early 2008 MacBook Pro?
    Is there maybe another driver I can try?
    Is a PowerBook G4 supported, by any chance?

  • ARIYAN says:

    hey guys I have a windows 7

    have downloaded artisan and the phidgets softwares.

    my issue is that I cannot see a change in the temperature on the artisan software. it just sits at 195 degrees celcius. I believe I need to somehow program some settings on artisan to accurately read from my phidgets 1048 sensor.

    HELP PLEASE?///??