You are on page 1of 79

BeerSmith 2

2013 BeerSmith LLC

Note: To change the product logo for your ow n print manual or PDF, click "Tools > Manual Designer" and modify the print manual template.

Title page 1
Use this page to introduce the product
by BeerSmith LLC

This is "Title Page 1" - you may use this page to introduce your product, show title, author, copyright, company logos, etc. This page intentionally starts on an odd page, so that it is on the right half of an open book from the readers point of view. This is the reason why the previous page was blank (the previous page is the back side of the cover)

BeerSmith 2
2013 BeerSmith LLC
All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, or mechanical, including photocopying, recording, taping, or information storage and retrieval systems - without the written permission of the publisher. Products that are referred to in this document may be either trademarks and/or registered trademarks of the respective owners. The publisher and the author make no claim to these trademarks. While every precaution has been taken in the preparation of this document, the publisher and the author assume no responsibility for errors or omissions, or for damages resulting from the use of information contained in this document or from the use of programs and source code that may accompany it. In no event shall the publisher and the author be liable for any loss of profit or any other commercial damage caused or alleged to have been caused directly or indirectly by this document. Printed: February 2013 in (whereever you are located)

Publisher ...enter name... Managing Editor ...enter name... Technical Editors ...enter name... ...enter name... Cover Designer ...enter name... Team Coordinator ...enter name... Production ...enter name...

