beersmith 2 - cloud object storage | store & retrieve data ... · beersmith 2 offers a ton of...
TRANSCRIPT
© 2013 BeerSmith LLC
BeerSmith 2
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 1Use this page to introduce the product
by BeerSmith LLC
This is "Title Page 1" - you may use this page to introduceyour product, show title, author, copyright, company logos,etc.
This page intentionally starts on an odd page, so that it is onthe right half of an open book from the readers point of view.This is the reason why the previous page was blank (theprevious page is the back side of the cover)
All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, ormechanical, including photocopying, recording, taping, or information storage and retrieval systems - without thewritten permission of the publisher.
Products that are referred to in this document may be either trademarks and/or registered trademarks of therespective 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 noresponsibility for errors or omissions, or for damages resulting from the use of information contained in thisdocument or from the use of programs and source code that may accompany it. In no event shall the publisher andthe author be liable for any loss of profit or any other commercial damage caused or alleged to have been causeddirectly or indirectly by this document.
Printed: February 2013 in (whereever you are located)
BeerSmith 2
© 2013 BeerSmith LLC
PublisherSpecial thanks to:
All the people who contributed to this document, to mum and dadand grandpa, to my sisters and brothers and mothers in law, to oursecretary Kathrin, to the graphic artist who created this great productlogo on the cover page (sorry, don't remember your name at themoment but you did a great work), to the pizza service down thestreet (your daily Capricciosas saved our lives), to the copy shopwhere this document will be duplicated, and and and...
Last not least, we want to thank EC Software who wrote this greathelp tool called HELP & MANUAL which printed this document.
Managing Editor
Technical Editors
Cover Designer
...enter name...
...enter name...
...enter name...
...enter name...
...enter name...
Production
...enter name...
Team Coordinator
...enter name...
BeerSmith 24
© 2013 BeerSmith LLC
Table of Contents
Foreword 7
Part I Welcome to BeerSmith! 9
................................................................................................................................... 91 Getting Started
................................................................................................................................... 102 What's New
................................................................................................................................... 123 Frequently Asked Questions
................................................................................................................................... 144 Online Resources
................................................................................................................................... 145 Building a Recipe
.......................................................................................................................................................... 15Creating Your First Recipe
.......................................................................................................................................................... 16Recipe Design Tab
.......................................................................................................................................................... 17Yeast Starter Tab
.......................................................................................................................................................... 18Mash Details Tab
.......................................................................................................................................................... 18Timer Tab
.......................................................................................................................................................... 19Fermentation Tab
.......................................................................................................................................................... 19Water Volumes Tab
.......................................................................................................................................................... 20Notes Tab
.......................................................................................................................................................... 20Brew Steps (the BrewSheet)
.......................................................................................................................................................... 20Recipe Set as Default
................................................................................................................................... 216 Finding Your Way Around BeerSmith
.......................................................................................................................................................... 21Activating BeerSmith
.......................................................................................................................................................... 22Tabbed and Windowed Browsing
.......................................................................................................................................................... 23My Recipes and Folders
.......................................................................................................................................................... 24Editing Functions
.......................................................................................................................................................... 24Reports
.......................................................................................................................................................... 25Printing and Previewing
.......................................................................................................................................................... 26Automatic Unit Conversion
.......................................................................................................................................................... 26Customizing Columns
................................................................................................................................... 277 Scaling and Adjusting Recipes
.......................................................................................................................................................... 27Scaling the Size of a Recipe
.......................................................................................................................................................... 27Converting a Recipe
.......................................................................................................................................................... 28Adjusting Gravity for a Recipe
.......................................................................................................................................................... 28Adjusting Bitterness of a Recipe
.......................................................................................................................................................... 28Adjusting Color of a Recipe
................................................................................................................................... 298 Shopping and Inventory
.......................................................................................................................................................... 29Understanding Inventory Management
.......................................................................................................................................................... 30Shopping List
.......................................................................................................................................................... 31Inventory
................................................................................................................................... 329 Using Profiles and Styles
.......................................................................................................................................................... 32Styles
.......................................................................................................................................................... 32Equipment Profiles
.......................................................................................................................................................... 34Mash Profiles
.......................................................................................................................................................... 35Carbonation Profiles
.......................................................................................................................................................... 36Fermentation Profiles
................................................................................................................................... 3610 Adding Custom Ingredients
.......................................................................................................................................................... 37Hops
.......................................................................................................................................................... 37Grains and Sugars
5Contents
5
© 2013 BeerSmith LLC
.......................................................................................................................................................... 38Yeast
.......................................................................................................................................................... 39Miscellaneous Ingredients
.......................................................................................................................................................... 40Water
................................................................................................................................... 4011 The BeerSmith Cloud
.......................................................................................................................................................... 41BeerSmithRecipes.com
................................................................................................................................... 4312 Importing and Exporting Files
.......................................................................................................................................................... 43Using the Import Wizard
.......................................................................................................................................................... 44Opening a File
.......................................................................................................................................................... 45Export All
.......................................................................................................................................................... 46Export Selected Items
................................................................................................................................... 4713 Calendar and Notes
.......................................................................................................................................................... 47Notes
.......................................................................................................................................................... 47Calendar
................................................................................................................................... 4814 Brewing Tools
.......................................................................................................................................................... 48Water Profiler
.......................................................................................................................................................... 49Infusion Tool
.......................................................................................................................................................... 50Decoction Tool
.......................................................................................................................................................... 50Mash Adjustment Tool
.......................................................................................................................................................... 51Yeast Starter Tool
.......................................................................................................................................................... 52Hydrometer Temperature Tool
.......................................................................................................................................................... 52Refractometer Tool
.......................................................................................................................................................... 53Percent Alcohol Tool
.......................................................................................................................................................... 54Hop Bitterness Tool
.......................................................................................................................................................... 54Hop Age Tool
.......................................................................................................................................................... 54Boil Off Tool
.......................................................................................................................................................... 55Water Needed Tool
.......................................................................................................................................................... 55Dilution Tool
.......................................................................................................................................................... 55Weight-Volume Tool
.......................................................................................................................................................... 56Carbonation Tool
................................................................................................................................... 5615 Unit Conversion Tools
.......................................................................................................................................................... 57Temperature Units
.......................................................................................................................................................... 57Gravity Units
.......................................................................................................................................................... 57Pressure Units
.......................................................................................................................................................... 57Weight Units
.......................................................................................................................................................... 58Volume Units
................................................................................................................................... 5816 Options
.......................................................................................................................................................... 58Brewing Options
.......................................................................................................................................................... 59Units
.......................................................................................................................................................... 59Bitterness
.......................................................................................................................................................... 60Refractometer
.......................................................................................................................................................... 60Yeast Starter
.......................................................................................................................................................... 61Advanced
.......................................................................................................................................................... 62Look and Feel
.......................................................................................................................................................... 62Custom Reports
.......................................................................................................................................................... 65Cloud Options
................................................................................................................................... 6517 Help and Product Activation
.......................................................................................................................................................... 66Recovering a Lost Product Key
.......................................................................................................................................................... 66Add-ons
.......................................................................................................................................................... 67Checking for Updates
.......................................................................................................................................................... 67About BeerSmith
................................................................................................................................... 6718 Changing the BeerSmith Documents Directory
BeerSmith 26
© 2013 BeerSmith LLC
................................................................................................................................... 6819 Uninstalling BeerSmith
................................................................................................................................... 6820 License and Copyright Information
Index 0
Foreword
This is just another title pageplaced between table of contents
and topics
7Foreword
© 2013 BeerSmith LLC
Top Level IntroThis page is printed before a new
top-level chapter starts
Part
I
Welcome to BeerSmith! 9
© 2013 BeerSmith LLC
1 Welcome to BeerSmith!
Need help with BeerSmith?
New to BeerSmith?
o Getting Started
o Activating BeerSmith
o Setting Units to Metric/Imperial
o Creating your Equipment Profile
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 Tabbed and Windowed Browsing
o Creating your Equipment Profile
o Building a Recipe
o Scaling and Adjusting Recipes
o The BeerSmith Recipe Cloud
o Using Profiles and Styles
o Adding Custom Ingredients
o Shopping and Inventory
o Calendar and Notes
o Brewing Tools
o Unit Conversion Tools
o Help and Product Activation
Online BeerSmith Support
o BeerSmith Support Page
o Video Tutorials
o Discussion Forum
o Recipe Archive
o BeerSmith Main Page
Online Articles, Reference and Podcast
o BeerSmith Blog
o BeerSmith Podcast
o Weekly Newsletter
o Home Brewing with BeerSmith Book
o BrewWiki Encyclopedia
o BeerSmith Guide Article Index
Advanced Topics
o Recovering a Lost Product Key
o Changing the Look and Feel
o Options/Preferences
o Understanding Inventory Management
o Converting a Recipe
o 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 brewedbefore.
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 mayupgrade by purchasing a key for BeerSmith 2. Once you have your key you can ActivateBeerSmith to permanently register your copy.
BeerSmith 210
© 2013 BeerSmith LLC
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 designtab 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 equipmento 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 andadapt sample recipes that came with BeerSmith or you downloaded from the internet.
More Advanced Recipe Features
o The recipe editor also has tabs for yeast starters, mash details, fermentation and notes.
o In addition you can print step-by-step instructions for the recipe you just created
o You can use the buttons on the ribbon to quickly scale and adjust your recipe
o You can also add your own ingredients to the list of pre-loaded ones
o 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
Welcome to BeerSmith! 11
© 2013 BeerSmith LLC
to share recipes via a cloud folder - so you can work from more than one computer. It also is tightlyintegrated with our new web site at BeerSmithRecipes.com so you can share a recipe with thecommunity 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 anintegrated 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
o The recipe design process was also redesigned from scratch
o A beer glass shows you the color of the beer in real-time as you add new ingredients
o The style guide comparison includes graphical bars to show which items are in or out of style
o The expanded ingredient display can be sorted and now shows the current inventory of each item
o 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 recipeo You can now adjust grain percentages using the Grain Adj button next to the ingredients list
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 datao The Yeast Starter Tab can help you estimate the right size yeast starter to use with your liquid
yeasto The Mash Details Tab lets you adjust and record details of your mash session - and includes a
visual graph of the mash processo 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
BeerSmith 212
© 2013 BeerSmith LLC
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 profileo 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, BeerSmithDiscussion 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 keycommand 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
Welcome to BeerSmith! 13
© 2013 BeerSmith LLC
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 unitsafter 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
recipeso 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/
BeerSmith 214
© 2013 BeerSmith LLC
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 Tabo 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 asmargins 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 tosupport 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
communityo 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
o BeerSmith Blog - Dozens of articles and our podcast on home brewing
o BeerSmith Podcast - Interviews with top brewers from around the world
o Newsletter - Get weekly articles on home brewing for free
o Home Brewing with BeerSmith - My collection of home brewing articles - printed as a book on
Amazono BrewWiki - Brewing encyclopedia and Wiki you can add articles to
o BeerSmith Guide - An index of over 100 articles on brewing
1.5 Building a Recipe
BeerSmith 2 has a very extensive set of tools for designing recipes as well as new tabs for recordingmany of the details of your brewing session. Virtually every aspect of the recipe design process andbrewing process has been improved.
Welcome to BeerSmith! 15
© 2013 BeerSmith LLC
See Also: Scaling and Adjusting Recipes, Finding your Way Around BeerSmith, Using Profiles andStyles 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 Creating your First Recipe
o Recipe Design Tab
o Yeast Starter Tab
o Mash Details Tab
o Timer Tab
o Fermentation Tab
o Water Volumes Tab
o Notes Tab
o Brew Steps
o 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 yourequipment and the beer style you are targeting, then start adding ingredients. BeerSmith will update theestimates 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 allbrewers can select their carbonation method and fermentation profile using the buttons below the styleguide.
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 brewingequipment. 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 "SingleInfusion, Medium Body, No Mash Out" profile. See Mash Profiles for more details on availableprofiles.
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 andcolor will be adjusted. These numbers will continuously be compared to the style you selected and
BeerSmith 216
© 2013 BeerSmith LLC
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 dialogo 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 toquickly select a set of ingredients and see instantly how it affects your beer. You can perform all of thesteps 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 referredto below. For the basics, follow the process shown below.
See Also: Scaling and Adjusting Recipes, Finding your Way Around BeerSmith, Using Profiles andStyles 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 brewingequipment. 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 "SingleInfusion, Medium Body, No Mash Out" profile. See Mash Profiles for more details on availableprofiles.
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 andcolor will be adjusted. These numbers will continuously be compared to the style you selected anddisplayed 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
Welcome to BeerSmith! 17
© 2013 BeerSmith LLC
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 starterneeded if using liquid yeast. Note that yeast starters are rarely needed with dry yeast as it merelyneeds 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 extractboiled with water and then cooled to room temperature. The recommended target gravity for a yeaststarter is 1.036 SG.
The top right section shows the yeast packages currently in your recipe. This list shows the viability ofeach yeast package and estimated number of viable cells in that package. The average large smackpack/vial of liquid yeast has approximately 100 billion viable cells when new and the small smack packscontain only about 20 billion cells.
To get an accurate viability reading, be sure to edit each yeast and enter the production date for theyeast packet.
On the left side, the tool shows an estimate of the yeast cells needed. This is based on the type ofrecipe, 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 checkthe box if you are using a stir plate. Note that stir plates significantly increase growth rates for youryeast starter, and are recommended. Once you have entered a yeast starter size, the tool will show theestimate of how many cells you have using the starter. If it is too few you can either increase the startersize or the number of packages of yeast.
Along the bottom of the tool is the recommended number of packages and starter size. Note that thestarter size may be different than your starter size if you are not using the recommended number ofyeast packs shown.
Finally on the bottom right the calculator will estimate the number of dry yeast packets (large 11.5 gramones) to use and hydration needed for those yeast packets.
Note: The recommended liquid starter and yeast starter used numbers will not match up with theactuals unless you use the recommended number of yeast packets and recommended yeast startersize.
See Also: Yeast Starter Options, Yeast Starter Tool
Online Articles: Yeast Starters Part 1, Yeast Starters Part 2, Making a Yeast Starter, Beer Yeast andFermentation, 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
BeerSmith 218
© 2013 BeerSmith LLC
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 mashbrewers. 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 yourequipment and edit the mash steps. To the right is the mash profile displayed graphically, and belowthe 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 tunvolume!), record the mash pH and end of running gravity (if desired - purely optional), and record yourvolumes and gravity into the boiler. If you enter your measured boil volume and boil starting gravity it willalso calculate the actual mash efficiency.
Note: The mash efficiency is not the same as the brewhouse efficiency - brewhouse efficiency includesall losses between mashing and the fermenter while mash efficiency includes only losses in the mashprocess 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 BagPodcast
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 youbrew 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 timefields 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.
Welcome to BeerSmith! 19
© 2013 BeerSmith LLC
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 thefermenter and also show your aging and bottling/kegging options. It also allows you to accuratelycalculate 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, finalgravity) to get accurate measured calculations.
The "Into the Boiler" section shows your estimated and measured boil volume and gravities. The "Intofermenter" shows the estimated and measured batch size and original gravity for the beer. "BrewhouseEfficiency" 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 "Atbottling/kegging" section provides space for the final gravity of the beer and volume actually bottled orkegged.
On the right half of the display the current fermentation and aging profile is displayed (temperature versustime) as well as your preferred carbonation method, carbonation level and how much pressure or sugarneeded for carbonation.
On the lower half you can enter taste notes and your taste rating (typically the BJCP score if youcompete your beer - a value between 1 and 50). On the bottom right is the estimated and actualstatistics (alcohol by volume and weight and calories) for your finished beer.
Online Articles: Understanding Brewhouse Efficiency, Improving your Brewhouse Efficiency, Apparentand Real Attenuation Part 1, Part 2, Counting Calories in Beer, How to Keg your Beer, Beer BottlingTips, 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 inyour brewing process. These include the mash, boil and fermentation and bottling. When brewing, thishelps you plan and track your water usage, and also adjust many equipment settings if they do notmatch this particular batch of beer.
BeerSmith 220
© 2013 BeerSmith LLC
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 detailso 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 thesettings 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 yourrecipe. You can enter taste notes for the finished beer or other notes detailing your design, recipe andbrewing notes.
Note: A smaller display of the notes field is available on the main design page - these are the samefield, 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 easyfor you to brew that specific recipe.
Note: You can also create your own custom report templates and print them using the reports featureincluding 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 viewo Highlight any recipe from My Recipes view - a preview of that recipe will be shown in the preview
windowo 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 youwish to make it easier to create new recipes in the future. Essentially the default recipe is the one thatwill come up whenever you add a new recipe from My Recipes view.
Welcome to BeerSmith! 21
© 2013 BeerSmith LLC
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 bethose 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 ofrecipes and tools. The goal of the new interface is to make it much easier to work with several tools orviews 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 Activating your Copy of BeerSmith
o Using Tabbed and Windowed Browsing
o My Recipes and Folders
o Editing Functions
o Reports
o Printing and Previewing
o Automatic Unit Conversion
o 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 yourcomputers for personal use (i.e. don't share it with a friend) using the same key. Your key is tied to yourcomputer 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 toallow you to recover your key if lost or misplaced in the future. If you don't enter an email address, andlater 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 emaillist containing articles from the BeerSmith blog. This is completely optional, but if you choose to do sowe will send you a subscription confirmation (which you must confirm to complete your subscription) andafter that you will receive approximately one beer brewing article each week along with an occasionalnewsletter.
NOTE: BeerSmith 1.X version keys are not compatible with BeerSmith 2. You need to purchase anew key or upgrade to register BeerSmith 2
See Also: Recovering a lost product key
BeerSmith 222
© 2013 BeerSmith LLC
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 anelectronic 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 firewallo 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 onlysupported one visible view at a time, so opening a tool often obscured the recipe or view you werecurrently working on.
BeerSmith 2 incorporates tabbed and window browsing - which makes it possible to open as many toolsand recipes as you like without disrupting your workflow. Users with multiple monitors can open severaldifferent 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) areopened in separate windows. Any item can be displayed in a window, tab or within the currently activeview. 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 anew tab or window. You can also do the same using Control/Command-click or Shift-Click (or doubleclick 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 behavioro 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
Welcome to BeerSmith! 23
© 2013 BeerSmith LLC
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/Command-
Double-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 andBack 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 folderis shown on the left side of the main BeerSmith window as a tree. You can click on the My Recipesfolder 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 asbrewed for future reference.
Note: You do not need to explicitly save any of your recipes stored in your My Recipes folder or any ofthe profiles or ingredients in the main profile or ingredient views. These are saved automatically whenyou 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
buttono See this section for information on designing your recipe
BeerSmith 224
© 2013 BeerSmith LLC
1.6.4 Editing Functions
BeerSmith supports editing functions that most Windows and Mac users will be quite familiar with suchas Cut, Copy, Paste, Edit, Undo, and Redo. These are available in any of the profile, ingredient andrecipe 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 sessiono To undo the last editing function you performed, click on the Undo button on the toolbar or edit
menuo 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 commonediting functions
1.6.5 Reports
BeerSmith 2 has the ability to print and preview a diverse set of report formats. The program has anumber of basic (text, brewsheet, competition, etc) preloaded with the program and you also have theability to make custom reports if you desire.
Reports are displayed in the preview window typically shown below or to the right of major data viewssuch as the profile, ingredient and recipe folder views. These reports can be printed or previewed usingthe print and preview commands. You can change the current report format using the drop-down on thetitle bar of the preview window.
Note on Margins and Print Settings: BeerSmith actually uses two different systems for printing. Theprofile, ingredient and recipe folder views and preview reports, which are typically in HTML or text formatare printed using your internet browser. On Windows, BeerSmith uses an Internet Explorer plugin formore flexibility with HTML reports. However, this means many of the settings (margins and headers) areset from Internet explorer rather than within BeerSmith. For dialogs and brewing tools, which are printeddirectly, you can use the Page Setup dialog (File menu) to set print options. Also currently on the Macthese settings are active as a limited native browser is implemented.
Welcome to BeerSmith! 25
© 2013 BeerSmith LLC
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 examplerecipes 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 boxand 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, ingredientand recipe folder views.
Note on Margins and Print Settings: BeerSmith actually uses two different systems for printing. Theprofile, ingredient and recipe folder views and preview reports, which are typically in HTML or text formatare printed using your internet browser. On Windows, BeerSmith uses an Internet Explorer plugin formore flexibility with HTML reports. A second system is used to print dialogs. On Windows, you candrag the margins for HTML reports from the print preview dialog. The other printouts do not haveadjustable 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.
BeerSmith 226
© 2013 BeerSmith LLC
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 youcan enter a unit descriptor after any number and BeerSmith will automatically convert the unit for youwhen you hit the tab key. For example entering "56 C" into a temperature field that defaults to degreesF 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 fieldwhich 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 convertto "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 alreadydisplayed.
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
Welcome to BeerSmith! 27
© 2013 BeerSmith LLC
on the column headingso 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 toextract recipes (or other types).
See Also: Building a Recipe
Tools for Scaling, Adjusting and Converting Recipes
o Scaling the Size of a Recipe
o Converting a Recipe
o Adjusting the Original Gravity of a Recipe
o Adjusting the Bitterness of a Recipe
o 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 recipesize up or down, matching original gravity, bitterness and color of the original recipe as closely aspossible. Using this command you can scale a recipe to match your equipment profile, a different targetbatch 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 willassure 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 dialogo You also have the option of manually setting a new batch size, boil volume, or brewhouse efficiency
number if desiredo 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 arecipe from all-grain to extract (or partial mash). In fact you can convert between any of the three majortypes. The conversion process is a fairly complicated operation that does its best to preserve theoriginal recipe's color, bitterness and original gravity.
During the conversion, some ingredients may be replaced - especially those needing mashing instead ofsteeping and the base grain which will be converted to the based extract (or grain) you selected in thedialog.
Note: Whenever possible it is best to convert recipes using your own personal equipment profile - thiswill assure a complete match between the recipe you have imported and your own equipment.
BeerSmith 228
© 2013 BeerSmith LLC
Limitations: Some very light colored beers cannot be accurately converted to extract due to the factthat malt extract is generally much darker than comparable pale grain malt. The converter will do thebest 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
o Select the recipe you want to use either by opening it or selecting it from your My Recipes view
o Select the Convert button on the ribbon
o Select the type you want to convert to - you can convert it to any type using this tool
o 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 dialogo 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.
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 grainamounts 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 recipeo 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 hopamounts 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 recipeo 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 grainamounts 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 mayfail as it can't adjust the color without changing its original gravity. In this case, it will typically adjust therecipe as light or dark as it can without altering the original gravity.
Online Articles: Understanding Beer Color
Welcome to BeerSmith! 29
© 2013 BeerSmith LLC
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 recipeo 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: UnderstandingInventory 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 tomanage 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 Addto 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 yougo to brew a recipe you can use the Remove Inv button in any open recipe to remove ingredients foundin 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
BeerSmith 230
© 2013 BeerSmith LLC
your shopping carto 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 mouseo 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 topurchase 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 itemsto add to your inventory once you purchase them and even add an entire recipe to the shopping list inone shot.
See Also: Understanding Inventory Management, Editing Functions,
Adding Items Directly to the Shopping List
o Select the Shopping List 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 want to add from the list and enter the quantity and current price to purchase
o 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 carto 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 mouseo 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
Welcome to BeerSmith! 31
© 2013 BeerSmith LLC
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 mouseo 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 mouseo 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 canadd 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 adifferent price from the shopping cart, BeerSmith will dollar-average the price to determine average costof 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 mouseo 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
BeerSmith 232
© 2013 BeerSmith LLC
1.9 Using Profiles and Styles
Profiles such as equipment and mash profiles let you store a commonly used set of equipment orprocess and apply it to a recipe as needed. Styles includes the beer style database which is used inthe recipe design tool to compare recipes against established standards for a style. The most popularbeer style database (The BJCP style database) is included with BeerSmith. All of the profiles and stylesare 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 soyou have the correct equipment setup for new recipes.
Using Profiles and Styles
o Styles Database - a collection of data on beer styles from around the world
o Equipment Profiles - used to manage your brewing equipment
o Mash Profiles - used to make mashing as simple as possible
o Carbonation Profiles - used in recipes for bottling and kegging techniques
o 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 guidesare integrated with the Recipe Design Tab so you can choose a target style for your beer and BeerSmithwill 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 forUS brewers, though some overseas may prefer other guides.
New Feature: BeerSmith now has support for extensive descriptions of a style (the text is no longerlimited)
Important Note!: BeerSmith supports multiple style guides, and by default only the style guides thathave their "Style Guide" field set to "BJCP 2008" will be displayed. This can cause confusion if you aretrying to add your own styles from the style view. To display another style guide or show all style guidesat 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 currentlyselected 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 veryimportant that you create your own personal equipment profile to match your particular set of brewingequipment 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
Welcome to BeerSmith! 33
© 2013 BeerSmith LLC
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 brewingsetup. As the equipment profile is used throughout the recipe calculations, an accurate equipmentprofile 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 theBrewing tab in the Options dialog after you have created and set your equipment profile. If you edit yourprofile 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 equipmentprofile
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 owno 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 brewingsystems 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 tuno 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 andhigher 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 pipingo Top Up Water for Kettle - Enter zero here for most cases unless you add additional water
between the mash and the boilo 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 bechecked.
o Boil Volume - The volume of water at the start of the boil
BeerSmith 234
© 2013 BeerSmith LLC
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 batcho 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 boilo Cooling Shrinkage - Water typically loses about 4% of its volume when cooled from boiling to
room temperatureo 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 fermentero 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 boilo Batch Volume Into Fermenter - The target batch size as measured into the fermenter - typically a
bit over 5 gallons for most home brewerso 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 recipesimply by choosing them. BeerSmith includes commonly used infusion mash profiles, decoction mashprofiles, 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 adjustmash details for a single recipe using the recipe's mash tab. It is rare that you will need to create yourown 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 thoselisted as "Single Infusion" mash profiles. These are single step infusion mashes where a measure of hotwater is mixed with grains and left for an hour or so to convert the starches in the grains. Double andTriple infusions are used infrequently - and only needed for beers with a high proportion of non-barleybase grains. Temperature mashing is used by those who have a mash tun that can be heated - and theburner 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 articlesfor BIAB below).
Most mash profiles have variants for light, medium and full body profiles. The light body profiles mash ata lower temperature resulting in higher enzyme activity and a cleaner lighter overall profile. Full bodyprofiles mash at a higher temperature resulting in less enzymatic activity and more unfermentablesugars 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 morethan an additional step at the end of the mash to raise the temperature of the overall mash to haltenzymatic 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 thegrains are mashed in the boil kettle lined with a grain bag. BIAB profiles generally have a lower grainabsorption rate and also have no sparge step since they use the full boil volume in the mash step.
Welcome to BeerSmith! 35
© 2013 BeerSmith LLC
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 BagPodcast
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 Select the Mash Profile view from the profile menu or ribbon
o Click on the Add Mash button on the ribbon
o Give your profile a unique but descriptive name
o Set your starting grain and tun temperature as well as sparge temperature. In most cases the
default are sufficient.o 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 actualgrain weight from the recipe. For most recipes 10 lbs or 4.5 kg is a reasonable starting point.
o 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 mixturetypically boils a bit above the boiling point of water.
o The Mash pH is used to record the recommended mash pH for this profile.
o Add steps to the mash profile by clicking Add Mash Step. You can also edit/delete or reorder
steps using the buttons showno The mash dialog also will show a graphical representation of the mash profile
o Batch sparge options are shown for batch sparging. For optimal results, I recommend setting "Use
Equal Batches" when batch sparging.o 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). Thisis primarily used in Brew-In-A-Bag or No-Sparge mash techniques. The boil volume basis helps youdetermine approximate values for a given boil volume - it too will be scaled to the actual boil volumewhen you apply this profile to a recipe.
1.9.4 Carbonation Profiles
A carbonation profile represents a method for carbonating your beer. This could include either addingsome 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 willcalculate 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
BeerSmith 236
© 2013 BeerSmith LLC
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 Select the Mash Profile view from the profile menu or ribbon
o Select the Add Carbonation button from the ribbon
o Give your profile a unique name and select the type (bottle, keg or keg with priming agent).
o 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 cornsugar.
1.9.5 Fermentation Profiles
A fermentation profile represents the steps to use when fermenting and aging your beer. Most brewersuse a two stage fermentation though a third stage is common for lagers. BeerSmith comes pre-loadedwith many of the most common fermentation and aging profiles for ales, lagers and select specialtybeers styles.
Using any fermentation profile in a recipe is as simple as choosing it within the recipe design tab. Youcan 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 Select the Fermentation Profile view from the profile menu or ribbon
o Select the Add Ferm button from the ribbon
o Give your profile a unique name and select the number of stages to use
o 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", "AddGrains", etc... buttons within the recipe design tab. You can also manage your inventory of items fromwithin this view.
However, occasionally you may find it necessary to add your own ingredients. Fortunately the entireingredient 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 customingredients with others using the Export Selected command. When importing, be sure to copy/pastethe 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 therecipe so it can be shared with others. Therefore changing a value in your ingredients views (below) will
Welcome to BeerSmith! 37
© 2013 BeerSmith LLC
only affect future recipes made with that ingredient, and will not alter previously made recipes or recipesyou imported from another source.
Using Ingredient Tables
o Hop Ingredients
o Grains, Sugars and Extracts
o Yeast
o Miscellaneous Ingredients
o Water
1.10.1 Hops
The Hops view allows you to add or edit the hop database that is available within the recipe design toolfor building recipes. From here you can add new varieties of hops, edit the parameters for hops to beused 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 completecopy of its ingredients stored internally. Changing an ingredient will only change future recipes madewith 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 itis 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 mouseo 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 isavailable within the recipe design tool for building recipes. From here you can add new varieties of grainsand sugars, edit the parameters for items to be used in new recipes, and delete those you don't regularlyuse.
Note: Editing an item in this database will not change existing recipes as each recipe has a completecopy of its ingredients stored internally. Changing an ingredient will only change future recipes made
BeerSmith 238
© 2013 BeerSmith LLC
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 Select the Grain view from the ingredient menu or ribbon
o Select the Add Grain button to add a new item
o You can add new grains, sugars, liquid extract or dry extract by adjusting the type
o 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 mouseo 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 designtool for building recipes. From here you can add new varieties of yeasts, edit the parameters for items tobe 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 completecopy of its ingredients stored internally. Changing an ingredient will only change future recipes madewith 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 andFermentation, 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
Welcome to BeerSmith! 39
© 2013 BeerSmith LLC
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 perpack is also important if you use this yeast with the yeast starter tab of yeast starter tool, as it is ameasure of the number of cells in a fresh yeast pack. Typically large smack packs and vials fromWyeast or White labs contain a bit over 100 billion cells while small packs contain only 20 billioncells. Large 11.5 gram dry yeast packs contain approximately 200 billion cells and smaller 5.5g dryyeast 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 mouseo 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 thatis available within the recipe design tool for building recipes. From here you can add new miscellaneousingredients, edit the parameters for items to be used in new recipes, and delete those you don't regularlyuse.
Note: Editing an item in this database will not change existing recipes as each recipe has a completecopy of its ingredients stored internally. Changing an ingredient will only change future recipes madewith 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 Select the Miscellaneous view from the ingredient menu or ribbon
o Select the Add Misc button to add a new item
o You can add new grains, sugars, liquid extract or dry extract by adjusting the type
o 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 sizewhen 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 bedisplayed 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 mouseo Click the Set Price button on the ribbon to set all of the prices at once
BeerSmith 240
© 2013 BeerSmith LLC
1.10.5 Water
The Water view allows you to add or edit the water database that is available within the recipe designtool for building recipes. From here you can add new water profiles, edit the parameters for waters to beused 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 completecopy of its ingredients stored internally. Changing an ingredient will only change future recipes madewith 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
o Select the Water view from the ingredient menu or ribbon
o Select the Add Water button to add a new item
o The critical parameters for water profiles are the mineral profiles.
o 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
1.11 The BeerSmith Cloud
The BeerSmith recipe cloud is a new internet based recipe sharing service that is tightly integrated withBeerSmith 2.1.
In BeerSmith 2.1 a new "Cloud View" has been added for storing recipes. Recipes added to this cloudfolder are not stored on your local machine but are instead stored on the BeerSmithRecipes.com website 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 easilyYou can mark a recipe as shared, in which case it will now be available publicly on theBeerSmithRecipes.com web server, forming a large active database of BeerSmith recipes for the homebrewing community.You can also go to BeerSmithRecipes.com and find recipes you like. These can be downloaded orsaved 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
Welcome to BeerSmith! 41
© 2013 BeerSmith LLC
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
immediatelyo 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, viewyour existing cloud folder recipes, download recipes, comment on and review recipes, follow friendsand 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. Usingthis 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 anycomputer 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
BeerSmith 242
© 2013 BeerSmith LLC
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
foldero 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 foldero 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 andcan 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 featureo 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 youremail 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 importantthat you use the same email address when registering your gravitar that you used when registeringfor BeerSmithRecipes.com
o You can also set the Units (Metric or English) used to display recipes from your profile page.
Welcome to BeerSmith! 43
© 2013 BeerSmith LLC
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 avariety 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 filescompatible with earlier versions of BeerSmith, which have a (*.bsm) file extension and BeerXML formatfiles (*.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 thatyou copy and paste any items you want to permanently keep into your "My Recipes" folder of theingredients 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 allowssignificantly more flexibility and expanded features over the BeerSmith 1.x binary file format. BeerSmith2.0 can read and write both formats for compatibility with users of the earlier version.
Importing and Exporting File Topics
o Using The Import Wizard
o Opening a file
o Exporting all items in a view
o 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 importyour recipes, equipment and matching inventory from an existing version of BeerSmith on the samemachine. The wizard runs when you first install BeerSmith 2, but you can also run it later by selecting Import Wizard from the File menu.
BeerSmith 244
© 2013 BeerSmith LLC
The import wizard attempts to find your existing BeerSmith installation, and shows you the newestmatching directory found (if any) to import your files from. If no directory is found you are also offered theoption to select a directory to import from. BeerSmith is looking for the BeerSmith 1.4 directorycontaining 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 anymatching inventory. If items are found that do not match your BeerSmith 2 ingredients, the program willshow you how many unmatched inventory items were found.
Note: You can also manually import items from BeerSmith 1 including mash profiles, and customingredients. 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 Select Import Wizard from the File menu.
o BeerSmith 2 will attempt to locate your BeerSmith 1 directory and show the location it has found.
o If desired you can specify a separate directory to import from.
o 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 avariety 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 filescompatible with earlier versions of BeerSmith, which have a (*.bsm) file extension and BeerXML formatfiles (*.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.
Welcome to BeerSmith! 45
© 2013 BeerSmith LLC
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 nameo 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 programso 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 canemail or share with other brewers.
BeerSmith 2 supports three different file formats - allowing you to exchange recipes and data with avariety 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 filescompatible with earlier versions of BeerSmith, which have a (*.bsm) file extension and BeerXML formatfiles (*.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 anupdate to BeerSmith 2 shortly.
Saving to a BeerSmith 2 File (*.BSMX)
o Select the Export All command from the file menu or toolbar.
o Navigate to the directory you wish to save to, and give the file a name such as "Recipes.bsmx"
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.
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 BeerSmitho 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 typeo 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.
BeerSmith 246
© 2013 BeerSmith LLC
Saving to a BeerXML File (*.XML)
o NOTE: Exporting to BeerXML is currently not implemented but is expected to be available in an
update shortlyo 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
typeo 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. Notethat you can select multiple items by Control-clicking or Shift-clicking on items (hold down the shift orcontrol keys on the keyboard when selecting items). Control-clicking adds individual items, while shift-clicking can be used to select a range of items.
BeerSmith 2 supports three different file formats - allowing you to exchange recipes and data with avariety 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 filescompatible with earlier versions of BeerSmith, which have a (*.bsm) file extension and BeerXML formatfiles (*.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 anupdate to BeerSmith 2 shortly.
Saving to a BeerSmith 2 File (*.BSMX)
o Select the items you want to export - by clicking on them, shift-clicking or control-clicking
o Select the Export All command from the file menu or toolbar.
o Navigate to the directory you wish to save to, and give the file a name such as "Recipes.bsmx"
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.
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 BeerSmitho 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 typeo 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.
Welcome to BeerSmith! 47
© 2013 BeerSmith LLC
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 shortlyo 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
typeo 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 youcan keep track of key milestones such as racking from the primary to secondary fermenter and bottlingyour 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. Eventsand 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
o Select the Notes command on the View menu.
o Select the Add Note button on the ribbon
o Enter the name of the note and a short description
o 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
1.13.2 Calendar
The calendar can be used for brewing planning. It displays your recipes and notes in a simple monthlycalendar format so you can schedule events and brewing sessions as well as remind yourself of criticalevents such as racking the beer during fermentation or bottling.
BeerSmith 248
© 2013 BeerSmith LLC
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 currentmonth.
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 dateo 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 dayo 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 sizeo 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 simpleand common brewing calculations. These include common mash calculations, refractometer andhydrometer 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 Water Profiler
o Infusion Tool
o Decoction Tool
o Mash Adjustment Tool
o Yeast Starter Tool
o Hydrometer Temperature Tool
o Refractometer Tool
o Percent Alcohol Tool
o Hop Bitterness Tool
o Hop Age Tool
o Boil Off Tool
o Water Needed Tool
o Dilution Tool
o Weight-Volume Tool
o Carbonation Tool
1.14.1 Water Profiler
The Water Profile Tool (Tools Ribbon) can be used to match specific brewing water profiles from aroundthe world. This is important, particularly for all grain brewers who would like to match a particular water
Welcome to BeerSmith! 49
© 2013 BeerSmith LLC
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 thebest water additions to match your base and target water profile. It does this using a "best fit" linearprogramming 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 usedo Click on the Calculate Best Additions button to find the best additions possible to match your
base profile to your water profileo 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 theion 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 andHCO3 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 basewater, 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, evenafter 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 concentrationof 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 whenmashing your grains for all grain or partial mash brewing. An infusion is nothing more than hot watermixed 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 stepo Enter your target step temperature, and how much water you are adding for this step
BeerSmith 250
© 2013 BeerSmith LLC
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 totalweight 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 mashtuns 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 potand then added back to the mash to raise the temperature during steps in the mash. The decoction toolis 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 steptemperature, 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
masho 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 mashtuns 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 slightlyabove 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 stepo 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 tobe off by a little bit. By adding cold water or hot water to the mash you can bring your mash back to itstarget 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 themeasured 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
Welcome to BeerSmith! 51
© 2013 BeerSmith LLC
heat. Note that the mash tun specific heat is generally between 0.2 and 0.5, with all metal mashtuns 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 hotor 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. Pitchingthe correct number of cells in a batch of yeast is important as it optimizes fermentation and reduces thechance of off-flavors or incomplete fermentation. Yeast starters are typically made from liquid yeastpackages to increase the number of viable cells before pitching your yeast into the wort at the start offermentation.
Yeast starters are rarely required when using dry yeast or slurry. Dry yeast is simply hydrated using asmall amount of warm water about 30 minutes before pitching. Slurry is typically harvested in sufficientquantity for reuse.
Note that the pitching rates and internal values used by this calculator can be adjusted in the OptionsDialog Yeast Tab. Also, you can perform starter calculations within a recipe using the Yeast Starter Tabwithin 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 andFermentation, 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. Noteyou 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 andinclude 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 alsobe 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 onlyabout 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 plateo 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
BeerSmith 252
© 2013 BeerSmith LLC
o Dry yeast does not generally require a starter - instead the appropriate number of dry yeast packs
are hydrated about 30 minutes before useo 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 asample 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 measuringhot wort during mashing, must be adjusted to compensate for temperature. This tool performs thatcalculation.
Online Articles: Using a Hydrometer for Brewing Beer, Calibrating your Equipment
Using the Hydrometer Temperature Tool
o Select the Hydrometer Temperature Tool from the Tools menu or ribbon.
o Enter the measured gravity for your sample - as taken directly from your hydrometer
o Enter the temperature at which your sample was taken
o The tool will show the corrected specific gravity at the bottom
o 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 arecalibrated at different temperatures. In most cases the calibration temperature is shown on thescale 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 thereadings made using a refractometer must be adjusted before use. This tool makes those adjustmentsto 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 Optionso Select the calculation to perform (see below)
Welcome to BeerSmith! 53
© 2013 BeerSmith LLC
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 wortbefore 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 toget the final gravity. You need to have both the original gravity (taken before fermentation started) and acurrent 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 finalgravity measurement taken with both a refractometer and hydrometer. It is useful if you forgot tomeasure 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 originalgravity and final gravity of a beer. These include the apparent and real attenuation for the yeast (whatpercent of sugars fermented), the alcohol percentages (by volume and by weight) and the estimatednumber 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
attenuationo The estimated number of calories (total and from alcohol) is displayed
BeerSmith 254
© 2013 BeerSmith LLC
1.14.9 Hop Bitterness Tool
The hop bitterness tool can be used to estimate the number of International Bitterness Units (IBUs orbitterness) for a given set of hop additions. It is a standalone tool - as these calculations are also builtinto the recipe calculator. IBUs is the primary measurement used by home and professional beers todetermine 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
o Select the Hop Bitterness Tool from the Tools menu or ribbon.
o Enter the batch volume, which is the target volume of beer going into the fermenter
o Enter your boil volume (start of boil) and boil gravity (start of boil)
o 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
buttonso 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 brewingbooks.
1.14.10 Hop Age Tool
As they age, hops lose some of their viability and bitterness. The hop age tool calculates the loss inalpha (bitterness) percentage as a function of time for various storage conditions. If you are not workingwith fresh hops, it is a good idea to calculate the hop bitterness loss for each of the hop additions inyour recipe. In general, you should consider getting new hops after aging has reduced the hop alpha to50% 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 tominimize 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 rateand shrinkage rate. During the boil, typically 10-15% of the water in the wort is evaporated or boiled offfor a typical 90 minute boil. In addition, after boiling, the water will lose approximately 4% due toshrinkage.
Welcome to BeerSmith! 55
© 2013 BeerSmith LLC
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) times100 (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 gravityo 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 withina 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 willshow the amount of water absorbed by the grain (grain absorption) and the total sparge waterneeded.
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 fermentationlosses 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 blendedbeers. 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 dilutiono 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 - andparticularly useful for determining how much beer is left in a partially filled keg. To use it you do need toknow the starting weight of the empty container or keg.
BeerSmith 256
© 2013 BeerSmith LLC
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 previouslyo 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 pressureneeded 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 1liter of water would be 1 volume of CO2. Typical beer styles range from 1.8 volumes (a relatively flatEnglish beer) to 3.0 volumes for a highly carbonated German beer. Most average beers are in the 2.3-2.7 volume range.
Note that the recipe system supports Carbonation Profiles which offer additional flexibility in bottling andkegging.
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 youwill 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 sugarshown, 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 toadjust your default units used in recipes and related tools.
Available Unit Conversion Tools (Unit Tools Menu/Ribbon)
o Temperature Units
o Specific Gravity Units
o Pressure Units
o Weight Units
o Volume Units
Welcome to BeerSmith! 57
© 2013 BeerSmith LLC
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 UnitConversion 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 anyfield.
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 anyfield.
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 anyfield.
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).
BeerSmith 258
© 2013 BeerSmith LLC
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 anyfield.
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 optionsused globally in the recipe design process, various brewing tools and also look and feel options for theprogram. These include basic brewing defaults, the unit system used within the program, advancedconstants used within calculations and look and feel options.
To open the options/preferences dialog select the Options command on the Tools menu or toolbar (thisis called Preferences on the Macintosh version under the BeerSmith2 menu or on the toolbar.
Tabs within the Options/Preferences Dialog
o Brewing Options
o Units
o Bitterness
o Refractometer
o Yeast Starter
o Advanced
o Look and Feel
o Custom Reports
o Cloud Options
1.16.1 Brewing Options
The Brewing Options page shows basic options related to brewing such as the brew type (extract, allgrain or partial mash) you use, the brewers name, the default beer style guide to use and the defaultequipment profile for new recipes.
It also has space for personal information used on some competitive brewing reports but this informationis not stored within the recipe itself to protect your privacy - as recipes often get passed around fromperson 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 underthe 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
Welcome to BeerSmith! 59
© 2013 BeerSmith LLC
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 recipesand performing calculations. BeerSmith supports English, Metric and Imperial units and also lets youset a precision for each item (digits beyond the decimal point) and an increment for each to use whenincrementing amounts.
Note that in addition to the default units, BeerSmith also supports Automatic Unit Conversion in anyfield.
Mac Note: On the Macintosh version of BeerSmith, the options dialog is listed as Preferences underthe 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 youautomatically.
1.16.3 Bitterness
The Bitterness Options are used internally to estimate bitterness levels (IBUs) within the recipe designtab as well as the bitterness tool. Setting the options here will change the calculation for all recipesdisplayed on this computer.
Mac Note: On the Macintosh version of BeerSmith, the options dialog is listed as Preferences underthe BeerSmith2 menu and toolbar rather than options
BeerSmith 260
© 2013 BeerSmith LLC
New Change: The default leaf, plug and pellet hop adjustments have changed from version 1.X ofBeerSmith. Most hop estimation formulas were developed using leaf hops, so version 2.0 uses leafhops as the baseline (zero adjustment) and makes 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 calculationsshould 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 bigeffect 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 mostrefractometers 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 underthe 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 withinthe 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
Welcome to BeerSmith! 61
© 2013 BeerSmith LLC
Online Articles: Yeast Starters Part 1, Yeast Starters Part 2, Making a Yeast Starter, Chris WhitePodcast, Chris White Interview
Mac Note: On the Macintosh version of BeerSmith, the options dialog is listed as Preferences underthe 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 specificgravity. 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 thefastest, liquid yeast within a few months, and dry yeast can actually last several years if properlystored.
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 throughoutBeerSmith (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 offinternal calculations if misused. The default values for the options are shown in parenthesis next to eachvalue.
Mac Note: On the Macintosh version of BeerSmith, the options dialog is listed as Preferences underthe 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. Theserepresent 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
BeerSmith 262
© 2013 BeerSmith LLC
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 higherattenuation 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 canenter the slope and center temperature for adjusting based on mash temperature. The defaultvalues 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 variousitems in the program are opened. By default most new windows will be created in a new tab, but youcan 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 atool or view. If you shift-click, the tool will display in a new window, and if you Control-click the view willdisplay in a new tab (overriding the default).
New Feature: The adjustment theme, look and feel and opening of items in tabs/windows is entirely newin BeerSmith 2.0
Mac Note: On the Macintosh version of BeerSmith, the options dialog is listed as Preferences underthe 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 ortab, 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 insteadto undo changes.
1.16.8 Custom Reports
With BeerSmith 2 you can create your own custom report formats in addition to those included withBeerSmith. Custom reports can be created either in plain text format or HTML format. HTML formatoffers 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 aretypically installed to your BeerSmith templates directory under the Program Files (Application packageon the Mac). On windows this is in the "Program Files/BeerSmith2/Reports" directory. In the Mac thereports 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 ofBeerSmith data you include the name of the BeerSmith variable with a dollar sign ('$') before it in the
Welcome to BeerSmith! 63
© 2013 BeerSmith LLC
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 recipewithin 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 thenyou 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 installyour 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 drop-
downo 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 TagActual Alcohol by Vol: $ABVAdjust Temp for Equipment: $EQUIP_ADJUSTAge beer for: $AGEAge (In Days)r: $AGEAsst Brewer: $ASST_BREWERBatch Size: $DISPLAY_BATCH_SIZEBitterness: $IBUBitterness Ratio: $BITTERNESS_RATIOBoil Ingredients: $BOIL_INGREDIENTSBoil Size: $DISPLAY_BOIL_SIZEBoil Time: $BOIL_TIMEBoil Volume: $DISPLAY_BOIL_SIZEBottling Date: $BOTTLING_DATEBrewer: $BREWERBrewhouse Efficiency: $EFFICIENCYCalories: $CALORIESCarbonation Type: $CARBONATION_TYPECarbonation Used: $CARBONATION_USEDColor Swatch: $COLOR_SWATCH((Added 3/28/08)) HEX Color: $RGB_COLORDate: $DATE
BeerSmith 264
© 2013 BeerSmith LLC
Display Age Temp: $DISPLAY_AGE_TEMPDisplay Batch Size: $DISPLAY_BATCH_SIZEDisplay Carbonation: $DISPLAY_CARBONATIONDisplay Primary Temp: $DISPLAY_PRIMARY_TEMPDisplay Secondary Temp: $DISPLAY_SECONDARY_TEMPDisplay Tertiary Temp: $DISPLAY_TERTIARY_TEMPDrink and Enjoy!: $END_DATEEquipment: $EQUIPMENTEst Color: $EST_COLOREst Final Gravity: $EST_FGEst Original Gravity: $EST_OGEstimated Alcohol by Vol: $EST_ABVEstimated pre-boil gravity: $PRE_BOIL_OGEstimated Mash Efficiency: $EST_MASH_EFFICIENCYFerment Ingredients: $FERMENT_INGREDIENTSFinal Volume: $DISPLAY_BATCH_SIZEFor Batch Size: $BATCH_SIZEGrain Temperature: $GRAIN_TEMPIngredients: $INGREDIENTSKeg/Bottling Temperature: $DISPLAY_CARB_TEMPMash Ingredients : $MASH_INGREDIENTSMash Ingredients : $MASH_INGREDIENTSMeasured Final Gravity: $DISPLAY_FGMeasured Original Gravity: $DISPLAY_OGName: $NAMENotes: $NOTESPrepare for Bottling/Kegging: $BOTTLING_INGREDIENTSPressure/Weight: $CARBONATION_PRESSPrimary Age: $PRIMARY_AGEPrimary fermentation: $PRIMARY_DATEPrimary Ingredients: $PRIMARY_INGREDIENTSRecipe Price $PRICESecondary Age: $SECONDARY_AGESecondary fermentation: $SECONDARY_DATESecondary Ingredients: $SECONDARY_INGREDIENTSSparge Steps: $SPARGE_STEPSSparge Temperature: $SPARGE_TEMPSparge Water: $SPARGE_VOLUMESteep Hops: $STEEP_HOPSSteep Ingredients: $STEEP_INGREDIENTSStorage Temperature: $DISPLAY_AGE_TEMPStyle Category $STYLE.CATEGORYStyle Letter: $STYLE_LETTERStyle Name: $STYLE_NAMETaste Notes: $TASTE_NOTESTaste Rating(out of 50): $TASTE_RATINGTertiary Age: $TERTIARY_AGETertiary Fermentation: $TERTIARY_DATETotal Grain Weight: $GRAIN_WEIGHTTotal Grain Weight: $TOTAL_GRAINSTotal Hops added to boil: $TOTAL_HOPSTunTemperature: $TUN_TEMPType: $TYPE
Welcome to BeerSmith! 65
© 2013 BeerSmith LLC
Volumes of CO2: $CARBONATIONWater preperation: $WATER_PREPYeast 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 establishyour 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 passwordo 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 inCloud 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 whounderstand proxies. Type the address (numeric or web address) of the proxy in this box. If yourproxy requires a non-standard port, you can type in address:port_number where port_number isthe 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 andtutorials to help you get up to speed quickly.
Help and Product Activation Options
o Key Help Topics
o Purchasing a Product Key for BeerSmith 2 - From our online store
o Activating BeerSmith 2
o Recovering a Lost Product Key
o Online Resources for BeerSmith 2
o About BeerSmith (shows current version number)
New to BeerSmith?
o Getting Started
o Activating BeerSmith
o Creating your Equipment Profile
BeerSmith 266
© 2013 BeerSmith LLC
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 Tabbed and Windowed Browsing
o Creating your Equipment Profile
o Building a Recipe
o Scaling and Adjusting Recipes
o Using Profiles and Styles
o Adding Custom Ingredients
o Shopping and Inventory
o Calendar and Notes
o Brewing Tools
o Unit Conversion Tools
o 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 theRecover 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 toget 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-onso Select the Delete button to uninstall a selected add-on
Welcome to BeerSmith! 67
© 2013 BeerSmith LLC
1.17.3 Checking for Updates
BeerSmith will periodically check for a new version of BeerSmith. On the help menu and ribbon there isalso a command to check for updates. When you find a new update, you will be redirected to theupdate page on the BeerSmith website. From here you can download and install the new update. It isimportant 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 tellingyou 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 whenupdates 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 originalinstallation.
1.17.4 About BeerSmith
The About command shows the copyright, current version of BeerSmith you are running and the authorand 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 directoryfor easy backup and file management. Some users have requested the ability to move it to anotherdirectory, so we have added that feature.
NOTE: BeerSmith 2 separates the Documents from the Program Files/Application so your data is notoverwritten when you update the program - DO NOT move your documents directory to the samedirectory as your BeerSmith program files, as this could result in data loss if you update your program inthe 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 directoryo As soon as you are done you will need to restart BeerSmith to use the new directory
BeerSmith 268
© 2013 BeerSmith LLC
1.19 Uninstalling BeerSmith
BeerSmith is easy to uninstall, but by default the uninstall program does not delete any of your personalrecipes 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 2Copyright 2002-2011 BeerSmith LLC
Author: Bradley J. Smith, PhDAll Rights Reserved
http://www.beersmith.com
Licensing Terms
License AgreementThis is a legal agreement between you (either individual or entity) and the BeerSmith LLCbusiness. If you do not agree to the terms of this agreement, promptly return the disk andaccompanying items to place of purchase for a refund (Registered versions only – BeerSmithLLC is NOT responsible for distribution or replacement of unregistered shareware copies).
BeerSmith 2 uses the wxWidgets library in building the binary distribution of BeerSmith. Thelicense terms of use for wxWidgets are included below. BeerSmith is distributed as a binarywork only under the binary exemption of the wxWidgets library license.
Use of the NSIS installer for installation and configuration of the BeerSmith program is subjectto the NSIS and other applicable license terms listed separately below.
Single User LicenseA single user license permits users to use BeerSmith only on two computers. Site use, networkuse, 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,
Welcome to BeerSmith! 69
© 2013 BeerSmith LLC
files, data or executables except for registered users with the express purpose of backing upthese 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 UsersBeerSmith LLC warrants that the disks provided with the registered version of BeerSmith arefree from defects for a period of 90 days from the purchase date. You may return defectivedisks to us for replacement or refund. Please return the complete package includingdocumentation in a salable state to your place of purchase.
LIMITATION OF LIABILITYBEERSMITH LLC HEREBY LIMITS THEIR LIABILITY AND EXCLUSIVE REMEDYTO 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 LLCBUSINESS, ITS PARTNERS, OFFICERS OR EMPLOYEES LIABLE FOR ANYDAMAGES WHATSOEVER BEYOND ONE OF THE TWO REMEDIES DESCRIBEDABOVE.
GENERAL TERMSUse 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 ASIS WITH NO WARRANTIES EITHER EXPRESS OR IMPLIED.
PROPER USEBeerSmith LLC prohibits the use of this software for any and all improper and illegal activitiesincluding, but not limited to: illegal brewing (check your local laws), underage brewing,promotion of underage drinking, alcohol abuse, illegal activities performed under the influence ofalcohol, and drinking and driving. We encourage the responsible adult use of the software forlegal home brewing, and urge everyone to brew and drink responsibly.
NO OTHER WARRANTYEXCEPT AS PROVIDED ABOVE BEERSMITH LLC DISCLAIMS ALL WARRANTIESWITH RESPECT TO THIS PRODUCT, EITHER EXPRESS OR IMPLIED, INCLUDING,BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY ANDFITNESS FOR A PARTICULAR PURPOSE. SHOULD THE PRODUCT PROVEDEFECTIVE IN ANY WAY THE PURCHASER ASSUMES THE RISK OF SERVICING,REPAIR, CORRECTION, INCIDENTAL, OR CONSEQUENTIAL DAMAGES.(INCLUDING BUT NOT LIMITED TO DAMAGES RESULTING FROM ACCIDENTSDURING BREWING, LOSS OF INFORMATION, ILLEGAL USE OF THE SOFTWARE,IMPROPER BREWING TECHNIQUES, DRINKING OFFENSES SUCH ASUNDERAGE DRINKING, ALCOHOL ABUSE, DRINKING AND DRIVING, CRIMESCOMMITTED UNDER THE INFLUENCE OF ALCOHOL AND THE LIKE) USING
BeerSmith 270
© 2013 BeerSmith LLC
THIS SOFTWARE.
This agreement is governed by the laws of the state of Virginia and shall inure to the benefit ofthe BeerSmith LLC and any successors, administrators, heirs, and assigns. Any action orproceeding brought by either party against the other arising out of or related to this agreementshall be brought only in a STATE or FEDERAL court of competent jurisdiction located inFairfax County, VA. The parties hereby consent to personam jurisdiction of said courts.
Trial Version Distribution RulesThe trial version of our products may be obtained from www.beersmith.com and comes with nowarranty. The trial version of BeerSmith may be distributed freely on a non-profit basis as longas it is maintained as a complete package and no attempts are made to circumvent the trialperiod or any trial feature limitations. Permission to distribute trial versions of BeerSmith on afor-profit basis must be obtained in writing from the BeerSmith LLC. BeerSmith may only bedistributed as a complete package including all documentation, program, and sample files. BeerSmith registration keys MAY NOT be distributed with or without the trial version exceptwith explicit written permission.
Trial PeriodThe trial versions of our products may have limitations or a limited trial period. Users may notreverse engineer or disable trial period protections in an attempt to circumvent the limited usefeatures of the trial version. Users may not distribute or share registration keys.
Obtaining licensed versionsYou can obtain a registered licensed key of BeerSmith from www.beersmith.com by remittingpayment as described on our web site at www.beersmith.com Each key is for use on TWOCOMPUTERS ONLY, both for use by the original registrant. The sharing, distribution, or useof one key to register more than one copy of BeerSmith is EXPRESSLY PROHIBITED by thislicense. BeerSmith LLC reserves the right to disable keys that it has reason to believe havebeen compromised, shared, distributed, or otherwise misused. Site licenses and wholesalepricing terms are available - visit our web site for details.
Alpha and Beta VersionsPre-release or so called "Alpha" and "Beta" versions of BeerSmith are for the sole use ofregistered "beta" testers. Use of any of these versions requires written permission fromBeerSmith LLC. Public distribution and use of these versions is strictly prohibited.
wxWindows Library - used internally in BeerSmith andavailable from http://www.wxwidgets.org/
wxWindows Library Licence, Version 3.1 ======================================
Copyright (c) 1998-2005 Julian Smart, Robert Roebling et al
Welcome to BeerSmith! 71
© 2013 BeerSmith LLC
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 ANDMODIFICATION 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 GNULibrary 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
BeerSmith 272
© 2013 BeerSmith LLC
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 theexception of the compression modules and where otherwise noted, are licensed under thezlib/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 version1.0.
zlib/libpng license
This software is provided 'as-is', without any express or implied warranty. In no event will theauthors 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 commercialapplications, 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 theoriginal software. If you use this software in a product, an acknowledgment in the productdocumentation would be appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be misrepresented asbeing the original software.
3. This notice may not be removed or altered from any source distribution.
bzip2 license
Redistribution and use in source and binary forms, with or without modification, are permittedprovided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditionsand the following disclaimer.
Welcome to BeerSmith! 73
© 2013 BeerSmith LLC
2. The origin of this software must not be misrepresented; you must not claim that you wrote theoriginal software. If you use this software in a product, an acknowledgment in the productdocumentation would be appreciated but is not required.
3. Altered source versions must be plainly marked as such, and must not be misrepresented asbeing the original software.
4. The name of the author may not be used to endorse or promote products derived from thissoftware without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS AND ANY EXPRESS ORIMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEARE 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 ORSERVICES; 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 INANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THEPOSSIBILITY OF SUCH DAMAGE.
Julian Seward, Cambridge, UK.
Common Public License version 1.0
THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THISCOMMON PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION ORDISTRIBUTION OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OFTHIS AGREEMENT.
1. DEFINITIONS
"Contribution" means:
a) in the case of the initial Contributor, the initial code and documentation distributed under thisAgreement, 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 thatparticular Contributor. A Contribution 'originates' from a Contributor if it was added to the Programby such Contributor itself or anyone acting on such Contributor's behalf. Contributions do notinclude additions to the Program which: (i) are separate modules of software distributed in
BeerSmith 274
© 2013 BeerSmith LLC
conjunction with the Program under their own license agreement, and (ii) are not derivative works ofthe Program.
"Contributor" means any person or entity that distributes the Program.
"Licensed Patents " mean patent claims licensable by a Contributor which are necessarily infringedby 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 allContributors.
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, publiclydisplay, publicly perform, distribute and sublicense the Contribution of such Contributor, if any, andsuch derivative works, in source code and object code form.
b) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free patent license under Licensed Patents to make, use, sell, offer tosell, import and otherwise transfer the Contribution of such Contributor, if any, in source code andobject code form. This patent license shall apply to the combination of the Contribution and theProgram if, at the time the Contribution is added by the Contributor, such addition of theContribution causes such combination to be covered by the Licensed Patents. The patent licenseshall not apply to any other combinations which include the Contribution. No hardware per se islicensed hereunder.
c) Recipient understands that although each Contributor grants the licenses to its Contributions setforth herein, no assurances are provided by any Contributor that the Program does not infringe thepatent or other intellectual property rights of any other entity. Each Contributor disclaims any liabilityto Recipient for claims brought by any other entity based on infringement of intellectual propertyrights or otherwise. As a condition to exercising the rights and licenses granted hereunder, eachRecipient 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 theProgram, 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 itsContribution, 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 licenseagreement, provided that:
a) it complies with the terms and conditions of this Agreement; and
Welcome to BeerSmith! 75
© 2013 BeerSmith LLC
b) its license agreement:
i) effectively disclaims on behalf of all Contributors all warranties and conditions, express andimplied, including warranties or conditions of title and non-infringement, and implied warranties orconditions 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 aloneand not by any other party; and
iv) states that source code for the Program is available from such Contributor, and informs licenseeshow to obtain it in a reasonable manner on or through a medium customarily used for softwareexchange.
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 thatreasonably 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 theProgram, the Contributor who includes the Program in a commercial product offering should do soin a manner which does not create potential liability for other Contributors. Therefore, if aContributor includes the Program in a commercial product offering, such Contributor ("CommercialContributor") hereby agrees to defend and indemnify every other Contributor ("IndemnifiedContributor") 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 theextent caused by the acts or omissions of such Commercial Contributor in connection with itsdistribution of the Program in a commercial product offering. The obligations in this section do notapply to any claims or Losses relating to any actual or alleged intellectual property infringement. Inorder to qualify, an Indemnified Contributor must: a) promptly notify the Commercial Contributor inwriting of such claim, and b) allow the Commercial Contributor to control, and cooperate with theCommercial Contributor in, the defense and any related settlement negotiations. The IndemnifiedContributor 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
BeerSmith 276
© 2013 BeerSmith LLC
performance claims, or offers warranties related to Product X, those performance claims andwarranties are such Commercial Contributor's responsibility alone. Under this section, theCommercial Contributor would have to defend claims against the other Contributors related to thoseperformance claims and warranties, and if a court requires any other Contributor to pay anydamages as a result, the Commercial Contributor must pay those damages.
5. NO WARRANTY
EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM ISPROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OFANY 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 issolely responsible for determining the appropriateness of using and distributing the Program andassumes all risks associated with its exercise of rights under this Agreement, including but not limitedto the risks and costs of program errors, compliance with applicable laws, damage to or loss ofdata, programs or equipment, and unavailability or interruption of operations.
6. DISCLAIMER OF LIABILITY
EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENTNOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT,INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES(INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ONANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, ORTORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OFTHE USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTSGRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCHDAMAGES.
7. GENERAL
If any provision of this Agreement is invalid or unenforceable under applicable law, it shall not affectthe validity or enforceability of the remainder of the terms of this Agreement, and without furtheraction by the parties hereto, such provision shall be reformed to the minimum extent necessary tomake such provision valid and enforceable.
If Recipient institutes patent litigation against a Contributor with respect to a patent applicable tosoftware (including a cross-claim or counterclaim in a lawsuit), then any patent licenses granted bythat Contributor to such Recipient under this Agreement shall terminate as of the date such litigationis filed. In addition, if Recipient institutes patent litigation against any entity (including a cross-claim orcounterclaim in a lawsuit) alleging that the Program itself (excluding combinations of the Programwith other software or hardware) infringes such Recipient's patent(s), then such Recipient's rightsgranted 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
Welcome to BeerSmith! 77
© 2013 BeerSmith LLC
terms or conditions of this Agreement and does not cure such failure in a reasonable period of timeafter becoming aware of such noncompliance. If all Recipient's rights under this Agreementterminate, Recipient agrees to cease use and distribution of the Program as soon as reasonablypracticable. However, Recipient's obligations under this Agreement and any licenses granted byRecipient relating to the Program shall continue and survive.
Everyone is permitted to copy and distribute copies of this Agreement, but in order to avoidinconsistency the Agreement is copyrighted and may only be modified in the following manner. TheAgreement Steward reserves the right to publish new versions (including revisions) of this Agreementfrom 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 AgreementSteward to a suitable separate entity. Each new version of the Agreement will be given adistinguishing version number. The Program (including Contributions) may always be distributedsubject to the version of the Agreement under which it was received. In addition, after a new versionof the Agreement is published, Contributor may elect to distribute the Program (including itsContributions) 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 thisAgreement, whether expressly, by implication, estoppel or otherwise. All rights in the Program notexpressly granted under this Agreement are reserved.
This Agreement is governed by the laws of the State of New York and the intellectual property lawsof the United States of America. No party to this Agreement will bring a legal action under thisAgreement more than one year after the cause of action arose. Each party waives its rights to a jurytrial in any resulting litigation.
Special exception for LZMA compression module
Igor Pavlov and Amir Szekely, the authors of the LZMA compression module for NSIS, expresslypermit you to statically or dynamically link your code (or bind by name) to the files from the LZMAcompression module for NSIS without subjecting your linked code to the terms of the CommonPublic license version 1.0. Any modifications or additions to files from the LZMA compressionmodule for NSIS, however, are subject to the terms of the Common Public License version 1.0.
Endnotes 2... (after index)
BeerSmith 278
© 2013 BeerSmith LLC
Back Cover