#### Artisan helps coffee roasters record, analyze, and control roast profiles. With the help of a thermocouple data logger, or a proportional–integral–derivative controller (PID controller), this software offers roasting metrics to help make decisions that influence the final coffee flavor.

Artisan is free for personal and commercial use, but asks for a [donation](https://www.paypal.me/MarkoLuther).

## HOME

<https://artisan-scope.org>

The home of its development is on GitHub were all source and binary files are available as well as an issue tracker.

<https://github.com/artisan-roaster-scope/artisan>

## MAILING LIST

<https://lists.einfachkaffee.de/postorius/lists/artisan-user.lists.einfachkaffee.de/>

## ARTISAN BLOG

https://artisan-roasterscope.blogspot.de

## FEATURES

Runs on 64bit Windows 10, macOS 10.15 Catalina (legacy builds support Windows 8 and macOS 10.13 High Sierra), Redhat/Debian Linux (incl. 32bit Raspberry Pi) and supports a large number of devices and roasting machines. See <https://artisan-scope.org/devices/index> for supported devices and <https://artisan-scope.org/machines/index> for supported machines.

**Artisan offers**
- Unlimited number of curves.
- Rate-of-rise (RoR), area-under-the-curve (AUC), development-time-ratio (DTR) calculations.
- Projection lines and head-up-display (HUD).
- Roast profile evaluation and statistics.
- Roast-, production- and ranking reports.
- Automated reproduction of roasts via alarm programs, replay of events or PID control.
- Batch counter.
- Profile designer, cupping editor, spider- and wheel graph.
- User defined buttons and sliders with programable actions.
- Many import and export formats.

## INSTALLATION

See <https://github.com/artisan-roaster-scope/artisan/blob/master/wiki/Installation.md>

## LICENCE

Artisan is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
   
Artisan is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 
   
Copies of the GNU General Public License has been included with this 
distribution in the file `LICENSE.txt`. An online version is available at
<http://www.gnu.org/licenses/>.

## LIBRARIES

Artisan uses the following libraries in unmodified forms:
- Python 3.x released under the PSF licence http://www.python.org/psf/
  http://www.python.org/
- QT 5.x under the Qt GNU Lesser General Public License version 2.1 (LGPL)
  http://qt-project.org/products/licensing
- Numpy and Scipy, Copyright (c) 2005, NumPy Developers; All Rights Reserved
  http://www.scipy.org/
- PyQt 5.x and SIP 4.x under the Qt GNU GPL v. 3.0 licence; Copyright (c) 2010 Riverbank Computing Limited
  http://www.riverbankcomputing.co.uk/software/pyqt/
- matplotlib, Copyright (c) 2002-2015 John D. Hunter; All Rights Reserved. Distributed under a licence based on PSF.
  http://matplotlib.sourceforge.net
- py2app under the PSF open source licence; Copyright (c) 2004-2006 Bob Ippolito <bob at redivi.com>
  Copyright (c) 2010-2012 Ronald Oussoren <ronaldoussoren at mac.com>.
  http://packages.python.org/py2app/
- pyinstaller under the GPL license
  http://www.pyinstaller.org
- pymodbus under the BSD License by Galen Collins
  https://github.com/bashwork/pymodbus
- python-snap7 under MIT license
  https://github.com/gijzelaerr/python-snap7 
- arabic_reshaper.py under GPL by Abd Allah Diab (Mpcabd)


## VERSION HISTORY

See <https://github.com/artisan-roaster-scope/artisan>