Special thanks to: All the people who contributed to this document, to mum and dad and grandpa, to my sisters and brothers and mothers in law, to our secretary Kathrin, to the graphic artist who created this great product logo on the cover page (sorry, don't remember your name at the moment but you did a great work ), to the pizza service down the street (your daily Capricciosas saved our lives), to the copy shop where this document will be duplicated, and and and... Last not least, we want to thank EC Software who wrote this great help tool called HELP & MANUAL which printed this document.

BeerSmith 2

Table of Contents
Foreword 7

Part I Welcome to BeerSmith!

1 Getting ................................................................................................................................... Started 9 2 What's ................................................................................................................................... New 10 3 Frequently ................................................................................................................................... Asked Questions 12 4 Online ................................................................................................................................... Resources 14 5 Building ................................................................................................................................... a Recipe 14
Creating Your .......................................................................................................................................................... First Recipe 15 Recipe Design .......................................................................................................................................................... Tab 16 Yeast Starter .......................................................................................................................................................... Tab 17 Mash Details Tab .......................................................................................................................................................... 18 Tim er Tab .......................................................................................................................................................... 18 Ferm entation.......................................................................................................................................................... Tab 19 Water Volum es .......................................................................................................................................................... Tab 19 Notes Tab .......................................................................................................................................................... 20 Brew Steps (the .......................................................................................................................................................... Brew Sheet) 20 Recipe Set as.......................................................................................................................................................... Default 20

6 Finding ................................................................................................................................... Your Way Around BeerSmith 21


Activating BeerSm .......................................................................................................................................................... ith 21 Tabbed and Window .......................................................................................................................................................... ed Brow sing 22 My Recipes and .......................................................................................................................................................... Folders 23 Editing Functions .......................................................................................................................................................... 24 Reports .......................................................................................................................................................... 24 Printing and Preview .......................................................................................................................................................... ing 25 Autom atic Unit .......................................................................................................................................................... Conversion 26 Custom izing Colum .......................................................................................................................................................... ns 26

7 Scaling ................................................................................................................................... and Adjusting Recipes 27


Scaling the Size .......................................................................................................................................................... of a Recipe 27 Converting a Recipe .......................................................................................................................................................... 27 Adjusting Gravity .......................................................................................................................................................... for a Recipe 28 Adjusting Bitterness .......................................................................................................................................................... of a Recipe 28 Adjusting Color .......................................................................................................................................................... of a Recipe 28

8 Shopping ................................................................................................................................... and Inventory 29


Understanding .......................................................................................................................................................... Inventory Managem ent 29 Shopping List .......................................................................................................................................................... 30 Inventory .......................................................................................................................................................... 31

9 Using................................................................................................................................... Profiles and Styles 32


Styles .......................................................................................................................................................... 32 Equipm ent Profiles .......................................................................................................................................................... 32 Mash Profiles.......................................................................................................................................................... 34 Carbonation Profiles .......................................................................................................................................................... 35 Ferm entation.......................................................................................................................................................... Profiles 36

10 Adding ................................................................................................................................... Custom Ingredients 36


Hops .......................................................................................................................................................... 37 Grains and Sugars .......................................................................................................................................................... 37 2013 BeerSmith LLC

Contents

Yeast .......................................................................................................................................................... 38 Miscellaneous .......................................................................................................................................................... Ingredients 39 Water .......................................................................................................................................................... 40

11 The BeerSmith ................................................................................................................................... Cloud 40


BeerSm ithRecipes.com .......................................................................................................................................................... 41

12 Importing ................................................................................................................................... and Exporting Files 43


Using the Im port .......................................................................................................................................................... Wizard 43 Opening a File .......................................................................................................................................................... 44 Export All .......................................................................................................................................................... 45 Export Selected .......................................................................................................................................................... Item s 46

13 Calendar ................................................................................................................................... and Notes 47


Notes Calendar .......................................................................................................................................................... 47 .......................................................................................................................................................... 47

14 Brewing ................................................................................................................................... Tools 48


Water Profiler .......................................................................................................................................................... 48 Infusion Tool .......................................................................................................................................................... 49 Decoction Tool .......................................................................................................................................................... 50 Mash Adjustm .......................................................................................................................................................... ent Tool 50 Yeast Starter .......................................................................................................................................................... Tool 51 Hydrom eter Tem .......................................................................................................................................................... perature Tool 52 Refractom eter .......................................................................................................................................................... Tool 52 Percent Alcohol .......................................................................................................................................................... Tool 53 Hop Bitterness .......................................................................................................................................................... Tool 54 Hop Age Tool.......................................................................................................................................................... 54 Boil Off Tool .......................................................................................................................................................... 54 Water Needed .......................................................................................................................................................... Tool 55 Dilution Tool .......................................................................................................................................................... 55 Weight-Volum .......................................................................................................................................................... e Tool 55 Carbonation Tool .......................................................................................................................................................... 56

15 Unit Conversion ................................................................................................................................... Tools 56


Tem perature .......................................................................................................................................................... Units 57 Gravity Units .......................................................................................................................................................... 57 Pressure Units .......................................................................................................................................................... 57 Weight Units .......................................................................................................................................................... 57 Volum e Units.......................................................................................................................................................... 58

16 Options ................................................................................................................................... 58
Brew ing Options .......................................................................................................................................................... 58 Units .......................................................................................................................................................... 59 Bitterness .......................................................................................................................................................... 59 Refractom eter .......................................................................................................................................................... 60 Yeast Starter .......................................................................................................................................................... 60 Advanced .......................................................................................................................................................... 61 Look and Feel .......................................................................................................................................................... 62 Custom Reports .......................................................................................................................................................... 62 Cloud Options .......................................................................................................................................................... 65

17 Help and ................................................................................................................................... Product Activation 65


Recovering a .......................................................................................................................................................... Lost Product Key 66 Add-ons .......................................................................................................................................................... 66 Checking for .......................................................................................................................................................... Updates 67 About BeerSm .......................................................................................................................................................... ith 67

18 Changing ................................................................................................................................... the BeerSmith Documents Directory 67


2013 BeerSmith LLC

BeerSmith 2 19 Uninstalling ................................................................................................................................... BeerSmith 68 20 License ................................................................................................................................... and Copyright Information 68

Index

2013 BeerSmith LLC

Foreword

Foreword

This is just another title page placed between table of contents and topics

2013 BeerSmith LLC

Top Level Intro


This page is printed before a new top-level chapter starts

Part

Welcome to BeerSmith!

Welcome to BeerSmith!
Need help with BeerSmith?
New to BeerSmith?
o o o o o o o Getting Started Activating BeerSmith Setting Units to Metric/Imperial Creating your Equipment Profile Creating your First Recipe Finding your Way Around BeerSmith Frequently Asked Questions

Online BeerSmith Support


o o o o o BeerSmith Support Page Video Tutorials Discussion Forum Recipe Archive BeerSmith Main Page

Online Articles, Reference and Podcast


o o o o o o BeerSmith Blog BeerSmith Podcast Weekly Newsletter Home Brewing with BeerSmith Book BrewWiki Encyclopedia BeerSmith Guide Article Index

Upgrading from Version 1.x?


o What's New in Version 2.0? o Tabbed and Windowed Browsing o Importing and Exporting Files

Using BeerSmith
o o o o o o o o o o o o Tabbed and Windowed Browsing Creating your Equipment Profile Building a Recipe Scaling and Adjusting Recipes The BeerSmith Recipe Cloud Using Profiles and Styles Adding Custom Ingredients Shopping and Inventory Calendar and Notes Brewing Tools Unit Conversion Tools Help and Product Activation

Advanced Topics
o o o o o o Recovering a Lost Product Key Changing the Look and Feel Options/Preferences Understanding Inventory Management Converting a Recipe Custom Reports

1.1

Getting Started
BeerSmith 2 offers a ton of features for the home brewer and professional brewer alike. This getting started guide is intended to help you get up to speed quickly, even if you have never brewed before.

Activation and Trial Versions


o BeerSmith has a 21 day trial period (no activation required), after that you must purchase a key to continue to use BeerSmith unless you have already purchased BeerSmith 2. Existing users may upgrade by purchasing a key for BeerSmith 2. Once you have your key you can Activate BeerSmith to permanently register your copy.

2013 BeerSmith LLC

10

BeerSmith 2

Key Features for Building Recipes


o Most of time with BeerSmith will likely be spent designing and editing recipes. This is done from the My Recipes View which is displayed when you first enter BeerSmith. o You can add a new recipe to your My Recipes folder by clicking on the Add Recipe Button on the ribbon which opens the recipe design editor in a new tab. o There is a tutorial on creating your first recipe here. BeerSmith comes pre-loaded with the most common brewing ingredients so it is a matter of choosing the ones you want in the recipe design tab and adjusting the amounts to create a new recipe. o Once you are done with your recipe you can save it by pressing the OK button o We also have video tutorials on creating recipes here.

Creating an Equipment Profile


o To best use BeerSmith, it is important that you create a personal equipment profile to match your particular set of brewing equipment o The process only takes a few minutes - but using an accurate equipment profile within your recipes will improve your results. Equipment can also be used to more quickly and accurately scale and adapt sample recipes that came with BeerSmith or you downloaded from the internet.

More Advanced Recipe Features


o o o o o The recipe editor also has tabs for yeast starters, mash details, fermentation and notes. In addition you can print step-by-step instructions for the recipe you just created You can use the buttons on the ribbon to quickly scale and adjust your recipe You can also add your own ingredients to the list of pre-loaded ones You can import and export recipes and other data from the internet to share your recipes with friends, and scale imported recipes to match your personal equipment

Standalone Tools and Unit Converters


o BeerSmith comes with 15 stand-alone tools to perform the most common brewing calculations o It also has unit conversion tools for converting between different unit systems, and you can even do unit conversions and simple calculations in any field

Shopping, Inventory, Calendar and Notes


o BeerSmith includes a shopping cart to make your personal shopping list for the next trip to the store. You can even add all the ingredients for a recipe to the shopping cart in one click using the Add to Cart button from the open recipe. o The shopping cart and recipes are integrated with the inventory view - for easy inventory management. o A brewing calendar and notes feature lets you track and schedule your brewing sessions and brewing events.

1.2

What's New
BeerSmith 2 has been redesigned from the ground up to make it easier to navigate and use.

New in BeerSmith 2.1


o BeerSmith 2.1 has two major changes as well as a number of smaller updates included. o The BeerSmith Cloud folder is the most significant change. It allows internet connected computers
2013 BeerSmith LLC

Welcome to BeerSmith!

11

to share recipes via a cloud folder - so you can work from more than one computer. It also is tightly integrated with our new web site at BeerSmithRecipes.com so you can share a recipe with the community and search from thousands of recipes others have created. o The new Brewday Timer is the second major new feature. It gives you a mash/steep and boil timer for brewing your beer. It displays step-by-step instructions for these two critical stages with an integrated timer and alarm to tell you when to add the next major ingredient additions or steps.

New Look and Feel


o The entire program was rewritten from the ground up to support tabbed and windowed browsing making it easier to work with multiple recipes and tools. o You can open recipes, tools and other views in either a new tab or window o A ribbon and integrated toolbars make all of the functions and tools more accessible o Themes allow you to customize the look and feel of the program

Macintosh Support
o BeerSmith 2 is now available for the Macintosh, and both versions have compatible file formats and are nearly identical

New Recipe Design Tab


The recipe design process was also redesigned from scratch A beer glass shows you the color of the beer in real-time as you add new ingredients The style guide comparison includes graphical bars to show which items are in or out of style The expanded ingredient display can be sorted and now shows the current inventory of each item A section is dedicated to user selectable fields - rather than fixing a few fields in the display we let you choose the ones you want most when designing a recipe o You can now adjust grain percentages using the Grain Adj button next to the ingredients list o o o o o

New Recipe Tabs


o Within the recipe editor, we've added tabs to help you focus on individual pieces of the brewing process including extended session data o The Yeast Starter Tab can help you estimate the right size yeast starter to use with your liquid yeast o The Mash Details Tab lets you adjust and record details of your mash session - and includes a visual graph of the mash process o A Fermentation Tab helps you manage fermentation, bottling and aging details.

Brew in a Bag Support


o We now have mash profiles to automatically support Brew-in-a-bag (BIAB) brewing

Profiles for Carbonation and Fermentation


o BeerSmith recipes now support profiles for both carbonation and fermentation, making it easy to select the perfect bottling and aging profile to match your beer.

New Data Format


o BeerSmith now uses *.bsmx format files, an extended XML format that is easier to extend and add to as new features are added to BeerSmith

2013 BeerSmith LLC

12

BeerSmith 2

o BeerSmith can still freely import and export BeerSmith 1.x (*.bsm) files as well as BeerXML open format recipe files

New Tools
o A new Yeast Starter Tool will calculate your yeast starter size o The Water Profile Tool now has a button that will calculate the ideal water additions to match a given target water profile o A number of other tools have been updated, revised and improved

New Add-ons
o The new add-on tool lets you download and manage ingredient and recipe add-on packs from the BeerSmith website

1.3

Frequently Asked Questions


Some of the most commonly asked questions are locate here. Note : Our Online FAQ is updated frequently and may have the latest answer to your questions See Also: BeerSmith Help, Online Resources, BeerSmith Support Page, BeerSmith Videos, BeerSmith Discussion Forum, BeerSmith Blog/Podcast

BeerSmith seems complicated - how can I get started?


o See our Getting Started page for some of the first steps you should take o A lot of people enjoy watching the video tutorials which explain how to perform common operations in BeerSmith

Can I install BeerSmith on more than one computer?


o A single key allows you to install BeerSmith on up to two computers for your personal use. So you can, for example, install your copy to your laptop and desktop computer. You should not, however, share your key with a friend. o Be sure to use the same email address when activating your copies of BeerSmith

I'm Receiving a Warning from my Antivirus Program When I Install BeerSmith 2


o BeerSmith 2 is a new program, so some antivirus programs have flagged it incorrectly o Please see this page on how you can help us correct these false-positive reports

My computer died or I lost my key and I need to reinstall...


o Download the latest version of BeerSmith from BeerSmith.com o Your key should be on the original email receipt you received when you ordered or in the inside front cover of your CD if you purchased a CD. o If you no longer have your key, use the Recover Key command on the help menu or ribbon to recover your key. If your copy is expired when you reinstall, there is a link to the recover key command on the activation screen.

Where can I learn more about homebrewing?


o BeerSmith has one of the largest collection of articles about homebrewing on the web including the
2013 BeerSmith LLC

Welcome to BeerSmith!

13

BeerSmith Blog and Podcast, BeerSmith Discussion Forum and our weekly newsletter.

Can I convert/change units to metric/english/imperial units?


o You can change your default units to Metric, Imperial, or English from the Options Dialog, Units Page. You can also do in-place unit conversions for any field of the same type by entering the units after any number.

How can I transfer my data to another computer or share recipes?


o You can transfer recipes using the Export All command to export your My Recipes view and then open the file on the other computer.

How do I import recipes sent or downloaded from the internet?


o Open the file and then copy/paste the recipes you want to keep into your My Recipes folder. o You can download and import sets of BeerSmith recipes from our BeerSmith Recipe Collection.

I'm having a problem with BeerSmith


o Please visit our main support page online for the latest patches, videos, add-ons, discussion forum and help using BeerSmith

Is BeerSmith available for the Macintosh?


o BeerSmith 2.0 is now available for the Macintosh computer from BeerSmith.com

Where can I download more recipes for BeerSmith?


o Two popular places to get BeerSmith recipes include our Recipes Archive and Discussion Forum o See Opening a File for details on how to open and import new recipes in different formats

How do I customize my equipment settings?


o This is a critical first step - as you really need to have your own equipment profile to properly design recipes o See the article on Equipment Profiles for a field-by-field description of building your own equipment profile

How can I change the defaults for creating a new recipe?


o Use the Set Default Recipe command

What is your upgrade policy?


o All minor version upgrades (2.0, 2.1, 2.2, etc...) are free. Major upgrades (3.0, 4.0, 5.0) will require a new registration or upgrade fee

Does BeerSmith run on Linux?


o Some users have had success running BeerSmith under Wine. I am considering a pure Linux release as a possibility for future upgrades.

Why does BeerSmith calculate a different bitterness (IBU) value than program/

2013 BeerSmith LLC

14

BeerSmith 2

spreadsheet X?
o BeerSmith uses the Tinseth hop equation to estimate bitterness by default. Many others use Rager. You can change the hop equation used from the Options Dialog, Bitterness Tab o Also - make sure your equipment profile is properly set up as these can affect the bitterness calculation

I'm having problems with Printing/Print preview margins?


o On the PC version, all Text and HTML report formats (including recipes) are printed using an internet explorer plugin, so if you are having printing problems or want to adjust certain settings such as margins or headers please check your internet explorer settings first

Where can I get more help?


o In addition to the help included with BeerSmith, we run an extensive set of Online Resources including our Support Page, Discussion Forum, Videos and Blog/Podcast. o If you can't find what you are looking for, often posting a message to the discussion forum is a quick way to get an answer

1.4

Online Resources
BeerSmith has one of the most extensive collections of online resources and communities both to support BeerSmith software and the brewing community in general.

BeerSmith Support Resources Online


o BeerSmith Support Page - The central hub for BeerSmith support o Discussion Forum - Discuss brewing, BeerSmith and get your questions answered by our online community o Video Tutorials - Videos showing you how to use BeerSmith 2 o Recipe Archive - Download BeerSmith recipes o BeerSmith Main Page - Download the latest version and get the latest news

BeerSmith Home Brewing Articles, Podcast, References


BeerSmith Blog - Dozens of articles and our podcast on home brewing BeerSmith Podcast - Interviews with top brewers from around the world Newsletter - Get weekly articles on home brewing for free Home Brewing with BeerSmith - My collection of home brewing articles - printed as a book on Amazon o BrewWiki - Brewing encyclopedia and Wiki you can add articles to o BeerSmith Guide - An index of over 100 articles on brewing o o o o

1.5

Building a Recipe
BeerSmith 2 has a very extensive set of tools for designing recipes as well as new tabs for recording many of the details of your brewing session. Virtually every aspect of the recipe design process and brewing process has been improved.
2013 BeerSmith LLC

Welcome to BeerSmith!

15

See Also: Scaling and Adjusting Recipes, Finding your Way Around BeerSmith, Using Profiles and Styles and Adding Custom Ingredients Online Articles: BeerSmith Guide, Recipe Design, Hop Bitterness, Beer Color, Hop Techniques, Mashing Techniques, Understanding Brewhouse Efficiency, Partial Mash Brewing, Beer Style Articles

Recipe Design and Editing Topics


o o o o o o o o o o Creating your First Recipe Recipe Design Tab Yeast Starter Tab Mash Details Tab Timer Tab Fermentation Tab Water Volumes Tab Notes Tab Brew Steps Recipe Set as Default Option

1.5.1

Creating Your First Recipe


This is intended as a simple tutorial on creating a recipe. The basic process is to choose your equipment and the beer style you are targeting, then start adding ingredients. BeerSmith will update the estimates for bitterness, color, etc as you go. If you are brewing all-grain or partial mash you can also select a mash profile for your beer, and all brewers can select their carbonation method and fermentation profile using the buttons below the style guide. See Also: Recipe Design Tab, Scaling and Adjusting Recipes, Finding your Way Around BeerSmith, Using Profiles and Styles and Adding Custom Ingredients Online Articles: BeerSmith Guide, Recipe Design, Hop Bitterness, Beer Color, Hop Techniques, Mashing Techniques, Understanding Brewhouse Efficiency, Partial Mash Brewing, Beer Style Articles

Creating a New Recipe


o Open a new recipe by clicking on the Add Recipe button from My Recipes view. An empty recipe will open in a new tab. o Enter the name of your recipe, your name as the brewer and pick the type of recipe you want to create (all-grain, extract or partial-mash) o Choose your equipment profile by clicking on the equipment name button. If you have not already done so, it is recommended you set up an equipment profile to match your particular set of brewing equipment. This should populate the batch size, efficiency and boil size fields. o In the style guide section, select a target style for your beer by clicking on the Style name o If you are an all grain or partial mash brewer, select the Mash profile for your beer by clicking on the mash name - if you are a beginning all grain brewer, I recommend you choose the "Single Infusion, Medium Body, No Mash Out" profile. See Mash Profiles for more details on available profiles. o Start adding ingredients to your beer using the various "Add" buttons next to the ingredient list. As you add ingredients the color of the beer glass icon and estimated original gravity, bitterness and color will be adjusted. These numbers will continuously be compared to the style you selected and
2013 BeerSmith LLC

16

BeerSmith 2

displayed on scale below the ingredients. o You can select your carbonation (bottling/kegging) method and fermentation aging profile to match your beer near the bottom of the dialog o Press OK to save your recipe, or Cancel to abandon it.

1.5.2

Recipe Design Tab


The recipe design tool is the central area for building new beer recipes. It is intended to allow you to quickly select a set of ingredients and see instantly how it affects your beer. You can perform all of the steps to build your recipe from this single tab. The other tabs (yeast starter, mash details, fermentation) are used to detail and record your brewing process - but the recipe design takes place here. Recipe design can be a complex process. For details on making better recipes, see the articles referred to below. For the basics, follow the process shown below. See Also: Scaling and Adjusting Recipes, Finding your Way Around BeerSmith, Using Profiles and Styles and Adding Custom Ingredients Online Articles: BeerSmith Guide, Recipe Design, Hop Bitterness, Beer Color, Hop Techniques, Mashing Techniques, Understanding Brewhouse Efficiency, Partial Mash Brewing, Beer Style Articles

Recommended Recipe Design Process


o Open a new recipe by clicking on the Add Recipe button from My Recipes view. o The Recipe Design tab will be selected by default o Enter the name of your recipe, your name as the brewer and pick the type of recipe you want to create (all-grain, extract or partial-mash) o Choose your equipment profile by clicking on the equipment name button. If you have not already done so, it is recommended you set up an equipment profile to match your particular set of brewing equipment. This should populate the batch size, efficiency and boil size fields. o In the style guide section, select a target style for your beer by clicking on the Style name o If you are an all grain or partial mash brewer, select the Mash profile for your beer by clicking on the mash name - if you are a beginning all grain brewer, I recommend you choose the "Single Infusion, Medium Body, No Mash Out" profile. See Mash Profiles for more details on available profiles. o Start adding ingredients to your beer using the various "Add" buttons next to the ingredient list. As you add ingredients the color of the beer glass icon and estimated original gravity, bitterness and color will be adjusted. These numbers will continuously be compared to the style you selected and displayed on scale below the ingredients. o You can select your carbonation (bottling/kegging) method and aging profile to match your beer near the bottom of the dialog

Customizing your Display


o In the bottom right of the design view you can customize your display using dozens of recipe fields using the Select Fields button

Adjusting Grain Percentages


o Click the Grain Pct button next to the ingredients list o Adjust the recipe grain percentages until the total is 100% and press OK - BeerSmith will adjust the weights of the grains to match your percentages

2013 BeerSmith LLC

Welcome to BeerSmith!

17

Adding a Picture
o You can use the "+" and "X" buttons to the right of the beer glass icon to add your own thumbnail picture (or delete it) of your brew

1.5.3

Yeast Starter Tab


The yeast starter tab is primarily designed to help you calculate the proper size of a yeast starter needed if using liquid yeast. Note that yeast starters are rarely needed with dry yeast as it merely needs to be hydrated before use. See the online articles below for additional details. Generally a yeast starter is created 12-24 hours before brewing, and is made from dry malt extract boiled with water and then cooled to room temperature. The recommended target gravity for a yeast starter is 1.036 SG. The top right section shows the yeast packages currently in your recipe. This list shows the viability of each yeast package and estimated number of viable cells in that package. The average large smack pack/vial of liquid yeast has approximately 100 billion viable cells when new and the small smack packs contain only about 20 billion cells. To get an accurate viability reading, be sure to edit each yeast and enter the production date for the yeast packet. On the left side, the tool shows an estimate of the yeast cells needed. This is based on the type of recipe, batch size and pitch rate setting which can be adjusted in the Yeast Options dialog if desired. Below that is the estimated number of yeast cells in your recipe if you use no starter at all. Under the "Yeast Starter Used" section, you can enter the size of starter you intend to use and check the box if you are using a stir plate. Note that stir plates significantly increase growth rates for your yeast starter, and are recommended. Once you have entered a yeast starter size, the tool will show the estimate of how many cells you have using the starter. If it is too few you can either increase the starter size or the number of packages of yeast. Along the bottom of the tool is the recommended number of packages and starter size. Note that the starter size may be different than your starter size if you are not using the recommended number of yeast packs shown. Finally on the bottom right the calculator will estimate the number of dry yeast packets (large 11.5 gram ones) to use and hydration needed for those yeast packets. Note : The recommended liquid starter and yeast starter used numbers will not match up with the actuals unless you use the recommended number of yeast packets and recommended yeast starter size. See Also: Yeast Starter Options, Yeast Starter Tool Online Articles: Yeast Starters Part 1, Yeast Starters Part 2, Making a Yeast Starter, Beer Yeast and Fermentation, Chris White Podcast, Chris White Interview

Displaying the Yeast StarterTab


o Open a recipe by double clicking on it o Click on the Yeast Starter tab a the top of the recipe window to view/edit your recipe yeast starter details
2013 BeerSmith LLC

18

BeerSmith 2

1.5.4

Mash Details Tab


The mash details tab is used to display details of the mash steps used for all-grain and partial mash brewers. It is disabled (greyed) for extract brewers since they do not mash. In the top half of the display you can select your mash profile, adjust your mash profile to match your equipment and edit the mash steps. To the right is the mash profile displayed graphically, and below the mash profile you have the sparge step and volume displayed. In the bottom half you can adjust starting conditions for your mash (grain and mash tun temperature), take a look at the estimated volume needed to support your mash profile (and compare it to your tun volume!), record the mash pH and end of running gravity (if desired - purely optional), and record your volumes and gravity into the boiler. If you enter your measured boil volume and boil starting gravity it will also calculate the actual mash efficiency. Note: The mash efficiency is not the same as the brewhouse efficiency - brewhouse efficiency includes all losses between mashing and the fermenter while mash efficiency includes only losses in the mash process itself Online Articles: Infusion Mashing, Mash Steps for All Grain, Partial Mashing, Decoction Mashing, Infusion Mashing and Decoction, Batch Sparging Guide, Brew in a Bag Techniques, Brew in a Bag Podcast

Displaying the Mash Details Tab


o Open a recipe by double clicking on it o Click on the Mash Details tab a the top of the recipe window to view/edit your recipe mash details

1.5.5

Timer Tab
The brewday timer tab is a new feature added in BeerSmith 2.1. It gives you a simple timer for mashing/ steeping and also a separate boil timer. Below the timer are step-by-step instructions that scroll as you brew to show the next steps. It also has a built in alarm to tell you when major events occur. See Also: Brewing Options

Displaying the Timer Tab


o Open a recipe by double clicking on it o Click on the Timer tab button in the open recipe

Mashing/Steeping with the Timer Tab


o For all grain recipes, the top timer is used for mashing. The steps shown are for the mash profile you selected for this recipe (see Mash tab). o For extract recipes it will show the steeping steps if you are steeping any grains. The steep time and temperature for steeping grains in an extract recipe are set using the steep grain temp and time fields below the steep timer box (which is disabled for recipes using a mash). o To start the timer, use the play button next to the mash/steep timer. To pause it, use the pause icon. To reset the timer back to zero use the reset icon. o You can also set the timer to a particular time using the ste button. o As the timer progresses it will show each step, and play an alarm when the next step time is reached. o As old steps are finished, they will be greyed out and then removed from the list after a few minutes.
2013 BeerSmith LLC

Welcome to BeerSmith!

19

Boiling with the Timer Tab


o The bottom (boil) timer and steps on the timer tab are used for timing the boil. o Boil steps (including first wort hops and aroma hops steeped at the end of the boil) are listed in the area below the boil timer. o To start the timer, use the play button next to the boil timer. To pause it, use the pause icon. To reset the timer back to zero use the reset icon. o You can set the timer to a particular point in the process using the set button. o As the timer progresses it will show each step with its time, and play an alarm when the next step time is reached. o As old steps are finished, they will be greyed out and then removed from the list after a few minutes.

1.5.6

Fermentation Tab
The fermentation tab for a recipe is a central area for detailing your brewing process from the boiler to the fermenter and also show your aging and bottling/kegging options. It also allows you to accurately calculate your overall brewhouse efficiency, carbonation levels and statistics for the finished beer. Note: You must record and enter the measured values (boil volume, original gravity, batch size, final gravity) to get accurate measured calculations. The "Into the Boiler" section shows your estimated and measured boil volume and gravities. The "Into fermenter" shows the estimated and measured batch size and original gravity for the beer. "Brewhouse Efficiency" provides your estimated and measured brewhouse efficiency for all grain brewers. "Fermentation and Storage" gives you a place to track the gravities of your beer as it ferments. The "At bottling/kegging" section provides space for the final gravity of the beer and volume actually bottled or kegged. On the right half of the display the current fermentation and aging profile is displayed (temperature versus time) as well as your preferred carbonation method, carbonation level and how much pressure or sugar needed for carbonation. On the lower half you can enter taste notes and your taste rating (typically the BJCP score if you compete your beer - a value between 1 and 50). On the bottom right is the estimated and actual statistics (alcohol by volume and weight and calories) for your finished beer. Online Articles: Understanding Brewhouse Efficiency, Improving your Brewhouse Efficiency, Apparent and Real Attenuation Part 1, Part 2, Counting Calories in Beer, How to Keg your Beer, Beer Bottling Tips, Recipe Design Tab

Displaying the Fermentation Tab


o Open a recipe by double clicking on it o Click on the Fermentation tab a the top of the recipe window to view/edit your recipe fermentation details

1.5.7

Water Volumes Tab


In the recipe editor, the water volumes tab shows the various water volumes associated with the steps in your brewing process. These include the mash, boil and fermentation and bottling. When brewing, this helps you plan and track your water usage, and also adjust many equipment settings if they do not match this particular batch of beer.

2013 BeerSmith LLC

20

BeerSmith 2

The water volume tab is very similar to the Water Needed Tool available as a standalone tool.

Displaying the Water Volumes Tab


o Open a recipe by double clicking on it o Click on the Water Volumes tab a the top of the recipe window to view/edit your recipe water volume details o If you want to permanently change aspects of your equipment it is important that you go to the Equipment Profile and edit your settings there, as changing them in a recipe will only alter the settings for that one recipe.

1.5.8

Notes Tab
The notes tab is a tab available for any open recipe that allows you to enter extensive notes for your recipe. You can enter taste notes for the finished beer or other notes detailing your design, recipe and brewing notes. Note: A smaller display of the notes field is available on the main design page - these are the same field, but the notes tab allows more space for extensive editing. See Also: Building a Recipe

Displaying the Notes Tab


o Open a recipe by double clicking on it o Click on the Notes tab a the top of the recipe window to view/edit your recipe notes

1.5.9

Brew Steps (the BrewSheet)


BeerSmith can build a set of brewing steps (also called the BrewSheet) for any recipe to make it easy for you to brew that specific recipe. Note : You can also create your own custom report templates and print them using the reports feature including reports that look like the brewing steps report. See Also: Custom Report Templates, Using Reports, Printing and Previewing

Displaying the Brew Steps/BrewSheet


o Select or open the recipe you are working with o Click the Brew Steps button on the ribbon to preview the brewing steps for this recipe

Displaying additional Reports


o The brewing steps report is simply a report format - you can select others to view from your My Recipes view o Highlight any recipe from My Recipes view - a preview of that recipe will be shown in the preview window o Click on the Report dropdown on the title bar for the preview window to change report formats

1.5.10 Recipe Set as Default


BeerSmith lets you set up a default recipe containing just about any settings, profiles or ingredients you wish to make it easier to create new recipes in the future. Essentially the default recipe is the one that will come up whenever you add a new recipe from My Recipes view.
2013 BeerSmith LLC

Welcome to BeerSmith!

21

Setting the Default Recipe Template for New Recipes


o First create a new empty recipe, and adjust any of the settings you want. For example, you might want to set the type, equipment, boil time, brewer, carbonation and fermentation settings to be those you most commonly use. You can even add ingredients if you like. o Once you have your "default recipe" the way you like it, pick the Set as Default icon on the ribbon o You will be asked to confirm that you want to make this the new default recipe - click yes to do so o Now if you create a new recipe it will have all of the settings/fields you just used as the starting point for editing.

1.6

Finding Your Way Around BeerSmith


BeerSmith 2 introduces an entirely new look and feel including the ribbon bar, and tabbed browsing of recipes and tools. The goal of the new interface is to make it much easier to work with several tools or views at once. Click on the topics below to learn more. See Also: Building a Recipe, Scaling and Adjusting Recipes, Calendar and Notes, Brewing Tools

Using BeerSmith
o o o o o o o o Activating your Copy of BeerSmith Using Tabbed and Windowed Browsing My Recipes and Folders Editing Functions Reports Printing and Previewing Automatic Unit Conversion Customizing Columns in a View

1.6.1

Activating BeerSmith
BeerSmith 2 uses a key system for registration. You can install BeerSmith 2 on up to two or your computers for personal use (i.e. don't share it with a friend) using the same key. Your key is tied to your computer and email address - so please keep your key private. Email and Privacy: BeerSmith 2 allows you to enter your email address when activating your copy. This email address is stored privately and not used for any commercial purposes - it is strictly used to allow you to recover your key if lost or misplaced in the future. If you don't enter an email address, and later need to recover your key you will be unable to do so. The BeerSmith Email List: If you enter an email, you also have option of joining the BeerSmith email list containing articles from the BeerSmith blog. This is completely optional, but if you choose to do so we will send you a subscription confirmation (which you must confirm to complete your subscription) and after that you will receive approximately one beer brewing article each week along with an occasional newsletter. NOTE: BeerSmith 1.X version keys are not compatible with BeerSmith 2. You need to purchase a new key or upgrade to register BeerSmith 2 See Also: Recovering a lost product key

2013 BeerSmith LLC

22

BeerSmith 2

How to Activate Your Copy of BeerSmith


o If you have not done so, purchase a product activation key from our website. If you purchased BeerSmith on CD the key should be on the inside front cover of the CD jacket. If you purchase an electronic key via our site you will receive it via email, usually within a few minutes of ordering. o Make sure you are connected to the internet and BeerSmith is allowed to contact our server through your firewall o Enter your product registration key - it should be a group of four sets of 5 digits each (example: AAF3G-F83D2-D83DA-823F8) where each character is the letters A-G or numbers 1-9. o You may choose to enter an email address (optional). However if you don't enter an email address, you will be unable to recover your key if lost in the future. o You may optionally check the box to subscribe to the BeerSmith Email List if desired. o Press OK to register your product. A message will be displayed if your email list and key were properly registered.

1.6.2

Tabbed and Windowed Browsing


BeerSmith 2 is a significant departure from the previous versions of BeerSmith. BeerSmith 1 only supported one visible view at a time, so opening a tool often obscured the recipe or view you were currently working on. BeerSmith 2 incorporates tabbed and window browsing - which makes it possible to open as many tools and recipes as you like without disrupting your workflow. Users with multiple monitors can open several different items and display them on the screen all at once. By default, most tools and views are opened in new tabs, and individual items (except recipes) are opened in separate windows. Any item can be displayed in a window, tab or within the currently active view. You can change this behavior by altering the look and feel options. Note: You can change the default opening option for an item by right clicking on that item to open it in a new tab or window. You can also do the same using Control/Command-click or Shift-Click (or double click when opening) to activate an item in a window, tab or in-place. See Also: Look and Feel options, My Recipes and Folders, Editing Functions, Reports

Opening a New Tab or Window


o By default, most tools and views are opened in new tabs, and individual items (except recipes) are opened in separate windows. This includes most tools, the profile, ingredient and open recipe views. o You can change this behavior for an item permanently by altering the look and feel options. o You can also right click on an item and select the Edit in New Tab selection or Edit in New Window to override the default behavior o Finally, you can modify the default opening behavior for an item by Control/Command-Clicking or Shift-Clicking it. This applies to most menus, buttons and views.

Forcing a New Window


o Right click on an item and select the Edit in New Window to override the default behavior o If the default behavior is not to open a new window for an item, Shift-Clicking or Shift-Double-Clicking the item will also open it in a new window

Forcing a New Tab

2013 BeerSmith LLC

Welcome to BeerSmith!

23

o Right click on an item and select the Edit in New Tab to override the default behavior o If the default behavior is not to open a new tab for an item, Ctrl/Command-Clicking or Ctrl/CommandDouble-Clicking the item will also open it in a new tab

Opening in the Current View


o Though rarely used, you can also set an item to open over the current view. In this case the new view will obscure the previous one and you can navigate between views using the Forward and Back buttons on the toolbar o This mode is primarily used for navigating My Recipes and the recipe folders, and not recommended for tools and other items.

1.6.3

My Recipes and Folders


BeerSmith stores all of your recipes in the main My Recipes folder and sub-folders. Your recipes folder is shown on the left side of the main BeerSmith window as a tree. You can click on the My Recipes folder or any of the subfolders to display the recipes within those folders. In addition, BeerSmith maintans a Brew Log where you can store complete copies of your recipes as brewed for future reference. Note: You do not need to explicitly save any of your recipes stored in your My Recipes folder or any of the profiles or ingredients in the main profile or ingredient views. These are saved automatically when you close BeerSmith and also saved in the background every few minutes if your computer is idle. See Also: Importing and Exporting Files, Building a Recipe, Scaling and Adjusting Recipes

Adding a Recipe Folder


o You can add a folder to your My Recipes folder or any sub-folder by selecting the parent folder and clicking the Add Folder button on the ribbon.

Navigating Recipe Folders


o Recipe folders are typically opened over the existing My Recipes view and you can navigate between them using the Back and Forward buttons on the toolbar. o You can also change folders by clicking on the folder name in the tree shown on the left side of the main view.

Moving Recipes Between Folders


o You can Cut/Copy/Paste recipes and entire folders to rearrange them within your folders. o You can also drag and drop folders and recipes to other folders - usually this is best done if you drag an item or selected items from the folder to the tree view folders on the left.

Adding Recipes to the Brew Log


o You can recipe to your Brew Log folder Copy to Log button on the ribbon.

Adding a Recipe within a Folder


o You can create a new recipe in any folder by opening that folder and then clicking the Add Recipe button o See this section for information on designing your recipe

2013 BeerSmith LLC

24

BeerSmith 2

1.6.4

Editing Functions
BeerSmith supports editing functions that most Windows and Mac users will be quite familiar with such as Cut, Copy, Paste, Edit, Undo, and Redo. These are available in any of the profile, ingredient and recipe folder views. See Also: Recipes and Folders, Ingredient Views, Profiles and Styles, Navigating BeerSmith

Editing an Item
o Double click on any item to open it for editing.

Cut, Copy Delete and Paste using the Clipboard


o BeerSmith supports the standard Cut/Copy/Delete/Paste functions. o To copy or cut an item or set of items, select those items. You can select multiple items using Ctrl/Command-click or Shift-Click with the mouse. o Click on the Cut, Copy, or Delete button on the ribbon or edit menu to cut or copy the selected items to the clipboard. o If desired, switch to another folder, view or file o Click on the Paste button to paste the cut/copied items into the current folder

Undo and Redo


o We've made a real effort to allow undo and redo for any of the major editing functions within a given BeerSmith session o To undo the last editing function you performed, click on the Undo button on the toolbar or edit menu o To redo an edit you previously undid - use the Redo button on the toolbar or edit menu

Right Click Editing Menu


o Like many popular programs, you can also access the most common editing functions for an item by right clicking (control-click on the Macintosh) any item to bring up a pop-up menu with common editing functions

1.6.5

Reports
BeerSmith 2 has the ability to print and preview a diverse set of report formats. The program has a number of basic (text, brewsheet, competition, etc) preloaded with the program and you also have the ability to make custom reports if you desire. Reports are displayed in the preview window typically shown below or to the right of major data views such as the profile, ingredient and recipe folder views. These reports can be printed or previewed using the print and preview commands. You can change the current report format using the drop-down on the title bar of the preview window. Note on Margins and Print Settings: BeerSmith actually uses two different systems for printing. The profile, ingredient and recipe folder views and preview reports, which are typically in HTML or text format are printed using your internet browser. On Windows, BeerSmith uses an Internet Explorer plugin for more flexibility with HTML reports. However, this means many of the settings (margins and headers) are set from Internet explorer rather than within BeerSmith. For dialogs and brewing tools, which are printed directly, you can use the Page Setup dialog (File menu) to set print options. Also currently on the Mac these settings are active as a limited native browser is implemented.

2013 BeerSmith LLC

Welcome to BeerSmith!

25

See Also: Custom Reports, Brewing Steps, Printing and Previewing

Printing or Previewing a Report


o Select the Print or Preview buttons on the toolbar, or the ones on the title bar for the preview window. See printing and previewing for more info.

Changing Report Formats


o On the title bar for the preview window pane is a drop-down box that shows the currently selected report format and lets you choose other report formats. o To add additional report formats or create your own, please see the Custom Reports section

Setting the Default Report Format


o Just to the left of the current report format name on the title bar of the preview pane is a small flag icon. Clicking on this icon will let you set the default report format for a given type (for example recipes or hops) o You must confirm your selection when you change the default report format

Rearranging the Preview Pane


o You can change the preview pane to either display below your data items or to the right of them. To change the location of the preview pane, select the small preview pane icon between the search box and close button on the title bar for your data view. o A drop-down menu will appear and allow you to display the pane below or to the right of your data. In addition you can close the preview pane so only the data view is shown from here.

Adding Custom Reports


o See Custom Reports Options

1.6.6

Printing and Previewing


BeerSmith lets you print or preview your work as you go. This includes most tools, the profile, ingredient and recipe folder views. Note on Margins and Print Settings: BeerSmith actually uses two different systems for printing. The profile, ingredient and recipe folder views and preview reports, which are typically in HTML or text format are printed using your internet browser. On Windows, BeerSmith uses an Internet Explorer plugin for more flexibility with HTML reports. A second system is used to print dialogs. On Windows, you can drag the margins for HTML reports from the print preview dialog. The other printouts do not have adjustable margins at this time. See Also: Custom Reports, Brewing Steps, Reports

Printing or Previewing a Report


o You can print reports from the profile, ingredient and recipe folder views. o Select the Print or Preview buttons on the toolbar, or the ones on the title bar for the preview window. See printing and previewing for more info.

2013 BeerSmith LLC

26

BeerSmith 2

Changing Report Formats


o On the title bar for the preview window pane is a drop-down box that shows the currently selected report format and lets you choose other report formats. o To add additional report formats or create your own, please see the Custom Reports section

Printing a Dialog or Tool


o You can print dialogs or tools as well by clicking the Print button or Preview button for any dialog or tool. o On HTML reports in Windows, you can change the margins from within the print preview window by dragging them

1.6.7

Automatic Unit Conversion


BeerSmith supports automatic unit conversion in almost any field. This means, for example, that you can enter a unit descriptor after any number and BeerSmith will automatically convert the unit for you when you hit the tab key. For example entering "56 C" into a temperature field that defaults to degrees F will automatically convert from Celsius to Fahrenheit. You can even enter compound entries in certain situations such as entering "5 lb 3 oz" into a weight field which will correctly be converted to the current weight units. Finally you can do simple math in any field - for example entering "3/5" into a field will correctly convert to "0.60" when you hit tab. This applies to all fields that use standard weight, volume, temperature, gravity, color or pressure units. The only exception is certain advanced options which use fixed units. See Also: Unit Options

Converting Units Within a Field


o Enter the number followed by the units and then hit the tab key - for example entering "5 kg" into a weight field will convert to native units (pounds for example) once you hit the tab key.

Performing Simple Math Within a Field


o Enter the math expression into any field and hit the tab key. For example "3*2.4" will calculate the product of 3 and 2.4. o BeerSmith supports the four basic math operations (+, -, / and *) as well as parenthesis to group expressions

1.6.8

Customizing Columns
You can adjust the width of columns in any data view and also add or delete columns to those already displayed.

Resizing a Column
o Drag the separator between two column headers with the mouse to change the size of a column

Customizing Columns
o Choose the Customize Columns command from the View menu or ribbon, or alternately right click
2013 BeerSmith LLC

Welcome to BeerSmith!

27

on the column headings o Add, remove and rearrange the columns as desired o Press OK to change the columns displayed in the main view

1.7

Scaling and Adjusting Recipes


BeerSmith has a number of tools you can use on any recipe to make it easy to set the recipe's color, bitterness, original gravity or size. In addition BeerSmith has an automated tool for converting all grain to extract recipes (or other types). See Also: Building a Recipe

Tools for Scaling, Adjusting and Converting Recipes


o o o o o Scaling the Size of a Recipe Converting a Recipe Adjusting the Original Gravity of a Recipe Adjusting the Bitterness of a Recipe Adjusting the Color of a Recipe

1.7.1

Scaling the Size of a Recipe


The Scale Recipe button on the ribbon for My Recipes view or any open recipe will scale the recipe size up or down, matching original gravity, bitterness and color of the original recipe as closely as possible. Using this command you can scale a recipe to match your equipment profile, a different target batch size or even to adjust a recipe's brewhouse efficiency. Note: Whenever possible it is best to scale recipes using your own personal equipment profile - this will assure a complete match between the recipe you have imported and your own equipment.

Scaling the Size of a Recipe


o Select the recipe you want to add either by opening it or selecting it from your My Recipes view o Select the Scale Recipe button on the ribbon o The best method for scaling a recipe is to use your own equipment profile - choose it using the equipment profile button at the top of the dialog o You also have the option of manually setting a new batch size, boil volume, or brewhouse efficiency number if desired o Press OK to scale the recipe size and ingredients to match the existing recipe's original gravity, bitterness and color

1.7.2

Converting a Recipe
The Convert Recipe button on the ribbon for My Recipes view or any open recipe lets you convert a recipe from all-grain to extract (or partial mash). In fact you can convert between any of the three major types. The conversion process is a fairly complicated operation that does its best to preserve the original recipe's color, bitterness and original gravity. During the conversion, some ingredients may be replaced - especially those needing mashing instead of steeping and the base grain which will be converted to the based extract (or grain) you selected in the dialog. Note: Whenever possible it is best to convert recipes using your own personal equipment profile - this will assure a complete match between the recipe you have imported and your own equipment.

2013 BeerSmith LLC

28

BeerSmith 2

Limitations: Some very light colored beers cannot be accurately converted to extract due to the fact that malt extract is generally much darker than comparable pale grain malt. The converter will do the best it can, but in some cases has a hard time converting very light colored beers. Online Articles: Converting All Grain Recipes to Extract

Converting a Recipe
Select the recipe you want to use either by opening it or selecting it from your My Recipes view Select the Convert button on the ribbon Select the type you want to convert to - you can convert it to any type using this tool The best method for converting a recipe is to use your own personal equipment profile - choose it using the equipment profile button at the top of the dialog o Select the base grain to use for the new recipe - this will be the grain that the converter uses as the base malt to make up the bulk of the grain bill in the new recipe. o o o o

1.7.3

Adjusting Gravity for a Recipe


The Adjust Gravity button on the ribbon for My Recipes view or any open recipe will adjust the grain amounts used in the recipe to match a target original gravity.

Adjusting the Original Gravity of a Recipe


o Select the recipe you want to use either by opening it or selecting it from your My Recipes view o Select the Adj Gravity button on the ribbon o The scales will show the old and new original gravities as well as the style range (graphically and numerically) for the style guide chosen for this recipe o Enter your new original gravity and press OK to adjust the gravity

1.7.4

Adjusting Bitterness of a Recipe


The Adjust Bitterness button on the ribbon for My Recipes view or any open recipe will adjust the hop amounts used in the recipe to match a target bitterness level (in IBUs).

Adjusting the Bitterness of a Recipe


o Select the recipe you want to use either by opening it or selecting it from your My Recipes view o Select the Adj Bitterness button on the ribbon o The scales will show the old and new bitterness levels as well as the style range (graphically and numerically) for the style guide chosen for this recipe o Enter your new bitterness level and press OK to adjust the bitterness

1.7.5

Adjusting Color of a Recipe


The Adjust Color button on the ribbon for My Recipes view or any open recipe will adjust the grain amounts used in the recipe to match a target color level for the recipe. Limitations: For recipes that have no dark colored grains or no light colored grains, the color tool may fail as it can't adjust the color without changing its original gravity. In this case, it will typically adjust the recipe as light or dark as it can without altering the original gravity. Online Articles: Understanding Beer Color

2013 BeerSmith LLC

Welcome to BeerSmith!

29

Adjusting the Color of a Recipe


o Select the recipe you want to use either by opening it or selecting it from your My Recipes view o Select the Adj Color button on the ribbon o The scales will show the old and new color levels as well as the style range (graphically and numerically) for the style guide chosen for this recipe o Enter your new color and press OK to adjust the color

1.8

Shopping and Inventory


BeerSmith has integrated shopping and inventory views you can use for brewing beer. The recipes, inventory and shopping list are all tied together for easy management of your inventory while brewing. For details on how recipes, the shopping list and inventory work together please read: Understanding Inventory Management

Shopping and Inventory View Details


o Understanding Inventory Management o Shopping List View o Inventory View

1.8.1

Understanding Inventory Management


BeerSmith has an integrated set of inventory, shopping list and recipe tools for making it easy to manage your inventory. The three key views used in inventory management are the Shopping List, Inventory View and Recipe View. The basic flow is shown below:

Starting with a recipe, you can add all of the ingredients from a recipe to the shopping list using the Add to Cart button from any open recipe. Once you have purchased the ingredients in your shopping list, select them and use the Add to Inventory button to add them to your inventory view. Finally, when you go to brew a recipe you can use the Remove Inv button in any open recipe to remove ingredients found in the recipe from inventory. The three basic steps in this cycle are detailed below:

Adding All of the Ingredients for a Recipe


o Select the recipe you want to add either by opening it or selecting it from your My Recipes view o Select the Add to Cart button - this will automatically add the ingredients needed for this recipe to

2013 BeerSmith LLC

30

BeerSmith 2

your shopping cart o Go to the Shopping List to select your shopping list and view or edit the ingredients added

Adding Items Purchased to the Inventory


o After you have purchased a given set of items you can add them to the Inventory view o Select the items you want to add to inventory - you can select multiple items using Control/ Command-Click and Shift-Click with the mouse o Select the Add to Inventory button on the ribbon o The items will be added to your inventory view in the quantities you purchased o If desired you can now remove these items from your shopping list using the Delete button

Removing Ingredients from Inventory When Brewing


o Open the recipe you are going to brew o Select the Remove Inv button from the ribbon o Note that if you try to remove ingredients twice within a short period you may be asked to confirm that you intended to do so

1.8.2

Shopping List
The shopping list view is a feature to help you manage your inventory and also keep track of items to purchase for your next trip to the store. From here you can make a shopping list, set prices for the list, print out your shopping list and print the shopping list for a trip to the store. You can also select items to add to your inventory once you purchase them and even add an entire recipe to the shopping list in one shot. See Also: Understanding Inventory Management, Editing Functions ,

Adding Items Directly to the Shopping List


o o o o Select the Shopping List command from the View menu or toolbar Choose the Add Grain, Add Hops, Add Yeast, or Add Misc button on the ribbon Select the item you want to add from the list and enter the quantity and current price to purchase You can use the Add Item button to enter other (non-ingredient) items such as equipment

Adding All of the Ingredients for a Recipe


o Select the recipe you want to add either by opening it or selecting it from your My Recipes view o Select the Add to Cart button - this will automatically add the ingredients needed for this recipe to your shopping cart o Go to the Shopping List to select your shopping list and view or edit the ingredients added

Adding Items Purchased to the Inventory


o After you have purchased a given set of items you can add them to the Inventory view o Select the items you want to add to inventory - you can select multiple items using Control/ Command-Click and Shift-Click with the mouse o Select the Add to Inventory button on the ribbon o The items will be added to your inventory view in the quantities you purchased o If desired you can now remove these items from your shopping list using the Delete button

2013 BeerSmith LLC

Welcome to BeerSmith!

31

To Empty your Shopping List


o Within the shopping list view, select the Empty Cart button

To Print your Shopping List


o Within the shopping list view, select the Print List button

Setting the Price


o Within the Shopping List view, select the items you wish to set. You can select multiple items using Ctrl/Command-click and Shift-click on your mouse o Click the Set Price button on the ribbon to set all of the prices at once

Rounding Up Purchase Amounts


o Within the Shopping List view, select the items you wish to set. You can select multiple items using Ctrl/Command-click and Shift-click on your mouse o Click the Round Up button on the ribbon to round the quantities for these items up to the next whole number for purchase

1.8.3

Inventory
The Inventory view lets you manage your inventory of ingredients used for brewing. From here you can add items to inventory, and edit the inventory and prices of items. New Feature: If you have an existing item in inventory with a given price, then add a new item at a different price from the shopping cart, BeerSmith will dollar-average the price to determine average cost of the items in inventory. See Also: Shopping List, Understanding Inventory Management, Editing Functions

Adding Items Directly to Inventory


o Select the Inventory command from the View menu or toolbar o Choose the Add Grain, Add Hops, Add Yeast, or Add Misc button on the ribbon o Select the item you wish to add, inventory amount and price it was purchased at

Adding Items Purchased from the Shopping List to the Inventory


o Switch to Shopping List view by selecting Shopping List command from the view menu or ribbon o Select the items you want to add to inventory - you can select multiple items using Control/ Command-Click and Shift-Click with the mouse o Select the Add to Inventory button on the ribbon o The items will be added to your inventory view in the quantities you purchased o If desired you can now remove these items from your shopping list using the Delete button

Removing Ingredients from Inventory When Brewing


o Open the recipe you are going to brew o Select the Remove Inv button from the ribbon o Note that if you try to remove ingredients twice within a short period you may be asked to confirm that you intended to do so

2013 BeerSmith LLC

32

BeerSmith 2

1.9

Using Profiles and Styles


Profiles such as equipment and mash profiles let you store a commonly used set of equipment or process and apply it to a recipe as needed. Styles includes the beer style database which is used in the recipe design tool to compare recipes against established standards for a style. The most popular beer style database (The BJCP style database) is included with BeerSmith. All of the profiles and styles are used in the beer recipe design process. For a new user of BeerSmith, the standard styles and profiles should be sufficient to get started. However, it is strongly recommended that you create your own personal equipment profile early on so you have the correct equipment setup for new recipes.

Using Profiles and Styles


o o o o o Styles Database - a collection of data on beer styles from around the world Equipment Profiles - used to manage your brewing equipment Mash Profiles - used to make mashing as simple as possible Carbonation Profiles - used in recipes for bottling and kegging techniques Fermentation Profiles - used in fermenting and aging your beer

1.9.1

Styles
The Styles database contains a list of the beer styles to use when building recipes. The style guides are integrated with the Recipe Design Tab so you can choose a target style for your beer and BeerSmith will automatically compare key parameters for your beer against the selected beer style. The default style guide displayed with BeerSmith is "BJCP 2008". This is the standard style guide for US brewers, though some overseas may prefer other guides. New Feature: BeerSmith now has support for extensive descriptions of a style (the text is no longer limited) Important Note!: BeerSmith supports multiple style guides, and by default only the style guides that have their "Style Guide" field set to "BJCP 2008" will be displayed. This can cause confusion if you are trying to add your own styles from the style view. To display another style guide or show all style guides at once you need to set the "Style Guide" option within the Brewing tab of the Options dialog. See Also:Beer Style Articles, The BJCP Web Site, Recipe Design Tab

Using the Style Guide View


o Select the Style view from the profile menu or ribbon o From here you can add, edit or delete new styles using the large buttons on the ribbon o NOTE: If adding a new style, the "Style Guide" field must exactly match the currently set style guide option in the Options Dialog, Brewing Tab or it will not be displayed. Only the currently selected style guide will be shown both in the Styles view and when building recipes.

1.9.2

Equipment Profiles
The Equipment profiles are used to store your personal equipment settings for building recipes. It is very important that you create your own personal equipment profile to match your particular set of brewing equipment and set that as the default for future recipes. New Feature: BeerSmith now has the brewhouse efficiency as part of the equipment profile making it
2013 BeerSmith LLC

Welcome to BeerSmith!

33

easier to scale and match recipes based on recipe profiles. Important Note!: Please take a few minutes to create your own equipment profile for your brewing setup. As the equipment profile is used throughout the recipe calculations, an accurate equipment profile is important particularly if you want accurate water calculations when brewing. Also important: If you want to make your new equipment profile the default for all new recipes, use the Brewing tab in the Options dialog after you have created and set your equipment profile. If you edit your profile in the future you may need to update this option to have it saved for future recipes. See Also: Recipe Design Tab, BeerSmith Support Page - has videos on building your own equipment profile Online Articles: Understanding Brewhouse Efficiency, Improving your Brewhouse Efficiency

Using the Equipment Profile View


o Select the Equipment view from the profiles menu or ribbon o From here you can add, edit or delete new equipment profiles using the large buttons on the ribbon

Creating an Equipment Profile of Your Own


o Select the Equipment view from the profiles menu or ribbon o Click on the Add Equip button to add a new equipment profile, or you can copy/paste an existing profile and edit the copy to make it your own o Details for the equipment profile dialog are shown below o Press OK to save your equipment profile o If you want to make your new equipment profile the default for all new recipes, use the Brewing tab in the Options dialog

Details of the Equipment Dialog - Setting up your own profile


o Name - Give your personal equipment profile a descriptive name o Brewhouse Efficiency - If you are an all-grain or partial mash brewer, this should be set to the overall gross efficiency for your system from grain to fermenter including losses. For most brewing systems this is in the range of 68%-76%. o Hop Utilization Factor - Should always be set to 100% unless you are working with a very large system (more than 20 gallons) in which case your utilization might be higher. o Mash Tun Volume - The volume of your mash tun (for BIAB brewers, you should set this to the volume of your boil vessel). o Mash Tun Weight - Approximate weight (mass) of your mash tun - used to compensate mash temperatures for the thermal mass of your tun o Mash Tun Specific Heat - The specific heat of your mash tun - generally this is a number between 0.10 and 0.50 with lower numbers associated with all metal mash tuns such as stainless steel and higher numbers representing plastic thermal coolers. o Lauter Tun Deadspace - Represents the deadspace in the lauter tun - how much wort will likely be lost to the lauter tun screen and piping o Top Up Water for Kettle - Enter zero here for most cases unless you add additional water between the mash and the boil o Calculate Boil Volume Automatically - When checked this will determine the boil volume based on the Batch volume into the fermenter minus losses and evaporation. Generally it should be checked. o Boil Volume - The volume of water at the start of the boil
2013 BeerSmith LLC

34

BeerSmith 2

o Boil Time - The time that you usually boil the wort - typically 60-90 minutes for an all grain batch or slightly less for an extract batch o Boil Off - An estimate of the water boiled off or evaporated during the boil o Evaporation Rate - Calculated from the boil off - this represents the percentage boiled/evaporated off during the boil o Cooling Shrinkage - Water typically loses about 4% of its volume when cooled from boiling to room temperature o Cooling Loss - Simply the cooling shrinkage expressed as a volume o Losses to Trub/Chiller - The amount of wort lost in the trub or chiller during the transfer from the boiling vessel to the fermenter o Top Up Water - Typically zero for a full boil batch, but many extract brewers do add a few gallons of water at the end of the boil o Batch Volume Into Fermenter - The target batch size as measured into the fermenter - typically a bit over 5 gallons for most home brewers o Fermentation Loss - Losses to trub and transfers during the fermentation process o Bottling Volume - The batch volume minus fermentation losses - represents the volume of beer left to be bottled or kegged

1.9.3

Mash Profiles
A mash profile represents the steps needed for mashing grains during all-grain or partial mash brewing. BeerSmith comes pre-loaded with the most popular mash profiles which you can use in any recipe simply by choosing them. BeerSmith includes commonly used infusion mash profiles, decoction mash profiles, batch sparge profiles and even brew-in-a-bag (BIAB) profiles. Choose a mash profile within any all-grain or partial mash recipe's design tab to use it. You can adjust mash details for a single recipe using the recipe's mash tab. It is rare that you will need to create your own mash profile, but you can do so from this mash profile view as outlined below. Understanding Mash Profiles: The mash profiles most frequently used by homebrewers are those listed as "Single Infusion" mash profiles. These are single step infusion mashes where a measure of hot water is mixed with grains and left for an hour or so to convert the starches in the grains. Double and Triple infusions are used infrequently - and only needed for beers with a high proportion of non-barley base grains. Temperature mashing is used by those who have a mash tun that can be heated - and the burner is used to heat the mixture and maintain its temperature rather than a hot water addition. Decoction mashing is an advanced technique used primarily in certain continental styles. Brew in a Bag (BIAB) is a relatively new method that lets you mash and brew in a single brew pot (see online articles for BIAB below). Most mash profiles have variants for light, medium and full body profiles. The light body profiles mash at a lower temperature resulting in higher enzyme activity and a cleaner lighter overall profile. Full body profiles mash at a higher temperature resulting in less enzymatic activity and more unfermentable sugars in the finished beer - providing a fuller body to the finished beer. Mash profiles also have the option of "Mash Out" or "No Mash Out". A mash-out step is nothing more than an additional step at the end of the mash to raise the temperature of the overall mash to halt enzymatic activity and increase viscosity when lautering. Unless you are working with a very thick mash (i.e. a lot of Wheat), a mash out is generally not required. New Feature: BeerSmith now has support for Brew-In-A-Bag (BIAB) profiles - a technique where the grains are mashed in the boil kettle lined with a grain bag. BIAB profiles generally have a lower grain absorption rate and also have no sparge step since they use the full boil volume in the mash step.

2013 BeerSmith LLC

Welcome to BeerSmith!

35

See Also: Recipe Design Tab, Recipe Mash Details Tab Online Articles: Infusion Mashing, Mash Steps for All Grain, Partial Mashing, Decoction Mashing, Infusion Mashing and Decoction, Batch Sparging Guide, Brew in a Bag Techniques, Brew in a Bag Podcast

Using the Mash Profile View


o Select the Mash Profile view from the profile menu or ribbon o From here you can add, edit or delete new mash profiles using the large buttons on the ribbon

Creating a New Mash Profile


o o o o o Select the Mash Profile view from the profile menu or ribbon Click on the Add Mash button on the ribbon Give your profile a unique but descriptive name Set your starting grain and tun temperature as well as sparge temperature. In most cases the default are sufficient. Set the grain weight basis - this is a sample grain weight used only for building the mash profile. Once the mash profile is actually used in a recipe this number will be adjusted to match the actual grain weight from the recipe. For most recipes 10 lbs or 4.5 kg is a reasonable starting point. The boiling temperature (212F or 100C) is used only in decoction calculations. If you are creating a new decoction profile, this temperature may need to be adjusted higher as the mash water mixture typically boils a bit above the boiling point of water. The Mash pH is used to record the recommended mash pH for this profile. Add steps to the mash profile by clicking Add Mash Step. You can also edit/delete or reorder steps using the buttons shown The mash dialog also will show a graphical representation of the mash profile Batch sparge options are shown for batch sparging. For optimal results, I recommend setting "Use Equal Batches" when batch sparging. The BIAB/Full boil option will override the water calculations for mashing and set the initial mash steps and subsequent steps so a full boil volume will result from the mash (no sparge water). This is primarily used in Brew-In-A-Bag or No-Sparge mash techniques. The boil volume basis helps you determine approximate values for a given boil volume - it too will be scaled to the actual boil volume when you apply this profile to a recipe.

o o o o o

1.9.4

Carbonation Profiles
A carbonation profile represents a method for carbonating your beer. This could include either adding some kind of sugar when bottling, or kegging using CO2 pressure to carbonate, or kegging with sugar (called natural carbonation). BeerSmith comes pre-loaded with a number of carbonation profiles. Within the recipe design tab you can simply choose any existing carbonation profile and BeerSmith will calculate the correct keg pressure or amount of sugar to use for carbonating your beer. In rare cases you might want to add your own carbonation profile, which you can do from this view. See also: How to Keg your Beer, Beer Bottling Tips, Recipe Design Tab

Using the Carbonation Profile View

2013 BeerSmith LLC

36

BeerSmith 2

o Select the Carbonation Profile view from the profile menu or ribbon o From here you can add, edit or delete new carbonation profiles using the large buttons on the ribbon

Adding a Carbonation Profile


o o o o Select the Mash Profile view from the profile menu or ribbon Select the Add Carbonation button from the ribbon Give your profile a unique name and select the type (bottle, keg or keg with priming agent). If using a sugar for bottling other than corn sugar, adjust the percentage effectiveness of the item relative to corn sugar. Most sugars (except table sugar) are less effective at priming than corn sugar.

1.9.5

Fermentation Profiles
A fermentation profile represents the steps to use when fermenting and aging your beer. Most brewers use a two stage fermentation though a third stage is common for lagers. BeerSmith comes pre-loaded with many of the most common fermentation and aging profiles for ales, lagers and select specialty beers styles. Using any fermentation profile in a recipe is as simple as choosing it within the recipe design tab. You can customize the fermentation profile to a single recipe within the recipe's fermentation tab. See Also: Recipe Design Tab, Fermentation Tab

Using the Fermentation Profile View


o Select the Fermentation Profile view from the profile menu or ribbon o From here you can add, edit or delete new fermentation and aging profiles using the large buttons on the ribbon

Adding a Fermentation Profile


o o o o Select the Fermentation Profile view from the profile menu or ribbon Select the Add Ferm button from the ribbon Give your profile a unique name and select the number of stages to use For each stage, set the length in days and temperature. For the aging stage, you can ramp the temperature (used for many lager profiles) slowly down to the final target temperature.

1.10

Adding Custom Ingredients


BeerSmith 2 comes pre-loaded with many of the most common ingredients you will use for brewing beer. Using these ingredients is as simple as opening a new recipe and selecting the "Add Hops", "Add Grains", etc... buttons within the recipe design tab. You can also manage your inventory of items from within this view. However, occasionally you may find it necessary to add your own ingredients. Fortunately the entire ingredient database is open to you for editing, so you can add or edit ingredients at will. Note that you can import ingredients from others using the Open command, and share your custom ingredients with others using the Export Selected command. When importing, be sure to copy/paste the ingredients you wish to keep into the appropriate ingredient view below. Note: When you use ingredients within a recipe, a complete copy of that ingredient is stored within the recipe so it can be shared with others. Therefore changing a value in your ingredients views (below) will
2013 BeerSmith LLC

Welcome to BeerSmith!

37

only affect future recipes made with that ingredient, and will not alter previously made recipes or recipes you imported from another source.

Using Ingredient Tables


o o o o o Hop Ingredients Grains, Sugars and Extracts Yeast Miscellaneous Ingredients Water

1.10.1 Hops
The Hops view allows you to add or edit the hop database that is available within the recipe design tool for building recipes. From here you can add new varieties of hops, edit the parameters for hops to be used in new recipes, and delete those you don't regularly use. Note: Editing an item in this database will not change existing recipes as each recipe has a complete copy of its ingredients stored internally. Changing an ingredient will only change future recipes made with this ingredient. See Also: Editing Functions for using basic cut, copy, paste and delete functions

Using the Hops View


o Select the Hops view from the ingredient menu or ribbon o From here you can add, edit or delete new hops using the large buttons on the ribbon o You can also adjust inventory by editing the inventory field for this item, and set the price (used for future recipes) using the Set Price button

Adding a New Hop Variety


o Select the Hops view from the ingredient menu or ribbon o Select the Add Hops button to add a new item o The critical parameters for hops are the alpha percentage and form of hops- as both are used to estimate bitterness in a recipe. The hop stability index is important if you use the hop age tool as it is a measure of how well hops of this variety can be stored.

Setting the Price


o Within the ingredient view, select the items you wish to set. You can select multiple items using Ctrl/Command-click and Shift-click on your mouse o Click the Set Price button on the ribbon to set all of the prices at once

1.10.2 Grains and Sugars


The Grains and Sugar view allows you to add or edit the malt grains, extract and sugars database that is available within the recipe design tool for building recipes. From here you can add new varieties of grains and sugars, edit the parameters for items to be used in new recipes, and delete those you don't regularly use. Note: Editing an item in this database will not change existing recipes as each recipe has a complete copy of its ingredients stored internally. Changing an ingredient will only change future recipes made

2013 BeerSmith LLC

38

BeerSmith 2

with this ingredient. See Also: Editing Functions for using basic cut, copy, paste and delete functions

Using the Grains and Sugars View


o Select the Grain view from the ingredient menu or ribbon o From here you can add, edit or delete new items using the large buttons on the ribbon o You can also adjust inventory by editing the inventory field for this item, and set the price (used for future recipes) using the Set Price button

Adding a New Grain or Sugar Item


o o o o Select the Grain view from the ingredient menu or ribbon Select the Add Grain button to add a new item You can add new grains, sugars, liquid extract or dry extract by adjusting the type The critical parameters for grains/extracts/sugars are the type, color and potential fields as these are used in recipes to estimate the recipe color and original/final gravity.

Setting the Price


o Within the ingredient view, select the items you wish to set. You can select multiple items using Ctrl/Command-click and Shift-click on your mouse o Click the Set Price button on the ribbon to set all of the prices at once

1.10.3 Yeast
The Yeast view allows you to add or edit the yeast database that is available within the recipe design tool for building recipes. From here you can add new varieties of yeasts, edit the parameters for items to be used in new recipes, and delete those you don't regularly use. Note: Editing an item in this database will not change existing recipes as each recipe has a complete copy of its ingredients stored internally. Changing an ingredient will only change future recipes made with this ingredient. See Also: Editing Functions for using basic cut, copy, paste and delete functions Online Articles: Yeast Starters Part 1, Yeast Starters Part 2, Making a Yeast Starter, Beer Yeast and Fermentation, Chris White Podcast, Chris White Interview

Using the Yeast View


o Select the Yeast view from the ingredient menu or ribbon o From here you can add, edit or delete new items using the large buttons on the ribbon o You can also adjust inventory by editing the inventory field for this item, and set the price (used for future recipes) using the Set Price button

Adding a New Yeast Item


o Select the Yeast view from the ingredient menu or ribbon o Select the Add Yeast button to add a new hop o You can add new grains, sugars, liquid extract or dry extract by adjusting the type
2013 BeerSmith LLC

Welcome to BeerSmith!

39

o The critical parameters for yeast include the type, form and attenuation - as these are used to estimate the viability of the yeast and also in estimating the final gravity for a recipe. The cells per pack is also important if you use this yeast with the yeast starter tab of yeast starter tool, as it is a measure of the number of cells in a fresh yeast pack. Typically large smack packs and vials from Wyeast or White labs contain a bit over 100 billion cells while small packs contain only 20 billion cells. Large 11.5 gram dry yeast packs contain approximately 200 billion cells and smaller 5.5g dry yeast packets contain about half that amount (100 billion cells).

Setting the Price


o Within the ingredient view, select the items you wish to set. You can select multiple items using Ctrl/Command-click and Shift-click on your mouse o Click the Set Price button on the ribbon to set all of the prices at once

1.10.4 Miscellaneous Ingredients


The Miscellaneous Ingredient view allows you to add or edit the miscellaneous ingredient database that is available within the recipe design tool for building recipes. From here you can add new miscellaneous ingredients, edit the parameters for items to be used in new recipes, and delete those you don't regularly use. Note: Editing an item in this database will not change existing recipes as each recipe has a complete copy of its ingredients stored internally. Changing an ingredient will only change future recipes made with this ingredient. See Also: Editing Functions for using basic cut, copy, paste and delete functions

Using the Miscellaneous View


o Select the Miscellaneous view from the ingredient menu or ribbon o From here you can add, edit or delete new items using the large buttons on the ribbon o You can also adjust inventory by editing the inventory field for this item, and set the price (used for future recipes) using the Set Price button

Adding a New Miscellaneous Item


o o o o Select the Miscellaneous view from the ingredient menu or ribbon Select the Add Misc button to add a new item You can add new grains, sugars, liquid extract or dry extract by adjusting the type The critical parameters for miscellaneous ingredients include the type, amount recommended per batch and use for the ingredient. The amount recommended is typically scaled by the batch size when adding this ingredient to a new recipe - so it is important to set a recommended amount here. The use determines where in the brewing process this ingredient will be added and how it will be displayed on the brew steps report.

Setting the Price


o Within the ingredient view, select the items you wish to set. You can select multiple items using Ctrl/Command-click and Shift-click on your mouse o Click the Set Price button on the ribbon to set all of the prices at once

2013 BeerSmith LLC

40

BeerSmith 2

1.10.5 Water
The Water view allows you to add or edit the water database that is available within the recipe design tool for building recipes. From here you can add new water profiles, edit the parameters for waters to be used in new recipes, and delete those you don't regularly use. Note: Editing an item in this database will not change existing recipes as each recipe has a complete copy of its ingredients stored internally. Changing an ingredient will only change future recipes made with this ingredient. See Also: Editing Functions for using basic cut, copy, paste and delete functions Online Articles: Understanding Brewing Water, Mash pH - Water Treatment for Brewing

Using the Water View


o Select the Water view from the ingredient menu or ribbon o From here you can add, edit or delete new water using the large buttons on the ribbon o You can also adjust inventory by editing the inventory field for this item, and set the price (used for future recipes) using the Set Price button

Adding a New Water Type


Select the Water view from the ingredient menu or ribbon Select the Add Water button to add a new item The critical parameters for water profiles are the mineral profiles. If you add water additions (gypsum, table salt, etc...), you will be asked whether you wish to add these additions when adding this water profile to a new recipe. o See the Water Profile Tool for more information on how to calculate and use water additions and profiles o o o o

1.11

The BeerSmith Cloud


The BeerSmith recipe cloud is a new internet based recipe sharing service that is tightly integrated with BeerSmith 2.1. In BeerSmith 2.1 a new "Cloud View" has been added for storing recipes. Recipes added to this cloud folder are not stored on your local machine but are instead stored on the BeerSmithRecipes.com web site and accessed via an active internet connection. The cloud view provides three services: It lets you share a set of recipes in the cloud folder across multiple computers and synch them easily You can mark a recipe as shared, in which case it will now be available publicly on the BeerSmithRecipes.com web server, forming a large active database of BeerSmith recipes for the home brewing community. You can also go to BeerSmithRecipes.com and find recipes you like. These can be downloaded or saved to your cloud folder for easy access in BeerSmith.

Getting Started with the BeerSmith Cloud


o You first need to register for an account at BeerSmithRecipes.com o After registering you can go to Cloud on the View menu or ribbon and use your login to access

2013 BeerSmith LLC

Welcome to BeerSmith!

41

your cloud folder. You will need an active internet connection. o Now you can copy/paste recipes into the cloud folder as needed, or right click on any BeerSmith recipe you've created and use the Copy to Cloud Folder command

Sharing Cloud Recipes


o From within the BeerSmith program, open the cloud view and use the large Shared/Private button to mark a recipe as private or shared. o By default all new recipes are private and only visible to you o Sharing a recipe makes it public so it can be viewed and downloaded by anyone visiting the BeerSmithRecipes.com web site

Synchronizing Recipes Across Machines


o If you log into the same user account from two different machines, you will see the same recipes in your cloud folder. o If you add a new recipe or edit one on one machine, it will be uploaded to the cloud folder immediately o You can check for new recipes on the server using the Synch button on the ribbon from your cloud folder at any time. o The program will automatically synchronize every 12 minutes or so - but you can adjust the time in the Cloud Options dialog.

Finding, Sharing, and Reviewing Recipes on BeerSmithRecipes.com


o The web site at BeerSmithRecipes.com is a giant searchable database of BeerSmith recipes contributed by other home brewers. If you log into this web site you can search for recipes, view your existing cloud folder recipes, download recipes, comment on and review recipes, follow friends and much more. o For more information on BeerSmithRecipes.com, please view this help topic.

1.11.1 BeerSmithRecipes.com
The cloud service in BeerSmith 2.1 and higher is hosted on the web site BeerSmithRecipes.com. Using this feature, you can copy recipes to your cloud folder and they will appear on your BeerSmithRecipes. com account. The cloud folder gives you a shared set of recipes that can be accessed via your account from any computer running BeerSmith. It also lets you publish recipes as shared so anyone can access it. See Also: The BeerSmith Cloud

Getting Started with BeerSmithRecipes.com


o You first need to register for an account at BeerSmithRecipes.com o Use the Register button on the web site to register for a new account. You will need an active email address. o After registering a confirmation code and link will be sent to your email address. You will need to use this code and link to activate your account. o Once you have activated your account you can log into your account at any time using your user name and password

2013 BeerSmith LLC

42

BeerSmith 2

Adding Recipes to Your Account


o Open BeerSmith 2 and click on the Cloud icon on the View menu or ribbon o When prompted, use the user name and password you established above to log into your cloud folder o Once you are logged in you can Copy/Paste recipes between the cloud folder and your My Recipes folders. o You can also right click on any normal recipe and use the Copy to Cloud Folder command to copy recipes to your cloud folder o Recipes added to your cloud folder will instantly appear in your Recipes folder online if you log into BeerSmithRecipes.com from any web browser.

Sharing Recipes
o Newly added recipes in your cloud folder are private by default. To share them with others you can use the Shared/Private icon on the ribbon from within BeerSmith. A shared recipe is public and can be found and downloaded by anyone. o You can also log into your online BeerSmithRecipes.com account and share recipes from there using the Mark as Private/Mark as Shared links

Upgrading your Cloud Storage


o The default basic account only allows space for 10 recipes in the cloud folder. o You can upgrade your account to a higher level of membership at any time by logging into your account on BeerSmithRecipes.com and using the Upgrade button on the main menu. o Due to the costs of maintaining the server, bandwidth, etc, the service is subscription based with most subscriptions lasting a year.

Finding Recipes Online


o You can search the extensive database of shared recipes by visiting BeerSmithRecipes.com and using the search feature o When you find recipes of interest, you can Bookmark them using the Bookmark link. o Later you can Download or create private copies of the recipe in your cloud folder for use in BeerSmith.

Reviewing Recipes
o If you are logged in to the BeerSmithRecipes.com web site you can review recipes and add your comments to each review.

Managing Your Profile


o Use the Profile menu item to edit your user profile. Here you can enter your real name (if desired), tagline, location, club, and website. By default your profile is PUBLIC information, except for your email which is not shared. o You can also manage Notifications here. By default you will receive emails when someone posts a comment on your recipe, sends a message to you, or follows you. o You can set up a gravitar by clicking on the Add Gravitar button. The site uses the gravitar system for storing avatar images, In order for your gravatar to show up on the web site it is important that you use the same email address when registering your gravitar that you used when registering for BeerSmithRecipes.com o You can also set the Units (Metric or English) used to display recipes from your profile page.

2013 BeerSmith LLC

Welcome to BeerSmith!

43

Following Other Brewers


o You can search for fellow brewers by email address, name or user name using the Find Friends button on the main page just below the main search box. o If you have friends on the site, you can follow them using the Follow User button. This lets you see when they add new comments or post new recipes to the site. o You can see a list of all of the latest events related to your friends from the Friends main menu item.

Posting to Your Wall


o Each user has a Wall for comments and links available from the Wall menu item online. o You can leave comments on your own wall or post to another's wall.

Private Messaging
o BeerSmithRecipes.com also has a simple private messaging system. You can go to your inbox and send messages to other friends from there. o You can decide not to receive private messages using the Notifications section of your Profile.

1.12

Importing and Exporting Files


BeerSmith 2 supports three different file formats - allowing you to exchange recipes and data with a variety of brewers, even those who don't have the latest version of BeerSmith. These file formats include: BeerSmith 2 files, which have a (*.bsmx) file extension, BeerSmith 1.X files compatible with earlier versions of BeerSmith, which have a (*.bsm) file extension and BeerXML format files (*.xml extension) - an open format supported by many other brewing programs. Note: When importing new data that you wish to make part of your permanent record, it is important that you copy and paste any items you want to permanently keep into your "My Recipes" folder of the ingredients or profile views so it will be permanently stored when you next open BeerSmith. New Feature: BeerSmith 2 uses a new XML based format with a "*.BSMX" extension which allows significantly more flexibility and expanded features over the BeerSmith 1.x binary file format. BeerSmith 2.0 can read and write both formats for compatibility with users of the earlier version.

Importing and Exporting File Topics


o o o o Using The Import Wizard Opening a file Exporting all items in a view Exporting selected items in a view

1.12.1 Using the Import Wizard


On the PC/Windows version of BeerSmith only, you have the option of using the import wizard to import your recipes, equipment and matching inventory from an existing version of BeerSmith on the same machine. The wizard runs when you first install BeerSmith 2, but you can also run it later by selecting Import Wizard from the File menu.

2013 BeerSmith LLC

44

BeerSmith 2

The import wizard attempts to find your existing BeerSmith installation, and shows you the newest matching directory found (if any) to import your files from. If no directory is found you are also offered the option to select a directory to import from. BeerSmith is looking for the BeerSmith 1.4 directory containing your Recipes.bsm file. Once you have selected the directory to import, BeerSmith 2 will import all of your existing recipes, except for the samples directory, as well as your equipment profiles. It will also attempt to import any matching inventory. If items are found that do not match your BeerSmith 2 ingredients, the program will show you how many unmatched inventory items were found. Note : You can also manually import items from BeerSmith 1 including mash profiles, and custom ingredients. See Opening a File or the Video below for information on how to do this. See Also: Opening a File Online Articles: Video on Importing Items from BeerSmith 1.X

Using the Import Wizard


o o o o Select Import Wizard from the File menu. BeerSmith 2 will attempt to locate your BeerSmith 1 directory and show the location it has found. If desired you can specify a separate directory to import from. BeerSmith will import your recipes and equipment from the location found.

1.12.2 Opening a File


BeerSmith 2 supports three different file formats - allowing you to exchange recipes and data with a variety of brewers, even those who don't have the latest version of BeerSmith. These file formats include: BeerSmith 2 files, which have a (*.bsmx) file extension, BeerSmith 1.X files compatible with earlier versions of BeerSmith, which have a (*.bsm) file extension and BeerXML format files (*.xml extension) - an open format supported by many other brewing programs.

Opening a BeerSmith 2 File (*.BSMX)


o Select the Open command from the file menu or toolbar. o Navigate to the file you wish to open - all BeerSmith 2 files use a proprietary XML format with the extension (.bsmx) such as "Recipes.bsmx" o Press OK to open the file o The file you just opened will be displayed in a separate tab with the file name as the title for the tab. When you close this tab you will be asked if you want to save the items in this file. o To permanently keep items in the open file, you need to copy and paste them into your "My Recipes" folder or one of the Ingredients or Profiles folders for future use.

Opening a BeerSmith 1.X File (*.BSM)


o Select the Open command from the file menu or toolbar. o Select "BeerSmith 1.x Files (*.bsm)" from the file type drop-down in the open file dialog box - this will show only BeerSmith 1.x files with a BSM extension. o Navigate to the file you wish to open - all BeerSmith 1 files use a proprietary binary format with the extension (.bsm) such as "Recipes.bsm" o Press OK to open the file o The file you just opened will be displayed in a separate tab with the file name as the title for the tab.

2013 BeerSmith LLC

Welcome to BeerSmith!

45

When you close this tab you will be asked if you want to save the items in this file. o To permanently keep items in the open file, you need to copy and paste them into your "My Recipes" folder or one of the Ingredients or Profiles folders for future use.

Opening a BeerXML File (*.XML)


o Select the Open command from the file menu or toolbar. o Select "BeerXML Files (*.xml)" from the file type drop-down in the open file dialog box - this will show only BeerXML files with a *.xml file name o Navigate to the file you wish to open - all BeerXML files use an open XML format described at BeerXML.com and used by many other brewing programs o Press OK to open the file o The file you just opened will be displayed in a separate tab with the file name as the title for the tab. When you close this tab you will be asked if you want to save the items in this file. o To permanently keep items in the open file, you need to copy and paste them into your "My Recipes" folder or one of the Ingredients or Profiles folders for future use.

1.12.3 Export All


The Export All command exports all of the items in the current view or folder to a file which you can email or share with other brewers. BeerSmith 2 supports three different file formats - allowing you to exchange recipes and data with a variety of brewers, even those who don't have the latest version of BeerSmith. These file formats include: BeerSmith 2 files, which have a (*.bsmx) file extension, BeerSmith 1.X files compatible with earlier versions of BeerSmith, which have a (*.bsm) file extension and BeerXML format files (*.xml extension) - an open format supported by many other brewing programs. Note : At this time the BeerXML export is not yet complete, though we hope to have it ready as an update to BeerSmith 2 shortly.

Saving to a BeerSmith 2 File (*.BSMX)


o o o o Select the Export All command from the file menu or toolbar. Navigate to the directory you wish to save to, and give the file a name such as "Recipes.bsmx" Press OK to save the file All of the items in the current view will be saved to that file, which you can email or transfer to a friend or second computer for importing.

Saving to a BeerSmith 1.X File (*.BSM)


o Saving to a BeerSmith 1.x format lets you exchange recipes and data with those who have the earlier version of BeerSmith o Select the Export All command from the file menu or toolbar. o Select the type "BeerSmith 1.x (*.bsm)" in the drop-down within the open file dialog to set the correct file type o Navigate to the directory you wish to save to, and give the file a name with a bsm extension such as "Recipes.bsm" o Press OK to save the file o All of the items in the current view will be saved to that file, which you can email or transfer to a friend or second computer for importing.

2013 BeerSmith LLC

46

BeerSmith 2

Saving to a BeerXML File (*.XML)


o NOTE: Exporting to BeerXML is currently not implemented but is expected to be available in an update shortly o Select the Export All command from the file menu or toolbar. o Select the type "BeerXML (*.xml)" in the drop-down within the open file dialog to set the correct file type o Navigate to the directory you wish to save to, and give the file a name with a xml extension such as "Recipes.xml" o Press OK to save the file o All of the items in the current view will be saved to that file, which you can email or transfer to a friend or second computer for importing.

1.12.4 Export Selected Items


The Export Selected Items command exports only the items you have selected in the current view. Note that you can select multiple items by Control-clicking or Shift-clicking on items (hold down the shift or control keys on the keyboard when selecting items). Control-clicking adds individual items, while shiftclicking can be used to select a range of items. BeerSmith 2 supports three different file formats - allowing you to exchange recipes and data with a variety of brewers, even those who don't have the latest version of BeerSmith. These file formats include: BeerSmith 2 files, which have a (*.bsmx) file extension, BeerSmith 1.X files compatible with earlier versions of BeerSmith, which have a (*.bsm) file extension and BeerXML format files (*.xml extension) - an open format supported by many other brewing programs. Note : At this time the BeerXML export is not yet complete, though we hope to have it ready as an update to BeerSmith 2 shortly.

Saving to a BeerSmith 2 File (*.BSMX)


o o o o o Select the items you want to export - by clicking on them, shift-clicking or control-clicking Select the Export All command from the file menu or toolbar. Navigate to the directory you wish to save to, and give the file a name such as "Recipes.bsmx" Press OK to save the file All of the items in the current view will be saved to that file, which you can email or transfer to a friend or second computer for importing.

Saving to a BeerSmith 1.X File (*.BSM)


o Select the items you want to export - by clicking on them, shift-clicking or control-clicking o Saving to a BeerSmith 1.x format lets you exchange recipes and data with those who have the earlier version of BeerSmith o Select the Export All command from the file menu or toolbar. o Select the type "BeerSmith 1.x (*.bsm)" in the drop-down within the open file dialog to set the correct file type o Navigate to the directory you wish to save to, and give the file a name with a bsm extension such as "Recipes.bsm" o Press OK to save the file o All of the items in the current view will be saved to that file, which you can email or transfer to a friend or second computer for importing.

2013 BeerSmith LLC

Welcome to BeerSmith!

47

Saving to a BeerXML File (*.XML)


o Select the items you want to export - by clicking on them, shift-clicking or control-clicking o NOTE: Exporting to BeerXML is currently not implemented but is expected to be available in an update shortly o Select the Export All command from the file menu or toolbar. o Select the type "BeerXML (*.xml)" in the drop-down within the open file dialog to set the correct file type o Navigate to the directory you wish to save to, and give the file a name with a xml extension such as "Recipes.xml" o Press OK to save the file o All of the items in the current view will be saved to that file, which you can email or transfer to a friend or second computer for importing.

1.13

Calendar and Notes


The calendar and notes features give you a chance to schedule events and brewing of recipes so you can keep track of key milestones such as racking from the primary to secondary fermenter and bottling your beer.

Notes and Calendar View Topics


o Notes View o Calendar View

1.13.1 Notes
The notes view lets you keep short notes, items to-do or track events related to your brewing. Events and to-do items are also displayed on the appropriate date on the brewing calendar.

Viewing Your Notes


o Select the Notes command on the View menu. o From here you can edit and manage your notes.

Adding and Editing Notes


Select the Notes command on the View menu. Select the Add Note button on the ribbon Enter the name of the note and a short description Select the type of note: A regular note has no end date. Events and tasks have specific end-dates and will be displayed on the calendar. o If appropriate enter the start and end dates for the task or event. o As needed you can add additional text in the Notes section o Press OK to save your note o o o o

1.13.2 Calendar
The calendar can be used for brewing planning. It displays your recipes and notes in a simple monthly calendar format so you can schedule events and brewing sessions as well as remind yourself of critical events such as racking the beer during fermentation or bottling.

2013 BeerSmith LLC

48

BeerSmith 2

Viewing The Calendar


o Select the Calendar command on the View menu. o From here you can edit and manage your calendar.

Working with the Calendar


o When you first open the calendar it will show the current month. You can change the month or year using the buttons on the toolbar or ribbon. Selecting the today button will move back to the current month. o If you add a note that is a task or event its start and end date will be displayed on the calendar o If you add a recipe, its key dates will also be shown including the brewing date, key fermentation dates and bottling date o You can edit an item on the calendar by double clicking on it o If a day has more than one item, a small number with a circle around it will be displayed in the upper right corner for that day o If you click on a given day's title, a popup menu will show all of the events for that day, even if there are too many to display in the current screen format or size o If you select any of the items in the popup menu, or double click on an item in the calendar it will open that item for editing.

1.14

Brewing Tools
BeerSmith has a significant number of brewing tools available for the home brewer for performing simple and common brewing calculations. These include common mash calculations, refractometer and hydrometer calculations, and tools for managing yeast starters and water profiles. For more details on the tools available click on the links below. See Also: Unit Conversion Tools

Brewing Tools Available


o o o o o o o o o o o o o o o Water Profiler Infusion Tool Decoction Tool Mash Adjustment Tool Yeast Starter Tool Hydrometer Temperature Tool Refractometer Tool Percent Alcohol Tool Hop Bitterness Tool Hop Age Tool Boil Off Tool Water Needed Tool Dilution Tool Weight-Volume Tool Carbonation Tool

1.14.1 Water Profiler


The Water Profile Tool (Tools Ribbon) can be used to match specific brewing water profiles from around the world. This is important, particularly for all grain brewers who would like to match a particular water
2013 BeerSmith LLC

Welcome to BeerSmith!

49

profile during the mash to achieve a certain flavor or bitterness profile. New Feature: BeerSmith now includes a Calculate Best Additions button that automatically finds the best water additions to match your base and target water profile. It does this using a "best fit" linear programming model. Online Articles: Understanding Brewing Water, Mash pH - Water Treatment for Brewing

How to Use the Water Profiler


o Select the Water Profile tool from the Tools menu or ribbon. o Select the water you are targeting using the Target Profile button o Select the water you are starting with, such as your local water profile using the Base Profile button and enter the volume of water used o Click on the Calculate Best Additions button to find the best additions possible to match your base profile to your water profile o Optionally, you can also use the Dilute With button to add a volume of water to dilute the base water profile. This is useful, for example, if you want to use distilled or bottled water to reduce the ion content of your base water to match a given profile. o If you click on Save Totals you can save the total ions shown as a new water profile. o If you click on Save Additions to Target you can save the water additions to the target water profile so they will be used in a recipe if you add that target water profile to a recipe in the future.

Understanding The Tool


o The tool is displayed as a table. The columns in the table represent the various ions present in the water profile (Ca for Calcium, Mg for Magnesium, Na for Sodium, SO4 for Sulfate, Cl for Chloride and HCO3 for bicarbonate). o The rows from top to bottom show the base water profile, effect of various water additions (such as Gypsum and Chalk), the water you are duliting with (if applicable), and the totals for your base water, plus additions and the dilution. o The bottom two rows show the water profile you are targeting, and the difference between the total water profile you have created and the target. In most cases there will be a difference shown, even after Calculate Best Additions is pressed because a precise match is not always possible. o If you find a large positive difference in a column after calculating the best additions, you should consider diluting the mix with distilled water, as likely your base water has too high a concentration of that ion. o For additional information, consider reading the articles referenced above or visiting our online forum.

1.14.2 Infusion Tool


The infusion tool can determine the appropriate strike or infusion water temperature to use when mashing your grains for all grain or partial mash brewing. An infusion is nothing more than hot water mixed with grains during the mash to achieve a given temperature for the mixture. Online Articles: Infusion Mashing, Mash Steps for All Grain, Partial Mashing

Using the Infusion Tool


o Select the Infusion Tool from the Tools menu or ribbon. o Select Initial Strike if this is the first step (called a strike) in your mash, or Infusion Step if this is a later mash step o Enter your target step temperature, and how much water you are adding for this step

2013 BeerSmith LLC

50

BeerSmith 2

o Enter the starting conditions for your mash including the starting water volume (if this is not your first step), initial mash temperature (or room temperature if this is your first step) and the total weight of the grain you are mashing. o If you want to also adjust for equipment - include a non-zero mash tun weight and mash tun specific heat. Note that the mash tun specific heat is generally between 0.2 and 0.5, with all metal mash tuns being on the low end and plastic insulated mash tuns being on the high end of that range. o The tool will show you the temperature of water to add, as well as the mash tun volume needed and water to grain ratio for the mash.

1.14.3 Decoction Tool


In decoction mashing, a portion of the water and grain mixture in the mash is boiled in a separate pot and then added back to the mash to raise the temperature during steps in the mash. The decoction tool is a calculator to help determine how much mixture you need to remove and boil for each step. Note that most decoction profiles start with an infusion step which brings the mash to the first step temperature, and then decoction methods are used after that to achieve follow-on steps. Online Articles: Decoction Mashing, Infusion Mashing and Decoction

Using the Decoction Tool


o Select the Decoction Tool from the Tools menu or ribbon. o Enter the target step temperature for the next step in your mash profile o Enter the starting conditions for your mash including the starting water volume and the total weight of the grain you are mashing. o Enter the starting mash temperature, which is usually the temperature of the current step in your mash o If you want to also adjust for equipment - include a non-zero mash tun weight and mash tun specific heat. Note that the mash tun specific heat is generally between 0.2 and 0.5, with all metal mash tuns being on the low end and plastic insulated mash tuns being on the high end of that range. o Enter the temperature at which your decoction boils. Due to altitude variations, and also the fact that the mash is a mixture of water and grain, often the decoction will boil at a temperature slightly above the boiling point of water (which is 212F or 100C). o The tool will show the volume of water and grain mixture than needs to be decocted (removed and boiled) to achieve the next step o It will also show the water to grain ratio of the current mash step

1.14.4 Mash Adjustment Tool


The mash adjustment tool is used when brewing to adjust the temperature of the mash if it happens to be off by a little bit. By adding cold water or hot water to the mash you can bring your mash back to its target temperature. Online Articles: Infusion Mashing, Mash Steps for All Grain, Partial Mashing

Using the Mash Adjustment Tool


o Select the Mash Adjustment Tool from the Tools menu or ribbon. o Enter your target step temperature - the temperature you want to hit o Enter the starting conditions for your mash including the starting water volume, amount of grain currently in the mash and your starting temperature for the grain. The starting temperature is the measured temperature of the mash before we adjust it. o If you want to also adjust for equipment - include a non-zero mash tun weight and mash tun specific
2013 BeerSmith LLC

Welcome to BeerSmith!

51

heat. Note that the mash tun specific heat is generally between 0.2 and 0.5, with all metal mash tuns being on the low end and plastic insulated mash tuns being on the high end of that range. o In the bottom section, enter the temperature of the water you are adding. If you want to lower your mash temperature, use chilled or cold water. Raising the mash temperature is best done with hot or boiling water. o The tool will show you how much water to add to achieve your target temperature as well as the final water to grain ratio.

1.14.5 Yeast Starter Tool


The yeast starter tool lets you determine the size of yeast starter to use for a batch of beer. Pitching the correct number of cells in a batch of yeast is important as it optimizes fermentation and reduces the chance of off-flavors or incomplete fermentation. Yeast starters are typically made from liquid yeast packages to increase the number of viable cells before pitching your yeast into the wort at the start of fermentation. Yeast starters are rarely required when using dry yeast or slurry. Dry yeast is simply hydrated using a small amount of warm water about 30 minutes before pitching. Slurry is typically harvested in sufficient quantity for reuse. Note that the pitching rates and internal values used by this calculator can be adjusted in the Options Dialog Yeast Tab. Also, you can perform starter calculations within a recipe using the Yeast Starter Tab within a recipe. New Feature: The yeast starter is entirely new in BeerSmith 2.0 Online Articles: Yeast Starters Part 1, Yeast Starters Part 2, Making a Yeast Starter, Beer Yeast and Fermentation, Chris White Podcast, Chris White Interview

Using the Yeast Starter Tool


o Select the Yeast Starter Tool from the Tools menu or ribbon. o Enter the properties of your target batch of beer including the type, volume (into the fermenter) and original gravity. This will determine the number of yeast cells needed for this batch of beer. Note you can adjust the pitch rates for different types of beer in the Options Dialog Yeast Tab. o Since yeast cells do die off (lose viability) with age, you can include the age of your yeast in the calculation. Check the "Estimate viability from age" to determine the percent of viable cells and include it in the calculation. o For viability, enter the yeast form and its production date (or harvest date if using slurry). This will determine the remaining viability of the yeast pack as of today's date. The viability rates can also be adjusted from the Options Dialog Yeast Tab.

For a Liquid Yeast Starter


o If using liquid yeast, enter the starter pack cell count. The large Wyeast and White labs vials/ smack packs have about 100 billion viable cells each, while the small Wyeast packs have only about 20 billion cells each. o Using a stir plate when growing your starter can significantly reduce the size needed. Check this box if using a stir plate o The tool will display the number of yeast packs needed and also the starter size needed. It will also show the number of packs that would be needed if you don't use a starter at all.

For Dry Yeast


2013 BeerSmith LLC

52

BeerSmith 2

o Dry yeast does not generally require a starter - instead the appropriate number of dry yeast packs are hydrated about 30 minutes before use o The tool will display the number of packs needed (most homebrew yeast packs are 11 to 11.5 grams each). o It will also show you the volume of warm water needed to hydrate your yeast.

For Yeast Slurry


o Yeast slurry is typically collected from an already fermented batch of beer and used within a few days for a follow-on batch. It is not used with a starter. o The tool will show the volume of thick yeast slurry needed for the target batch. o Note that yeast slurry loses its viability rapidly - and must generally be used within a few days of collection

1.14.6 Hydrometer Temperature Tool


The hydrometer temperature tool is a very simple tool to calculate the true hydrometer reading from a sample taken at higher/lower temperatures. All hydrometers are calibrated at standard temperature (typically 60F or 15C). However measurements taken far from standard temperature, such as measuring hot wort during mashing, must be adjusted to compensate for temperature. This tool performs that calculation. Online Articles: Using a Hydrometer for Brewing Beer, Calibrating your Equipment

Using the Hydrometer Temperature Tool


o o o o o Select the Hydrometer Temperature Tool from the Tools menu or ribbon. Enter the measured gravity for your sample - as taken directly from your hydrometer Enter the temperature at which your sample was taken The tool will show the corrected specific gravity at the bottom In general you should not need to change the calibration temperature for your hydrometer. Most brewing hydrometers are calibrated at 60F or 15C. However some rare laboratory hydrometers are calibrated at different temperatures. In most cases the calibration temperature is shown on the scale of the hydrometer in small letters. If needed, set this value to match your hydrometer.

1.14.7 Refractometer Tool


Refractometers available for home use are typically calibrated to measure the amount of table sugar (sucrose) in a sample of water. The primary sugar in barley beer is maltose and not sucrose, so the readings made using a refractometer must be adjusted before use. This tool makes those adjustments to provide an accurate gravity reading from a given sample. If this is your first time using a refractometer, I strongly suggest you read my article on refractometer use , and also take time to calibrate your refractometer before use. Online Articles: Using a Refractometer for Beer Brewing

Using the Refractometer Tool


o Select the Refractometer Tool from the Tools menu or ribbon. o If you have not already done so - please calibrate your refractometer using the "Calibrate Refractometer button and Refractometer Calibration Options o Select the calculation to perform (see below)

2013 BeerSmith LLC

Welcome to BeerSmith!

53

Calculating the Unfermented Wort Gravity


The unfermented wort gravity calculator is intended to be used before you have started fermentation either to measure the gravity of wort in the boiler or mash or to measure the original gravity of your wort before you add yeast. o Select "Unfermented wort gravity" as the calculation o Enter the refractometer reading for the unfermented wort (at room temperature - cool the sample before measuring) o The corrected specific gravity will be displayed

Calculating the Gravity of Fermenting Wort


This calculation is used once fermentation has started or can also be used at the end of fermentation to get the final gravity. You need to have both the original gravity (taken before fermentation started) and a current refractometer reading to get an accurate gravity during fermentation. o Select "Fermenting wort gravity" as the calculation o Enter the refractometer reading for the fermenting wort (at room temperature - cool the sample before measuring) o Enter the original gravity reading - taken before fermentation was started o The corrected specific gravity will be displayed

Backing Out the Original Gravity of a Finished Beer


This calculation, though rarely used, can actually estimate the original gravity of the beer using a final gravity measurement taken with both a refractometer and hydrometer. It is useful if you forgot to measure the original gravity up front. o Select "Fermenting wort gravity" as the calculation o Enter the refractometer reading for the finished beer (at room temperature - cool the sample before measuring) o Enter the hydrometer reading for the finished beer o The estimated original gravity will be displayed under "Corrected gravity"

1.14.8 Percent Alcohol Tool


The alcohol and attenuation tool calculates a variety of fermentation statistics based on the original gravity and final gravity of a beer. These include the apparent and real attenuation for the yeast (what percent of sugars fermented), the alcohol percentages (by volume and by weight) and the estimated number of calories in the beer. Online Articles: Apparent and Real Attenuation Part 1, Part 2

Using the Alcohol and Attenuation Tool


o Select the Alcohol and Attenuation Tool from the Tools menu or ribbon. o Enter the original gravity and final gravity as measured for your beer. o The OE, AE and RE values show your original, apparent and real extract in degrees plato - figures often used by professional brewers. o The alcohol percentage will be shown (by volume and by weight) o The degree of attenuation (percent of sugars fermented) is shown - both apparent and real attenuation o The estimated number of calories (total and from alcohol) is displayed

2013 BeerSmith LLC

54

BeerSmith 2

1.14.9 Hop Bitterness Tool


The hop bitterness tool can be used to estimate the number of International Bitterness Units (IBUs or bitterness) for a given set of hop additions. It is a standalone tool - as these calculations are also built into the recipe calculator. IBUs is the primary measurement used by home and professional beers to determine the balance and hoppiness of beer. Online Articles: Calculating Hop Bitterness, Best Hop Techniques, Balancing your Beer Bitterness, Glenn Tinseth Interview

Using the Hop Bitterness Tool


Select the Hop Bitterness Tool from the Tools menu or ribbon. Enter the batch volume, which is the target volume of beer going into the fermenter Enter your boil volume (start of boil) and boil gravity (start of boil) Select the equation you wish to use - most all grain brewers use Tinseth, but many extract brewers also use Rager. o Choose the hops you wish to add, the amount and how long to boil each using the Add/Edit/Delete buttons o The total IBUs will be displayed o The number of Alpha Acid Units (AAUs) is also displayed. This number is generally less accurate than the IBU number, and should only be used as a cross reference if using older home brewing books. o o o o

1.14.10 Hop Age Tool


As they age, hops lose some of their viability and bitterness. The hop age tool calculates the loss in alpha (bitterness) percentage as a function of time for various storage conditions. If you are not working with fresh hops, it is a good idea to calculate the hop bitterness loss for each of the hop additions in your recipe. In general, you should consider getting new hops after aging has reduced the hop alpha to 50% of its original value or less. Online Articles: Hop Storage and Aging, Balancing your Beer Bitterness

Using the Hop Age Tool


o Select the Hop Age Tool from the Tools menu or ribbon. o Choose a hops from the database or enter the hop name, alpha and hop storage index. The hop storage index is the percent of hops lost in 6 months of storage at a constant temperature of 68 F (20 C). o Enter the age of the hops and storage temperature, along with the storage method. If possible, hops should always be stored in a oxygen barrier container such as a foil pouch or glass jar to minimize exposure to oxygen. o The tool will display the adjusted alpha value - which can be used in a recipe or the IBU calculator to account for lower bitterness due to aging.

1.14.11 Boil Off Tool


The boil off tool is used to calculate evaporation and shrinkage losses given a particular evaporation rate and shrinkage rate. During the boil, typically 10-15% of the water in the wort is evaporated or boiled off for a typical 90 minute boil. In addition, after boiling, the water will lose approximately 4% due to shrinkage.

2013 BeerSmith LLC

Welcome to BeerSmith!

55

Using the Boil Off Tool


o Select the Boil off Tool from the Tools menu or ribbon o Enter your start of boil volume and gravity o Enter the evaporation rate for the boil, shrinkage rate and the amount of time to boil. If you don't know your evaporation rate, it can easily be calculated as ((post_boil_vol / pre_boil_vol) - 1.0) times 100 (which gives you a percentage) o The tool will calculate the volume boiled off, evaportation rate per hour as well as the post boil volume and post boil gravity o If you enter the shrinkage rate, it will also show you the shrinkage loss and factor that into the overall calculation

1.14.12 Water Needed Tool


The water needed tool closely matches the internal calculations used for estimating water needed within a recipe. To use the water needed tool, you need to enter many of the same details contained an equipment profile.

Using the Water Needed Tool


o Select the Water Needed Tool from the Tools menu or ribbon. o At the top select the brew type - if doing an extract brew the mash portion of this dialog will be greyed out as you don't need to mash for an extract beer. o Below the brew type, the total water needed for brewing the beer is displayed o In the Mash section, you can enter the mash water volume (amount you are adding during the mash), total grain weight, lauter tun deadspace and top up water for the kettle. The calculator will show the amount of water absorbed by the grain (grain absorption) and the total sparge water needed. o For boil and fermentation, enter you boil losses (for evaporation), losses to trub/chiller, cooling loss (typically 4%), top up water and volume into the fermenter. You can also include fermentation losses if desired. o The calculator will show your start of boil volume, boil off percentage, cooling losses and volume at bottling.

1.14.13 Dilution Tool


If you want to change the character of a finished beer or wort, you can mix it with water or another beer (dilute it) to get a mixture. This is done with some very high gravity beers as well as many blended beers. The dilution tool helps you determine the gravity of the mixture.

Using the Dilution Tool


o Select the Dilution Tool from the Tools menu or ribbon. o Enter the starting volume and gravity of the first beer being mixed o Select whether you are diluting with water or wort/beer and enter the volume and specific gravity of the dilution o The tool will show the total volume of the mixture and specific gravity of mixture

1.14.14 Weight-Volume Tool


The weight to volume tool is useful for calculating the amount of water or beer left in a container - and particularly useful for determining how much beer is left in a partially filled keg. To use it you do need to know the starting weight of the empty container or keg.
2013 BeerSmith LLC

56

BeerSmith 2

Using the Weight To Volume Tool


o Select the Weight-to Volume Tool from the Tools menu or ribbon. o Enter the current weight of the partially filled container as well as the weight of the empty container you recorded previously o Enter the specific gravity of the beer in the container (if known) or 1.000 for water o The tool will display the estimated volume remaining in the container

1.14.15 Carbonation Tool


The carbonation tool is used to estimate the corn sugar needed for carbonating bottled beer or pressure needed for carbonating a keg of finished beer. Note that the carbonation level is measured in volumes of CO2. One liter of CO2 gas dissolved into 1 liter of water would be 1 volume of CO2. Typical beer styles range from 1.8 volumes (a relatively flat English beer) to 3.0 volumes for a highly carbonated German beer. Most average beers are in the 2.32.7 volume range. Note that the recipe system supports Carbonation Profiles which offer additional flexibility in bottling and kegging. Online Articles: How to Keg Homebrewed Beer

Using the Carbonation Tool


o Select the Carbonation Tool from the Tools menu or ribbon. o Enter the target number of volumes of CO2 which will determine your carbonation level. Most beers require between 2.0 and 3.0 volumes, though a few styles run lower or higher than that range. o If bottling, enter the temperature of the beer when it is bottled (often room temperature). If kegging, enter the intended storage temperature for the keg (typically the temperature of the refrigerator you will be storing the keg in). o Enter the volume of the finished beer o If kegging, the tool will display your target carbonation pressure for forced carbonation. As an alternative you can also consider naturally carbonating your keg with the amount of corn sugar shown, though natural carbonation in kegs is rarely used today. o For bottling, the corn sugar weight or alternatively dry malt extract weight to use for bottling the beer is displayed.

1.15

Unit Conversion Tools


The unit conversion tools let you convert between various unit systems. Note that BeerSmith also has a feature for Automatic Unit Conversion in any field, as well as options to adjust your default units used in recipes and related tools.

Available Unit Conversion Tools (Unit Tools Menu/Ribbon)


o o o o o Temperature Units Specific Gravity Units Pressure Units Weight Units Volume Units

2013 BeerSmith LLC

Welcome to BeerSmith!

57

1.15.1 Temperature Units


This tool converts between different temperature units. Note that in addition to the temperature conversion tool, BeerSmith also supports Automatic Unit Conversion in any field.

Using the Temperature Units Tool


o Select the Temperature Units Tool from the Unit Tools menu or ribbon. o Enter the temperature you want to convert into the appropriate field. For example if your original temperature is in degrees F - enter it in the Fahrenheit field. o The other two fields will display the temperature converted to those units (for example Celsius and Kelvin)

1.15.2 Gravity Units


This tool converts between different specific gravity units. Note that in addition to this conversion tool, BeerSmith also supports Automatic Unit Conversion in any field.

Using the Specific Gravity Units Tool


o Select the Specific Gravity Units Tool from the Unit Tools menu or ribbon. o Enter the specific gravity you want to convert into the appropriate field (for example Specific Gravity). o The other field will display the specific gravity converted to those units (for example Plato).

1.15.3 Pressure Units


This tool converts between different pressure units. Note that in addition to this conversion tool, BeerSmith also supports Automatic Unit Conversion in any field.

Using the Pressure Units Tool


o Select the Pressure Units Tool from the Unit Tools menu or ribbon. o Enter the pressure you want to convert into the appropriate field (for example PSI). o The other fields will display the pressure converted to those units (for example Kilopascals).

1.15.4 Weight Units


This tool converts between different weight units. Note that in addition to this conversion tool, BeerSmith also supports Automatic Unit Conversion in any field.

Using the Weight Units Tool


o Select the Weight Units Tool from the Unit Tools menu or ribbon. o Enter the weight you want to convert into the appropriate field (for example pounds) o The other fields will display the weight converted to those units (for example Kilograms).

2013 BeerSmith LLC

58

BeerSmith 2

1.15.5 Volume Units


This tool converts between different volume units. Note that in addition to this conversion tool, BeerSmith also supports Automatic Unit Conversion in any field.

Using the Specific Gravity Units Tool


o Select the Volume Units Tool from the Unit Tools menu or ribbon. o Enter the volume you want to convert into the appropriate field (for example Quarts). o The other fields will display the volume converted to those units (for example Liters).

1.16

Options
The Options dialog (called Preferences on the Macintosh version) lets you set a wide variety of options used globally in the recipe design process, various brewing tools and also look and feel options for the program. These include basic brewing defaults, the unit system used within the program, advanced constants used within calculations and look and feel options. To open the options/preferences dialog select the Options command on the Tools menu or toolbar (this is called Preferences on the Macintosh version under the BeerSmith2 menu or on the toolbar.

Tabs within the Options/Preferences Dialog


o o o o o o o o o Brewing Options Units Bitterness Refractometer Yeast Starter Advanced Look and Feel Custom Reports Cloud Options

1.16.1 Brewing Options


The Brewing Options page shows basic options related to brewing such as the brew type (extract, all grain or partial mash) you use, the brewers name, the default beer style guide to use and the default equipment profile for new recipes. It also has space for personal information used on some competitive brewing reports but this information is not stored within the recipe itself to protect your privacy - as recipes often get passed around from person to person. Only the brewer name is included with recipes you export. Note that you can set additional recipe defaults using the Recipe - Set As Default feature. Mac Note: On the Macintosh version of BeerSmith, the options dialog is listed as Preferences under the BeerSmith2 menu and toolbar rather than options

Using the Brewing Options Tab


o Select the Options dialog from the Tools menu or toolbar below the main ribbon (Preferences on
2013 BeerSmith LLC

Welcome to BeerSmith!

59

the BeerSmith 2 menu for the Macintosh version). o Enter your the name and brew type for the person who regularly uses this software o If you want to change to another style guide you can do so here, but most brewers will be happy with the current BJCP style guide (currently 2008 version). o Select your equipment profile. If you have not already done so, you should probably create your own equipment profile to match your particular set of brewing equipment. o If you use the competition reports for brewing competition you may want to enter the competition information shown.

Calendar Options
o The calendar options determine which recipes are included on the calendar. o You can choose the folders to display (All folders, My Recipes only or Brew Log only) o You can also hide recipes where you are not the brewer. In this case, only recipes with a Brewer matching the name entered under Brewer at the top of this brewing options dialog will be displayed.

1.16.2 Units
The Units Options page lets you set the default units that are used by BeerSmith for displaying recipes and performing calculations. BeerSmith supports English, Metric and Imperial units and also lets you set a precision for each item (digits beyond the decimal point) and an increment for each to use when incrementing amounts. Note that in addition to the default units, BeerSmith also supports Automatic Unit Conversion in any field. Mac Note: On the Macintosh version of BeerSmith, the options dialog is listed as Preferences under the BeerSmith2 menu and toolbar rather than options

Using the Units Options Tab


o Select the Options dialog from the Tools menu or toolbar below the main ribbon (Preferences on the BeerSmith 2 menu for the Macintosh version). o Click on the Units tab on the left side of the dialog o If you want to quickly set all of your units, choose one of the buttons at the bottom of the dialog such as "Set to Metric Units" to quickly choose metric units for your default. o If desired, you can set individual fields as well, and also adjust the precision displayed and increment size for incrementing/decrementing amounts within the recipe design dialog. o If you are using English units, you can also show weights as pounds and ounces (such as 3 lbs 2 oz) which can help to make many recipes more readable. o Note that in addition to the default units, BeerSmith also supports Automatic Unit Conversion in any field, so you can enter the units after a number in any field and it will do the conversion for you automatically.

1.16.3 Bitterness
The Bitterness Options are used internally to estimate bitterness levels (IBUs) within the recipe design tab as well as the bitterness tool. Setting the options here will change the calculation for all recipes displayed on this computer. Mac Note: On the Macintosh version of BeerSmith, the options dialog is listed as Preferences under the BeerSmith2 menu and toolbar rather than options

2013 BeerSmith LLC

60

BeerSmith 2

New Change: The default leaf, plug and pellet hop adjustments have changed from version 1.X of BeerSmith. Most hop estimation formulas were developed using leaf hops, so version 2.0 uses leaf hops as the baseline (zero adjustment) and mak es a slight positive adjustment for plug and pellet hops. This will result in a slight difference between V1.X and V2.0 calculations, but the V2.0 calculations should be more accurate for pellet and plug hops.

Using the Bitterness Options Tab


o Select the Options dialog from the Tools menu or toolbar below the main ribbon (Preferences on the BeerSmith 2 menu for the Macintosh version). o Choose the Bitterness tab on the left toolbar in the dialog o Choose the formula to use for estimating recipe bitterness. Most brewers recommend Tinseth for all grain or full-boil brews and Rager for extract brewing. Note that changing the formula will have a big effect on the IBU estimation, so it is best to pick one formula and stick with it for consistency. o The first wort and mashing options show how much bitterness is added or subtracted relative to default boil hops using these two methods. The default values of 10% for first wort hops and -80% for mash hops are appropriate for most brewers. o The hop type adjustments are applied when whole, leaf or plug hops are used as the different hop types have slightly different utilization in the boil. The defaults of 0.0 for leaf, 2.0% for plug and 10% for pellet hops should be accurate for general brewing.

1.16.4 Refractometer
The refractometer options are for use when calibrating a refractometer, primarily for using it with the Refractometer Tool. Calibrating your refractometer is an important step, as by default most refractometers are calibrated to be used with sucrose (table sugar) rather than measuring wort and beer. If this is your first time using a refractometer, I strongly suggest you read my article on refractometer use . Online Articles: Using a Refractometer for Beer Brewing Mac Note: On the Macintosh version of BeerSmith, the options dialog is listed as Preferences under the BeerSmith2 menu and toolbar rather than options

Using the Refractometer Options to Calibrate your Refractometer


o Select Options from the Tools menu or tool bar (Preferences on the BeerSmith 2 menu for the Macintosh version). o Click on the Refractometer tab within the options dialog. o Get a sample of distilled water and cool it to 68F, then take a reading with your refractometer. Enter the reading here (it should be close to zero brix). o Next use a sample of wort (water with dry malt extract or a sample from your beer) and measure it with both a hydrometer and the refractometer, Enter the readings you measure here. o Once calibration is complete, you can use the Refractometer tool to calculate future refractometer measurements.

1.16.5 Yeast Starter


The yeast starter options are used internally for both the Yeast Starter Tool and Yeast Starter Tab within the recipe designer to calculate the appropriate size and viability for yeast samples and starters. Changing these options will affect both the tool and recipe yeast starter calculations. New Feature: The yeast starter is entirely new in BeerSmith 2.0
2013 BeerSmith LLC

Welcome to BeerSmith!

61

Online Articles: Yeast Starters Part 1, Yeast Starters Part 2, Making a Yeast Starter, Chris White Podcast, Chris White Interview Mac Note: On the Macintosh version of BeerSmith, the options dialog is listed as Preferences under the BeerSmith2 menu and toolbar rather than options

Setting the Yeast Starter Options


o Select Options from the Tools menu or toolbar (Preferences on the BeerSmith 2 menu for the Macintosh version). Select the Yeast icon on the toolbar in the options dialog. o In the desired yeast pitching rate section, you can set the desired (target) pitching rate for various types of beer. These are measured in millions of cells per milliliter per degree plato of specific gravity. The default values are recommended. o The yeast growth limits set limits on the highest yeast growth when using a starter for liquid yeast. If you increase this value it effectively results in larger yeast starters needing fewer packets of yeast, while lowering the number results in smaller starters but more packets required up front. o The stir plate factor represents the increase in growth of yeast when using a stir plate. Using a stir plate can significantly reduce the size of starter needed, so they are recommended. o In the dry yeast options, you can set the number of dry yeast cells per gram and water to use when hydrating dry yeast (in milliliters per gram). The default values are recommended. o The yeast viability and aging section lets you adjust the starting viability (percent of cells) for new yeast and loss of yeast viability per month for each of the three major yeast types. Slurry ages the fastest, liquid yeast within a few months, and dry yeast can actually last several years if properly stored. o The final section for yeast slurry concentration allows you to adjust the number of cells in the slurry as well as the non-slurry percent for slurry collected from a previous batch of beer.

1.16.6 Advanced
The advanced settings give you an opportunity to set a variety of internal constants used throughout BeerSmith (both in recipes and in tools) to perform calculations. New Feature: The adjustment of all major constants and final gravity based on mash temperature is new. WARNING: This feature is for advanced users only - changing these constants can significantly throw off internal calculations if misused. The default values for the options are shown in parenthesis next to each value. Mac Note: On the Macintosh version of BeerSmith, the options dialog is listed as Preferences under the BeerSmith2 menu and toolbar rather than options

Setting the Advanced Options


o Select Options from the Tools menu or toolbar (Preferences on the BeerSmith 2 menu for the Macintosh version). Select the Advanced icon on the toolbar in the options dialog. o The advanced settings section has two options for grain absorption. The first is used for conventional mashing while the second is used for Brew-in-a-bag (BIAB) mash profiles. These represent how much water is absorbed by the grains (in fluid ounces per ounce of grain). o The malt specific heat is the amount of heat absorbed by grains during the mash. It is measured in calories per gram of malt per degree Celsius. o The grain volume is the volume of space occupied by a kilogram of grain (liters per kilogram). o The steeping efficiency is the mash efficiency from steeping grains. Typically only a small

2013 BeerSmith LLC

62

BeerSmith 2

percentage (10-15%) of steeped grains end up in the wort after steeping. o BeerSmith has a new feature in the recipe designer that allows the mash temperature to be used to adjust the estimated final gravity. Beers with a low mash temperature tend to have higher attenuation during fermentation and lower starting gravity. The relationship in BeerSmith is linear, adjusting by a small percentage per degree of mash temperature off the center value. Here you can enter the slope and center temperature for adjusting based on mash temperature. The default values are an average of values from various sources. o Finally the brew log name can be adjusted - if you prefer another name instead of the default value.

1.16.7 Look and Feel


The look and feel settings let you adjust the overall color scheme for BeerSmith as well as how various items in the program are opened. By default most new windows will be created in a new tab, but you can change that behavior if you wish to display them in a window or over the current tab (use the back/ forward buttons to navigate). NOTE: You can also change how windows show up at any time by Control-clicking or Shift-clicking a tool or view. If you shift-click, the tool will display in a new window, and if you Control-click the view will display in a new tab (overriding the default). New Feature: The adjustment theme, look and feel and opening of items in tabs/windows is entirely new in BeerSmith 2.0 Mac Note: On the Macintosh version of BeerSmith, the options dialog is listed as Preferences under the BeerSmith2 menu and toolbar rather than options

Setting the Look and Feel Options


o Select Options from the Tools menu or toolbar (Preferences on the BeerSmith 2 menu for the Macintosh version). Select the Look and Feel icon on the toolbar in the options dialog. o If you want to change the overall color scheme for BeerSmith you can pick a new theme using the Color Scheme drop-down. o If you want to change how different items are opened such as recipes or tools, pick the option from the drop down in the "Options for Opening New Views and Windows" section. o If you wish to have a confirmation dialog displayed when closing an item before saving changes, check the "Confirm changes" box. Note that this will only be active when you close a window or tab, and will not intercede if you save or cancel the item. o Check the "Confirm before deleting items" box if you want a confirmation box to be displayed every time you delete an item. Note that this is rarely needed since you can use the undo button instead to undo changes.

1.16.8 Custom Reports


With BeerSmith 2 you can create your own custom report formats in addition to those included with BeerSmith. Custom reports can be created either in plain text format or HTML format. HTML format offers greater flexibility as you can include images, advanced formatting, etc. A good starting point for a custom report is to look at the reports that come with BeerSmith. These are typically installed to your BeerSmith templates directory under the Program Files (Application package on the Mac). On windows this is in the "Program Files/BeerSmith2/Reports" directory. In the Mac the reports are located within the BeerSmith2 application under the Contents/Reports section. Text files may contain simple text formatting (spaces, tabs and newlines). To insert a piece of BeerSmith data you include the name of the BeerSmith variable with a dollar sign ('$') before it in the
2013 BeerSmith LLC

Welcome to BeerSmith!

63

template. For example within a recipe $NAME will be replaced with the name of the recipe, $STYLE_NAME the name of the beer style selected, etc... HTML templates work exactly the same way - including $NAME will display the name of the recipe within an HTML recipe template. BeerSmith supports the names listed in the BeerXML standard - all with a dollar sign in front of them. See the BeerXML standard for an extensive listing of variables available (see below for more tags). Once you have a template created, save it to the Documents/BeerSmith2/Reports directory and then you can install it using the instructions below.

Installing a Custom Report


o Copy your report template (either in TXT or HTML) to your Documents/BeerSmith2/Reports directory. If you have changed the directory where BeerSmith documents are stored, please install your file to that directory/Reports instead. o Select the Options dialog from the Tools menu o Select the Reports tab o Click on the Add Report button o Enter the display name of your report - which is the title that will be displayed in the reports dropdown o Select the type - either plain text or HTML (web page) o Enter the file name for your new template such as MyReport.txt or MyReport.html o Press Ok to save it, and Ok again to close the options dialog o Go to the preview pane under your My Recipes view and select your new report from the Reports dropdown displayed on the preview pane

Commonly Used Recipe Tags


Purpose Tag Actual Alcohol by Vol: $ABV Adjust Temp for Equipment: $EQUIP_ADJUST Age beer for: $AGE Age (In Days)r: $AGE Asst Brewer: $ASST_BREWER Batch Size: $DISPLAY_BATCH_SIZE Bitterness: $IBU Bitterness Ratio: $BITTERNESS_RATIO Boil Ingredients: $BOIL_INGREDIENTS Boil Size: $DISPLAY_BOIL_SIZE Boil Time: $BOIL_TIME Boil Volume: $DISPLAY_BOIL_SIZE Bottling Date: $BOTTLING_DATE Brewer: $BREWER Brewhouse Efficiency: $EFFICIENCY Calories: $CALORIES Carbonation Type: $CARBONATION_TYPE Carbonation Used: $CARBONATION_USED Color Swatch: $COLOR_SWATCH ((Added 3/28/08)) HEX Color: $RGB_COLOR Date: $DATE
2013 BeerSmith LLC

64

BeerSmith 2

Display Age Temp: $DISPLAY_AGE_TEMP Display Batch Size: $DISPLAY_BATCH_SIZE Display Carbonation: $DISPLAY_CARBONATION Display Primary Temp: $DISPLAY_PRIMARY_TEMP Display Secondary Temp: $DISPLAY_SECONDARY_TEMP Display Tertiary Temp: $DISPLAY_TERTIARY_TEMP Drink and Enjoy!: $END_DATE Equipment: $EQUIPMENT Est Color: $EST_COLOR Est Final Gravity: $EST_FG Est Original Gravity: $EST_OG Estimated Alcohol by Vol: $EST_ABV Estimated pre-boil gravity: $PRE_BOIL_OG Estimated Mash Efficiency: $EST_MASH_EFFICIENCY Ferment Ingredients: $FERMENT_INGREDIENTS Final Volume: $DISPLAY_BATCH_SIZE For Batch Size: $BATCH_SIZE Grain Temperature: $GRAIN_TEMP Ingredients: $INGREDIENTS Keg/Bottling Temperature: $DISPLAY_CARB_TEMP Mash Ingredients : $MASH_INGREDIENTS Mash Ingredients : $MASH_INGREDIENTS Measured Final Gravity: $DISPLAY_FG Measured Original Gravity: $DISPLAY_OG Name: $NAME Notes: $NOTES Prepare for Bottling/Kegging: $BOTTLING_INGREDIENTS Pressure/Weight: $CARBONATION_PRESS Primary Age: $PRIMARY_AGE Primary fermentation: $PRIMARY_DATE Primary Ingredients: $PRIMARY_INGREDIENTS Recipe Price $PRICE Secondary Age: $SECONDARY_AGE Secondary fermentation: $SECONDARY_DATE Secondary Ingredients: $SECONDARY_INGREDIENTS Sparge Steps: $SPARGE_STEPS Sparge Temperature: $SPARGE_TEMP Sparge Water: $SPARGE_VOLUME Steep Hops: $STEEP_HOPS Steep Ingredients: $STEEP_INGREDIENTS Storage Temperature: $DISPLAY_AGE_TEMP Style Category $STYLE.CATEGORY Style Letter: $STYLE_LETTER Style Name: $STYLE_NAME Taste Notes: $TASTE_NOTES Taste Rating(out of 50): $TASTE_RATING Tertiary Age: $TERTIARY_AGE Tertiary Fermentation: $TERTIARY_DATE Total Grain Weight: $GRAIN_WEIGHT Total Grain Weight: $TOTAL_GRAINS Total Hops added to boil: $TOTAL_HOPS TunTemperature: $TUN_TEMP Type: $TYPE
2013 BeerSmith LLC

Welcome to BeerSmith!

65

Volumes of CO2: $CARBONATION Water preperation: $WATER_PREP Yeast Starter: $YEAST_STARTERS

1.16.9 Cloud Options


The cloud options tab is used to set your login user name and password for the BeerSmith Cloud folder. Before entering a user name and password, you need to establish an account at BeerSmithRecipes.com . If you click on the Create an Account link it will take you to the web site where you can establish your account. See Also: The BeerSmith Cloud, Using BeerSmithRecipes.com

Setting the Cloud Options


o Select Options from the Tools menu or toolbar (Preferences on the BeerSmith 2 menu for the Macintosh version). Select the Cloud icon on the toolbar in the options dialog. o You can enter your BeerSmithRecipes.com user name and password here. o If you don't have an account, click on the Create an Account button and you will be taken to the web site to establish one. o If you have lost your password you can use the Lost Password link to receive an email to reset your password o The Cloud Refresh Time determines how often the program checks the server for new recipes (in minutes). You can also check for new recipes at any time by clicking the Sync button while in Cloud Folder View. o The Proxy Server can be used to route your cloud service through a proxy server if your local network has our server blocked. Note, however that this is an advanced option only for users who understand proxies. Type the address (numeric or web address) of the proxy in this box. If your proxy requires a non-standard port, you can type in address:port_number where port_number is the port to use. o To turn off the proxy, simply leave the Proxy Server field blank.

1.17

Help and Product Activation


The help ribbon and menu show options for registering your product as well as major help topics. BeerSmith includes extensive built in help integrated with the program as well as online videos and tutorials to help you get up to speed quickly.

Help and Product Activation Options


o o o o o o Key Help Topics Purchasing a Product Key for BeerSmith 2 - From our online store Activating BeerSmith 2 Recovering a Lost Product Key Online Resources for BeerSmith 2 About BeerSmith (shows current version number)

New to BeerSmith?
o Getting Started o Activating BeerSmith o Creating your Equipment Profile

2013 BeerSmith LLC

66

BeerSmith 2

o Creating your First Recipe o Finding your Way Around BeerSmith o Frequently Asked Questions

Upgrading from Version 1.x?


o What's New in Version 2.0? o Tabbed and Windowed Browsing o Importing and Exporting Files

Using BeerSmith
o o o o o o o o o o o Tabbed and Windowed Browsing Creating your Equipment Profile Building a Recipe Scaling and Adjusting Recipes Using Profiles and Styles Adding Custom Ingredients Shopping and Inventory Calendar and Notes Brewing Tools Unit Conversion Tools Help and Product Activation

1.17.1 Recovering a Lost Product Key


If you registered an email address when you activated BeerSmith 2, you can recover your key using the Recover Key command on the help menu or ribbon.

Recovering a Lost Key


o If you no longer have BeerSmith installed, download the latest version from www.beersmith.com o Select the Recover Key command from the help menu or ribbon o Enter the email you used when you originally activated your copy of BeerSmith. It is important that you use the exact same email address, and that this email address is still active/valid. o BeerSmith will contact the server and if it finds a matching email address it will email the key to your email address.

1.17.2 Add-ons
BeerSmith has a new feature that allows you to install data and recipe add-ons. This is a great way to get new recipes and vendor specific ingredients.

Installing and Uninstalling an Add-on


o Select Add-ons from the help menu or toolbar o BeerSmith will show a list of your currently installed add-ons o Select the Add button from here to add a new add-on to the list - note you must be connected to the internet to browse and download add-ons o Select the Delete button to uninstall a selected add-on

2013 BeerSmith LLC

Welcome to BeerSmith!

67

1.17.3 Checking for Updates


BeerSmith will periodically check for a new version of BeerSmith. On the help menu and ribbon there is also a command to check for updates. When you find a new update, you will be redirected to the update page on the BeerSmith website. From here you can download and install the new update. It is important that you install your new copy in the same location as the old one. NOTE: Due to a bug in version 2.0.38 and below , you may not receive an update notification telling you of a new version. Please download BeerSmith 2 version 2.0.40 or above directly from our website at BeerSmith.com and install that update. Versions 2.0.40 and above should correctly notify you when updates are available as long as you are connected to the internet.

Checking for Updates


o Select the Update command from the help menu or ribbon o If a new version is available you will be prompted to download it from the BeerSmith web site o After downloading the new version, be sure to install it in the same Program Files or Application location as your old version. Since your data is stored separately in the Documents directory, installing will not overwrite your existing data. o NOTE: Do not install the program into your Documents/BeerSmith2 directory as it will overwrite your existing recipes. Install it to the same Program Files or Application directory as your original installation.

1.17.4 About BeerSmith


The About command shows the copyright, current version of BeerSmith you are running and the author and contributors.

Displaying the About Box


o Select About from the help menu or help ribbon o The about box will show the current version you are running in the form major-version.minor-version. build (for example 2.0.45 for build 45 of version 2.0

1.18

Changing the BeerSmith Documents Directory


By default, BeerSmith 2 stores all of your recipe and other data in your Documents/BeerSmith2 directory for easy backup and file management. Some users have requested the ability to move it to another directory, so we have added that feature. NOTE: BeerSmith 2 separates the Documents from the Program Files/Application so your data is not overwritten when you update the program - DO NOT move your documents directory to the same directory as your BeerSmith program files, as this could result in data loss if you update your program in the future and overwrite your recipes.

Changing Where BeerSmith 2 Documents Are Stored


o Select the Change Documents Directory command from the File menu o Create and select the new directory where you want your BeerSmith 2 files stored o NOTE: Any existing files in the destination directory may be overwritten, so make sure you have the correct destination directory o As soon as you are done you will need to restart BeerSmith to use the new directory

2013 BeerSmith LLC

68

BeerSmith 2

1.19

Uninstalling BeerSmith
BeerSmith is easy to uninstall, but by default the uninstall program does not delete any of your personal recipes and data.

Uninstalling on Windows
o From the Windows Start menu, go to All Programs->BeerSmith2->Uninstall BeerSmith 2. The uninstall wizard will remove the BeerSmith 2 program from your PC. o The uninstaller does not remove your recipe and other personal data that are stored in the Documents/BeerSmith2 directory. o If desired, you can manually remove the 'Documents/BeerSmith2' directory by dragging it to the windows trash can.

Uninstalling on the Macintosh


o Go to your Applications directory and remove the BeerSmith2 application by dragging it to the trash can on your desktop. o If you also wish to delete your recipes and other data, go to your Documents/BeerSmith2 directory and remove it by dragging it to the trashcan

1.20

License and Copyright Information

BeerSmith 2
Copyright 2002-2011 BeerSmith LLC Author: Bradley J. Smith, PhD All Rights Reserved http://www.beersmith.com

Licensing Terms
License Agreement This is a legal agreement between you (either individual or entity) and the BeerSmith LLC business. If you do not agree to the terms of this agreement, promptly return the disk and accompanying items to place of purchase for a refund (Registered versions only BeerSmith LLC is NOT responsible for distribution or replacement of unregistered shareware copies). BeerSmith 2 uses the wxWidgets library in building the binary distribution of BeerSmith. The license terms of use for wxWidgets are included below. BeerSmith is distributed as a binary work only under the binary exemption of the wxWidgets library license. Use of the NSIS installer for installation and configuration of the BeerSmith program is subject to the NSIS and other applicable license terms listed separately below. Single User License A single user license permits users to use BeerSmith only on two computers. Site use, network use, or installation of a single license on more than two computers requires a separate license. No one may copy or distribute any portion of the registered documentation, registration keys,
2013 BeerSmith LLC

Welcome to BeerSmith!

69

files, data or executables except for registered users with the express purpose of backing up these files for personal use on their registered computers. In addition, no one may disassemble, decompile, reverse engineer, loan, rent, or lease this software. This software is protected by U. S. and international copyright laws. Limited Warranty for Registered Users BeerSmith LLC warrants that the disks provided with the registered version of BeerSmith are free from defects for a period of 90 days from the purchase date. You may return defective disks to us for replacement or refund. Please return the complete package including documentation in a salable state to your place of purchase. LIMITATION OF LIABILITY BEERSMITH LLC HEREBY LIMITS THEIR LIABILITY AND EXCLUSIVE REMEDY TO 1) REFUND OF THE ORIGINAL PURCHASE PRICE OF THE SOFTWARE OR 2) REPLACEMENT OF A DEFECTIVE DISK AT BEERSMITH'S SOLE DISCRETION . PURCHASER OF SOFTWARE AGREES NOT TO HOLD THE BEERSMITH LLC BUSINESS, ITS PARTNERS, OFFICERS OR EMPLOYEES LIABLE FOR ANY DAMAGES WHATSOEVER BEYOND ONE OF THE TWO REMEDIES DESCRIBED ABOVE. GENERAL TERMS Use of this software for any period of time equates to agreement to all terms of this license. BeerSmith is only one possible tool for brewing beer. THIS SOFTWARE IS PROVIDED AS IS WITH NO WARRANTIES EITHER EXPRESS OR IMPLIED. PROPER USE BeerSmith LLC prohibits the use of this software for any and all improper and illegal activities including, but not limited to: illegal brewing (check your local laws), underage brewing, promotion of underage drinking, alcohol abuse, illegal activities performed under the influence of alcohol, and drinking and driving. We encourage the responsible adult use of the software for legal home brewing, and urge everyone to brew and drink responsibly. NO OTHER WARRANTY EXCEPT AS PROVIDED ABOVE BEERSMITH LLC DISCLAIMS ALL WARRANTIES WITH RESPECT TO THIS PRODUCT, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. SHOULD THE PRODUCT PROVE DEFECTIVE IN ANY WAY THE PURCHASER ASSUMES THE RISK OF SERVICING, REPAIR, CORRECTION, INCIDENTAL, OR CONSEQUENTIAL DAMAGES. (INCLUDING BUT NOT LIMITED TO DAMAGES RESULTING FROM ACCIDENTS DURING BREWING, LOSS OF INFORMATION, ILLEGAL USE OF THE SOFTWARE, IMPROPER BREWING TECHNIQUES, DRINKING OFFENSES SUCH AS UNDERAGE DRINKING, ALCOHOL ABUSE, DRINKING AND DRIVING, CRIMES COMMITTED UNDER THE INFLUENCE OF ALCOHOL AND THE LIKE) USING
2013 BeerSmith LLC

70

BeerSmith 2

THIS SOFTWARE. This agreement is governed by the laws of the state of Virginia and shall inure to the benefit of the BeerSmith LLC and any successors, administrators, heirs, and assigns. Any action or proceeding brought by either party against the other arising out of or related to this agreement shall be brought only in a STATE or FEDERAL court of competent jurisdiction located in Fairfax County, VA. The parties hereby consent to personam jurisdiction of said courts. Trial Version Distribution Rules The trial version of our products may be obtained from www.beersmith.com and comes with no warranty. The trial version of BeerSmith may be distributed freely on a non-profit basis as long as it is maintained as a complete package and no attempts are made to circumvent the trial period or any trial feature limitations. Permission to distribute trial versions of BeerSmith on a for-profit basis must be obtained in writing from the BeerSmith LLC. BeerSmith may only be distributed as a complete package including all documentation, program, and sample files. BeerSmith registration keys MAY NOT be distributed with or without the trial version except with explicit written permission. Trial Period The trial versions of our products may have limitations or a limited trial period. Users may not reverse engineer or disable trial period protections in an attempt to circumvent the limited use features of the trial version. Users may not distribute or share registration keys. Obtaining licensed versions You can obtain a registered licensed key of BeerSmith from www.beersmith.com by remitting payment as described on our web site at www.beersmith.com Each key is for use on TWO COMPUTERS ONLY, both for use by the original registrant. The sharing, distribution, or use of one key to register more than one copy of BeerSmith is EXPRESSLY PROHIBITED by this license. BeerSmith LLC reserves the right to disable keys that it has reason to believe have been compromised, shared, distributed, or otherwise misused. Site licenses and wholesale pricing terms are available - visit our web site for details. Alpha and Beta Versions Pre-release or so called "Alpha" and "Beta" versions of BeerSmith are for the sole use of registered "beta" testers. Use of any of these versions requires written permission from BeerSmith LLC. Public distribution and use of these versions is strictly prohibited.

wxWindows Library - used internally in BeerSmith and available from http://www.wxwidgets.org/


wxWindows Library Licence, Version 3.1 ====================================== Copyright (c) 1998-2005 Julian Smart, Robert Roebling et al
2013 BeerSmith LLC

Welcome to BeerSmith!

71

Everyone is permitted to copy and distribute verbatim copies of this licence document, but changing it is not allowed. WXWINDOWS LIBRARY LICENCE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public Licence as published by the Free Software Foundation; either version 2 of the Licence, or (at your option) any later version. This library 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. See the GNU Library General Public Licence for more details. You should have received a copy of the GNU Library General Public Licence along with this software, usually in a file named COPYING.LIB. If not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. EXCEPTION NOTICE 1. As a special exception, the copyright holders of this library give permission for additional uses of the text contained in this release of the library as licenced under the wxWindows Library Licence, applying either version 3.1 of the Licence, or (at your option) any later version of the Licence as published by the copyright holders of version 3.1 of the Licence document. 2. The exception is that you may use, copy, link, modify and distribute under your own terms, binary object code versions of works based on the Library. 3. If you copy code from files distributed under the terms of the GNU General Public Licence or the GNU Library General Public Licence into a copy of this library, as this licence permits, the exception does not apply to the code that you add in this way. To avoid misleading anyone as to the status of such modified files, you must delete this exception notice from such code and/or adjust the licensing conditions notice accordingly. 4. If you write modifications of your own for this library, it is your
2013 BeerSmith LLC

72

BeerSmith 2

choice whether to permit this exception to apply to your modifications. If you do not wish that, you must delete the exception notice from such code and/or adjust the licensing conditions notice accordingly.

NULLSOFT SCRIPTABLE INSTALL SYSTEM used to install BeerSmith


For additional details see http://nsis.sourceforge.net

Copyright (C) 1995-2009 Contributors More detailed copyright information can be found in the individual source code files. Applicable licenses
All NSIS source code, plug-ins, documentation, examples, header files and graphics, with the exception of the compression modules and where otherwise noted, are licensed under the zlib/libpng license. The zlib compression module for NSIS is licensed under the zlib/libpng license. The bzip2 compression module for NSIS is licensed under the bzip2 license. The lzma compression module for NSIS is licensed under the Common Public License version 1.0.

zlib/libpng license
This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software. Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software. This notice may not be removed or altered from any source distribution.

2.

3.

bzip2 license
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

2013 BeerSmith LLC

Welcome to BeerSmith!

73

2.

The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software. The name of the author may not be used to endorse or promote products derived from this software without specific prior written permission.

3.

4.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Julian Seward, Cambridge, UK. jseward@acm.org

Common Public License version 1.0


THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS COMMON PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT. 1. DEFINITIONS "Contribution" means: a) in the case of the initial Contributor, the initial code and documentation distributed under this Agreement, and b) in the case of each subsequent Contributor: i) changes to the Program, and ii) additions to the Program; where such changes and/or additions to the Program originate from and are distributed by that particular Contributor. A Contribution 'originates' from a Contributor if it was added to the Program by such Contributor itself or anyone acting on such Contributor's behalf. Contributions do not include additions to the Program which: (i) are separate modules of software distributed in
2013 BeerSmith LLC

74

BeerSmith 2

conjunction with the Program under their own license agreement, and (ii) are not derivative works of the Program. "Contributor" means any person or entity that distributes the Program. "Licensed Patents " mean patent claims licensable by a Contributor which are necessarily infringed by the use or sale of its Contribution alone or when combined with the Program. "Program" means the Contributions distributed in accordance with this Agreement. "Recipient" means anyone who receives the Program under this Agreement, including all Contributors. 2. GRANT OF RIGHTS a) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free copyright license to reproduce, prepare derivative works of, publicly display, publicly perform, distribute and sublicense the Contribution of such Contributor, if any, and such derivative works, in source code and object code form. b) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a nonexclusive, worldwide, royalty-free patent license under Licensed Patents to make, use, sell, offer to sell, import and otherwise transfer the Contribution of such Contributor, if any, in source code and object code form. This patent license shall apply to the combination of the Contribution and the Program if, at the time the Contribution is added by the Contributor, such addition of the Contribution causes such combination to be covered by the Licensed Patents. The patent license shall not apply to any other combinations which include the Contribution. No hardware per se is licensed hereunder. c) Recipient understands that although each Contributor grants the licenses to its Contributions set forth herein, no assurances are provided by any Contributor that the Program does not infringe the patent or other intellectual property rights of any other entity. Each Contributor disclaims any liability to Recipient for claims brought by any other entity based on infringement of intellectual property rights or otherwise. As a condition to exercising the rights and licenses granted hereunder, each Recipient hereby assumes sole responsibility to secure any other intellectual property rights needed, if any. For example, if a third party patent license is required to allow Recipient to distribute the Program, it is Recipient's responsibility to acquire that license before distributing the Program. d) Each Contributor represents that to its knowledge it has sufficient copyright rights in its Contribution, if any, to grant the copyright license set forth in this Agreement. 3. REQUIREMENTS A Contributor may choose to distribute the Program in object code form under its own license agreement, provided that: a) it complies with the terms and conditions of this Agreement; and
2013 BeerSmith LLC

Welcome to BeerSmith!

75

b) its license agreement: i) effectively disclaims on behalf of all Contributors all warranties and conditions, express and implied, including warranties or conditions of title and non-infringement, and implied warranties or conditions of merchantability and fitness for a particular purpose; ii) effectively excludes on behalf of all Contributors all liability for damages, including direct, indirect, special, incidental and consequential damages, such as lost profits; iii) states that any provisions which differ from this Agreement are offered by that Contributor alone and not by any other party; and iv) states that source code for the Program is available from such Contributor, and informs licensees how to obtain it in a reasonable manner on or through a medium customarily used for software exchange. When the Program is made available in source code form: a) it must be made available under this Agreement; and b) a copy of this Agreement must be included with each copy of the Program. Contributors may not remove or alter any copyright notices contained within the Program. Each Contributor must identify itself as the originator of its Contribution, if any, in a manner that reasonably allows subsequent Recipients to identify the originator of the Contribution. 4. COMMERCIAL DISTRIBUTION Commercial distributors of software may accept certain responsibilities with respect to end users, business partners and the like. While this license is intended to facilitate the commercial use of the Program, the Contributor who includes the Program in a commercial product offering should do so in a manner which does not create potential liability for other Contributors. Therefore, if a Contributor includes the Program in a commercial product offering, such Contributor ("Commercial Contributor") hereby agrees to defend and indemnify every other Contributor ("Indemnified Contributor") against any losses, damages and costs (collectively "Losses") arising from claims, lawsuits and other legal actions brought by a third party against the Indemnified Contributor to the extent caused by the acts or omissions of such Commercial Contributor in connection with its distribution of the Program in a commercial product offering. The obligations in this section do not apply to any claims or Losses relating to any actual or alleged intellectual property infringement. In order to qualify, an Indemnified Contributor must: a) promptly notify the Commercial Contributor in writing of such claim, and b) allow the Commercial Contributor to control, and cooperate with the Commercial Contributor in, the defense and any related settlement negotiations. The Indemnified Contributor may participate in any such claim at its own expense. For example, a Contributor might include the Program in a commercial product offering, Product X. That Contributor is then a Commercial Contributor. If that Commercial Contributor then makes
2013 BeerSmith LLC

76

BeerSmith 2

performance claims, or offers warranties related to Product X, those performance claims and warranties are such Commercial Contributor's responsibility alone. Under this section, the Commercial Contributor would have to defend claims against the other Contributors related to those performance claims and warranties, and if a court requires any other Contributor to pay any damages as a result, the Commercial Contributor must pay those damages. 5. NO WARRANTY EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is solely responsible for determining the appropriateness of using and distributing the Program and assumes all risks associated with its exercise of rights under this Agreement, including but not limited to the risks and costs of program errors, compliance with applicable laws, damage to or loss of data, programs or equipment, and unavailability or interruption of operations. 6. DISCLAIMER OF LIABILITY EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 7. GENERAL If any provision of this Agreement is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this Agreement, and without further action by the parties hereto, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable. If Recipient institutes patent litigation against a Contributor with respect to a patent applicable to software (including a cross-claim or counterclaim in a lawsuit), then any patent licenses granted by that Contributor to such Recipient under this Agreement shall terminate as of the date such litigation is filed. In addition, if Recipient institutes patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Program itself (excluding combinations of the Program with other software or hardware) infringes such Recipient's patent(s), then such Recipient's rights granted under Section 2(b) shall terminate as of the date such litigation is filed. All Recipient's rights under this Agreement shall terminate if it fails to comply with any of the material
2013 BeerSmith LLC

Welcome to BeerSmith!

77

terms or conditions of this Agreement and does not cure such failure in a reasonable period of time after becoming aware of such noncompliance. If all Recipient's rights under this Agreement terminate, Recipient agrees to cease use and distribution of the Program as soon as reasonably practicable. However, Recipient's obligations under this Agreement and any licenses granted by Recipient relating to the Program shall continue and survive. Everyone is permitted to copy and distribute copies of this Agreement, but in order to avoid inconsistency the Agreement is copyrighted and may only be modified in the following manner. The Agreement Steward reserves the right to publish new versions (including revisions) of this Agreement from time to time. No one other than the Agreement Steward has the right to modify this Agreement. IBM is the initial Agreement Steward. IBM may assign the responsibility to serve as the Agreement Steward to a suitable separate entity. Each new version of the Agreement will be given a distinguishing version number. The Program (including Contributions) may always be distributed subject to the version of the Agreement under which it was received. In addition, after a new version of the Agreement is published, Contributor may elect to distribute the Program (including its Contributions) under the new version. Except as expressly stated in Sections 2(a) and 2(b) above, Recipient receives no rights or licenses to the intellectual property of any Contributor under this Agreement, whether expressly, by implication, estoppel or otherwise. All rights in the Program not expressly granted under this Agreement are reserved. This Agreement is governed by the laws of the State of New York and the intellectual property laws of the United States of America. No party to this Agreement will bring a legal action under this Agreement more than one year after the cause of action arose. Each party waives its rights to a jury trial in any resulting litigation.

Special exception for LZMA compression module


Igor Pavlov and Amir Szekely, the authors of the LZMA compression module for NSIS, expressly permit you to statically or dynamically link your code (or bind by name) to the files from the LZMA compression module for NSIS without subjecting your linked code to the terms of the Common Public license version 1.0. Any modifications or additions to files from the LZMA compression module for NSIS, however, are subject to the terms of the Common Public License version 1.0.

2013 BeerSmith LLC

78

BeerSmith 2

Endnotes 2... (after index)

2013 BeerSmith LLC

Back Cover

You might also like