# O que é Brewfather? [Abrir APP Brewfather](http://web.brewfather.app)\ [Ir para página inicial do Brewfather](http://brewfather.app) Brewfather é um software para cervejeiros caseiros feito do zero para ofecerer a você **a melhor** experiência em criação de receitas e produção de cervejas, que funcione tanto em **desktop ou celular,** com um **design moderno** e fácil de usar. Faça suas receitas de forma prática e rápida! **Sincronização** automática entre todos os seus computadores e celulares, além de suporte para utilização **offline**. Disponível em formato de web app, ele pode ser usado em **qualquer celular** com um navegador/browser. Adicione-o a sua tela inicial ou desktop sem necessitar instalar nenhum software. **Android tem suporte total para web apps**, simplesmente abra-o no Chrome e adicione-o a sua tela iniciar. Para dispositivos Apple/iOS você pode encontrar o Brewfather na app store para download. Também disponível na Google Play Store para Androids, use a versão que preferir. Clique na opção abaixo para usar.\ \ [](https://apps.apple.com/us/app/brewfather/id1488585822) [](https://web.brewfather.app) [](https://play.google.com/store/apps/details?id=com.warpkode.brewfather) Brewfather inclui: * Interface **poderosa**, **intuitiva** e **fácil de usar** * Suporte a **multi-plataforma** - um único aplicativo - sempre! * Suporte para **uso offline**, salvar dados automaticamente e sincronização automática * Funcionalidade completa e fácil de usar para criação de **receitas** * Acompanhamento completo de **loets/brassagens** - registre cada etapa de sua brassagem * **Gráfico** de fermentação * Repositório com centenas de **receitas de qualidade** disponíveis para você * **Brassagem cronometrada** com alarmes e notificações ao brassar sua receita! * **Configuração** do seu equipamento, agenda de brassagem, etapas da fermentação e ajuste de água * Configuração de equipamento altamente **customizável** para se adequar a qualquer tipo * Banco de dados grande e customizável de **ingredientes**, com milhares de itens * Controle de **estoque/inventário** & **custo** * Guia de múltiplos **estilos de cerveja** (BJCP, Brewers Association, Norbrygg, SHBF, DØDL) * Suporte a estilos de cerveja customizados * **Exporte** sua receita ou lote para PDF * Importe e exporte receitas em formato **BeerXML** * Unidades métricas e US/imperial disponíveis * **Redimensione** receitas * **Compartilhe** receitas facilmente * Estime sua Gravidade Final (FG) baseado em muitas variáveis * **Calcule** cada detalhe importante da sua receita e lote * Calculadora para definir facilmente a quantidade de levedura e/ou starter de levedura * Calculadora de **ajuste de água integrada** com dados de **pH** * Strike temperature calculation * Cálculo adequado de amargor do lúpulo na cerveja * Suporte a **API** para integrar com seus outros equipamentos ou soluções de terceiros * E muito mais **ferramentas** e **funcionalidades** para ajudar na sua brassagem! Integrações: * Integre com [**Tilt**](/br/integrations/tilt-hydrometer), [**iSpindel**](/br/integrations/ispindel)**,** [**Brewpiless**](/br/integrations/brewpiless)**,** [**MyBrewbot**](/br/integrations/mybrewbot#what-is-mybrewbot)**,** [**Plaato Airlock**](/br/integrations/plaato/airlock), [**Plaato Keg**](/br/integrations/plaato/keg) **e** [**Custom Stream**](/br/integrations/custom-stream) com suporte a [**Webhook**](/br/integrations/webhook) * Integração duas vias com [**SmartPID**](/br/integrations/smartpid), para controle no dia de brassagem e fermentação * [**API** ](/br/api)para integração com projetos próprios ou for integration with your own or third party solutions ![Suporte multi-plataforma. Use-o no seu desktop ou celular.](/files/-LFSJBBOtnnOVJFtJWV_) ## Por que usar Brewfather? Brewfather entende que criar suas receitas e acompanhar seus lotes de brassagem deve ser simples e divertido, com fácil acesso a todos os seus dispositivos sem nenhuma complexidade. {% hint style="info" %} Brewfather procura atender todas as necessidades dos(as) cervejeiros(as) em um único lugar e novas funcionalidades são adicionadas continuamente. [Entre em contato](https://gitlab.com/warpkode/public/brewfather/boards) se você sentir falta de alguma funcionalidade ou identificar alguma falha/problema! {% endhint %} ## Web-app e iOS/Android app‌ Brewfather está disponível também em PWA (progressive web application), que possibilita o uso em qualquer aparelho com um navegador/browser (adicione facilmente o web-app na sua tela inicial do celular como um app, sem a necessidade de nenhuma instalação adicional). Além disso, Brewfather tem suporte total para uso offline, pois ele armazena seus dados no seu aparelho na primeira vez que você abre o app, ainda com conexão a internet. Brewfather está também disponível para as plataformas [iOS aqui](https://apps.apple.com/us/app/brewfather/id1488585822) e [Android aqui](https://play.google.com/store/apps/details?id=com.warpkode.brewfather). ## Grátis para usar o tempo que desejar! Brewfather pode ser **usado gratuitamente o tempo que desejar,** com apenas algumas limitações**.** Novos usuários tem a possibilidade de utilizar a versão Premium por 30 dias gratuitamente para testes, sem nenhuma limitação. Qualquer ferramenta ou calculadora do Brewfather pode ser usada gratuitamente sem nenhuma limitação sempre que vocês desejar. Como um usuário em modo gratuito, você está limitado a um **máximo de 10 receitas/lotes**, e nenhuma importação/exportação. Se você chegar a esse limite, você poderá deletar alguma receita ou lote e então poderá colocar outra no lugar, ou então assinar o Brewfather Premium. Se você atingir o limite de 10 receitas e/ou lotes no seu período de testes da versão Premium, você não perderá nada quando o período de testes terminar, mas suas receitas e/ou lotes ficarão disponíveis apenas em modo leitura/consulta. Você ainda poderá deletar alguma(s) para chegar a um total menor que o limite de 10 e então adicionar novas receitas novamente. ## Brewfather Premium Você pode assinar a conta Premium e desbloquear o limite de receitas/lotes e todas as funcionalidades premium. A assinatura Premium custa $1.99 dólares americanos por mês ou $19.99 dólares americanos por ano (valores podem variar de acordo com sua região/localização), e isso inclui os custos e desenvolvimento de novas funcionalidades no Brewfather. **Funcionalidades exclusivas da assinatura Premium incluem:** * **Ilimitado** número de receitas * **Ilimitado** número de lotes (brassagens) * Funcionalidades de **exportar/importar** * **Integração** com Tilt, iSpindel, Brewpiless, MyBrewbot, Plaato Airlock/Keg, SmartPID, Custom Stream e mais... * **API** para integração * Criação do seu perfil público e publicação de suas receitas na biblioteca pública de receitas do app * Controle de **estoque/inventário** * Controle de **custos** de ingredientes * Guia de **estilos de cerveja** personalizados * Possibilidade de **recuperar** receitas e lotes de brassagens deletadas * Adicionar **dados manualmente** no gráfico de fermentaçãoAccess to **experimental features** * **Muitas outras funcionalidades premium que estão por vir!** {% hint style="info" %} Para assinar o **Brewfather Premium** - vá até sua conta no [App Brewfather](https://web.brewfather.app/) e clique em **Atualizar para Premium!** {% endhint %} Todos os pagamentos e dados do cartão de crédito são gerenciados de forma segura pela [Stripe](https://www.stripe.com/). Brewfather nunca tem acesso a nenhuma informação sobre seu modo de pagamento. Totalmente de acordo com o padrão PCI. Para assinaturas direto no app, o pagamento é gerenciado diretamente pela Apple (App Store) ou Google (Play Store). ## Sobre o Brewfather Brewfather (gerenciado por [**Warpkode AS**](https://warpkode.com)) Desenvolvedor e arquiteto líder: Thomas Gangsøy. Desenvolvedor Profissional e cervejeiro de coração! Brewfather® é uma marca registrada. Brewfather**©** copyright Warpkode AS. Todos os direitos reservados. ## Documentação {% hint style="info" %} A documentação está em processo contínuo de escrita. {% endhint %} ![Monitore seus lotes de brassagens com as integrações do Brewfather](/files/-LFSJfdaVSwmwwONU9nN) # Iniciando o uso {% content-ref url="/pages/-Lus8GEuZ26A3kaJi-YF" %} [Importar Receitas](/br/getting-started/import-recipes) {% endcontent-ref %} {% content-ref url="/pages/-LF3hT9Q0s5os451J9es" %} [Vídeos introdutórios](/br/getting-started/introduction-videos) {% endcontent-ref %} {% content-ref url="/pages/-LF3ety-wpkAIUS-t78I" %} [Configurando seu perfil de equipamento](/br/getting-started/setting-up-your-equipment-profile) {% endcontent-ref %} {% content-ref url="/pages/-LF3eVpdZxRFqbwVV4t6" %} [Criando uma nova receita](/br/getting-started/creating-a-new-recipe) {% endcontent-ref %} {% content-ref url="/pages/-LF4R8Pgdnt5WKrvEQhW" %} [Tilt Hydrometer](/br/integrations/tilt-hydrometer) {% endcontent-ref %} {% content-ref url="/pages/-LF4SPDKe6PerPhJEz6J" %} [Calculadora de Água](/br/recipes/water-calculator) {% endcontent-ref %} [**Go to Brewfather APP**](https://web.brewfather.app) More information will come here about how to get started with Brewfathers most important features! Stay tuned for more. # Importar Receitas ## Importar do Beersmith 1. Exporte todas as suas receitas de uma vez selecionando as receitas/pastas que deseja exportar, clique com o botão direito do mouse e selecione "Export Selected" (Exportar Selecionados). ![Export recipes from Beersmith](/files/-Lus8_LC7dpUYCC_OJhG) 2\. Selecione **BeerXML** como tipo do arquivo quando for salvar os arquivos exportados 3\. Na página de receitas do Brewfather, clique no ícone IMPORTAR no canto direito superior ![Clique em IMPORTAR na página de receitas](/files/-Lus9ECTrb2qPnGxXK38) 4\. Selecione BeerXML como formato do arquivo a ser importado ![Selecione BeerXML](/files/-Lus9Yz6Vub48BC2zf7u) 5\. Escolha os arquivos BeerXML que foram importados e o sistema começará a importar as receitas para seu arquivo. Será solicitado para adicionar tags as suas receitas no caso de haver duplicação. ## Organizando as receitas no Brewfather Brewfather trabalha com tags para organizar suas receitas. Na página de receitas você pode ordenar por Primeira Tag. A primeira tag definida na receita aparecerá como uma pasta na lista de receitas da sua conta.. # Criando uma nova receita ## Criando uma receita Clique no botão de + ao lado de **Adicionar Receita** no canto direito inferior na página principal de receitas! ou clique no botão de + ba barra de ferramentas do topo da página de receitas.. ![](/files/-MG9hhoKrWbj-adsm6dR) # Seu primeiro lote ## Iniciando um lote/brassagem Clique no botão que há no canto direito inferior dentro de qualquer receita e então clique em **Brassar**! ![](/files/-LFSN1talyvOIOpUgu7R) # Configurando seu perfil de equipamento Para configurar o seu perfil de equipamento, selecione a página de Perfis no menu principal. Clique em EQUIPAMENTO e adicione um novo perfil, ou edite o perfil padrão. ![Perfil de equipamento é customizável para ter os números adequados ao seu sistema](/files/-LFS5yVURki0m54O7FCY) **Nome:** Nome do seu perfil de equipamento **Tempo de fervura:** Tempo de fervura para esse perfil de equipamento. Se você ajustar o tempo de fervura com a opção "Calc. vol. fervura" ativado, o volume de pré-fervura mudará para ser coerente com o novo tempo de fervura baseado na evaporação. **Descrição:** Campo livre para adicionar detalhes sobre seu equipamento. ## Volumes **Volume Desejado do Lote:** Escolha aqui se você quer o cálculo de volume final da sua mostura seja feito para o **Fermenter** ou na **Panela** ao final da fervura (quente), também conhecido como Volume Pós-Fervura. {% hint style="info" %} Usando **Panela** em **volume desejado do lote**, fica mais fácil de configurar, uma vez que o cálculo da Densidade Original (OG) será o mesmo, **independente** das Perdas no Trub/Chiller (exceto com adições no fermentador). Além disso, você só precisa saber sua **eficiência da mostura**, não sendo necessário a **eficiência do equipamento**. {% endhint %} **Volume do Lote:** Seu objetivo de volume final do seu lote de brassagem. É uma variável para o cálculo da sua densidade original (OG). **✔ Calc. vol. fervura:** Calcula automaticamente seu volume pré-fervura se estiver selecionado/ativado, calculado a partir do volume do lote. Calculada com base em sua taxa de fervura, perda de trub / chiller e **4%** de redução/expansão. **Volume Pré Fervura:** Definição do seu volume pré fervura manualmente, ou tenha-o calculado automaticamente (recomendado). Esse volume é mensurado próximo a temperatura de fervura (após a expansão).O **Volume Pós Fervura** é também mensurada na temperatura de fervura (antes do resfriamento). **Evaporação:** Taxa de evaporação por hora no seu equipamento. Variável muito importante para calcular o **volume pré fervura.** **Perdas Trub/Chiller:** Quantidade perdida com o trub (e/ou deixado no chiller e/ou tubos) **da panela para o fermentador.** Importante variável para calcular a eficiência do equipamento. **Espaço Morto na Panela de Mostura:** Volume recuperável do espaço morto na panela de mostura, usado para calcular a quantidade de água de mostura. Vale lembrar que esse volume não é perdido. Em equipamentos com fundo falso, esse é o volume necessário para que a água atinja o malte no fundo falso. Normalmente 0 (zero) em equipamentos BIAB. *O volume recuperável é o volume que não se perde na mosturação e será incluído na fervura.* **Perda na Panela de Mostura:** Volume **perdido** na sua panela de mostura e/ou volume perdido no seu processo de mostura como um todo. Normalmente 0 (zero) num equipamento one-vessel (panela única). É uma variável para a eficiência da mostura. *Valor perdido não é considerado utilizável na fervura.* **Perda no Fermentador:** Perda esperada no fermentador na etapa de engarrafar/embarrilar a cerveja. Usado para estimar o volume engarrafado/embarrilado e o potencial de densidade dos fermentáveis adicionados. **Espaço Morto na Panela de Lavagem:** é o volume perdido de onde sai sua água de lavagem. Por exemplo, se a sua água de lavagem sai de um recipiente com torneira que não permite que se retire todo o volume de água do recipiente, você deve colocar aqui essa quantidade. Esse volume será adicionado a quantidade de água de lavagem no cálculo de ajuste de água, para as definições de adições na mesma. **Água no Fermentador:** útil se você produz cervejas de alta densidade. Adição de água no fermentador para diluir o mosto, e o volume pré-fervura será reduzido para corresponder a adição prevista no fermentador. Também é útil se você adicionar algum outro ingrediente durante a fermentação. *O volume pós fervura no Brewfather se refere ao volume quente no final da fervura, ainda na panela, antes da redução (4%).* ## Eficiência **Eficiência do equipamento:** A eficiência do equipamento inclui todas as perdas até o fermentador. Variável importante no cálculo de sua Densidade Original (OG). Se você não conhece bem seu equipamento, um bom número para começar pode ser 65-75%. E você pode ajustar sua eficiência a qualquer momento após alguns lotes de brassagens. **Calcular eficiência da mostura:** É a eficiência do seu processo de mostura, até a pré-fervura, incluindo a lavagem. Variável importante para calcular sua densidade pré-fervura. Se você ativar a opção **Calcular eficiência da mostura** ativando seu checkbox, a eficiência da mostura será calculada a partir da eficiência do equipamento, com base em suas definições. Se estiver desativado, a eficiência do equipamento será calculada com base na eficiência da mostura (**recomendado**). ## Avançado **Utilização do Lúpulo:** Normalmente definido em 100%. É a média de utilização de lúpulo no seu equipamento. Isso é um fator multiplicador global para o cálculo de IBU. **Utilização de Lúpulo de Aroma:** Usado para calcular o IBU no hopstand (cesto de lúpulos) e lúpulos no whirlpool, e é também uma variável para calcular o incremento de IBU na fervura quando há um hopstand. Esse valor é somente utilizado quando nenhuma temperatura específica é definida no hopstand/whirlpool, dentro de sua receita. **✔ Calc. util. lúpulo de aroma:** Se ativado, automaticamente ele irá calcular a utilização de aroma do lúpulo baseado na temperatura definida no hopstand. **Temperatura de Infusão de Lúpulo:** É a média da temperatura de infusão do lúpulo, usado para calcular automaticamente a *Utilização de Lúpulo de Aroma* quando o *Calc. util. lúpulo de aroma* está ativado. Isso é também mostrado na ficha de brassagem se a temperatura não estiver especificada no lúpulo de hopstand. ## Água de mostura e lavagem **Taxa de Absorção de Grãos**: Volume de água absorvida pelos grãos por unidade de medida definida. L/kg quando usando unidades métricas e qt/lb quando usando unidade imperial. **Relação Água/Grão**: Quantidade efetiva de água do mash por unidade de grão. L/kg quando usando unidades métricas e qt/lb quando usando unidade imperial. **Método de cálculo de água de mostura e lavagem**:\ **Padrão**: Cálculo normal de quantidade de água de mostura e lavagem.\ **Sem lavagem**: Não fazer lavagem, volume total de água na mostura.\ **Customizado**: Defina sua própria fórmula. Fórmulas devem resultar em quantidade de água em litros. ### Água de Mostura/Volume *Configurações para calcular a água de mostura* **✔ Incluir o volume dos grãos nos limites da mostura**: Quando essa opção for selecionada, o limite mínimo e máximo da **água** de mostura se transforma em limite de **volume** de mostura. Isso significa que o volume de grãos de mostura passa a ser incluído nos números. Logo, o limite máximo do volume de mostura torna-se a capacidade máxima da panela de mostura. **Min:** Limite mínimo da água da mostura, **Max:** Limite máximo da água da mostura Se a água de mostura calculada estiver abaixo do limite mínimo, o Brewfather irá transferir certa quantidade de água de lavagem para aumentar o volume de água de mostura, aumentando dinamicamente a proporção água/grãos. Se a água de mostura calculada estiver acima do limite máximo, o Brewfather irá transferir certa quantidade de água de mostura para a água de lavagem ou complemento posterior para não exceder o limite, diminuindo dinamicamente a proporção água/grãos. ### Limite de Água de Lavagem Use essa opção para evitar quantidade elevada de água de lavagem, no caso de você ter limitação na panela de lavagem. **Min:** Tira água da água de mostura calculada, se possível, para atingir uma quantidade mínima de água de lavagem. A água de mash mínima será sempre priorizada. **Max:** Quantidade máxima de volume em seu recipiente de água de lavagem. **Limite de Transbordamento:**\ **Água Adicionada:** transbordamento é transferido para a como água adicionada (fervura).\ **Mostura:** Se a quantidade de água de lavagem calculada estiver acima do limite, ela moverá a água para a mostura (até que o volume máximo de mostura seja alcançado) e/ou a água adicionada não exceda o limite. **Quantidade mín. de água de lavagem**: Define a quantidade mínima sugerida de água de lavagem que você deseja para que seja possível cobrir sua unidade de aquecimento. ### Temperatura da Água Desejada **✔ Calc. temperatura inicial da água:** Quando esta opção é selecionada, uma temperatura desejada é calculada e adicionada como a primeira etapa em sua programação da mostura. **Capacidade de aquecimento da panela de mostura em *****volume de água equivalente em L*****:** Se a sua panela de mostura for pré-aquecida, defina a capacidade de aquecimento para 0. Caso contrário, use a **ferramenta de calibração da panela de mostura** para obter o valor para o seu equipamento. Este **não** é o volume da panela de mostura. ### Temperatura da Lavagem Entre com a temperatura desejada da lavagem. ## Passos para configurar um perfil de equipamento para uma single vessel 1. **Espaço Morto na Panela de Mostura**: Adicione água até chegar ao fundo falso de malte e observe exatamente a quantidade de água que você precisou adicionar. 2. Com o fundo falso colocado, adicione água até atingir 2-3 cm do topo da cama de grãos e observe exatamente a quantidade de água. Este será o **volume máximo de mostura** (incluindo **grãos**). Se o equipamento tiver a função de transbordamento, pare antes que ela transborde. 3. Teste a **fervura**, ajuste a potência (se possível) para atingir uma fervura adequada idealmente com mosto, mas com água também é possível, e observe a quantidade de água evaporada por hora. Lembre-se de medir os volumes na mesma temperatura, quente ou fria. 4. Meça quanta água restou no sistema após bombear/drenar toda a água/mosto, e estime a **perda com o trub**. 5. Para descobrir uma proporção razoável de **água/grão**, idealmente, deve-se fazer várias mosturas e obter dados mas uma alternativa é fazer cozimento com cerca de 1.060 OG e observar a quantidade de água adicionada para obter uma boa densidade de mostura. Subtraia o espaço morto da panela e, a seguir, divida a quantidade de água pela quantidade de grãos para obter a proporção água/grãos. 6. Comece com, por exemplo, uma eficiência da equipamento de 70% ou eficiência de mostura de 75% e ajuste-a ao seu resultado após as primeiras preparações. É possível de estabelecer um perfil básico a partir disso, que pode ser ajustado conforme você adquire mais experiência com a eficiência e perdas. # Vídeos introdutórios *Vídeos em inglês* Rápida introdução para criar sua primeira receita e lote no Brewfather (por KegLand): Configurando seu perfil de equipamento: Assista a introdução e o passo-a-passo feito por Hop Rod Garage [![Brewfather](http://img.youtube.com/vi/GMNkHXhClX4/0.jpg)](http://www.youtube.com/watch?v=GMNkHXhClX4) (Versão em Inglês) [https://youtu.be/eA0ts87FVgc](https://www.youtube.com/watch?v=eA0ts87FVgc) (Versão Norueguesa) Método de fácil de química da água : # Receitas ## Procurar receitas ## Abrir receita ## Ordenar receitas ## Adicionar nova receita ## Importar receita # Visão Geral ![](/files/-MHC8rUBSBhgIib9K-xa) ### Redimensionar a receita Altere o tamanho do lote ou a eficiência do seu perfil de equipamento dentro de uma receita específica, clique em salvar e o Brewfather vai te dar a opção de alterar automaticamente a receita (quantidade de maltes, lúpulos etc) para ficar coerente com os novos números (OG, ABV, volume etc). Se você mudar para outro perfil de equipamento, ele perguntará se você deseja escalar a receita também! ### Excluindo receitas Clique no botão de opções que há no canto direito inferior e então clique em EXCLUIR. ### Perfis em receitas existentes Quando você altera um perfil (equipamento, mostura, fermentação ou água) na **página de perfis**, você precisa selecioná-lo novamente na sua receita após as mudanças feitas no perfil. Isso é porque um perfil numa receita não é atualizado automaticamente para evitar alterações inesperadas em suas receitas antigas. Essas receitas ainda irão manter o mesmo perfil de quando a receita foi criada, e isso vale para todos os tipos de perfis. Novas receitas criadas após a alteração dos perfis já terão os dados atualizados daquele perfil que você definiu como padrão. ### Densidade Final Fixa / Densidade Final Estimada Se sua Densidade Final está definida para um valor fixo, você então é preciso clicar no botão **Densidade Final** e depois em **Redefinir** para ter o valor estimado. Isso acontece quando a receita é importada ou quando a densidade final foi definida manualmente. # Relative Bitterness Ratio RBR This article is mostly copied from the [original RBR article](http://www.madalchemist.com/relative_bitterness.html) (article source), all credits goes to: [Mad Alchemist](http://www.madalchemist.com/): The author Ryan Shwayder. The central purpose of this article--is that the Bitterness Ratio (BU:GU) that many homebrewers use can be easily made more accurate by focusing on more than Original Gravity and International Bitterness Units. Some factors impacting beer balance are not numerically quantifiable in simple terms. Examples include the malt bill (e.g. 1 lb of Honey Malt contributes far more sweetness than 1 lb of Chocolate Malt--although I almost tried to factor SRM into the new calculation), adjuncts, yeast, mash schedule, and hop variety. You must use your judgment and experience with regard to balance in these areas, because numbers are limited in what they can express. That said, one piece of data we have available to us is not figured into the standard Bitterness Ratio; attenuation. The more attenuated a beer is after fermenting, the fewer fermentable sugars--and therefore residual sweetness--are left behind. Without taking attenuation into account, the Bitterness Ratio is not quite as accurate as it could be in quantifiable terms. For example: A beer that starts out at an OG of 1.050 at 25 IBU would be said to have a Bitterness Ratio of 0.5. If it were split into two batches and one had an apparent attenuation of 80% (Beer A), while another had an apparent attenuation of 60% (Beer B), Beer A would be perceived to be more bitter than Beer B, as the latter has considerably more residual sweetness. The numbers in the tables and charts linked below reflect this theory that I have taken to calling the Relative Bitterness Ratio (RBR). The purpose of BU:GU and RBR are one in the same; to aid in properly balancing a beer against your taste expectations. Since balance expectations are set relative to all beers, we take into account a beer's Apparent Attenuation in comparison to the average beer, and increase the BU:GU if it is more attenuated than average or decreate the BU:GU if it is less attenuated than average. Just like BU:GU, RBR is more bitter when the number is higher and less bitter when the number is lower. If you are used to BU:GU numbers, you will already have an understanding of RBR because the numbers are essentially the same (\~0.5 is average balance--anything lower leans toward sweetness, and anything higher leans toward bitterness). The numbers listed under "Relative Bitterness" should appear familiar to those who have been using BU:GU for a period of time. The Relative Bitterness Ratio can be determined with a fairly simple formula using data you likely already have if you know your BU:GU. > `RBR = (BU:GU) x (1 + (ADF - 0.7655))` RBR = Relative Bitterness Ratio. ADF = Apparent Attenuation. 0.7655 is the average ADF of all beer styles. Since the Relative Bitterness Ratio takes into account balance relative to all beer styles, it uses this as a constant. You are comparing your beer's ADF against the average ADF (0.7655), then adjusting the standard Bitterness Ratio accordingly (it goes up if your ADF is higher than average, down if your ADF is lower than average). Just like BU:GU, higher numbers mean more bitter, lower numbers mean less bitter, and 0.5 is roughly average balance. How do you use this formula? Here's an example. > Beer A has an OG of 1.050 at 25 IBU. The BU (Bitterness Units) is 25 and the GU (Gravity Units) is 50. Therefore, the BU:GU ratio is 0.5 (25/50) > > The Apparent Attenuation of Beer A is 80%, or 0.8. So, the formula is as follows: > > `RBR = (BU:GU) x (1 + (ADF - 0.7655))`\ > `RBR = (25/50) x (1 + (0.8 - 0.7655))`\ > `RBR = 0.5 x (1 + (0.0345))`\ > `RBR = 0.5 x 1.0345`\ > `RBR = 0.51725` > > Since Beer A has a higher ADF than the average beer, it will be a little more bitter, relatively speaking. This means the Relative Bitterness Ratio (RBR) is slightly higher than the Bitterness Ratio (BU:GU). > > Beer B has an OG of 1.050 at 25 IBU. The BU (Bitterness Units) is 25 and the GU (Gravity Units) is 50. Therefore, the BU:GU ratio is 0.5 (25/50) > > The Apparent Attenuation of Beer B is 60%, or 0.6. So, the formula is as follows: > > `RBR = (BU:GU) x (1 + (ADF - 0.7655))`\ > `RBR = (25/50) x (1 + (0.6 - 0.7655))`\ > `RBR = 0.5 x (1 + (-0.1655))`\ > `RBR = 0.5 x 0.8345`\ > `RBR = 0.41725` > > Since Beer B has a lower ADF than the average beer, it will be a little less bitter, relatively speaking. This means the Relative Bitterness Ratio (RBR) is slightly lower than the Bitterness Ratio (BU:GU). As you can see from the example above, the calculation is quite simple when you already know your beer's expected apparent attenuation, gravity units, and IBUs. **Brewfather calculates both BU:GU (Bitterness Ratio) and RBR (Relative Bitterness Ratio) for you automatically. And is displayed below the Hops section in your recipe. If you click the BU:GU or RBR in the recipe designer you will also get style guide ranges for these values.** # Calculadora de Água ## Configure seu perfil de água - origem Acesse **Perfis** no menu principal e selecione **Água**. Selecione o perfil padrão e ajuste os valores para a água que você usa em suas brassagens. Para mais informações clique no link abaixo. {% content-ref url="/pages/-LF4S8rfwyLBc\_nYbrol" %} [Water](/br/profiles/water) {% endcontent-ref %} ## Localize a calculadora de água Normalmente você não quer começar ajustar a água até que o restante da sua receita esteja finalizada. Logo depois de criar sua receita e chegar na parte de ajuste de água, você encontrará a seção de calculadora de água na página de criação de receitas. ![Clique no botão CALC para iniciar o cálculo de água](/files/-MHsfBnjsclgSAWq0P-K) Isso abrirá a calculadora semelhante a tela abaixo: ![](/files/-MHsfa6ajamw9gWWxdJl) No topo você pode ver o pH da água em temperatura ambiente. **Todos os valores de pH devem ser medidos com o mosto em temperatura ambiente**. {% hint style="info" %} *Nota:* O pH medido irá variar dependendo de qual temperatura você medir, e isso não é uma falha do equipamento. Brewfather prevê que o **pH deve estar entre 5,2 e 5,6** em 20°C, e caso você não resfrie sua amostra a essa temperatura, seu medidor de pH mostrará algo em torno de 5,5 e 5,9 com ATC (Compensação Automática de Temperatura). *Medir o pH em temperaturas reais de mash pode danificar seu equipamento e não é recomendado*. {% endhint %} Existe um ícone de engrenagem que permite alterar algumas configurações relacionadas à calculadora de água. Detalharemos isso mais tarde. ## Grãos ![](/files/-MHshjjjTl2dNbNg8Ebk) A primeira parte da calculadora de água mostra os grãos em sua receita, e a calculadora atribui automaticamente um tipo de grão a cada um deles. Verifique se o grão e a **cor do grão** correspondem aos grãos que você usará e se o **tipo de grão** está correto. Se você usar algum malte **cristal**, **torrado** ou **acidificado**, certifique-se de que eles sejam atribuídos à categoria correta pois eles têm um grande impacto no pH estimado. Ajuste se necessário. ![](/files/-MHsiWqkdnsULt-KMSwb) Você também pode ignorar os grãos, fazendo com que não sejam considerados para o cálculo do pH. Útil se você estiver apenas utilizando um grão específico. ## Quantidade de Água A próxima seção mostra a quantidade de água de acordo com sua receita e perfil de equipamento. Verifique se eles estão corretos e ajuste os dados, se necessário. Por exemplo, você pode querer adicionar mais água de lavagem se tiver espaço morto panela de aquecimento de água de lavagem. ![Volume de Água](/files/-MHsk2aGkpr_KyVAH4wi) ## Água Origem Seu perfil padrão de água origem é pré-definido a deve normalmente não necessitar de alterações se você já fez isso anteriormente. Caso você utilize vários tipos de água diferentes, crie um perfil para cada uma delas e então você pode escolher a água a ser utilizada ao clicar no botão **alterar**. ![Perfil de Água Origem](/files/-MHskaiOP-wcHPI_Px4w) ## Água Alvo Se você deseja atingir um perfil de água específico para o ajuste da água, você pode, opcionalmente, selecionar ou criar um novo perfil alvo. O perfil alvo é usado quando você deseja usar o recurso de ajuste automático para atingir o perfil desejado partindo da sua água de origem. O perfil de água alvo também é o que aparece como uma diferença em seu perfil de água total durante o ajuste. ![Perfil de Água Alvo](/files/-MHslH54jwsZ2dRR_LEm) ## Comparação de Estilo ![Recomendação de Perfil para o estilo escolhido (cream ale, no exemplo)](/files/-MHslj1ENilWtKxhAzZ1) A seção de estilo permite que você compare o perfil total da água com uma faixa geral recomendada ou com uma recomendação de estilo específico. Se o seu perfil de destino estiver acima ou abaixo do intervalo recomendado, ele será exibido em **vermelho**; se estiver dentro do perfil recomendado, será exibido na cor **verde**. ![Exemplo de perfil para o estilo American IPA](/files/-MHsmLEOTdL1_cs0In82) Para selecionar outro estilo e ver sua recomendação, clique no no nome do estilo que está a direita da barra cinza, e selecione o estilo que você desejar verificar. ## Ajustando as adições ![Água sem ajuste](/files/-MHsn54PoICuZ5839By-) Essa seção da calculadora de ajuste de água é onde você altera as adições de minerais. Se você criou ou selecionou um perfil alvo, você pode clicar no botão AUTO para receber automaticamente a adição que resulta no valor mais próximo do desejado. {% hint style="info" %} A calculadora de água padrão apenas ajusta AUTOMATICAMENTE Sulfato de Cálcio, Cloreto de Cálcio e Sulfato de Magnésio. Como esses minerais apenas ajustam os níveis de cálcio, cloreto, magnésio e sulfato, o restante será deixado como está. Isso pode ser alterado nas configurações de água. {% endhint %} Com um clique no botão AUTO, você obterá uma correspondência mais próxima ao seu perfil alvo, dependendo de quais ingredientes estão ativados e definidos para serem ajustados automaticamente. ![](/files/-MHsoN4days0Fh8AE0za) Neste exemplo obtivemos uma boa correspondência nos valores que os ingredientes ativados ajustam e atingem mais ou menos nossos níveis desejados de cálcio, magnésio, cloreto e sulfato e nossa relação sulfato / cloreto desejada. Ajuste conforme necessário ou ajuste manualmente seus valores para atingir o perfil total de água desejado {% hint style="info" %} O ajuste automático não ajustará os ingredientes para que você exceda qualquer um dos valores de seu perfil alvo. Portanto, se você tiver problemas para atingir a proporção desejada de cálcio ou cloreto/sulfato com o recurso de ajuste automático, tente aumentar outros valores alvo, para permitir uma variação maior. {% endhint %} ## Sparge Water ![](/files/-LFA4orhzLo9afiSs_Yx) When adjustment of sparge water is enabled, it will automatically calculate the needed amount to match your desired total water profile. When deactivated these minerals will be added to your mash water. ## Acid ### Mash ![](/files/-LFA5G1uWFgg7G4YWgY9) This section allows you to adjust your mash pH down by Lactic or Phosphoric acid. Select your acid type with the dropdown and set the concentration to your acid strength. Adjust the amount to match you desired mash pH. ### Sparge ![](/files/-LFA5hJt5ALwjtOBTmpt) This section allows you to get a calculated amount for how much acid to add to your sparge water to reach a desired target pH. Enter your source pH and sparge water target pH. Usually you want your sparge water pH between 5.5 and 6 to reduce tannin extraction. ## Save adjustments to your recipe The data entered in the water calculator is saved to your recipe, so you can easily alter them later if needed. To automatically save your ingredients to the Misc section of your recipe. Click the green **Save adjustments to recipe** button at the bottom. ![BOOM. Adjustments saved to your recipe. Ready to brew!](/files/-LFA6L2iaKm1Dity8GkX) ## Water Settings To show the water settings click the cog in the top right of the water calculator. ![Water Settings](/files/-LFA1mK7P_ktZ8nqFGCM) \ In the water settings you have a list of all the ingredients available to the calculator. By default only a few of them are activated as these are the most common ingredients used in water adjustments. And only Gypsum, Calcium Chloride and Epsom Salt is activated for auto adjustment as default. In the advanced section you can **choose what form of Calcium Chloride** you are using. The default is Flaked. You can select Flaked, liquid or anhydrous. If you select liquid you can enter your concentration. You can also select if your sparge water adjustment should be activated by default. ### Chalk Using **Chalk** is **not recommended**, it is much preferred to use **Baking Soda NaHCO3** (*or Slaked Lime*) to increase pH. The reason for this is that under normal conditions Chalk reacts slowly and you will not get the effect on pH that you want when you need it. Much of the Chalk you add to mash will end up sitting on the grains after sparging and some will make it trough into the kettle and fermenter where it will continue to react and raising pH duing parts of the process where you would want it to be falling. There are work-arounds such as dissolving it in acid but you need to be careful that you don't acidify below pH 8.4 (at which pH all the carbonate has been converted to bicarbonate which does react rapidly enough to do what you want to do). One of the acids for this purpose is carbonic acid. To use it the Chalk (CaCO3) is placed in a pet bottle with water and CO2 injected to raise the pressure to the point where enough H2CO3 is dissolved to, in turn, dissolve the CaCO3. The goal is to get the CO3-- converted to Bicabonate (HCO3-) and the tricky part is that as soon as the pressure is released the HCO3- will convert back to CO3-- and re-precipitate as microcrystals you cannot see and you think you have dissolved all the Chalk. And some of is still dissolved. The problem is that you won't really be able to tell exactly how much you have dissolved. (Source: [AJ Delange](https://www.homebrewtalk.com/forum/threads/am-i-calculating-my-ph-right.652497/#post-8347271)) The option to activate Chalk is still there but use it carefully knowing the limitations. ## General help ### Solubility of minerals Calcium Chloride is quite soluble. \ Calcium Carbonate (Chalk) is quite insoluble. \ Gypsum (Calcium Sulfate) is not as soluble as Calcium Chloride, but much more soluble that Calcium Carbonate. \ Calcium Carbonate and Calcium Sulfate are both **less** soluble in **hot water than cold** (which is the reverse of the usual case). (Source: [AJ Delange](https://www.homebrewtalk.com/forum/threads/a-brewing-water-chemistry-primer.198460/#post-2324604)) ### Calcium Chloride form In the water calculator settings you can select between **Anhydrous**, **Dihydrate** and **Liquid**. #### Anhydrous **Anhydrous** is defined as without water. Therefore the anhydrous Calcium Chloride has a higher over all amount of calcium by weight. **CaCl2** which has a molecular weight of 110.98 g/mol. Allegedly this would mean it is 100% Calcium Chloride. Anhydrous Calcium Chloride can be sold in pellet form. #### Dihydrate Calcium Chloride **Dihydrate:** **CaCl2·2H2O** has a molecular weight of 147.0 g/mol This means the dihydrite is **theoretically at most**: (110.98 g/mol/147 g/mol x 100%) = **75.50 %** Calcium Chloride. In the real world the Calcium Chloride **Dihydrate is said to vary from 77% to 80%** Calcium Chloride. But selecting **Dihydrate / Flake** in the settings is recommended. **Dihydrate** is typically in a flake form. #### Liquid When selecting Liquid as form you can enter the strengt/concentration of your solution. ([Source](https://www.researchgate.net/post/Can_I_use_calcium_chloride_dihydrate_instead_of_calcium_chloride_for_the_preparation_of_buffer)) # Calculations ### Wort color $$ MCU = (Grain ColorLovibond \* Grain Weight Lbs)/VolumeIn UsGallons $$ $$ SRM Color = 1.49 \* (MCU \* 0.69) $$ $$ EBC = SRM \* 1.97 $$ # Lotes ![Na página de lotes você tem a visão geral de todas as suas brassagens planejadas, atuais ou passadas](/files/-MMN88C0XcPS7FsuRKW_) #### Criando um lote Clique no botão em verde **Brassar** na página de alguma receita (imagem de uma caneca de chopp, no canto direito superior) #### Excluir um lote Clique no botão de menu no canto direito inferior quando estiver num lote e então clique em EXCLUIR. # Planejado ![Fase de planejamento do lote](/files/-MMN8p56fTkO4X4OI4dt) Na parte do planejamento do seu lote você pode nomear e numerar o lote, além de definir a data de brassagem, verificar inventário ou editar a receita. O lote inclui uma cópia da receita, ou seja, qualquer mudança que você faça na receita quando estiver no modo de lote não irá alterar a receita original, a menos que você clique em SALVAR na parte da receita. Isso vale também para o caso de você fazer mudanças na receita original na página de receitas de um lote que está planejado, pois você terá que clicar em ATUALIZAR A RECEITA (ícone de uma seta em círculo) para que as alterações reflitam em seu lote. Desse modo o seu lote terá sempre uma cópia da receita do modo que ela era quando você fez a brassagem e então servirá também como um registro de versões de variações de uma mesma receita que você brassou várias vezes. Se você quiser uma nova cópia da receita do lote na sua página de receitas, abra a receita ao clicar em EDITAR (na página de lotes) e então clique no botão CLONAR (canto direito inferior). # Brassagem Entre em modo de brassagem ao clicar em **BRASSAGEM**, nas etapas disponíveis na parte superior da tela. ![Acompanhamento de Brassagem (opcional) para acompanhar e cronometrar sua brassagem.](/files/-MMNFkQ-Za0o-_Nfa8Gz) ![Ficha de brassagem e campos para anotar todas as medições, com valores previstos e estatísticas](/files/-MMNGG7l1_zN9kxQhpwI) # Fermenting ![Follow your fermentation realtime and log all your data with the many integrations aviailable (optional)](/files/-LUFiW0N2f6O8ePs_oLL) ![Follow your fermentation profile and additions, enter measured values and get stats](/files/-LUFiqe6tXpwiKHoM4ge) ![Calculate carbonation, see you stats and enter/see log details](/files/-LUFj3_KGGWa9YKpgKd4) # Completed ![Full overview over how the batch went, add taste rating if you want](/files/-LUFjPTzgJHsMHMpSTHU) # Devices This page is only active when at least one device is activated The devices page lists all your devices and the latest data recieved from them. Activate devices on the [Settings](/br/settings) page. You can also configure and remove devices. ![Total control over all your integrated devices](/files/-LUFkKnl1KqWA1YXjrqe) ### Settings #### Gravity offset Offset needs to be written as a full number eg -8 instead of -0.008 when you want to adjust for example a gravity reading of 1.052 to 1.044. # Inventory The inventory is designed to be fully customizable, that means you can add, edit and delete everything. ### Deleting inventory items If you delete an item, you actually remove it from your personal list of ingredients. When organizing inventory stock amounts you don't want to delete items, you want to edit the inventory amount field (setting it to 0 indicates out of stock). If you accidentally delete an item you can add it back by either: 1. Add it back from a recipe where the ingredient have been used from recipe (preferrably), 2. Add it again filling in the info manually, 3. restore default data in the settings (warning: this will reset all in the given category). ### Track inventory usage You substract from inventory when you plan a batch, and actively check each ingredient to remove them from inventory. ![Items not in stock is marked with a red exclamation mark](/files/-LFvaWyYxMHmTYDS9ruf) # Fermentables # Adding new malts The important number to know when adding your own malt is the extract number This document is based on this [blog post](https://famouslastworts.com/2019/05/24/calculating-potential-extract-from-malt-coas/?fbclid=IwAR06mrOklbeq7c9B_v7orOXN582TbV8XbREWxe7ge_Nzu1Guya77JgZzcMA) by Chris Saunders. ## Calculating Potential Extract for Brewfather from Malt COAs How much sugar (extract) can we get from malt? When we first start learning to brew the numbers seem like magic and try out best to use what our software or lookup tables (such as those in Palmer’s “How to Brew”) for granted. It’s possible to generalize a grain into one of the known categories, but with the rise of new malts and craft malsters those assumptions may end up being further off than expected. The end result? Missing gravity targets. However, calculating potential extract is quite straightforward and only requires a little bit of math. ### Understanding a Malt Certificate of Analysis ![Weyermann Certificate of Analysis for Colonge Malt](https://famouslastworts.files.wordpress.com/2019/05/screenshot-2019-05-24-06.52.25.png?w=800) In the above Weyermann COA we can see they include a lot of information that brewers can use to understand how a certain malt lot may impact brewhouse performance. In order for us to calculate the potential extract we are interested in two items: **moisture content,extract** and **fine grind – coarse grind difference.** In the above certificate we are lucky because the malster has provided us with the extract brewers are concerned with; **extract dry basis**. The terminology for this field can vary from maltster, it’s also sometimes known as **extract coarse ground, dry basis**. In either case, we want to be working with the dry basis (db) extract and can work backwards from there. As you might guess, the dry basis extract isn’t what we can expect from our grain because there’s still some moisture trapped in the malt. This moisture provides no extract whatsoever, so we will need to calculate what the actual extract of the malt will be. With this information we will be calculating **percent extract coarse grind, as is (%extract cg, ai)**. We also need to know what the **fine grind to coarse grind difference** is, which can sometimes be included on the certificate of analysis. The reason for the difference is because malsters perform their lab mashes (also known as the congress mash) on very finely crushed grain. This doesn’t represent the real world because mashing with such highly crushed grain would clog up lauter tuns! Some malsters may provide the difference, however it’s not always provided. Usually the difference between a coarse grind and fine grind won’t be more than 2% extract. A rule of thumb one can use 1% as the fine grind to coarse grind difference ``` %extract gc,ai = %extract cg,db x (1 - %moisture) ``` From the Weyermann Colonge malt we have the following numbers: * %extract (fine grind) dry basis: 81.6% * %moisture: 4.2% * fine grind – coarse grind difference: unknown; use 1% ``` %extract cg,db = %extract fg,db - 1% = 81.6% - 1% = 80.6% %extract cg,ai(WEY Cologne) = 80.6% x (1 - 4.2%) = 80.6 x (1 - 0.042) = 77.21% ``` So what does this mean? We now know that from every unit of Weyermann Colonge malt we will get 0.7721 units of extract (sugar) out of it (77.21%). #### [Spreadsheet to help calculate can be found here](https://docs.google.com/spreadsheets/d/1JcAMBRRWAhd9pZi-c7WgXc6l389Dg6dHjsfl9gluFPg). ## Adding a New Malt to Brewfather For this example, the Weyermann Colonge malt will be added to the [Brewfather](https://brewfather.app/) database. All that needs to be provided is the coarse grind as is extract. In this example 77.21% is set as Yield, then the Potential SG field is filled in automatically. ![Add new malts from the inventory page, click Fermentables, then Add.](https://famouslastworts.files.wordpress.com/2019/05/screenshot-2019-05-24-07.43.17.png?w=800) The **ppg**s line up with what was calcuated, which is a great way to validate that the new fermentable has been entered correctly. ### (Optional) How Potential/“Homebrew Units”/PPG is calculated In Brewfather you don't need to do this conversion or calculation, since you can enter the Yield % directly, but it can be useful for other use cases. The most common homebrew unit is **ppg** which stands for **p**oints per **p**ound per **g**allon. There’s another unit that metric users can use called the **pkl** which stands for **p**oints per **k**ilogram per **l**itre. It’s possible to actually calculate out how many ppgs or pkls one would get from their malt however there is an easier way to do it. There’s an adjunct that provides 100% extract and is very well documented in homebrewing books; sucrose! ``` ppgSucrose = 46 pklSucrose = 384 ``` With the known maximum for our homebrew unit of choice, we can figure out what our potential extract will be: ``` ppgWeyColonge = 46 * 0.7721 = 35.5 (1.036) pklWeyColonge = 384 * 0.7721 = 296.5 ``` The potential number in Brewfather is PPG in the format of 1.0XX, so the example above would be 1.036. ## Different Malsters. Different COAs Every malsters COA will look different, however with armed with the knowledge above it should be possible to find the required information to determine how much sugar a new malt will contribute to a brew. Instead of substituting a specialty pilsner malt from your local micro malster as “Canadian Pilsner Malt” with a note, it can be listed in recipes as the proper malster and product. ## References * How to Brew (4th Edition) John Palmer; Brewers Publications * A Handbook of Basic Brewing Calculations; Stephen Holle; MBAA # Hops # Miscs # Yeasts # Library ![](/files/-Lnb8W57N5X5Jlxza6s6) In the public recipe you can search for recipes shared by other Brewfather users. Located as a new page called "Library" in the menu. To share your recipes in the library there is now a new "padlock" icon in the recipe designer. Clicking this you can toggle the recipe to be publicly available. All users can view and download recipes. Upload (and voting) of recipes are for Premium users only. Text search can be used to search for all the visible text fields, inlcuding recipe name, style, tags, profile name. More filtering options will come later as the library grows. #### New public profile creation Be quick and reserve your brewery profile name today, this is unique and will be used to identify you in future Brewfather community features. The first time you try to share a recipe, you will be asked to create a public profile where you upload a brewery avatar, and choose your brewey profile name and so on. You can also initialize the public profile creator from the account page. Only premium users can create a public profile. ## Match copied recipes to your equipment When you copy someones recipe and want to brew it yourself here is a couple of suggestions: Open the recipe and click change equipment, select your own equipment profile, then it will ask you to scale when you click save. Then it will scale ingredients to match your efficiency and volumes. * If the recipe has hopstand, double check that hopstand-temp is the same in your equipment profile before you click save. * If you do water adjustments, open the water-calculator and re-do them to match your water. It could also be wise to open the yeat calculator and redo that to your liking and to get whole numbers. After doing this the recipe will match your equipment. # Perfis # Equipamento {% content-ref url="/pages/-LF3ety-wpkAIUS-t78I" %} [Configurando seu perfil de equipamento](/br/getting-started/setting-up-your-equipment-profile) {% endcontent-ref %} # Mash ## Getting Super Powers Becoming a super hero is a fairly straight forward process: ``` $ give me super-powers ``` {% hint style="info" %} Super-powers are granted randomly so please submit an issue if you're not happy with yours. {% endhint %} Once you're strong enough, save the world: {% code title="hello.sh" %} ```bash # Ain't no code for that yet, sorry echo 'You got to trust me on this, I saved the world' ``` {% endcode %} # Fermentation # Water ![Enter your water report values as ppm (mg/l)](/files/-LFwu_LgwZDPkgaINYhY) ## Water Report Conversion Brewfather uses ppm values for the water profile, so your water report have to be converted to this. Below you will find help converting your values to ppm. 1 **mg/L** = 1 ppm From **Alkalinity mmol/l** to ppm Bicarbonate HCO3: **multiply by 61**\ From **Alkalinity mg/l CaCO3** to ppm Bicarbonate HCO3: **multiply by 1.22**\ *From Alkalinity mmol/l to mg/l CaCO3: multiply by 50*\ \ 1000 **ug/L** = 1 ppm\ **ug/L** / 1000 = ppm ### Ion Conversion Calcium as **CaCO3** ppm \* 0.401 = **Calcium (Ca)** ppm\ Magnesium as **CaCO3** ppm \* 0.243 = **Magnesium (Mg)** ppm\ Sulfate as Sulfur ppm as **SO4-S** \* 3 = **Sulfate (SO4)** ppm\ Bicarbonate as **CaCO3** ppm \* 1.22 = **Bicarbonate (HCO3)** ppm\ \ US Hardness *grains/gallon* \* **6.86** = **Calcium (Ca)** ppm\ °Clark / °e (English) Hardness *grain/imp gallon* \* **5.71** = **Calcium (Ca)** ppm\ German Hardness (°dH, deutsche Härte) \* **7.14** = **Calcium (Ca)** ppm\ Calcium Hardness mEq/L or mval \* **20** = **Calcium (Ca)** ppm\ \ Karbonate Hardness dKH \* **21.8** = **Bicarbonate (HCO3)** ppm\ **Alkalinity mEq/L** or mval \* **61** = **Bicarbonate (HCO3)** ppm\ \ *Minor Ions (Currently not in use)*\ *Carbonate as **CaCO3 ppm** \* 0.6 = Carbonate (CO3) ppm*\ *Nitrate as Nitrogen **ppm as NO3-N** \* 4.43 = Nitrate (NO3) ppm* ### pH If the water report does not inlcude the pH you can use 8.0 as pH. {% content-ref url="/pages/-LF4SPDKe6PerPhJEz6J" %} [Calculadora de Água](/br/recipes/water-calculator) {% endcontent-ref %} # Styles ![Multiple style guidelines from BJCP, Brewers Association, Norbrygg, SHBF](/files/-LFTYedP5DqbzFlcQmi0) # Tools ![](/files/-LFRyfi6_hWv_pkmeG8F) # Alcohol ![Enter OG and FG to get important stats about your product](/files/-LFRyrZ7JDLgWKBe5Qe7) # Yeast Calculator ![Calculate how many yeast packages to add or how big of a starter to make](/files/-LFRz7vV7GrzRxnwYWEd) ### PurePitch Formula for calculating viability for White Labs PurePitch® yeast packets is based on official data found here: Average viability of PurePitch® pure liquid yeast over a period of six months: | Time | Viability | | -------- | --------- | | 1 month | 99.21% | | 2 month | 98.05% | | 3 month | 90.26% | | 4 months | 84.28% | | 5 months | 79.35% | | 6 months | 71.59% | # Refractometer ![Convert Brix to SG, or calculate fermented SG based on OG and Brix reading](/files/-LFRzK_rYuLY19uPaTFf) # Gravity Correction ![Calculate how much DME to add or how much to boil off if gravity is too low](/files/-LFRzZp_5fIURKgHUuIc) ![Calculate how much water to add if gravity is too high](/files/-LFRzf-S2IOdn-oJVex5) ![Calculate how to correct the gravity by altering boil time if preferred](/files/-LFRzqyr1VqNl8N6oRjD) # Hydrometer Correction ![Calculate corrected SG based on hydrometer reading and given temperature](/files/-LFS-emMS8i803n51IHX) # Carbonation ![Calculate sugar amount when carbonating with sugar](/files/-LFS-rXxbPgfaD4-_Fzb) ![Calculate carbonation preassure when force carbonating](/files/-LFS-ztYzar37dQwQQ1o) # Settings ![Overview of all the settings available](/files/-LUFXraXs8qyfh4r7GBg) In the settings you can... * Set your next batch number * Change general formulas for ABV, FG and IBU calculation * Change units between Metric, US or Imperial * Enable/disable special features * Change units for color and pressure * Activate Power-ups like SmartPID, Tilt, iSpindel, Brewpiless, MyBrewbot * Export all your personal data for local backup in a JSON file * Reset included data back to its default values ### Application ![](/files/-Ldi09HT_RhhxT2G0tm6) #### Reload Application Reloads the application, useful if you want to refresh to make sure you got the latest version of the application. #### Offline Support Normally this is activated by default, except on iOS (iPhone / iPad) where it is deactivated due to issues that Apple introduced in iOS 12.2 (will be activated by default again when this is fixed by Apple). When active, all your data is cached persistently in a local database for offline use and synchronized when you get back online. When deactivated, your data is cached in local memory, but is not persistent across application reboots. #### Alternative connection mode This must be kept off unless you experience issues where the device is not synchronizing at all on your current network, example some corporate networks. Setting can be activated to be used to work around proxies that prevent the Brewfather client from connecting to the backend. Activating this will decrease performance somewhat. # Account Click your portrait in the menu to access the account page. ![Manage Account Page](/files/-LFYlhx0BMDAL6lmcuXV) In the account page you can * Change subscription plan * Change your credit card * Sign out * Update your e-mail address * Set a new password for your account Setting a new password or changing your e-mail is only possible if you logged in recently. Sign out and log in again if you have not recently logged in. # Subscription To subscribe click the upgrade to premium button after you have selected montly or yearly payment plan. ![Subscription](/files/-LFYmSow2Fu81_k7dkrY) All payments and credit card details are handled securely by [Stripe](https://www.stripe.com/). # Integrations Brewfather currently has integrations with many devices. Check the menu for the correct page. # SmartPID ## What is SmartPID? **SmartPID** is a powerful and flexible controller for complete **brewing process automation** and recipe management as well as **fermentation temperature control**. SmartPID is wifi connected for data logging and remote process control via web and mobile. SmartPID is integrated with Brewfather to allow remote control and fermentation profile and recipe sending. ## Get SmartPID SmartPID can be bought [**directly from Arzaman SRL here**](http://smartpid.com/store/). ## Need SmartPID device help? **For SmartPID related setup, please check the** [**guides here**](http://smartpid.com/wiki/doku.php?id=demo_tutorials)**. Please contact SmartPID on email:** [**smartpid@arzaman.com**](mailto:smartpid@arzaman.com) **or** [**facebook**](https://www.facebook.com/smartPID)**.** ## Integration features {% hint style="info" %} **SmartPID has some limitations to the number of recipe mashing and boil steps. And number of steps and duration in the fermentation profile. Brewfather will try to map your recipes and profiles as best as it can within these limitations. More details are noted about this further down in the documentation.** {% endhint %} **Smart Hombrewing Application** * Recipe upload for starting the brew directly! * Remote monitor of process parameters (set point, current temperature, PID out, pump status, timers) * Process events listing * Remote actions (process start/stop pause/resume, set point change, power change, pump start/auto/stop) **Smart Thermostat** * Start the fermentation profile directly from the batch based on your recipe! * Remote monitor of process parameters (set point, current temperature, PID out, timers) * Process events listing * Remote actions (process start/stop pause/resume, set point change) ## Firmware Pre-Requirements In order to use the integration a specific firwmare level is needed on SmartPID Both classic DIN box controller (STC version) and the new CUBE version are fully compatible. **Smart Homebrewing ⇒** [**version 1.3-010**](http://smartpid.com/wiki/lib/exe/fetch.php?media=spc1000-biab-v1.3-010.bin.zip) **+** **Smart Thermostat ⇒** [**version 0.5-014**](http://smartpid.com/wiki/lib/exe/fetch.php?media=spc1000-base-wifi-v0.5-014.bin.zip) **+** Download the FW from the [SmartPID wiki page](http://smartpid.com/wiki/doku.php?id=sw_release) on the web site and upgrade. Click here for [upgrade instructions on video](https://youtu.be/RnQzNxVUHeo). #### Upgrade mini guide 1. [**Download** ](http://smartpid.com/wiki/doku.php?id=sw_release)firmware from SmartPID 2. Unzip the .bin file 3. Rename .bin file to **flash.bin** before copying it to SmartPID 4. Attach SmartPID to computer via USB **while** holding the **RED** button 5. Delete **FLASH.BIN** from the SmartPID storage device that has now appeared 6. **Copy** new **flash.bin** to SmartPID storage device 7. Safetly detach device after copy has finished 8. Verify that upgrade is ok by checking firmware version in the info menu #### Firmware upgrade troubleshooting If you have a SmartPID Thermostat and want to switch it to a SmartPID Homebrewing controller, or vice versa, you need to contact the SmartPID seller, switching firmware directly will not work without a special flash file. There is a know issue upgrading firmware on macOS, try a Windows computer if you have issues with Mac. ## Enable SmartPID integration ![Enable SmartPID in the Settings page in the Power-ups Section](/files/-LYH_otg0hBrXZ2rZnrv) ## Configure SmartPID ![Open the Devices page in the new menu option that appears](/files/-LYHahv7gEdnUIz8YYpX) ## Register/Login to SmartPID account In the devices page there will now be a **Configure** button next to the SmartPID section. Click it to set up SmartPID. ![Enter your e-mail and password, then login or register](/files/-LZo-qkDjehMrW4_dsfd) ### Register new SmartPID account (new SmartPID users) Enter your wanted e-mail and password then click Register. If registration is successful you will be logged in to the new account automatically. ***Warning: SmartPID Password is not encrypted and is stored in plain text**.* You can also register a new account in the SmartPID android app. ### Login to existing SmartPID account (existing SmartPID users) If you already have a SmartPID account. Enter your e-mail and password then click Register. If registration is successful you will be logged in to the new account automatically. ***Warning: SmartPID Password is not encrypted and is stored in plain text**.* ## SmartPID device setup Your SmartPID needs to be set up with wifi connection and the login for your SmartPID account. For instructions on how to set up your SmartPID device for Wifi and MQTT server connection please check the [**guide here**](http://smartpid.com/wiki/doku.php?id=demo_tutorials). #### Common setups [**SmartPID as a 1 channel thermostat for fermentation control**](/br/integrations/smartpid/thermostat-configuration) #### Sampling time SmartPID can be set up to send the status every X seconds. For best response time set this to 1 second. ## Register SmartPID device ![Configure SmartPID device](/files/-LZo18sLiRvR71ew903B) 1. From the SmartPID configuration window click **Add device** 2. Insert a name for your smartPID controller 3. Select the proper application (homebrewing / thermostat). This must be compatible with the firmware on your SmartPID 4. Enter the 12 characters serial number found in the SmartPID info menu 5. Enable **Channel 1** and/or **Channel 2**, optionally name the Channel(s). 6. **Save** to add to your device list 7. When you click Save the device will appear, and Brewfather will communicate with your SmartPID via MQTT messages ## Mode: Homebrewing ![Homebrewing Panel](/files/-LZo28pYGp_f7jKahMK4) ### Recipe upload and process start {% hint style="warning" %} **Important limitations:** Make sure the device is not in status mode, then it will be locked for control. SmartPID is limited to a **fixed schema for the mash steps** (listed below), some mashing profiles might not translate 100%, you can check the recipe steps sent to the SmartPID by clicking the green **recipe** text in the Send Recipe toggle before you click start.\ \ SmartPID is limited to **max 10 boil addition** **alarms**. {% endhint %} 1. Go to **Batches page** - **Brewing** tab 2. Click on the **Start** button in the **Brew Controller** section 3. Select your homebrewing controller from the list 4. Flag the proper options and press start to push the recipe to SmartPID controller and eventually start the recipe execution. {% hint style="info" %} Recipe is saved always in **position 1** in the controller and will override any recipe entered manually in that position {% endhint %} ![Start a recipe from the batch page](/files/-LZo39x0SGwwGTIsfMjB) ![Start Homebrewing SmartPID](/files/-LZo3bwsloYXy8CdLVsP) #### Optional Mash Steps Template If you want one to one mapping of the mahing steps to the recipe format of the SmartPID you can utilize the **Mash steps template** mashing profile. Brewfather will also intelligently try to **map any mash profile** to the fixed SmartPID scheme so this step is optional. ![](/files/-LZo2pWHoEdzzrYKDyEE) 1. Select profile in recipe ![](/files/-LZo2oQaAiVLP23I06Uo) 2\. Alter the profile by adjusting time and temperature on the steps with time greater than 0. Leave the rest as is. ## Mode: Thermostat ![Thermostat Panel](/files/-LZo2OI0Md8mE_5AiHKm) ### Start fermentation profile from recipe {% hint style="warning" %} **Important limitations**: Make sure the device is not in status mode, then it will be locked for control. SmartPID is **limited to 8 fermentation profile steps** where the fist 7 steps have a **maximum duration of 4 days** per step. This might limit the fermentation profile possibilities if you have profiles with many steps. *Step 8 will continue with no maximum duration.* **Brewfather will try to map your profile as best as it can within these limitations** (splitting steps with a duration longer than 4 days into multiple steps for the SmartPID profile). *But you are adviced to double check the profile steps.* {% endhint %} 1. Go to **Batches page** - **Fermentation** tab 2. Click on the **Start** button in the **Fermentation Controller** section 3. Select your thermostat controller from the list 4. Click **Start** to start the profile Optionally you can also start a fermentation profile or standard/manual mode from the devices page. {% hint style="info" %} Profile is saved always in **position 1** in the controller and will override any profile entered manually in that position {% endhint %} ![Start fermentation profile from Fermentation Controller in fermentation tab](/files/-LZo4A0L2ZGigMe6PlLo) ![When starting thermostat from the devices page you can select standard or advanced mode](/files/-LZo4BVnkr7RRPBaxxT2) # Thermostat Configuration Shows the SmartPID configuration for HW setup and process parameters when using it as a 1 channel thermostat with fridge and heating. Heating on Relay 1 and Cooling on Relay 2. ![](/files/-L_2zPH-Nczzxe-DBdEe) ![](/files/-L_2zSfJmgXfPL2F1WRZ) ![](/files/-L_2zY93zTuekUXuOmIe) ![](/files/-L_2zeSq9YqUH_bxpaq8) ![](/files/-L_2zihC-zY37j4wWZ_X) # Tilt Hydrometer Drop your Tilt in the fermenter or a glass of water, go into the settings page in [Brewfather APP](https://web.brewfather.app), enable Tilt. You will then get a cloud URL that you need to copy into the **Cloud URL** in your Tilt-app or TiltPi settings. Write a comment and click enter/send to log immediately. More details below. There is also a [video guide in Norwegian](https://youtu.be/DKC_pZ6kPIc) for TiltPi+Tilt Hydrometer. ![Fermentation Tab of the Batch](/files/-LWDS3oS79zsmEDaeaJr) Then go into the Fermentation tab of your batch and click **Devices.**\ After your Tilt has done it's first logging to Brewfather it will appear in the device list. ![](/files/-LWDSTtWM6exVtuQdDp9) Click the **ATTACH** button to make it log to this batch. Wait 15-30 minutes for your Tilt to log the next time. **Never log more than once every 15 minutes**, request logged more often than that will be ignored. This is the default value of the Tilt. ### Tilt 2 Phone App Setup ![](/files/-LaRbafp3NeQODuPI3vz) 1. Enable "use custom cloud url" in the Settings 2. Copy cloud url from settings in Brewfather 3. Click Save {% hint style="warning" %} If you want continous logging to Brewfather when using the Tilt App you need to keep your device active and next to the fermenter at all times, the Tilt does not log to the cloud on its own. If the devices goes to sleep it will stop logging. Setting up a TiltPi is recommended. {% endhint %} ### TiltPi Setup The best and most stable way to log is to have a dedicated Raspberry next to the fermenter, here is [how to set up a TiltPi](https://tilthydrometer.com/products/tilt-pi-raspberry-pi-disk-image-download). We recommend a Raspberry Pi Zero W + MicroSD 8GB + Micro USB charger. 1. Access the TiltPi via the browser 2. Select TILT **color** 3. Paste your **Cloud URL** 4. Time interval **15 minutes** or more 5. **Enable** start logging to the cloud 6. Make sure "Use Default Cloud URL for All" is **OFF**. 7. Attach in batch in Brewfather Enter a comment and click enter, to make the TiltPi send a logging request right away. ![](/files/-LFg8Lpoj3Tdr7IlHnJx) If you have issues with getting the TiltPi to log, try restarting it by removing the power and putting it back in, then start from 1. (optional) use TiltBridge instead of TiltPi: ### TiltBridge Setup TiltBridge is an alternative small and cheap device you can set up instead of a TiltPi. Read more on the following page: {% content-ref url="/pages/-M9UIKGrf6puKnlLxe\_v" %} [TiltBridge Setup](/br/integrations/tilt-hydrometer/tiltbridge-setup) {% endcontent-ref %} ### Attach to Batch After the Tilt has done its first logging to Brewfather, it will appear in the device list located in your Batch > Fermentation > Readings > **Devices**. Click on the Devices button and attatch your Tilt to the batch. The next time your Tilt logs, it will show up in your batch! ## Result ![Tilt integration gives you full control over your fermentation progress](/files/-LFyRpovfOXReR0X_i6u) ### Multiple devices Having multiple Tilts logging to Brewfather is simple, just set them all up logging to the same URL and make sure they have different colors. ## Where can i get a Tilt Hydrometer? *Want your shop listed here? Get in* [*touch*](/br/more/contact)*.* ### International ![](/files/-LI5DN48Hv7EE94adW1c) Buy directly from Tilt: ### Norwegian dealers ![](/files/-LI5AYVxfkWzoVr-WFAR) Buy from [Brewshop.no](https://brewshop.no/produkt/utstyr/gjaering/utstyr-til-gjaering/tilt-hydrometer-termometer-ny-versjon) ![](/files/-LI5Azo-Yh2kdJHfwSUI) Buy from [Petit-agentur.no](https://petit-agentur.no/search_result?keywords=tilt+hydrometer) ![](/files/-LI5D005WBhleGoqRN3a) Buy from [Vestbrygg.no](https://www.vestbrygg.no/home/SearchForm?q=tilt+hydrometer) ![](/files/-LWBn5D1rIhimiIY7Ej1) Buy from [Strømmen Hjemmebrygg](https://homebrew.no/) # TiltBridge Setup TiltBridge is a standalone piece of hardware which is designed to allow your Tilt Hydrometer to connect directly to WiFi without the need for an old cell phone, tablet, or Raspberry Pi. We recommend an ESP32 OLED board with wifi and bluetooth. This means you’ll have a small screen on the board where you also can see the information from your Tilt. You will also need a Micro USB charger. 1\. Download and install BrewFlasher from \ (both Windows and MacOS X) 2\. Connect the TiltBridge board to a USB port on your PC/Mac 3\. Run BrewFlasher and set/select the following (see example of the window below): * Serial port - where your TiltBridge is located * Project - TiltBridge * Device Family - ESP32 * Firmware - TiltBridge BETA - v0.2 - OLED ![](/files/-M9UJzR_tGm-fsttvhkx) * Erase flash - yes, wipes all data 4\. Click the button Download Firmware and Flash Controller. ![](/files/-M9UKB-E6-jv7S6goduR) 5\. When the Console shows «Connecting…..», press the Boot button on the back side of your board. This enables the upload to continue. 6\. The upload of the firmware should be done. 7\. Remove the Micro USB plug from the board and re-attach it again. 8\. You will see a message showing this: ![](/files/-M9UKjQ_CKsdeOkobJX5) ## Configuring TiltBridge for Brewfather You´ll first need to attach TiltBridge to your WIFI and then configure it to use the Tilt API key. 1\. Go to Brewfather and copy the API key for Tilt located under Settings. You will need this key soon. 2\. Navigate to or the IP address shown on the board screen. 3\. Click the Settings link at the top of the dashboard 4\. In the Brewfather Settings section at the bottom of the screen, paste the API key in the field Brewfather Stream key. Make sure you only insert the key itself and not the full http-address. ![](/files/-M9UKqJGig-Thjf7g549) 5\. Click the Update button. 6\. You should be good to go. Make sure you place the TiltBridge board close to your Tilt Hydrometer and within the range of your Wifi. For more details regarding TiltBridge, please see # Plaato {% content-ref url="/pages/-LzmopLmDqfWXD5\_PuA8" %} [Keg](/br/integrations/plaato/keg) {% endcontent-ref %} {% content-ref url="/pages/-LaXatcTmPB4Sb8ankvE" %} [Airlock](/br/integrations/plaato/airlock) {% endcontent-ref %} # Keg 1. Activate **Plaato Keg** in the settings page 2. Go to the **Devices** page in the menu to set up your Plaato kegs ![](/files/-M4s3KS5SPMdNtXIZq3l) 3\. Click configure. ![](/files/-M4s3VgMXBb65b68Kybv) 4\. Click Add Plaato Keg, this needs to be done one time per Keg-device. 5\. You need an auth key per keg device you have. This must be sent to you by Plaato support. ![](/files/-M4s3dD6KfD0C_3EDWdj) ![](/files/-M4s4lNx8d92IeiX3Uke) Currently this is a basic integration showing the status of the Kegs in the Devices page. A full integration with batches are in development. ![](/files/-M4s50mMj_yS_shu9iCi) # Airlock ### Get Plaato Airlock Get it directly from Plaato [here](https://www.plaato.io/). ### Enable Plaato Airlock in Settings ![Enable Plaato Airlock in the Settings, copy the Logging URL.](/files/-LaqPa32unL3u9nDJHTy) ### **Plaato App Webhook Setup** ![Paste the Logging URL from Brewfather](/files/-LaqPBD1I7DUKj8CoM3H) 1. **Enable** Plaato Airlock in the Brewfather Settings 2. **Copy** the Logging URL. 3. **Open** the **Plaato** App 4. Go to **WEBHOOK** tab 5. **Paste** Logging URL. 6. **Wait** up to 30 minutes. 7. Plaato should then **appear** in the Device page in Brewfather 8. **Attach** the Plaato device to your Batch (fermenting tab) 9. **Done** ### Result ![](/files/-Laj9zl9L5xd0GMTZfQJ) ### Logging with multiple Plaato Airlocks This works out of the box, just make sure the device name is unique per Plaato and they will all appear in the device list as separate entities. All will use the same webhook url. # iSpindel Vá para a página de configurações no [App Brewfather](https://web.brewfather.app/) e ative o iSpindel. Você verá então um **Endereço** e **URL** que você precisará copiar na página de configuração do iSpindel. Altere seu iSpidel para o modo de configuração e então você poderá acessar seu iSpindel pelo WiFi. Na página de configuração do iSpindel, defina o **nome** que desejar, defina as opções como **Service Type**: **HTTP**, **Port**: **80**, **Update intervall**: **900** e coloque o Endereço e URL das configurações do Brewfather. (Se a os campos port/server address não aparecem, tente pressionar o botão HTTP duas vezes.) Certifique-se que o campo de fórmula esteja preenchida da forma correta, definida quando você fez a calibração do ispindel, e tenha certeza que os dados da rede Wifi estão corretos, e então clique em salvar. Seu iSpindel deve então iniciar o envio das informações a cada 15 minutos.. Depois que o iSpindel fizer o primeiro registro de dados para o Brewfather, ele aparecerá na lista de dispositivos localizado em Lote > Fermentação > Leituras > **Dispositivos**. Clique no botão de dispositivos e então anexe seu iSpindel para o lote em questão. A próxima vez que seu iSpindel registrar novos dados, eles aparecerão vinculados ao seu lote! **Nunca defina a frequência de registro menor que 15 minutos**, pois registros com frequência menor que isso serão ignorados pelo sistema. É **muito importante que o intervalo de atualização seja 900 segundos ou mais**, ou então os dados serão ignorados e isso irá consumir mais bateria do seu dispositivo. {% hint style="info" %} Certifique-se que seu iSpindel registra a densidade em Plato (ela será convertida para SG) e a temperatura em Celsius. Adicione **\[SG]** ao nome do seu iSpindel se você usa densidade com a fórmula base de SG. Se a gravidade está sendo mostrada como 1.004 no Brewfather, então você está usando a fórmula errada. Mude a unidade de leitura para Plato ou troque o nome do iSpindel conforme mostrado acima. {% endhint %} ### Vários Dispositivos Ter múltiplos iSpindels registrando dados no Brewfather é simples, apenas defina-os todos para enviarem os dados para a mesma URL e garanta que eles tenham nomes únicos na configuração do iSpindel, e então vincule cada um deles com o seu lote adequado. # Calibração Ferva 3 litros de água com 1kg de açúcar.\ \ Use um densímetro e separe soluções da água acima com **1.050**, **1.040**, **1.030**, **1.020**, **1.010** e também água pura com **1.000**.\ \ Configure o iSpindel para reportar a densidade a cada 60 segundos no Brewfather, e na página de dispositivos você poderá ver a leitura reportada do iSpindel a cada minuto.\ \ Faça a leitura das soluções criadas acima e anote o ângulo/tilt informado pelo iSpindel. Preencha os valores na tabela de calibração do projeto iSpindel e ele irá calcular a fórmula exigida no formato desejado por você. \ \ Copie a fórmula de resultado na página de calibração do projeto e comece a ler os valores nas diferentes soluções novamente. **Certifique-se de usar a fórmula que informa em Plato**. O Brewfather então irá converter na unidade que você escolheu em suas configurações. Se a gravidade estiver exibindo 1,004 no Brewfather, você está usando a fórmula errada. Se você está usando Plato no Brewfather para a solução SG acima, você deverá ver valores próximos de 0, 2.5, 5, 7.5, 10 e 12.5. #### Recursos Planilha Excel de calibração: Outras informações: \
# BrewPiLess Check the [BrewPiLess documentation](https://github.com/vitotai/BrewPiLess/wiki/Logging-to-Brewfather) for setup instructions. You will find the ID in the URL in Brewfather settings. ### Option 1 Go into the settings page in [Brewfather APP](https://web.brewfather.app/), enable [Brewpiless](https://github.com/vitotai/BrewPiLess). Copy the ID from the **URL** to copy into the Brewpiless remote logging configuration page. Select Brewfather as logging type, and paste the id. After the Brewpiless has done its first logging to Brewfather, it will appear in the device list located in your Batch > Fermentation > Readings > **Devices**. Click on the Devices button and attatch your Brewpiless to the batch. The next time your Brewpiless logs, it will show up in your batch! **Never log more than once every 15 minutes**, request logged more often than that will be ignored. ### Option 2 Go into the settings page in [Brewfather APP](https://web.brewfather.app/), enable [Brewpiless](https://github.com/vitotai/BrewPiLess). You will then get a **URL**, **Data Type** and **Format** that you need to copy into the Brewpiless remote logging configuration page use remote logging type. **Set log time period to 900 seconds**. Your Brewpiless should then log every 15 minutes. After the Brewpiless has done its first logging to Brewfather, it will appear in the device list located in your Batch > Fermentation > Readings > **Devices**. Click on the Devices button and attatch your Brewpiless to the batch. The next time your Brewpiless logs, it will show up in your batch! **Never log more than once every 15 minutes**, request logged more often than that will be ignored. #### Logging format {"id":"FERMENTER1","tempUnit":"C","beerTemp":%b,"beerSet":%B,"fridgeTemp":%f,"fridgeSet":%F,"roomTemp":%r,"gravity":%g,"tiltValue":%t,"auxTemp":%a,"extVolt":%v,"timestamp":%u} **tempUnit** can be C for celcius, F for fahrenheit or K for kelvin. ### Multiple devices Having multiple BPL logging to Brewfather is simple, just set them all up logging to the same URL, but make sure they have unique an unique id in the configuration. Example above shows "FERMENTER1" as id. Newer BPL # MyBrewbot ## What is MyBrewbot? The MyBrewbot for Tilt, which has a bluetooth receiver to collect the Tilt data, controls the temperature of the fermenting wort and sends the logging data to Brewfather. This can be a good alternative to using a [TiltPi](/br/integrations/tilt-hydrometer#tiltpi-setup) as you can also control your heating and cooling with this unit based on the Tilt readings and/or external temperature sensor. Both the gravity and temperature (and all other data sent) will be logged to Brewfather. ### Buy MyBrewbot Get it directly [here](https://www.mybrewbot.com/). #### Norwegian dealers Buy from [Brewshop.no](https://brewshop.no/produkt/utstyr/maleutstyr/mybrewbot-for-tilt-temperaturkontroller) ## Setup Using MyBrewbot with Brewfather is very simple. Enable it in your Settings and copy the Logging ID into your MyBrewbot settings. ![1. Enable MyBrewbot in Brewfather](/files/-LPHZHCYZULk8Ld2St4d) ![2. Copy the Logging ID into the Brewfather Logging ID field in the MyBrewbot web config](/files/-LTqvJ4bCKyQU_WOyMAQ) You will find the IP for you MyBrewbot in the bottom of the settings in the MyBrewbot app, open this IP in your browser when you are in the same network as the device. Alternative easier setup coming soon: ![3. Alternative setup in the new MyBrewbot app (due for release soon)](/files/-LVoJ0FKyHbtQjdiOvop) Your MyBrewbot should then log every 15 minutes. [Click here for video](http://mybrewbot.co.uk/UI/Settings.mp4) demonstrating how to put in your Brewfather ID in the MyBrewbot app. After the MyBrewbot has done its first logging to Brewfather, it will appear in the device list located in your Batch > Fermentation > Readings > **Devices**. Click on the Devices button and attatch your MyBrewbot to the batch. The next time your MyBrewbot logs, it will show up in your batch! ## Result ![MyBrewBot with Tilt attached](/files/-LTqtxPeW6Jc2L5kJSMg) # Grainfather Bluetooth Controller This functionallity is still in beta, use the integration at your own risk and provide feedback on your experience. Only tested with G30. This integration is only supported using a chromium based browser (like Chrome or the new Edge), on a device with bluetooth. It also works using the web version of the app on an android device in the chrome browser. iOS or other browsers are not supported at this time. Enabling the GF Bluetooth Control toggle in the settings page enables you to send your recipe directly to the GF Controller. Go to the brewing tab of a batch, then you can click start in the brew-controller section of the batch to connect to your controller. Depending on the chromium browser and your operating system you might have to enable browser bluetooth support to make the bluetooth connect dialog show: Enter **chrome://flags** in the searchbar. Type: Platform Enable: **Experimental web Platform Features** # CraftBeerPi Posting Fermentation data from CraftBeerPi V3 is possible with this custom plugins provided by Brewfather users. Logging to **Custom Stream**: For **Tilt Hydrometer** find it here: For **iSpindel** go here: or or # Custom Endpoint Define a custom **https** endpoint to recieve batch JSON file when clicking the send button in the batch (only visible when this is enabled). ![Send JSON button appears in batch when this is activated](/files/-LFYdpBO9NU_Ny_d47vQ) ### Endpoint Endpoint needs to be HTTPS and support CORS ([Cross-Origin Resource Sharing](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)). The endpoint will recieve a POST with json data containing all the batch and recipe data. Useful if you want to start a brew session on a custom automated brewery. Could for example be a custom [IFTTT ](https://ifttt.com/)webhook. # Custom Stream Integrate your own logging device with a custom **HTTP POST** to the **URL** you are given in the settings. ![Enable custom stream in the settings page](/files/-LVoJnF0ydPfaP8sxA6P) Use the following **JSON** format in the body of the **POST:** ``` { "name": "YourDeviceName", // Required field, this will be the ID in Brewfather "temp": 20.32, "aux_temp": 15.61, // Fridge Temp "ext_temp": 6.51, // Room Temp "temp_unit": "C", // C, F, K "gravity": 1.042, "gravity_unit": "G", // G, P "pressure": 10, "pressure_unit": "PSI", // PSI, BAR, KPA "ph": 4.12, "bpm": 123, // Bubbles Per Minute "comment": "Hello World", "beer": "Pale Ale" } ``` Temperature units "**C**" for celcius, "**F**" for fahrenheit, "**K**" for kelvin.\ Gravity units "**G**" for SG and "**P**" for Plato.\ Pressure units "**PSI**", "**BAR**", "**KPA**". **Never log more than once every 15 minutes per device name**, request logged more often than that will be ignored. If you are logging more than one device give them each a unique name, maximum rate: one POST per device per 15 minutes. Field "name" is required. Other fields are optional. # Webhook For devices that support webhook you can enable it by clicking "(configure webhook)" on the settings page for that device type. ![Click "(configure webhook)"](/files/-LfvG7RAiYon6oi3lPQT) ![Enable, enter url, and select format](/files/-LfvGJaN6MOd7oLcNhDz) Format details: Raw format will send the data as recieved in a JSON body, Processed will send the processed data as stored in Brewfather. # Taplist/On-Tap Tapboad / Taplist and other On-Tap software that is integrated with Brewfather (none are endorsed): Integrations requires API key found in the settings page in your Brewfather application. tapitgood: barhelper: brewboard: [https://brewboard.app/ ](https://brewboard.app) taplist: - # API REST API ## Disclamer Breaking changes can come at any time as the development of the API is not finalized. Please keep yourself updated on the API-documentation. ## Authentication Authorization header must consist of your userid:apikey (base64 encoded). **Example**: UserId: xyz123\ API-key: 1234567890123456789012345678901234567890abcd\ \ Base 64 encode: "xyz123:1234567890123456789012345678901234567890abcd" ```javascript curl -H "authorization: Basic eHl6MTIzOjEyMzQ1Njc4OTAxMjM0NTY3ODkwMTIzNDU2Nzg5MDEyMzQ1Njc4OTBhYmNk" \ https://api.brewfather.app/v1/batches ``` In Postman, you can configure Basic Authorization by clicking the **Authorization** tab, selecting **Basic Auth** from the drop-down selector, and then typing the **username** (userid from above) and **password** (api-key form above) on the right of the colon on each row. The API supports HTTPS traffic only (for security reasons). ## Generate API-Key In the Settings page you can click GENERATE in the API-section to create your API-key. You can currently only have one API-key per account. ### Scopes Scopes control what the API-key can access. Currently you can choose: * **Read Recipes** * **Read Batches** * **Edit Batches** * **Read Inventory** * **Edit Inventory** When you generate your API-key you can select different scopes that the API-key can access, when new scopes are added you might need to generate a new key with the new scopes to allow access to the new scopes. ## Rate Limit Currently you can do a maximum of 150 calls per hour per API-key. Rate limits can be changed at any time, build your integration to handle http code **429 Too Many Requests**, response will include a [`Retry-After`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After) header. ## Batches ## Get Batches `GET` `https://api.brewfather.app/v1/batches` This endpoint allows you to list your batches. By default it returns batches with status = "Planning". Use the query parameter "status" to query for a given status. #### Query Parameters | Name | Type | Description | | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | include | array | Array of additional fields to include when complete is false. Example "recipe.fermentation**,**recipe.mash" to include the fermentation and mash profile. | | complete | boolean | Valid values "True" or "False". Inlcudes all the data in the result if True. Defaults to "**False**". If False only Name, Batch Number, Status, Brewer, Brew Date, Recipe Name is returned. | | status | string | Valid values "**Planning**", "**Brewing**", "**Fermenting**", "**Conditioning**", "**Completed**", "**Archived**". Defaults to "**Planning**". | | offset | number | Amount of documents to skip. Defaults to **0**. | | limit | number | Amount of documents to fetch. Defaults to **10**. Max **50**. | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` [ array of Brewfather BATCH JSON ] ``` {% endtab %} {% endtabs %} ## Get Batch `GET` `https://api.brewfather.app/v1/batches/:id` This endpoint allows you to fetch a specific batch.\ \ **:id** is the **\_id** property from the batch JSON. #### Query Parameters | Name | Type | Description | | ------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | include | string | Array of fields to include. Example "recipe.fermentation**,**recipe.mash" to include the fermentation and mash profile. When omitted all fields are included. Default fields are included in addition to the requested fields. | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` { Brewfather BATCH JSON } ``` {% endtab %} {% endtabs %} ## Update Batch `PATCH` `https://api.brewfather.app/v1/batches/:id` This endpoint allows you to update specific fields of a specific batch. Currently support setting the status, please let us know what fields you would like to be able to update via the API. #### Query Parameters | Name | Type | Description | | ------ | ------ | ------------------------------------------------------------------------------------------------------------------ | | status | string | Valid values "**Planning**", "**Brewing**", "**Fermenting**", "**Conditioning**", "**Completed**", "**Archived**". | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` ``` {% endtab %} {% endtabs %} ## Recipes ## Get Recipes `GET` `https://api.brewfather.app/v1/recipes` This endpoint allows you to list your recipes. #### Query Parameters | Name | Type | Description | | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | include | string | Array of additional fields to include when complete is false. Example "fermentation**,**mash" to include the fermentation and mash profile. | | complete | boolean | Valid values "True" or "False". Inlcudes all the data in the result if True. Defaults to "False". If False only Name, Author, Style Name, Type is returned. | | offset | number | Amount of documents to skip. Defaults to **0**. | | limit | number | Amount of documents to fetch. Defaults to **10**. Max **50**. | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` [ array of Brewfather RECIPE JSON ] ``` {% endtab %} {% endtabs %} ## Get Recipe `GET` `https://api.brewfather.app/v1/recipes/:id` This endpoint allows you to fetch a specific recipe.\ \ **:id** is the **\_id** property from the recipe JSON. #### Query Parameters | Name | Type | Description | | ------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | include | string | Array of additional fields to include. Example "fermentation**,**mash" to include the fermentation and mash profile. When omitted all fields are included. Default fields are included in addition to the requested fields. | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` { Brewfather RECIPE JSON } ``` {% endtab %} {% endtabs %} ## Inventory ## Get Fermentables `GET` `https://api.brewfather.app/v1/inventory/fermentables` This endpoint allows you to list your inventory items. It will only list items you have added manually or edited the default values for, or added an inventory amount on. #### Query Parameters | Name | Type | Description | | ----------------- | ------- | ----------------------------------------------------------------------------------------------------- | | include | array | Array of additional fields to include when complete is false. | | complete | boolean | Valid values "True" or "False". Inlcudes all the data in the result if True. Defaults to "**False**". | | inventory\_exists | boolean | Valid valuesValid values "True" or "False". If true, only include items with inventory **> 0** | | offset | number | Amount of documents to skip. Defaults to **0**. | | limit | number | Amount of documents to fetch. Defaults to **10**. Max **50**. | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` [ array of Brewfather JSON ] ``` {% endtab %} {% endtabs %} ## Get Fermentable `GET` `https://api.brewfather.app/v1/inventory/fermentables/:id` This endpoint allows you to fetch a specific item. #### Query Parameters | Name | Type | Description | | ------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------- | | include | string | Array of fields to include. When omitted all fields are included. Default fields are included in addition to the requested fields. | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` { Brewfather JSON } ``` {% endtab %} {% endtabs %} ## Update Fermentable `PATCH` `https://api.brewfather.app/v1/inventory/fermentables/:id` This endpoint allows you to update specific fields of a specific item. #### Query Parameters | Name | Type | Description | | ----------------- | ------ | ------------------------------------------------------------------------------------------------------------ | | inventory\_adjust | number | Adjust the existing inventory amount by the given amount. | | inventory | number | Set the inventory amount to the given value. (inventory\_adjust is ignored if you send in a inventory value) | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` ``` {% endtab %} {% endtabs %} ## Get Hops `GET` `https://api.brewfather.app/v1/inventory/hops` This endpoint allows you to list your inventory items. It will only list items you have added manually or edited the default values for, or added an inventory amount on. #### Query Parameters | Name | Type | Description | | ----------------- | ------- | ----------------------------------------------------------------------------------------------------- | | include | array | Array of additional fields to include when complete is false. | | complete | boolean | Valid values "True" or "False". Inlcudes all the data in the result if True. Defaults to "**False**". | | inventory\_exists | boolean | Valid valuesValid values "True" or "False". If true, only include items with inventory **> 0** | | offset | number | Amount of documents to skip. Defaults to **0**. | | limit | number | Amount of documents to fetch. Defaults to **10**. Max **50**. | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` [ array of Brewfather JSON ] ``` {% endtab %} {% endtabs %} ## Get Hop `GET` `https://api.brewfather.app/v1/inventory/hops/:id` This endpoint allows you to fetch a specific item. #### Query Parameters | Name | Type | Description | | ------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------- | | include | string | Array of fields to include. When omitted all fields are included. Default fields are included in addition to the requested fields. | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` { Brewfather JSON } ``` {% endtab %} {% endtabs %} ## Update Hop `PATCH` `https://api.brewfather.app/v1/inventory/hops/:id` This endpoint allows you to update specific fields of a specific item. #### Query Parameters | Name | Type | Description | | ----------------- | ------ | ------------------------------------------------------------------------------------------------------------ | | inventory\_adjust | number | Adjust the existing inventory amount by the given amount. | | inventory | number | Set the inventory amount to the given value. (inventory\_adjust is ignored if you send in a inventory value) | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` ``` {% endtab %} {% endtabs %} ## Get Miscs `GET` `https://api.brewfather.app/v1/inventory/miscs` This endpoint allows you to list your inventory items. It will only list items you have added manually or edited the default values for, or added an inventory amount on. #### Query Parameters | Name | Type | Description | | ----------------- | ------- | ----------------------------------------------------------------------------------------------------- | | include | array | Array of additional fields to include when complete is false. | | complete | boolean | Valid values "True" or "False". Inlcudes all the data in the result if True. Defaults to "**False**". | | inventory\_exists | boolean | Valid valuesValid values "True" or "False". If true, only include items with inventory **> 0** | | offset | number | Amount of documents to skip. Defaults to **0**. | | limit | number | Amount of documents to fetch. Defaults to **10**. Max **50**. | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` [ array of Brewfather JSON ] ``` {% endtab %} {% endtabs %} ## Get Misc `GET` `https://api.brewfather.app/v1/inventory/miscs/:id` This endpoint allows you to fetch a specific item. #### Query Parameters | Name | Type | Description | | ------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------- | | include | string | Array of fields to include. When omitted all fields are included. Default fields are included in addition to the requested fields. | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` { Brewfather JSON } ``` {% endtab %} {% endtabs %} ## Update Misc `PATCH` `https://api.brewfather.app/v1/inventory/miscs/:id` This endpoint allows you to update specific fields of a specific item. #### Query Parameters | Name | Type | Description | | ----------------- | ------ | ------------------------------------------------------------------------------------------------------------ | | inventory\_adjust | number | Adjust the existing inventory amount by the given amount. | | inventory | number | Set the inventory amount to the given value. (inventory\_adjust is ignored if you send in a inventory value) | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` ``` {% endtab %} {% endtabs %} ## Get Yeasts `GET` `https://api.brewfather.app/v1/inventory/yeasts` This endpoint allows you to list your inventory items. It will only list items you have added manually or edited the default values for, or added an inventory amount on. #### Query Parameters | Name | Type | Description | | ----------------- | ------- | ----------------------------------------------------------------------------------------------------- | | include | array | Array of additional fields to include when complete is false. | | complete | boolean | Valid values "True" or "False". Inlcudes all the data in the result if True. Defaults to "**False**". | | inventory\_exists | boolean | Valid valuesValid values "True" or "False". If true, only include items with inventory **> 0** | | offset | number | Amount of documents to skip. Defaults to **0**. | | limit | number | Amount of documents to fetch. Defaults to **10**. Max **50**. | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` [ array of Brewfather JSON ] ``` {% endtab %} {% endtabs %} ## Get Yeast `GET` `https://api.brewfather.app/v1/inventory/yeasts/:id` This endpoint allows you to fetch a specific item. #### Query Parameters | Name | Type | Description | | ------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------- | | include | string | Array of fields to include. When omitted all fields are included. Default fields are included in addition to the requested fields. | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` { Brewfather JSON } ``` {% endtab %} {% endtabs %} ## Update Yeast `PATCH` `https://api.brewfather.app/v1/inventory/yeasts/:id` This endpoint allows you to update specific fields of a specific item. #### Query Parameters | Name | Type | Description | | ----------------- | ------ | ------------------------------------------------------------------------------------------------------------ | | inventory\_adjust | number | Adjust the existing inventory amount by the given amount. | | inventory | number | Set the inventory amount to the given value. (inventory\_adjust is ignored if you send in a inventory value) | #### Headers | Name | Type | Description | | ------------- | ------ | ------------------- | | Authorization | string | See authentication. | {% tabs %} {% tab title="200 " %} ``` ``` {% endtab %} {% endtabs %} # More {% content-ref url="/pages/-LF4QlNRnhzXTU2ySr6m" %} [Contact](/br/more/contact) {% endcontent-ref %} # Contact ## Issues and feature request goes here: [Chat with Brewfather](https://m.me/brewfather)! Send Brewfather a message [here](https://www.facebook.com/brewfather) or [post in this group](https://www.facebook.com/groups/brewfather). You can also click the **Contact** button in the menu of the [Brewfather APP](https://web.brewfather.app). Brewfather is also on [Instagram](https://instagram.com/brewfatherapp) and [Twitter](https://twitter.com/brewfatherapp). # FAQ ## Where do i report bugs or feature request? Bugs or feature requests can be reported in the [issue tracker](https://gitlab.com/warpkode/public/brewfather/-/boards/1001783). Here you can also watch and vote for request made by others users. ## Where can i get in contact with other Brewfather users? The Brewfather user group is a great place for this: [Brewfather Facebook Group](https://www.facebook.com/groups/brewfather). ## How can i contact Brewfather? Send Brewfather a message [here](https://www.facebook.com/brewfather) or [post in this group](https://www.facebook.com/groups/brewfather). You can also click the **Contact** button in the menu of the [Brewfather APP](https://web.brewfather.app). Brewfather is also on [Instagram](https://instagram.com/brewfatherapp) and [Twitter](https://twitter.com/brewfatherapp). ## Can i convert my Facebook / Google login to username and password? Yes, log out of Brewfather and go to the login screen, write in your email in the email field, and click the "forgot your password?" link. You will then get an email to set your password. After you have set your password you can log in with that email and password combination.\ \ If you want to change the email-address tied to you account you can do so in the manage account page found by clicking your portrait/email/name in the menu. ## How do i scale a recipe? Easy! Just change batch size or efficiency in your equipment profile within a recipe, click save and it will ask you if you want to scale the recipe to match the new numbers. Also - if you change to another equipment profile it will scale to match it also! ## How do i send my recipe to Grainfather Connect? Check out [this video](https://youtu.be/PJRLapkOeis) (turn on subtitles). Basically you export a BeerXML on your phone and open it directly in the GF Connect app.\ \ On your batch click the **menu** button in the lower right, click **export**, select **BeerXML**, the file will show and you should get an option to open the file in your GF Connect app.
![iPhone example. Slightly different approach in Android.](/files/-LFndmRf1ejxmcAGckhw) Then you just start brewing! ## How do i set up my Tilt Hydrometer to work with Brewfather? See the Tilt Hydrometer page for setup instructions. {% content-ref url="/pages/-LF4R8Pgdnt5WKrvEQhW" %} [Tilt Hydrometer](/br/integrations/tilt-hydrometer) {% endcontent-ref %} ## How do i set up my iSpindel to work with Brewfather? See the iSpindel page for setup instructions. {% content-ref url="/pages/-LF4RCLBJGi8eAC6q4uM" %} [iSpindel](/br/integrations/ispindel) {% endcontent-ref %} ## How do i set up my Brewpiless to work with Brewfather? See the Brewpiless page for setup instructions {% content-ref url="/pages/-LF4RR1KiEo903OIIrH\_" %} [BrewPiLess](/br/integrations/brewpiless) {% endcontent-ref %} ## Android or iOS app? Brewfather is available as a progressive web application, and also on App Store and [Google Play](https://play.google.com/store/apps/details?id=com.warpkode.brewfather). Brewfather is available as an [iOS app here](https://apps.apple.com/us/app/brewfather/id1488585822). This is the recommended way to use the app on an iPhone or iPad. # Tips & Tricks ## If your android phone closes Brewfather and reloads it too often: try disable battery optimization to avoid this ![](/files/-LfPutuADaTXRrQksB5x) ![Optimize battery, disable for Brewfather (Android)](/files/-M17CIFNbe_2Qa5a9t19) # What is Brewfather? Learn about Brewfather's features for recipe design, batch tracking, inventory management, and device integrations. [Launch Brewfather app](http://web.brewfather.app)\ [Go to Brewfather Main Page](http://brewfather.app) Brewfather is brewing software written from the ground up to give you **the best** recipe design and brewing experience on both **desktop and mobile** devices. The **modern design** makes it easy to use on all platforms. Get your recipes done in no time! With automatic **synchronization** between all your devices and **offline** support you are covered no matter if you are at the brewery or at your local homebrew store buying ingredients. Available as a web app and a downloadable app on Google Play or the App Store. Brewfather can be used on **any device**. Add it to your home screen or desktop without having to install anything: Simply open it in the browser and add it to your home screen, or download the app version. Click below to get started:\ \ [](https://apps.apple.com/us/app/brewfather/id1488585822) [](https://web.brewfather.app) [](https://play.google.com/store/apps/details?id=com.warpkode.brewfather) {% hint style="success" %} **New to Brewfather?** Start with the [Getting Started](/getting-started) guide to set up your brewery, create your first recipe, and brew your first batch. {% endhint %} Brewfather includes * **Powerful, intuitive,** and **easy-to-use** interface * **Multi-device** support - one app everywhere - always! * Offline support, auto-saving, and **automatic synchronization** * **AI Brewing Assistant** for recipe ideas, modifications, inventory analysis, and brewing questions * Fully-featured and easy-to-use **recipe** designer * **Recipe versioning** and **recipe folders** for organizing and evolving your recipes * **File attachments** for batches and recipes * Complete **batch** tracking - log every step of your brew * The ability through batch tracking and inventory to provide **full traceability for commercial breweries** * Fermentation **chart** * Recipe library with hundreds of **quality recipes** available for you * Create your **public profile** and optionally share your recipes with the library * **Brew timer** with alarms and notifications for your brew day! * **Profiles** for your equipment, mash schedule, fermentation steps, and water * Highly **customizable** equipment profile to suit any brewing system * Large customizable **ingredients** database * **Inventory** stock & **cost** tracking * Multiple **style guidelines** (BJCP, Brewers Association, Norbrygg, SHBF, DØDL) * Supports custom style guidelines * **Print** your recipe or batch to PDF * Import and export **BeerXML**, **BeerJSON**, and **Brewfather JSON** * Metric and US/Imperial units * **Scale** recipes up/down * Easily **share** recipes * Estimate your Final Gravity based on many variables * **Calculate** every important detail of your recipes and batches * Easy-to-use yeast amount and yeast starter calculator * Integrated **water adjustment calculator** with **mash pH** * Strike temperature calculation * Guided mash actions for strike, infusion, temperature, and decoction steps across the recipe designer, brew sheet, and brew tracker * Proper calculation of hop-stand bitterness * **API** support for integration with your own tools or third-party solutions * And **many more** tools and features to help your brewing! Current highlights include [**Recipe Versioning**](/recipes/versioning), [**Recipe Folders**](/recipes/folders), the [**Color Adjuster**](/recipes/color-adjuster), [**File Attachments**](/file-attachments), redesigned batch and readings workflows, and the built-in [**AI Brewing Assistant**](/ai-assistant). Integrations: * Integrate [**Tilt**](/integrations/tilt-hydrometer), [**iSpindel**](/integrations/ispindel)**,** [**Brewtools**](/integrations/brewtools)**,** [**RAPT Cloud**](/integrations/rapt)**,** [**Brewpiless**](/integrations/brewpiless)**,** [**Plaato Airlock**](/integrations/plaato/airlock), [**Plaato Keg**](/integrations/plaato/keg)**,** [**Brewbrain Float Hydrometer**](/integrations/float-hydrometer)**,** [**Floaty**](/integrations/floaty-hydrometer) **and** [**Custom Stream**](/integrations/custom-stream) with [**Webhook**](/integrations/webhook) support and more... * Connect to the [**Brewtools Cloud**](/integrations/brewtools-cloud) * Full [**SmartPID**](/integrations/smartpid) two-way integration, for brew-day and fermentation control * [**API** ](/api)for integration with your own or third-party solutions ![Multi-device support, use it on your desktop and mobile devices](/files/-LFSJBBOtnnOVJFtJWV_) ## AI Brewing Assistant The [AI Brewing Assistant](/ai-assistant) is Brewfather's built-in chat assistant for brewing. It can help you: * Create recipes from a style, ingredient list, or free-text idea * Modify the current recipe by adjusting hops, grains, batch size, or process * Search your recipe library, inventory, and batch data * Answer brewing questions with Brewfather context The AI assistant is available with **Premium Plus** and uses monthly AI credits. See [Subscription](/account/subscription) for plan details. ## Why Brewfather? Brewfather believes designing your recipes and tracking your batches should be easy and fun with easy access from all your devices with no hassle. {% hint style="info" %} Brewfather strives to cover all your brewing needs in one place, new features are added continuously, get in touch via [Discord](https://discord.gg/WwBXhrUVeK) or the Contact button in the app if you miss any features or find any issues! {% endhint %} ## Free to use as long as you want! Brewfather can be **used for free as long as you want** and can fully be used for brewing on the free plan. The free limits are generous, and the app includes everything you need to brew. Eligible new users can start a free 30-day Premium trial without a credit card. The free version includes: * The full **recipe designer** * Full **batch tracking** * The full **tools and calculators** suite * The full **public recipe library** * The full **ingredients database** * The full **style guidelines database** Any of the tools and calculators can be used for free with no limitations as long as you want. As a Free user you are limited to a **maximum of 25 recipes and 25 batches**, and are unable to import or export data from within Brewfather. If you exceed these limitations you are free to delete recipes or batches, or sign up for a paid plan. If you exceed the free-plan limits during your Premium trial, you will not lose any data when the trial runs out, but extra recipes and/or batches become read-only until you either delete items to get back under the limit or subscribe. {% hint style="info" %} Remember to import your existing data during the free 30-day Premium trial if you are moving from another brewing app or from local files. {% endhint %} ## Brewfather Premium Brewfather offers paid plans that unlock unlimited recipes and batches plus advanced features. The checkout page shows the current prices for your region, currency, tax settings, and plan choice. In general, the annual **Brewfather Premium** price is set around **$29.99 / €29.99 / £24.99 plus tax**. See [Subscription](/account/subscription) for current plan details. **Premium features include:** * **Unlimited** number of recipes * **Unlimited** number of batches * **Import and export** features * **PDF print** of recipe, batch, inventory, and ingredients * **Integrate** with [**Tilt**](/integrations/tilt-hydrometer), [**iSpindel**](/integrations/ispindel)**,** [**Brewtools**](/integrations/brewtools)**,** [**Brewtools Cloud**](/integrations/brewtools-cloud)**,** [**RAPT Cloud**](/integrations/rapt)**,** [**Brewpiless**](/integrations/brewpiless)**,** [**Plaato Airlock**](/integrations/plaato/airlock), [**Plaato Keg**](/integrations/plaato/keg)**,** [**Brewbrain Float Hydrometer**](/integrations/float-hydrometer)**,** [**Floaty**](/integrations/floaty-hydrometer)**,** [**Custom Stream**](/integrations/custom-stream) with [**Webhook**](/integrations/webhook) support, and more... * **API** Access * Create your public profile and add recipes to the recipe library * Inventory stock tracking * Ingredient **cost** tracking * [**Recipe Versioning**](/recipes/versioning) * Custom style guidelines * Ability to restore deleted recipes and batches * Add **manual readings** for the fermentation chart * Advanced configuration for Final Gravity estimation * Access to **experimental features** ## Premium Plus **Premium Plus** includes everything in Premium, plus: * [**AI Brewing Assistant**](/ai-assistant) * Monthly AI credits * [**File Attachments**](/file-attachments) for batches and recipes * Early access to selected new features {% hint style="info" %} To sign up for a paid plan, go to your account page in [Brewfather app](https://web.brewfather.app/) and click **Upgrade** or **Change Plan**. {% endhint %} All payments and credit card details are handled securely by [Stripe](https://www.stripe.com/) or [Paddle](https://paddle.net/). Brewfather never receives any sensitive payment details. Full PCI compliance. For In-App subscription purchases the payments are handled by Apple (App Store) or Google (Google Play Store) depending on your device. ## Community Connect with other Brewfather users and share your experiences and get in touch with the Brewfather Team directly. Join the Brewfather Facebook group: Join our Discord: [Brewfather Discord Community](https://discord.gg/WwBXhrUVeK) [![](/files/YJIxJKRpl3Wi6rMg2dBm)](https://discord.gg/WwBXhrUVeK) ## About Brewfather Brewfather (owned by [**Warpkode AS**](https://warpkode.com)) Lead developer and architect: Thomas Gangsøy. Professional developer, and brewer at heart! Brewfather® is a registered trademark. Brewfather**©** copyright Warpkode AS. All rights reserved. ![Monitor your brews with Brewfather's integrations](/files/-LFSJfdaVSwmwwONU9nN) ## Documentation * [Getting Started](/getting-started) — Set up your brewery and brew your first batch * [Recipes](/recipes) — Recipe designer, folders, versioning, and water calculator * [Batches](/batches) — Batch tracking from planning to completion * [Profiles](/profiles) — Equipment, mash, fermentation, and water profiles * [Inventory](/inventory) — Ingredient stock and cost tracking * [Tools](/tools) — Brewing calculators and conversion tools * [Integrations](/integrations) — Connect devices and third-party services * [API](/api) — REST API for custom integrations * [FAQ](/faq) — Frequently asked questions {% hint style="warning" %} **Brewfather 3.1.0 Public Beta is available.** See [Public Beta](/beta) for the current changes and instructions for web, iOS, and Android access. {% endhint %} # Getting Started Get started with Brewfather by setting up your brewery, creating recipes, and brewing your first batch. Brewfather is a comprehensive brewing app for designing recipes, managing inventory, and tracking batches across web and mobile. Whether you are new to homebrewing or a seasoned brewer switching from another app, this section helps you get up and running. ## What You'll Accomplish By the end of these guides, you will have your brewery configured, your first recipe designed, and your first batch tracked. ## Recommended Learning Path Follow these guides in order for the smoothest experience: 1. [Quick Start](/getting-started/quick-start) — Your first recipe and batch in 5 minutes 2. [Setting Up Your Equipment Profile](/getting-started/setting-up-your-equipment-profile) — Configure your brewery for accurate calculations 3. [Creating a New Recipe](/getting-started/creating-a-new-recipe) — Design a recipe from scratch in the Recipe Designer 4. [Import Recipes](/getting-started/import-recipes) — Bring in recipes from BeerSmith, Brewer's Friend, or other tools 5. [Your First Batch](/getting-started/your-first-batch) — Brew, ferment, and track your batch from start to finish 6. [Introduction Videos](/getting-started/introduction-videos) — Visual walkthroughs from the community 7. [Add/Update Data](/getting-started/add-update-data) — Add custom ingredients or contribute to the shared database ## First Time in the App When you first sign in, Brewfather walks you through a short setup: accept the Terms of Service, learn about the app, optionally start a free 30-day Premium trial (no credit card required), and choose your preferred unit system (Metric, Imperial, or US). After onboarding, you will land on the Recipes page — your home base for designing and managing recipes. ## Navigation Overview The sidebar menu gives you access to the main sections of Brewfather: * **Recipes** — Design, edit, and organize your beer recipes * **Batches** — Track brews through Planning, Brewing, Fermenting, and Completed stages * **Inventory** — Manage your stock of fermentables, hops, yeast, and miscellaneous ingredients * **Library** — Browse community-shared recipes for inspiration * **Profiles** — Configure reusable equipment, mash, fermentation, and water profiles * **Styles** — View and reference beer style guidelines (BJCP, BA, and custom) * **Tools** — Access brewing calculators for carbonation, ABV, refractometer readings, and more * **Settings** — Customize units, formulas, and app preferences * **Devices** — Monitor connected IoT devices such as hydrometers and temperature controllers (visible when devices are configured) ## Guides {% content-ref url="/pages/TROmd6ZQR7StzibmTCEE" %} [Quick Start](/getting-started/quick-start) {% endcontent-ref %} {% content-ref url="/pages/-LF3ety-wpkAIUS-t78I" %} [Setting up your equipment profile](/getting-started/setting-up-your-equipment-profile) {% endcontent-ref %} {% content-ref url="/pages/-LF3eVpdZxRFqbwVV4t6" %} [Creating a new recipe](/getting-started/creating-a-new-recipe) {% endcontent-ref %} {% content-ref url="/pages/-Lus8GEuZ26A3kaJi-YF" %} [Import Recipes](/getting-started/import-recipes) {% endcontent-ref %} {% content-ref url="/pages/-LF3elbCaZdG4Dhw52QB" %} [Your first batch](/getting-started/your-first-batch) {% endcontent-ref %} {% content-ref url="/pages/-LF3hT9Q0s5os451J9es" %} [Introduction videos](/getting-started/introduction-videos) {% endcontent-ref %} {% content-ref url="/pages/-MQWr4HRhmk8vW3-mcpM" %} [Add/Update data](/getting-started/add-update-data) {% endcontent-ref %} ## Popular Next Steps {% content-ref url="/pages/-LF4R8Pgdnt5WKrvEQhW" %} [Tilt Hydrometer](/integrations/tilt-hydrometer) {% endcontent-ref %} {% content-ref url="/pages/-LF4SPDKe6PerPhJEz6J" %} [Water Calculator](/recipes/water-calculator) {% endcontent-ref %} [**Go to Brewfather app**](https://web.brewfather.app) # Quick Start Design your first recipe and start your first batch in Brewfather in about five minutes. Get your first recipe designed and your first batch started in about 5 minutes. ## Prerequisites * A Brewfather account (sign up at [web.brewfather.app](https://web.brewfather.app)) * Completed the onboarding setup (terms, units) ## Step 1: Create a New Recipe 1. Open the sidebar menu and navigate to **Recipes** 2. Click the **+** button in the toolbar to create a new recipe 3. Give your recipe a name at the top of the designer ## Step 2: Choose a Style and Set Up Basics 1. Select an **Equipment Profile** — Brewfather includes several pre-configured profiles, or you can [set up your own](/getting-started/setting-up-your-equipment-profile) 2. Pick a **Style** (e.g., "American IPA" from BJCP 2021) — the designer will show target ranges for OG, FG, IBU, color, and ABV 3. Set the **Brew Type** (All Grain, BIAB, Partial Mash, or Extract) ## Step 3: Add Ingredients 1. Tap the **+** button in the **Fermentables** section and search for a base malt (e.g., "Pale Ale Malt"). Set the amount. 2. Tap the **+** button in the **Hops** section and search for a hop (e.g., "Cascade"). Set the amount, time, and use (Boil, Dry Hop, etc.) 3. Tap the **+** button in the **Yeast** section and search for a yeast strain (e.g., "US-05") As you add ingredients, the calculated values (OG, IBU, Color, ABV) update in real time. The colored bars show how your recipe compares to the selected style guidelines. ## Step 4: Save Your Recipe Click the **Save** button in the toolbar. Your recipe is now stored in Brewfather and synced across all your devices. ## Step 5: Start Your First Batch 1. Click the **Brew** button in the recipe toolbar 2. Review the batch details (brew date, batch number, brewer name) 3. Click **Create Batch** Your batch is created in the **Planning** stage. From here you can review your water volumes, grain bill, and hop schedule before brew day. ## What You Just Did * Created a recipe with fermentables, hops, and yeast * Saved it to your Brewfather account * Started a batch to track your brew from planning through completion ## Next Steps * [**Set Up Your Equipment Profile**](/getting-started/setting-up-your-equipment-profile) — Configure your specific brewery for accurate volume and efficiency calculations * [**Create a Detailed Recipe**](/getting-started/creating-a-new-recipe) — Learn all 12 steps of the Recipe Designer including mash profiles, fermentation profiles, and water adjustments * [**Track Your Batch**](/getting-started/your-first-batch) — Follow your batch through Planning, Brewing, Fermenting, and Completed stages * [**Import Existing Recipes**](/getting-started/import-recipes) — Bring in recipes from BeerSmith or other brewing software via BeerXML or BeerJSON * [**Explore the Library**](/library) — Browse thousands of community-shared recipes for inspiration # Setting up your equipment profile Configure your Brewfather equipment profile with volumes, efficiency, and water calculations for accurate brewing. Your equipment profile tells Brewfather about your specific brewery — kettle sizes, efficiency, losses, and water calculations. Accurate equipment settings are the foundation for reliable recipe calculations, so it's worth taking a few minutes to configure this before your first brew. {% hint style="success" %} **Quick Setup — Just the Essentials** If you want to get brewing quickly, you only need to set these four values: 1. **Batch Volume** — Your target volume based on your **Batch Volume Target** setting 2. **Brewhouse Efficiency** — Start with 72% if you're unsure, then adjust after your first brew 3. **Boil Off** — How much liquid evaporates per hour (typically 3-4 L/hr or \~1 gal/hr) 4. **Trub/Chiller Loss** — Volume left behind in the kettle (typically 1-2 L or \~0.5 gal) You can fine-tune the other settings later as you learn your system. The rest of this page covers every field in detail. {% endhint %} {% hint style="warning" %} **Common setup mistakes to avoid:** * **Batch Volume** is not your kettle capacity. It depends on **Batch Volume Target**: select whether you want Batch Volume to match the final volume in the **Fermenter** or the end-of-boil **Kettle** volume (hot), also known as **Post-Boil Volume**. Entering pot size will result in too much water. * Don't guess your **Boil-Off Rate** — measure it by boiling a known volume of water for 60 minutes and checking the difference. * Start with **Brewhouse Efficiency** at 65–75% and adjust after your first few brews by comparing predicted vs. actual OG. {% endhint %} Many equipment profiles come pre-configured in Brewfather, but if you can't find your equipment here is how to set up your own. To set up your Equipment profile, select the Profiles page from the menu. Click Equipment, and add a new profile, or edit the default profile. ![The equipment profile is customizable to get the right numbers for any system](/files/-MZHQ_TOsdIYfbiKbJbR) **Name:** Name for your equipment profile **Boil Time:** Boil time for this equipment profile, if you adjust boil time when "Calc boil volume" is activated, the pre-boil volume will change to match the new boil time based on boil-off. **Description:** Free text field for details about the equipment. ## Volumes ![](/files/-MZHQUYyyGf3lxuxUyms) **Batch Volume Target:** Select if you want your Batch Volume to match final volume in **Fermenter** or end of boil **Kettle** volume (hot) also known as Post-Boil Volume. {% hint style="info" %} Using **Kettle** as **batch volume target** the Original Gravity calculation will be **independent of** your amount of **Trub/Chiller loss** (except fermenter additions). You only have to know your **mash efficiency** to set this up and **brewhouse efficiency is not needed**. When using Kettle as batch volume target brewhouse efficiency will be hidden. {% endhint %} {% hint style="info" %} **Hot vs cold volumes** Brewfather treats **Pre-Boil Volume** and **Post-Boil Volume** as **hot** kettle volumes (end of boil, before chilling). Think of **hot** as the volume at your boil temperature (often close to **100°C / 212°F**), and **cold** as the volume after chilling (often close to **20°C / 68°F**, or your pitching/fermentation temperature). Brewfather does not model the exact temperatures — it uses the **Cooling Shrinkage / Boil Expansion** percentage (default **4%**) as a simple conversion between hot and cold volumes. With shrinkage = **4%**, the hot↔cold conversion factor is **0.96**: * cold = hot × 0.96 * hot = cold ÷ 0.96 Example: 25.0 L hot post-boil ≈ 24.0 L cold. {% endhint %} **Batch Volume:** Your final batch volume target, a factor in calculating your Original Gravity. **✔ Calc boil volume:** Automatically calculates your **Pre-Boil Volume** if this is enabled, calculated back from **Batch Volume**. It accounts for boil-off, trub/chiller loss, and **Cooling Shrinkage / Boil Expansion** (default **4%**) (**recommended**). **Pre-Boil Volume:** Set your pre-boil volume manually, or have it calculated automatically (recommended). This is a **hot** kettle volume (end-of-boil reference, includes boil expansion). **Post-Boil Volume** is also a **hot** end-of-boil kettle volume (before chilling). **Boil Off:** How much you boiloff per hour with your setup, important factor in calculating Pre-Boil Volume. **Trub/Chiller Loss:** How much you lose as trub (and/or left in chiller and/or pipes) **from kettle to fermenter**, important factor in brewhouse efficiency. Total volume of the trub left in the kettle and/or cooler/tubes/hoses, including hop trub. **Mash-Tun Deadspace:** Recoverable deadspace volume in your mash-tun, used for calculating mash water amount. In a system with a malt pipe, it is the volume before the water reaches the bottom of the malt pipe. Usually 0 in BIAB. Mash water amount is normally a sum of mash-tun deadspace and water/grain ratio. ***Recoverable volume is volume that is not lost in mashing, but will be included in the boil.*** **Mash-Tun Loss:** Unrecoverable deadspace volume in your mash-tun and/or mash volume lost in your mash process. This is usually 0 in a one-vessel setup. A factor in mash efficiency. *Note: Currently efficiency is not automatically adjusted when this number is changed, you can manually adjust your expected efficiency due to the new dilution factor.* ***Unrecoverable volume does not transfer to boil.*** **Fermenter Loss:** Expected loss from fermenter to bottle/keg. Used to estimate bottling volume and gravity potential from fermentables added as *use* = *Bottling*. **HLT Deadspace** is any dead space in the Hot Liquor Tank (Sparge Water Heater). For example, if you use a sparge water heater that has the tap that draws higher than the bottom of the pot, you can set the liters that are not drawn. This volume will be added to the sparge water amount in the Water Adjustment Calculator, for calculating your sparge water additions. **Fermenter Top-Up** useful if you do high gravity brewing. Add volume into the fermenter to dilute the wort, the preboil volume will be lowered to match your planned fermenter addition. Also useful if you add any other liquid during fermentation. When increasing the Fermenter Top-Up value, the pre-boil volume will automatically lower to match the entered batch size after top-up (If **✔ Calc boil volume** is enabled). If you want to keep the same pre-boil value, increase the batch size accordingly. *Post-Boil Volume in Brewfather refers to the **hot** end-of-boil kettle volume (before applying Cooling Shrinkage). Default Cooling Shrinkage / Boil Expansion is **4%**.* ## Efficiency ![](/files/-MZHEmpVaCQvP2MwlXUD) **Brewhouse Efficiency:** The overall efficiency of your system - includes all losses to the fermenter. Important factor in calculating your Original Gravity. If you don't know your system, a good number to start with might be 65-75%. And you can dial in your exact efficiency after a couple of brews. Brewhouse Efficiency is hidden if you select batch volume target "Kettle". **Mash Efficiency:** The efficiency of your mash procedure, up to pre-boil, including sparging. Important factor in calculating your Pre-Boil Gravity. If you enable "calculate mash efficiency" by enabling the **Calc mash efficiency** checkbox, the mash efficiency will be back-calculated from the brewhouse efficiency based on the equipment profile numbers. If disabled, the brewhouse efficiency will be calculated based on the mash efficiency (**recommended**). ## Advanced ![](/files/-MZHEtqqaRKa7AZjFI3n) **Hop Utilization:** Normally left at 100%. Average hop utilization for your equipment. This is a global multiplier to the IBU calculation. **Aroma Hop Utilization:** For calculating IBU on hopstand/whirlpool hops, also used as a factor to calculate increased IBU from boil hops when you have a hopstand. This utilization is used only when no temperature is entered separately on the hop-stand/whirlpool hop in the recipe. **✔ Calc aroma hop utilization:** If checked, it will automatically calculate your Aroma Hop Utilization based on the entered hopstand temperature. **Hopstand Temperature:** The average temperature of your hopstand, used to automatically calculate your *Aroma Hop Utilization* when *Calc aroma hop utilization* is checked. This is also displayed in the brew sheet if temperature is not specified on the hopstand hop. **Whirlpool / No-Chill Time:** When you set this there will be a set hopstand/whirlpool time on the recipe which will add extra IBU's for all hops in the recipe based on the aroma hop utilization/hopstand temperature. This can also be used to estimate extra IBUs for **No-Chill brewing**. Recommended starting point for No-Chill brewing is a whirlpool time of 30 minutes and 90+C hopstand temperature. These numbers need to be tweaked based on your setup and ambient temperature. ## Altitude / Boil Temperature ![](/files/-MZHG4qDAQLJLR-scs6I) **✔ Altitude adjustment:** If checked, an input box for altitude will appear where you can enter your brewing altitude. This will calculate a new boil temperature for you which is used to calculate the recipe IBUs. Boil Temperatures under 100C will give a lower IBU. Change between meters and ft in the settings page. **Boil Temperature:** You can manually enter your boil temperature (If **✔ Altitude adjustment** is disabled) **Cooling Shrinkage / Boil Expansion:** Normally left at **4%**. This is the factor Brewfather uses to convert between **hot** kettle volumes (Pre-Boil/Post-Boil) and **cold** volumes after chilling (for example Fermenter volume). This value is **not** recalculated based on altitude/boil temperature settings. * With **4%**: cold = hot × **0.96**, and hot = cold ÷ **0.96** * If you set it to **0%**, Brewfather treats volumes across the recipe and batch as **cold** volumes ## Mash and Sparge Water ![](/files/-MZHIC12eIQde-mHNGiu) **Grain Absorption Rate**: Amount of water absorbed by the grain per unit of grain. L/kg when using metric units, and qt/lb when using gal/lbs as volume/weight units. Recommended starting amount **0.8 - 0.96 L/kg** for one vessel brewing systems, **0.6-0.75 L/kg** for BIAB. **Water/Grain Ratio**: Amount of effective mash water per unit of grain. L/kg when using metric units, and qt/lb when using gal/lbs as volume/weight units. Mash-Tun deadspace is added to this volume. **Mash/Sparge Water Calculation Method**:\ **Default**: For one step sparging (Fly sparging). Normal calculation of mash/sparge water amounts.\ **Batch Sparge**: This will calculate multiple sparging volumes (if needed) for batch sparging.\ **No Sparge**: No sparge, full mash volume.\ **Ignore boil expansion**: *Normally not used. This formula does not deduct boil expansion from the pre-boil volume when calculating sparge water amount. Used in some specific equipment profiles only.*\ **Custom**: Define your own custom formula. Formulas must result in water amount in Liter. **✔ Sparge water reminder**: When this is enabled a reminder in the mashing stage of the brew-tracker (when brewing the batch) will trigger at the set **Time left of mash**. ### Custom Water Calculation Method For very **advanced users** or **specialized brewing equipment** the water calculation formulas can be customized exactly for your needs. Select "**Mash/Sparge Water Calculation Method**: **Custom"** for these settings to appear. You can also use this to **manually set your mash and sparge water amounts**. Simply enter the amount in liters directly into the formula fields instead of a formula. ![](/files/-MZHLMuI0bjsEcFrhFaT) Resulting formulas must resolve into liters. Custom fields will consist of metric values. ### Mash Water Limits *Settings for calculating mash water limits that will override the result from the calculation method set above.* **✔ Include grain volume in mash limits**: When this is checked the min and max mash **water** limit turns into mash **volume** limit. Which means that the wet mash grain volume is included in the numbers. Then the max mash volume limit becomes the mash-tun max capacity. **Min:** Minimum limit of mash water, **Max:** Maximum limit of mash water If the calculated mash water is under the minimum limit, it will take water from the sparge water amount and move it to increase the mash volume, dynamically increasing your water/grain ratio. If the calculated mash water is over the maximum limit, it will move water to sparge or top-up water to not exceed the limit, dynamically decreasing your water/grain ratio. ### Sparge Water Limit Use this to avoid getting too much sparge water calculated, if you have limited room in your HLT. **Min:** Will take water from calculated mash water if possible to reach a minimum sparge water amount. Minimum mash water will be prioritized. **Max:** Maximum amount of room in your HLT / Sparge Water Heater. **Overflow Target:**\ **Top-Up:** overflow is moved to top-up water (boil).\ **Mash:** If the calculated sparge water amount is above the limit, it will move water to mash (until maximum mash volume is reached) and/or top-up water to not exceed the limit. **Min HLT water amount**: Define the minimum amount of suggested HLT water you want, so you can cover the coil or heating element. ### Strike Water Temperature **✔ Calc strike water temperature:** When this is checked a calculated strike temperature is added as a first step in your mash schedule. **Mash-Tun Heat Capacity in** ***L equivalent water volume*****:** If your mash-tun is pre-heated set heat capacity to 0. Otherwise use the [**Mash-Tun Calibration tool**](/tools/mash-tun-calibration) to get the value for your equipment. This is **not** Mash-Tun volume. Higher Mash-Tun Heat Capacity makes Brewfather calculate a higher strike water temperature because it assumes the tun absorbs more heat. Lowering the value lowers the calculated strike temperature. If your mash consistently lands high or low, verify the temperature and volume inputs first, then recalibrate instead of applying an arbitrary offset. ### Sparge Temperature Enter your desired sparge temperature. ## Basic steps to set up an equipment profile for a single vessel system 1. **Mash-tun deadspace**: Add water until you reach the bottom of the malt-pipe, note exactly how much water you need to add. 2. With the malt-pipe inserted, add water until it reaches 2-3 cm from the top of the malt pipe, note exactly how much water. This will be the **max mash volume** (including **grain**). If the brewer has overflow function, stop right before it overflows instead. 3. **Boil-off** test, adjust the power % (if possible) to get a reasonable boil, ideally wort, but water will work also, note how much water has boiled off per hour. Remember to measure the volumes at the same temperature, either hot or cold. 4. Measure how much water is left in the system after pumping/draining all the water/wort out (not center/dump drain), estimate of **trub loss**. Dip tube should be adjusted down (if applicable). 5. To figure out a reasonable **water/grain ratio** ideally, one should do multiple mashes and get experience, but one alternative is to do a brew with about 1.060 OG and note how much water added to get a good mash thickness. Subtract the Mash-tun deadspace, then divide amount of water on amount of grains to get the water/grain ratio. 6. Start out with for example a **brewhouse efficiency** of 70%, or **mash-efficiency** of 75%, and adjust it to your result after the first few brews. We should be able to set up a basic profile from that, which can be fine-tuned as you get more experience with the efficiency and losses. ### Recommended configuration You might also want to enter a max mash volume limit, to ensure the mash does not overflow. Activate **✔ Include grain volume in mash limits** and enter the maximum volume inside the mashing space of the vessel. When this is enabled you will get a warning text in the water section of the recipe if water amounts are adjusted due to mash limits (may result in thick mash and lower real world efficiency). ### Additional vessels For multiple vessel systems, you will do similar steps as for a single vessel system, but you should also measure your **Mash-Tun Loss** for transferring to boil, if you mash and boil in different vessels. And you also want to figure out your **Min HLT water amount** if you need to cover coil or heating element in the HLT. And add the **HLT Deadspace** to get extra sparge water calculated to ensure you can get the needed water out of your HLT. ## Next Steps Now that your equipment profile is configured, you're ready to design your first recipe: * [Creating a New Recipe](/getting-started/creating-a-new-recipe) — Step-by-step guide to building a recipe in the designer * [Import Recipes](/getting-started/import-recipes) — Bring in existing recipes from BeerSmith or other tools * [Mash-Tun Calibration Tool](/tools/mash-tun-calibration) — Fine-tune your mash tun's thermal properties for more accurate strike water calculations # Creating a new recipe Step-by-step guide to creating a beer recipe in Brewfather with ingredients, mash, and fermentation profiles. {% hint style="info" %} **Before you start:** For the most accurate calculations, [set up your equipment profile](/getting-started/setting-up-your-equipment-profile) first. You can also start from an existing recipe by browsing the [Library](/library) or [importing recipes](/getting-started/import-recipes) from another brewing tool. {% endhint %} This guide walks you through creating a recipe from scratch in Brewfather, from naming your beer to finalizing your ingredients and profiles. ## Step 1: Open the Recipe Designer Click the menu button in the lower right of the recipes page and click **Add recipe**! or click the + icon on the top toolbar of the recipes page. ![](/files/-LFS45tWvB5eKiw9sDJQ) This opens the [Recipe Designer](/recipes/designer), where you will build your recipe step by step. ## Step 2: Enter Recipe Details Start by filling in the basic information at the top of the designer: 1. **Name** — Give your recipe a descriptive name (e.g., "Citra Smash IPA") 2. **Author** — Enter your name or brewery name 3. **Type** — Select the brew type from the dropdown: * **All Grain** — Full mash with grain * **Partial Mash** — Combination of grain and extract * **Extract** — Malt extract based ## Step 3: Set Your Equipment Profile Select the equipment profile that matches your brewing setup. This determines batch size, efficiency, boil-off rates, and loss volumes. * Click **Change Equipment Profile** to select from your saved profiles * If you have not set up an equipment profile yet, see [Setting Up Your Equipment Profile](/getting-started/setting-up-your-equipment-profile) * Click **Scale** to adjust the recipe to a different batch size * Click **Boil Time** to set the length of your boil (typically 60 minutes) The equipment profile affects all calculated values in the recipe, so it is important to set this before adding ingredients. ## Step 4: Choose a Style Click **Change Style** to pick a beer style from the supported style guidelines (BJCP, Brewers Association, and others). Selecting a style provides target ranges for OG, FG, IBU, SRM/EBC, and ABV — shown as shaded areas on the value sliders so you can see at a glance whether your recipe is within style. You can also skip this step and brew without a style guideline. ## Step 5: Add Fermentables The fermentables section is where you build your grain bill (or extract additions): 1. Click the **Add** button to open the fermentable selector 2. Search for a malt by name — results include your inventory and Brewfather's built-in database 3. Click a fermentable to add it, then set the **amount** (weight) 4. Repeat to add more fermentables As you add fermentables, the **Pre-Boil Gravity**, **Original Gravity (OG)**, and **Color** values update in real-time at the bottom of the section. **Useful tools:** * **Percentage mode** — Click the percentage button to set fermentable amounts as percentages of the total grain bill, rather than absolute weights * **Scale to OG** — Click the OG button to scale all fermentables to hit a target Original Gravity ## Step 6: Add Hops 1. Click the **Add** button in the Hops section 2. Search for a hop variety 3. Set the **amount**, **use** (Boil, Dry Hop, Whirlpool, etc.), and **time** 4. Repeat for additional hop additions The **Total IBU**, **BU:GU ratio**, and **RBR** (Relative Bitterness Ratio) update in real-time as you adjust. * **Scale to IBU** — Click the IBU button to automatically scale your boil hop additions to hit a target IBU value ## Step 7: Add Miscellaneous Ingredients (Optional) Add water chemistry additions, spices, fining agents, yeast nutrients, or other extras: 1. Click the **Add** button in the Miscellaneous section 2. Search for the ingredient 3. Set the amount, use (Mash, Boil, Primary, Secondary, Bottling), and time ## Step 8: Add Yeast 1. Click the **Add** button in the Yeast section 2. Search for your yeast strain 3. Set the amount (number of packages or grams) Click the **Calc** button to open the [Yeast Calculator](/tools/yeast-calculator), which helps you determine the correct pitching rate and whether you need a starter. ## Step 9: Set Mash Profile Click **Change Mash Profile** to select a mash schedule. Brewfather includes common presets: * **Single Infusion** — A single mash step (most common for modern brewing) * **Step Mash** — Multiple temperature steps * **Decoction** — Traditional decoction-based step mashes * **Custom profiles** you have created You can also edit the mash steps directly by clicking the edit button. The estimated values update as you make changes. When editing mash steps, Brewfather can plan the brew-day action for each step: * **Strike** — `Mash in with X @ Y` * **Infusion** — Calculates how much water to add, and supports optional manual infusion amounts and infusion water temperature * **Decoction** — Calculates how much mash to pull, or lets you set a manual pull by volume or percent of mash. Decoction steps can use thick or thin pulls and can include an optional rest before boiling. * **Temperature** — Shows a direct heat step when no water addition or decoction is needed If your mash profile contains decoction steps, you can also set an optional **Decoction Boil Off Rate** on the mash profile to get more exact decoction return-volume guidance. Without a decoction boil-off rate, Brewfather still guides the pull and return, but avoids showing a falsely precise return volume. ## Step 10: Set Fermentation Profile Click **Change Fermentation Profile** to select a fermentation schedule with temperature steps and durations. You can set: * Primary fermentation temperature and duration * Secondary / conditioning (if applicable) * Cold crash temperature and duration * **Carbonation** — Set your target CO2 volumes for packaging ## Step 11: Review Water Volumes The Water section at the bottom shows calculated water volumes for each stage: * Mash water volume * Sparge water volume * Pre-boil volume * Estimated mash pH Click the **Calc** button to open the [Water Calculator](/recipes/water-calculator) for detailed water chemistry adjustments. ## Step 12: Save Your Recipe Click the **Save** button at the top of the designer to save your recipe. Your recipe now appears in the [Recipes](/recipes) list and is ready to brew. ## Next Steps * **Brew it** — See [Your First Batch](/getting-started/your-first-batch) to learn how to start a batch from your recipe * **Fine-tune** — Revisit the designer at any time to adjust ingredients and profiles * **Share it** — Use the Menu > Share option to generate a link others can view * **Export it** — Export as PDF, BeerXML, BeerJSON, or Brewfather Recipe JSON from the Menu > Tip > > As you make changes in the designer, all predicted values (OG, FG, IBU, SRM, ABV) update in real-time. Use the style guideline shading on the sliders to keep your recipe within the target range for your chosen style. # Import Recipes Import recipes into Brewfather from BeerXML, BeerJSON, and Brewfather JSON files. Brewfather supports importing recipes via **BeerXML**, **BeerJSON**, and **Brewfather JSON**. BeerXML and BeerJSON are interoperability formats used by brewing software. Brewfather JSON preserves Brewfather-specific recipe or batch data when moving data between Brewfather accounts or restoring backups. Importing is a Premium feature. {% hint style="warning" %} **Beta 3.1.0:** BeerJSON recipe import and export are in public beta. BeerXML and Brewfather JSON are also available in the stable app. See [Public Beta](/beta). {% endhint %} ## Import from Beersmith 1. Export all of your recipes in one go by selecting the folders you want to export, right-click and select "Export Selected". ![Export recipes from Beersmith](/files/-Lus8_LC7dpUYCC_OJhG) 2\. Select **BeerXML** as the file type when saving the exported file 3\. In the Recipes page of Brewfather, click the import icon in the top right ![Click import on the recipes page](/files/-Lus9ECTrb2qPnGxXK38) 4\. Select BeerXML as import format ![Select BeerXML](/files/-Lus9Yz6Vub48BC2zf7u) 5\. Choose the BeerXML file you exported. It will then start importing all the recipes in the file. You will be prompted to add a tag to the imported recipes if there is more than one in the file. ### Importing from Other Software The BeerXML format (.xml) is supported by most brewing applications. If your source application supports BeerJSON, export BeerJSON and choose **BeerJSON** in Brewfather. Brewfather detects BeerJSON files with a top-level `beerjson` object and can import one or more recipes from the file. Brewfather also supports importing its own **Brewfather JSON** format, which preserves all Brewfather-specific data. This is useful for transferring recipes between Brewfather accounts or restoring from a backup. When importing a BeerXML file exported by Brewfather, Brewfather can also read back Brewfather-specific mash planning fields such as manual infusion amount, infusion water temperature, decoction amount mode, decoction thickness, decoction rest, and decoction boil-off rate. Other brewing apps may ignore those custom BeerXML fields. BeerJSON is an interchange format, so some Brewfather-specific fields may not round-trip exactly between brewing apps. Brewfather preserves **Juice** and **Honey** fermentable types when importing and exporting BeerJSON. BeerJSON `fruit` fermentables import as **Other** because Brewfather does not currently have a separate Fruit fermentable type. ## Organizing recipes in Brewfather After import, you can organize your recipes using both **Recipe Folders** and **tags**: * Use [Recipe Folders](/recipes/folders) to move imported recipes into a folder structure * Use tags during import to label imported recipes by source, style, or migration batch * If you prefer a tag-based workflow, you can still sort recipes by **First Tag** on the Recipes page ## Import troubleshooting checklist If an import fails or keeps spinning: 1. Verify the file format is **BeerXML**, **BeerJSON**, or **Brewfather JSON**. 2. Re-export the file from the source app, then import again. 3. Try importing in the web app at [web.brewfather.app](https://web.brewfather.app) for clearer error feedback. 4. If the file still fails, open it in a text editor and check for obviously broken/empty fields. ### Common Grainfather BeerXML issue Some Grainfather exports can contain invalid BeerXML values (for example batch size fields not matching BeerXML spec expectations). In that case, Brewfather import may fail or import incorrect values. If that happens: 1. Re-export from Grainfather after verifying units/recipe settings. 2. Import again and verify batch size and gravity values. 3. If needed, correct the recipe values manually after import. See also [FAQ: Import fails or keeps spinning](/faq#import-fails-or-keeps-spinning-what-should-i-check). ## Next Steps * [Creating a New Recipe](/getting-started/creating-a-new-recipe) — Learn to build recipes from scratch in the Recipe Designer * [Your First Batch](/getting-started/your-first-batch) — Start brewing with one of your imported recipes * [Setting Up Your Equipment Profile](/getting-started/setting-up-your-equipment-profile) — Make sure your equipment is configured for accurate calculations with your imported recipes # Your first batch Brew your first batch in Brewfather from planning through brewing, fermenting, and completion. {% hint style="info" %} **Before you start:** You'll need a recipe to brew. If you haven't created one yet, see [Creating a New Recipe](/getting-started/creating-a-new-recipe) or [Import Recipes](/getting-started/import-recipes). {% endhint %} This guide walks you through the complete process of brewing a batch in Brewfather, from starting the batch through to completing it. ## Starting a Batch Click the menu button in the lower right of any recipe and click **Brew**! ![](/files/-LFSN1talyvOIOpUgu7R) This creates a new batch based on the selected recipe and takes you to the batch workflow. The batch progresses through four stages: **Planning**, **Brewing**, **Fermenting**, and **Completed**. ## Stage 1: Planning The [Planning](/batches/planning) stage is where you prepare for brew day: ### Set a Brew Date Choose the date you plan to brew. This can be in the future if you are scheduling ahead — you can always update it on the actual brew day. ### Review the Brew Sheet The brew sheet is a complete summary of your recipe, including: * Target volumes and gravities * Full ingredient list with amounts * Mash schedule and temperatures * Boil additions and timing * Fermentation schedule ### Check Off Inventory If you track ingredients in your [Inventory](/inventory), check off each ingredient as you gather it. This automatically subtracts the amounts from your inventory stock. > Tip > > Enable **Allow Negative Inventory** in settings to track ingredients you need to purchase. After checking inventory for your batch, go to Inventory, click Print, and select **Negative Only** to generate a shopping list of missing ingredients. ### Make Last-Minute Adjustments You can still edit the batch recipe during planning. Tap the recipe link to open it and make any changes before you start brewing. ## Stage 2: Brewing When you are ready to brew, navigate to the [Brewing](/batches/brewing) tab and click **Change Status to Brewing**: 1. Confirm the status change 2. Update the brew date if it differs from the planned date ### Follow the Brew Tracker The [Brew Tracker](/batches/brew-tracker) guides you through each step of the brewing process: 1. **Prepare** — Gather and measure all your ingredients 2. **Mash** — Click the play button to start the mash timer. Brewfather prompts you through each mash step with timers and audible notifications 3. **Boil** — Start the boil timer. You will be prompted at the correct times to add hops and other boil additions 4. **Hop Stand / Whirlpool** — If your recipe includes a hop stand, the tracker guides you through the cool-down and addition timing 5. **Cool & Transfer** — Cool your wort and transfer to the fermenter ### Record Measured Values During brewing, record your actual measurements in the **Measured Values** section: * **Pre-Boil Gravity** — Gravity reading before the boil starts * **Pre-Boil Volume** — Volume in the kettle before boiling * **Original Gravity (OG)** — Gravity reading after the boil and cooling * **Post-Boil Volume** — Volume after the boil * **Fermenter Volume** — Volume transferred to the fermenter These values are used to calculate your actual mash efficiency and brewhouse efficiency. Click **+Add** to record additional measurements like first runnings gravity or sparge gravity. ## Stage 3: Fermenting Once your wort is in the fermenter and yeast is pitched, move to the [Fermenting](/batches/fermenting) stage: 1. Click the **Fermenting** tab 2. Change the status to **Fermenting** ### Track Fermentation * **Gravity readings** — Record gravity samples over time to track fermentation progress * **Temperature readings** — Log fermentation temperatures manually or automatically via connected devices ([Tilt](/integrations/tilt-hydrometer), [iSpindel](/integrations/ispindel), [RAPT](/integrations/rapt), etc.) * **Fermentation chart** — View a graph of gravity and temperature over time ### Device Integration If you have a connected hydrometer or temperature sensor, Brewfather can receive readings automatically and plot them on the fermentation chart. See [Devices](/devices) and [Integrations](/integrations) for setup instructions. ### Dry Hop and Other Additions If your recipe has additions during fermentation (dry hops, fruit, spices), the tracker prompts you at the scheduled times. After fermentation, you can optionally move your batch to the **Conditioning** stage to track the carbonation and conditioning phase separately. The Conditioning stage shares the same view as Fermenting. ## Stage 4: Completed When fermentation is finished and you have packaged your beer: 1. Click the **Completed** tab 2. Change the status to **Completed** ### Record Final Values * **Final Gravity (FG)** — Your last gravity reading * **Packaging date** — When the beer was bottled or kegged * **Carbonation method** — Priming sugar, force carbonation, etc. ### Batch Summary The completed batch shows a full summary including: * Actual vs. target values (OG, FG, ABV, IBU, SRM) * Calculated efficiencies (mash, brewhouse) * Fermentation chart * All recorded measurements * Tasting notes (add them as you sample the finished beer) Once a batch is completed and you've added your tasting notes, you can **archive** it. Archived batches move to a separate section on the Batches page, keeping your active list clean while preserving all your data. ## Tips for Your First Batch * **Start simple** — An American Pale Ale or Blonde Ale are great first recipes with forgiving ingredients * **Record everything** — The more measurements you record, the better you can dial in your equipment profile for future batches * **Use the timers** — The brew tracker keeps you on schedule and ensures you do not miss addition times * **Check your equipment profile** — If your measured volumes and gravities are significantly off from predictions, update your [Equipment Profile](/getting-started/setting-up-your-equipment-profile) with your actual values for better accuracy next time * **Review after brewing** — Compare your actual vs. target numbers to learn where your system gains or loses efficiency ## What's Next Now that you've brewed your first batch, explore these features to get even more out of Brewfather: * [Devices & Integrations](/devices) — Connect a Tilt, iSpindel, or other device for automated fermentation tracking * [Inventory](/inventory) — Track your ingredient stock and costs * [Water Calculator](/recipes/water-calculator) — Dial in your water chemistry for your next brew * [Tools](/tools) — Explore brewing calculators for carbonation, yeast pitching rates, hop freshness, and more * [AI Brewing Assistant](/ai-assistant) — Get recipe suggestions and brewing advice (Premium Plus) # Introduction videos Watch community video tutorials covering Brewfather recipes, equipment setup, and water chemistry. These community-created video tutorials provide visual walkthroughs of Brewfather's key features. They are a great complement to the written guides in this section. ### Playlist ### Quick Recipe Creation Quick introduction to creating your first recipe and batch in Brewfather (by KegLand): Covers creating a basic recipe, adding ingredients, and starting a batch. (\~10 min) ### Equipment Setting up your equipment profile: Walks through configuring your equipment profile with volumes, efficiency, and losses. (\~15 min) ### General Watch the introduction and walkthrough video made by Hop Rod Garage [![Brewfather](http://img.youtube.com/vi/GMNkHXhClX4/0.jpg)](http://www.youtube.com/watch?v=GMNkHXhClX4) (English spoken version) A comprehensive walkthrough of Brewfather's main features including recipes, batches, and settings. (\~30 min) [https://youtu.be/eA0ts87FVgc](https://www.youtube.com/watch?v=eA0ts87FVgc) (Norwegian spoken version) ### Water Chemistry Introduction by BrewCabin: Overview of Brewfather's water chemistry tools and mineral adjustments. (\~20 min) Water chemistry easy method: Simplified method for water chemistry adjustments using Brewfather. *** > **Note:** These videos were created by community members and may show older versions of the Brewfather interface. The core workflows remain the same, but some UI elements may look different in the current version. ## Related Written Guides * [Quick Start](/getting-started/quick-start) — Get started in 5 minutes * [Setting Up Your Equipment Profile](/getting-started/setting-up-your-equipment-profile) — Detailed equipment configuration guide * [Creating a New Recipe](/getting-started/creating-a-new-recipe) — Step-by-step recipe creation * [Water Calculator](/recipes/water-calculator) — Water chemistry adjustments # Add/Update data How to add or update shared ingredients and profiles in the Brewfather database. Brewfather includes a shared global database for ingredients and common profiles. Data update requests can add or improve fermentables, hops, yeasts, miscellaneous items, equipment profiles, water profiles, mash profiles, and fermentation profiles. If you can't find the data you need, this guide covers how to add it to your personal inventory or profiles and optionally contribute it to the shared global database. {% hint style="warning" %} **Beta 3.1.0:** Submitting Equipment, Water, Mash, and Fermentation profiles is in public beta. Ingredient update requests remain available in the stable app. See [Public Beta](/beta). {% endhint %} ## Add ingredients or profiles for your own use Adding ingredients to your personal inventory is as simple as going to the **Inventory page** by selecting it in the main menu, then open the type of ingredient and then clicking the Add button in lower left. Fill in the details, then save. Here is a guide on how to get [proper malt data](/inventory/fermentables/adding-new-malts). ![](/files/-MQWrmvdCK2l2idIRzIg) The same can be done for profiles in the "**Profiles**" page. After adding the item or profile, it will be available in the recipe designer. ## Add missing data to the global database (available for all users) You can help by adding missing data or updating existing data by submitting a request in the app. To add data you created yourself, first add ingredients in **Inventory** or profiles in **Profiles** as described above. Then go to the settings page and click the "**Manage**" button in the data section to Submit Data Update Request. ![](/files/-MQWt8gWg8_0ADCRAKYm) Here you can submit a new request to add or update data in the global Brewfather database. ![](/files/-MQWtQ02sh2jDj3N7HtV) Click the "**Submit new update request**" button. ![](/files/-MQWucxk-Ihpam3gFdHn) Add a **description** of your request that makes it easier to identify what you are updating/changing/adding. Add a link to the **source** of the data, or describe how you got the information. In the update request, click **Add Item** and choose the type you want to contribute: **Fermentable**, **Hop**, **Yeast**, **Misc**, **Equipment**, **Water**, **Mash**, or **Fermentation**. After adding the item or profile, you can alter or modify the data as needed. Use **Delete Item** only when you are requesting that an existing global item or profile be removed or retired. You can also **import a BSMX** file using the import button at the top right. This will add all the items in the file to the request. If you are **updating an existing global item or profile** with improved data, you must make sure the existing entry is selected as the item to be replaced. Use **Add Replaced Item** or **Edit Replaced Item** to search the global data and choose the current entry your new data should replace. This helps reviewers publish the update against the correct shared database record. For profile requests, submit profiles that are likely to help other Brewfather users, not one-off personal setups. Include enough context in **Source** and **Update Description** for review. For water profiles, clarify whether the profile is a source water profile or a target profile when relevant. For mash and fermentation profiles, use clear names and steps so reviewers can identify the intended process. When you are done, click the "**Submit for approval**" button and your request will be reviewed, and once approved, the added data will be available for all users of Brewfather. ### General guidelines for data added to Global Database These rules must be followed for your request to be approved. * Make sure most of the numeric details are added when available * Fermentability on fermentables can be left blank, this is normally not available * Keep text description reasonable in length, not too long and detailed * Attenuation of yeast must be set to the maximum value specified by the laboratory. Example a yeast attenuates from 75% to 82%, set attenuation to 82% (this works best with the default "Normal" calculation method). But include the range in the data section for min and max. * If you are updating an existing item or profile with improved data, make sure the existing global entry is selected as the item to be replaced. * The item or profile you are requesting to be added must be of general interest to users of the app (i.e. not "Tony's mash tun") * More guidelines will come as needed. ## Next Steps * [Creating a New Recipe](/getting-started/creating-a-new-recipe) — Use your newly added ingredients in a recipe * [Inventory](/inventory) — Learn more about managing your ingredient inventory * [Adding New Malts](/inventory/fermentables/adding-new-malts) — Detailed guide for adding fermentable data with accurate specifications * [Profiles](/profiles) — Learn more about equipment, water, mash, and fermentation profiles # Recipes Browse, create, and manage your beer recipes with search, sorting, and folder organization.

The recipe section of Brewfather

This section lists all your recipes and provides the options for creating and importing recipes. There are many ways that you can choose to sort your recipes, and they are accessed by clicking the sort button The ways the recipes can be sorted include * Newest - Date order starting with the latest created recipe. * Name - Alphabetically by recipe name. * Style - Recipes are grouped by [Style](/styles), with the name of the style sorted alphabetically. * Author - Recipes are grouped by Author and then sorted alphabetically by Author. This is particularly useful in a commercial setting or when trying to find an imported recipe created by someone else. * Type - Recipes are grouped by recipe type, e.g., all grain, extract, etc. * Equipment - Recipes are grouped by [Equipment profile](/profiles/equipment), with the groups sorted alphabetically based on the Equipment profile name. * Mash - Recipes are grouped by [Mash profile](/profiles/mash), with the groups sorted alphabetically based on the Mash profile name. * Fermentation - Recipes are grouped by [Fermentation profile](/profiles/fermentation), with the groups sorted alphabetically based on the Fermentation profile name. * Folder - Recipes are grouped by their assigned folder. * First Tag & Last Tag - Recipes are grouped by either the first or last tag in the recipe tags section, with the groups sorted alphabetically based on the first or last tag name. All sort orders can be reversed to either A-Z or Z-A by clicking the sort direction arrow. ## List View and Folder View The recipes page supports two view modes, accessible via the view mode toggle button in the toolbar: * **List View** — The default view showing all recipes in a flat, scrollable list with sorting and search. This is the classic recipe list. * **Folder View** — An alternative view that organizes recipes into a nested folder structure, similar to a file manager. You can create folders, nest them, and drag-and-drop recipes between them. Switch between views at any time using the view toggle button. Your view preference is saved and persists between sessions. For full details on creating and managing folders, see [Recipe Folders](/recipes/folders). ## Recipe Versioning Recipe Versioning lets you save snapshots of your recipe at different points in time and restore any previous version. The version selector appears in the recipe toolbar and shows your current version number. * Create new versions with descriptions to track how your recipe evolves * Lock versions as immutable reference points * Restore, rollback, or branch from any previous version * Select which version to brew when creating a batch {% hint style="info" %} Recipe Versioning requires a **Premium** subscription. {% endhint %} For full details, see [Recipe Versioning](/recipes/versioning). ## Tags Each recipe can have one or more tags for organizing and searching your recipe collection. Tags can be added in the [recipe designer](/recipes/designer) below the main ingredient sections. You can sort recipes by their first or last tag (see sorting options above), and tags are included in the recipe search. Tags are separated by comma or period when entering them, and an autocomplete dropdown suggests existing tags as you type. ## Nutrition Information When the Nutritional Information feature is enabled in **Settings > Features**, each recipe displays estimated nutritional values including total calories (kcal), kilojoules (kJ), and carbohydrates (g) per serving. These values are calculated automatically from the recipe's fermentables and are shown in the [recipe designer](/recipes/designer) summary area. For more details, see the [Nutrition Information](/recipes/designer#nutrition-information) section of the Designer documentation. ### Importing a Recipe The [Import button](/getting-started/import-recipes) lets you choose the recipe you want to import in BeerXML, BeerJSON, or Brewfather JSON format. Please note this is only available in premium accounts and NOT free accounts. ### Adding or Creating a New Recipe The [Add Recipe](/recipes/designer) button takes you to the [recipe designer](/recipes/designer) screen to create a new recipe. The Menu Button also provides access to the Add Recipe and Import Recipe functions of Brewfather. ## Search through your recipes

Recipe Search

To search for a recipe, type your search term in the box shown above. This can be used to search for anything, including recipe names, authors, profiles or tags. ## Open a recipe To open a recipe, hover over a recipe with your mouse until it highlights, and then click or tap on the recipe on your phone. ## Toolbar Overview When in **List View**, the toolbar provides: * **Sort** — Choose how recipes are sorted (see sorting options above) * **Import** — Import recipes from BeerXML, BeerJSON, or Brewfather JSON * **Add Recipe** — Create a new recipe When in **Folder View**, additional buttons appear: * **Order Folders** — Reorder top-level folders manually or with auto-sort * **New Folder** — Create a new folder in the current location * **View Mode** — Switch back to List View ## Related docs * [Recipe Designer](/recipes/designer) * [Calculations](/recipes/calculations) * [Water Calculator](/recipes/water-calculator) * [Folders](/recipes/folders) * [Versioning](/recipes/versioning) * [Library](/library) # Designer Design recipes step by step with the Brewfather Recipe Designer's ingredient and calculation tools.
Image of the recipe designer screen where you set the details of your beer recipe in Brewfather

The recipe designer - simple and easy to follow layout

The recipe designer is the heart of your brewing creativity. This is where you design your recipes or modify recipes you have imported. {% hint style="warning" %} **Beta 3.1.0:** Juice/Honey fermentable types and expanded infusion/decoction action guidance are in public beta. The rest of the Recipe Designer remains available in the stable app. See [Public Beta](/beta). {% endhint %} The workflow has been carefully designed to take you step by step through creating your personalised brew. Starting by naming your recipe and choosing the style and your brewing equipment through choosing your ingredients, brewing and fermentation profiles. As you change details and ingredients, your batch details, such as color, predicted gravities and ABV, change in real-time, allowing you to fine-tune each recipe to your target values. ## Recipe Details

Enter recipe details

You input your recipe details in this section and choose the brew type. * Click on the text area under name and author to enter your details. * Click on the Type drop-down to choose the type of recipe (All Grain, Partial Mash or Extract) * **Recipe Image** — To the left of the recipe name, the beer color icon displays your recipe's estimated color. Click on it to upload a custom photo or image for your recipe. If an image has already been added, a thumbnail is shown instead, and clicking it lets you change or remove the image. * **Folder Selector** — Next to the Author field, you can assign the recipe to a folder for organization. See [Recipe Folders](/recipes/folders) for details. * **Version Selector** — When the recipe has been saved, a version selector appears in the recipe details area (on smaller screens) or in the toolbar (on larger screens), showing the current version number and providing access to version history. See [Recipe Versioning](/recipes/versioning) for details. Below the main recipe details and ingredient sections, you will find several additional fields: * **Tags** — A tag input field where you can add tags to organize and search your recipes. Tags are separated by comma or period. As you type, an autocomplete dropdown suggests existing tags. Tags are searchable from the recipes list page. * **Notes** — A large text area (up to 10,000 characters) for recording special notes about your recipe, such as brew day observations, recipe history, or anything else you want to remember. * **Teaser Text** — A short description field for your recipe. This text is displayed when the recipe is shared publicly, giving viewers a brief summary of what the recipe is about. Next comes setting your equipment profile. This affects the predicted values based on batch size, efficiency and other factors from your equipment profile.

Equipment details

* Click on the 'Scale' button to scale the recipe to whatever batch size you would like * Click the 'Change Equipment Profile' button to change your brewing equipment. Changing the equipment profile may ask you if you want to scale the recipe to match the new equipment profile. * Click on the 'Edit Equipment Profile' button to edit your current equipment profile Any edits made will mean Brewfather will prompt you to scale the recipe to ensure that the predicted outcome will remain the same. * Click on the 'Batch Size' button to change the batch size without scaling. * Click on the 'Boil Time' button to set the length of the boil The Style section provides the recipe designer with the guideline ranges to provide meaningful values for the sliders. The shaded areas represent the range of the values provided by the style. The style can be picked from multiple supported style guidelines, including BJCP, etc.

The Style section

Click on the 'Change Style' button to choose your style from the list of [available styles](/styles). ## Ingredients The main body of the designer screen is devoted to your ingredient entry areas.

The fermentables section of your recipe

### Fermentables This is the area where you choose your fermentables. This can include items you have already added to your inventory or a wide range of ingredients in the software. It includes a calculated Pre-Boil, Original Gravity and a Colour value at the bottom which updates in real time as you adjust your grain bill. The section header displays the total weight of all fermentables in the recipe next to the section title (for example, "Fermentables (5.2 kg)"). Each fermentable in the list shows its weight, name, supplier, type (Grain, Sugar, Liquid Extract, Dry Extract, Adjunct, Juice, Honey, or Other), grain color, percentage of the total grain bill, and the use type (Mash, Steep, or Boil) along with the time for boil additions. When Inventory Stock is enabled in Settings, a stock status indicator appears next to each fermentable showing whether it is in stock (see [Inventory Integration](#inventory-integration) below). * To add a fermentable to your recipe click the add button to bring up the 'Add Fermentable' dialog box.

The Add Fermentable Dialog

* Type in the search bar at the top to find a named brand of malt or a generic type of malt from your inventory or the built-in database of fermentables. * If the fermentable you want is not in the database or your inventory you can enter it directly from this dialog box and provide the relevant information about it. Find more information about adding custom fermentables [here](/inventory/fermentables/adding-new-malts). * If you wish to follow a recipe that lists the malts as percentages of the total you can use the add button to add 1kg/lb of each malt then click the Percentage button This will open a dialog box allowing you to set the percentages of each of the fermentable ingredients. Please note that you can go above or below 100% but Brewfather will scale the ingredients to end up with 100% and this may not be scaled the way you want it so keep an eye on the total percentage at the top of the dialog box. * You can also choose to scale the recipe up or down to a specific Original Gravity by clicking on the OG button This will scale all your ingredients linearly to reach the chosen OG. ### Hops Much like the fermentables this allows you to enter hops from your inventory or from a range of hops already included in the software. This includes a Total IBU, BU/GU (Bitterness Units/Gravity Units) ratio and a [RBR value (Relative Bitterness Ratio)](/recipes/designer/relative-bitterness-ratio) which updates in real time with each change you make.

The Hops section

* Click the 'Add' button to add hops from your Inventory or the database. This brings up a dialog that works in the same way as the Fermentables dialog and allows you to either search using the search box at the top or enter in custom details. * The IBU button allows you to set the IBU value that you want and Brewfather scales the 60-minute addition to match the IBU's set. * **Hop Summary toggle** — Click the list icon button in the section header to switch between the individual hop list view and a summary view. The summary view groups hop additions by hop variety, showing the combined total amount, alpha acid percentage, and total IBU contribution for each variety. This is useful for getting a quick overview when a recipe has many hop additions. The toggle is disabled when the recipe has fewer than two hop additions. The section header displays the total hop weight next to the title (for example, "Hops (120 g)"). Each individual hop entry shows its weight, a rate per volume (g/L or oz/gal), name, alpha acid percentage, hop type (Pellet, Whole, Cryo, or CO2 Extract), IBU contribution, use type (Boil, Mash, First Wort, Aroma/Hopstand, or Dry Hop), and time. For Dry Hop additions, the time is shown in days. When Inventory Stock is enabled in Settings, a stock status indicator appears next to each hop entry. **Hopstand** — Hops with the "Aroma" use type are treated as hopstand additions. These are displayed with a "hopstand" label and, if a hopstand temperature is set, the temperature is shown alongside (for example, "hopstand @ 80 C"). The summary area at the bottom of the hops section shows the total hopstand time in minutes and the hopstand temperature when applicable. **Dry Hop and Aroma Hop Rates** — Below the hop list, Brewfather displays the dry hop rate and aroma hop rate in g/L (or oz/gal). These rates are calculated based on the fermenter volume from your equipment profile. The values are color-coded: green when within the recommended range (approximately 4-8 g/L or 0.53-1.07 oz/gal based on research), and highlighted as a warning when above that range. ### Miscellaneous

The Miscellaneous Additions section

This section allows you to include water salt additions, yeast nutrients, finings etc to your recipe and works in the same way as all the sections, click the 'Add' button to choose your additions Miscellaneous ingredients are organized by type and use: * **Types** — Water Agent, Fining, Spice, Herb, Flavor, and Other. The type is displayed below each ingredient name. * **Use types** — Mash, Sparge, Boil, Flameout, Primary, Secondary, and Bottling. The use type determines at which stage of the brewing process the ingredient is added and is displayed on the right side of each entry. * **Time** — For Boil additions, the time in minutes is displayed next to the use type (for example, "15 min Boil"). * **Amount and units** — Each entry shows its amount along with the appropriate unit (g, mg, kg, ml, l, tsp, tbsp, pkg, items, drops, etc.). If a concentration percentage is specified (common for acids), it is displayed next to the ingredient name. When Inventory Stock is enabled in Settings, a stock status indicator appears next to each miscellaneous ingredient showing whether it is in stock. ### Yeast

The Yeast section

This section allows you to add your yeast to your recipe. Clicking the 'Add' button takes you to a dialog box that works in the same way as the other ingredient dialog boxes. You can search from the box at the top or enter custom details directly in the box. There is also a button to take you directly to the [yeast calculator](/tools/yeast-calculator) to work out the amount of yeast you need to pitch or the size of starter you need to create. This is accessible by clicking on the 'Calc' button You can add multiple yeast strains to a recipe. Each yeast entry in the list displays: * **Laboratory and product ID** — The yeast manufacturer (for example, "Lallemand", "Fermentis", "White Labs") and the product identifier are shown prominently. If neither is set, the yeast name is displayed instead. * **Attenuation** — The expected attenuation percentage is shown next to the product ID. * **Yeast name** — The full descriptive name of the yeast strain is displayed below the laboratory/product ID line. * **Starter information** — If a starter has been calculated, the starter volume and DME amount are displayed. * **Pitch rate details** — After using the yeast calculator, the total number of billion yeast cells and the pitch rate in million cells/ml/degree Plato are shown in a summary area below the yeast entries. If a multi-step starter was calculated, each step is listed with its volume and DME/LME requirements. **ABV Tolerance Warning** — If the recipe's predicted ABV would exceed the yeast's maximum ABV tolerance (the `maxAbv` field), Brewfather adjusts the estimated final gravity and displays a warning message indicating by how much the yeast tolerance was exceeded (for example, "Yeast ABV tolerance limit was exceeded by 1.2%"). This helps you identify when a yeast strain may struggle to fully ferment a high-gravity recipe. When Inventory Stock is enabled in Settings, a stock status indicator appears next to each yeast entry showing whether it is in stock. ### Mash Profile

The Mash Profile section

* Here you set your mash profile. You can choose a preset mash profile or one you have already created by clicking on the '[Change Mash Profile](/profiles/mash)' button * You can also directly edit the selected profile by clicking on the edit button The selected mash profile name is shown in the section header (for example, "Mash Profile (Single Infusion, Medium Body)"). Each mash step is displayed as a row showing: * **Step name or type** — The name of the step, or the step type (Infusion, Decoction, Temperature) if no custom name is set. * **Temperature** — The target temperature for the step. * **Duration** — The step time in minutes. * **Mash action guidance** — Brewfather shows the planned brew-day action for the step, for example `Mash in with X @ Y`, `Add X @ Y`, `Pull X thick mash`, `Pull X thin mash`, or `Heat mash to X`. For decoction steps, Brewfather can also show assumptions and warnings behind the inline info/warning icons: * Equipment boil temperature is used for decoction planning * Thick decoctions use the thick-pull ratio, while thin decoctions are treated as liquid-only pulls * Optional decoction rests can be shown as part of the planned pull, rest, boil, and return action * An optional mash-profile `Decoction Boil Off Rate` can be used to estimate `return about X` wording * Manual infusion/decoction overrides show warnings when the entered amount or temperature is unlikely to hit the target rest If your equipment profile has "Calculate Strike Water Temperature" enabled, the calculated strike temperature is displayed at the top of the mash step list before the individual steps. The equipment section of the recipe details also displays the Mash Efficiency percentage, which represents the efficiency of sugar extraction during the mash process. This is separate from the overall Brewhouse Efficiency. As you make changes, the estimated values at the bottom of the section will change in real time to show the predicted results of your changes. The exception to this is if the Final Gravity has been set to a specific value, which can be done or undone by clicking on the 'Final Gravity' button To undo the set final gravity, just click 'Reset' after clicking the 'Final Gravity' button to get an estimated final gravity value. ### Fermentation Profile

The Fermentation Profile section

Here you can choose your[ fermentation profile](/profiles/fermentation) from a list of preset fermentation profiles included or from a custom profile you have created yourself. * Following a common theme you just need to click on the 'Change Fermentation Profile' button to choose another profile * Click the 'Edit Profile' button to edit the current profile directly The selected fermentation profile name is shown in the section header. Each fermentation step is displayed as a row showing: * **Step name or type** — The name of the step, or the step type (Primary, Secondary, Tertiary, Cold Crash, Carbonation, Conditioning) if no custom name is set. * **Temperature** — The target temperature for the step. * **Ramp time** — If a ramp period is specified, it is shown below the temperature (for example, "2 day ramp"), indicating how many days it takes to transition to this step's temperature. * **Pressure** — For pressurized fermentation profiles, a pressure column is displayed showing the target pressure for each step. This column only appears when the fermentation profile has the "pressurized" option enabled. * **Duration** — The step time in days. **Carbonation** — Below the fermentation steps, the carbonation section lets you set your target carbonation level. If a style is selected, the style's recommended carbonation range is displayed as a Carbonation label (for example, "Carbonation 2.2 - 2.8") and is color-coded green when your target is within range. You can edit the target carbonation by entering a value in the input field. The carbonation is expressed in Volumes of CO2 or g/L depending on your unit settings. You can also set your carbonation volumes for when you come to package your beer. The style recommended range is shown by the Carbonation label; you can edit the target to your preference by either clicking the up and down arrows to the right of the figure under the ![](/files/VbNKCDqIa4LPckQBX1I0)label or by double-clicking and editing the value manually. ### Water

The Water Section

This section gives you an overview of the quantities of water needed for each stage of the brewing process and the current water profile. You get an estimated pH value for the mash at the top right by the 'Calc' button The 'Calc' button gives you easy access to the [water calculator](/recipes/water-calculator) where you can calculate the mineral and acid additions to get the right mineral profile and mash pH. ## Toolbar The recipe designer toolbar provides quick access to common actions: * **Undo / Redo** — Step backward or forward through your recent changes. These buttons appear once you have made at least one change to the recipe. * **Save** — When autosave is disabled in your recipe settings, a Save button appears in the toolbar allowing you to manually save your changes. When autosave is enabled, a Save button still appears if there are unsaved changes pending, giving you the option to save immediately rather than waiting for the autosave timer. * **Read Mode** — Toggle between edit mode and a read-only brew sheet view of your recipe. When Read Mode is active, the toolbar icon is highlighted and the recipe is displayed as a formatted, read-only brew sheet. This is useful for reviewing the recipe without accidentally making changes, or for viewing the recipe in a print-friendly format. * **Print** — Generate a PDF of the recipe (web only) * **Public / Private** — Toggle whether the recipe is publicly shared or kept private. When public, the icon shows an eye; when private, a lock icon is displayed. If the recipe is public but has validation issues, a warning icon is shown. * **Version Selector** — Shows the current version number and opens the version history (see [Recipe Versioning](/recipes/versioning)) * **Color Adjuster** — Open the Color Adjuster tool to adjust your grain bill to hit a target color (see [Color Adjuster](/recipes/color-adjuster)) * **Brew** — Start a brew session from this recipe, taking you to the [Batch Planning](/batches/planning) section * **Close** — Close the recipe and return to the previous screen On larger screens, additional toolbar buttons for Delete, Duplicate, Export, and Share are also visible directly in the toolbar for quick access. ### Recipe Details: Folder Selector In the recipe details section, next to the Author field, a **Folder** selector lets you assign the recipe to a folder directly from the designer. See [Recipe Folders](/recipes/folders) for more on organizing recipes into folders. ## Menu The menu appears as a **floating action button (FAB)** in the bottom-right corner of the recipe designer. Tapping the FAB opens a vertical list of sub-buttons that provide access to common recipe actions. Not all functions are available in a free account. The FAB contains the following sub-buttons (from bottom to top): * **Brew** — Takes you on to the [Batch Planning](/batches/planning) section which gives you step-by-step instructions for your brew day and timers for each section of the process * **Close / Save & Close** — Closes the recipe and takes you back to the previous screen, generally the recipes section screen. When autosave is disabled, the button label reads "Save & Close" and saves before closing. * **Save** — Manually save the recipe (only shown when autosave is disabled) * **Share** — Provides a URL you can share with people to enable them to see your recipe * **Export** — Provides you with the option to export the recipe in * PDF * BeerXML * BeerJSON * Brewfather recipe JSON * **Duplicate** — This creates another copy of the recipe * **Delete** — This deletes the current recipe ## Style Ranges The Style section in the recipe details area displays visual range indicators for each of the key recipe parameters. When a style is selected, each parameter shows a horizontal bar with a shaded region indicating the style's acceptable range and a marker for the recipe's current value. The indicators are color-coded green when the current value falls within the style range. The following parameters are shown: * **ABV** — Alcohol By Volume percentage * **OG** — Original Gravity (clickable to set a target OG) * **FG** — Final Gravity (clickable to set a target FG) * **Color** — Beer color in SRM or EBC depending on your unit settings (clickable to open the Color Adjuster) * **IBU** — International Bitterness Units (clickable to set a target IBU) * **BU/GU** — Bitterness Units to Gravity Units ratio (clickable to set a target ratio; toggled on/off by clicking the BU/GU label in the hops summary) * **RBR** — [Relative Bitterness Ratio](/recipes/designer/relative-bitterness-ratio) (toggled on/off by clicking the RBR label in the hops summary) When a style conformity checkmark appears in the Style section header (a double-check icon), it means all displayed parameters are within the selected style's ranges. ## Nutrition Information When the Nutritional Information feature is enabled in **Settings > Features > Nutritional Information**, the recipe designer displays nutrition data in the summary area below the mash section, alongside the Final Gravity, Apparent Attenuation, and ABV values. The following nutritional values are shown per serving: * **Calories (kcal)** — Total calories per serving, combining contributions from alcohol and carbohydrates * **Kilojoules (kJ)** — Total energy in kilojoules per serving * **Carbohydrates (g)** — Total carbohydrates in grams per serving The serving size is determined by your unit settings. The nutritional values are calculated automatically from the recipe's fermentables, original gravity, and final gravity. This feature helps you estimate the nutritional content of your finished beer without needing an external calculator. ## Scaling Options The recipe designer provides several different methods for adjusting recipe quantities, each suited to a different use case: * **Scale Recipe** — The Scale button in the Equipment section header scales the entire recipe to a new batch size. All ingredient amounts (fermentables, hops, miscellaneous, and water volumes) are proportionally adjusted so the recipe characteristics (OG, IBU, color, etc.) remain the same at the new volume. * **Batch Size** — The Batch Size button changes the batch volume without scaling any ingredient amounts. This is useful when you want to adjust the volume while keeping your ingredient amounts fixed, which will change the resulting OG, IBU, and color values. * **Scale to OG** — The OG button in the Fermentables section scales all fermentable amounts linearly to hit a specific target Original Gravity. This adjusts only the fermentable amounts, leaving hops and other ingredients unchanged. * **Scale to IBU** — The IBU button in the Hops section scales the 60-minute boil hop addition to reach a target IBU value. Only the 60-minute addition is adjusted; other hop additions remain unchanged. * **Equipment Profile Change** — When you change your equipment profile to one with a different batch size, Brewfather prompts you with the option to scale the recipe to match the new equipment. Choosing to scale adjusts all ingredients proportionally. Choosing not to scale keeps the ingredient amounts as they are, which will change the predicted values. ## Recipe Image You can upload a custom photo or image for your recipe. This image is displayed alongside the recipe name in the designer and in the recipe list. * To add an image, click on the beer color icon to the left of the recipe name. On smaller screens, an image icon appears to the right of the name field instead. This opens a dialog where you can upload a photo from your device. * If an image has already been uploaded, a thumbnail of the image is shown instead of the beer color icon. Click on the thumbnail to change or remove the image. * The uploaded image is also used when the recipe is shared publicly or exported. ## Inventory Integration When the **Inventory Stock** feature is enabled in **Settings**, the recipe designer shows stock status indicators next to each ingredient (fermentables, hops, miscellaneous, and yeast). This helps you quickly identify which ingredients you have in stock and which ones need to be purchased before brew day. The stock status feature is toggled using the **Show Stock** button in the "Other" section of the recipe designer. When enabled, a small status indicator appears next to each ingredient's amount, showing at a glance whether you have sufficient inventory. The indicator is based on the amounts recorded in your [inventory](/inventory). ## Profiles in existing recipes When you change a profile (equipment, mash, fermentation, water) from the **profiles page**, you have to reselect it in your recipe after you change it. This is because a profile in the recipe is not updated automatically to avoid breaking recipes unintentionally, it will stay at the same value as the profile had when the recipe was created. This goes for all profile types. New recipes will have the updated profile that you starred as default. ## Related docs * [Recipes](/recipes) * [Water Calculator](/recipes/water-calculator) * [Equipment Profiles](/profiles/equipment) * [Mash Profiles](/profiles/mash) * [Batches](/batches) # Relative Bitterness Ratio Understand the Relative Bitterness Ratio (RBR) formula and how it improves on BU:GU for beer balance. This article is mostly copied from the [original RBR article](http://www.madalchemist.com/relative_bitterness.html) (article source), all credits go to: [Mad Alchemist](http://www.madalchemist.com/): The author Ryan Shwayder. The central purpose of this article is that the Bitterness Ratio (BU:GU) that many homebrewers use can be easily made more accurate by focusing on more than Original Gravity and International Bitterness Units. Some factors impacting beer balance are not numerically quantifiable in simple terms. Examples include the malt bill (e.g. 1 lb of Honey Malt contributes far more sweetness than 1 lb of Chocolate Malt--although I almost tried to factor SRM into the new calculation), adjuncts, yeast, mash schedule, and hop variety. You must use your judgment and experience with regard to balance in these areas, because numbers are limited in what they can express. That said, one piece of data we have available to us is not figured into the standard Bitterness Ratio; attenuation. The more attenuated a beer is after fermenting, the fewer fermentable sugars--and therefore residual sweetness--are left behind. Without taking attenuation into account, the Bitterness Ratio is not quite as accurate as it could be in quantifiable terms. For example: A beer that starts out at an OG of 1.050 at 25 IBU would be said to have a Bitterness Ratio of 0.5. If it were split into two batches and one had an apparent attenuation of 80% (Beer A), while another had an apparent attenuation of 60% (Beer B), Beer A would be perceived to be more bitter than Beer B, as the latter has considerably more residual sweetness. The numbers in the tables and charts linked below reflect this theory that I have taken to calling the Relative Bitterness Ratio (RBR). The purpose of BU:GU and RBR is one and the same; to aid in properly balancing a beer against your taste expectations. Since balance expectations are set relative to all beers, we take into account a beer's Apparent Attenuation in comparison to the average beer, and increase the BU:GU if it is more attenuated than average or decrease the BU:GU if it is less attenuated than average. Just like BU:GU, RBR is more bitter when the number is higher and less bitter when the number is lower. If you are used to BU:GU numbers, you will already have an understanding of RBR because the numbers are essentially the same (\~0.5 is average balance--anything lower leans toward sweetness, and anything higher leans toward bitterness). The numbers listed under "Relative Bitterness" should appear familiar to those who have been using BU:GU for a period of time. The Relative Bitterness Ratio can be determined with a fairly simple formula using data you likely already have if you know your BU:GU. > `RBR = (BU:GU) x (1 + (ADF - 0.7655))` RBR = Relative Bitterness Ratio. ADF = Apparent Attenuation. 0.7655 is the average ADF of all beer styles. Since the Relative Bitterness Ratio takes into account balance relative to all beer styles, it uses this as a constant. You are comparing your beer's ADF against the average ADF (0.7655), then adjusting the standard Bitterness Ratio accordingly (it goes up if your ADF is higher than average, down if your ADF is lower than average). Just like BU:GU, higher numbers mean more bitter, lower numbers mean less bitter, and 0.5 is roughly average balance. How do you use this formula? Here's an example. > Beer A has an OG of 1.050 at 25 IBU. The BU (Bitterness Units) is 25 and the GU (Gravity Units) is 50. Therefore, the BU:GU ratio is 0.5 (25/50) > > The Apparent Attenuation of Beer A is 80%, or 0.8. So, the formula is as follows: > > `RBR = (BU:GU) x (1 + (ADF - 0.7655))`\ > `RBR = (25/50) x (1 + (0.8 - 0.7655))`\ > `RBR = 0.5 x (1 + (0.0345))`\ > `RBR = 0.5 x 1.0345`\ > `RBR = 0.51725` > > Since Beer A has a higher ADF than the average beer, it will be a little more bitter, relatively speaking. This means the Relative Bitterness Ratio (RBR) is slightly higher than the Bitterness Ratio (BU:GU). > > Beer B has an OG of 1.050 at 25 IBU. The BU (Bitterness Units) is 25 and the GU (Gravity Units) is 50. Therefore, the BU:GU ratio is 0.5 (25/50) > > The Apparent Attenuation of Beer B is 60%, or 0.6. So, the formula is as follows: > > `RBR = (BU:GU) x (1 + (ADF - 0.7655))`\ > `RBR = (25/50) x (1 + (0.6 - 0.7655))`\ > `RBR = 0.5 x (1 + (-0.1655))`\ > `RBR = 0.5 x 0.8345`\ > `RBR = 0.41725` > > Since Beer B has a lower ADF than the average beer, it will be a little less bitter, relatively speaking. This means the Relative Bitterness Ratio (RBR) is slightly lower than the Bitterness Ratio (BU:GU). As you can see from the example above, the calculation is quite simple when you already know your beer's expected apparent attenuation, gravity units, and IBUs. **Brewfather calculates both BU:GU (Bitterness Ratio) and RBR (Relative Bitterness Ratio) for you automatically, and it is displayed below the Hops section in your recipe. If you click the BU:GU or RBR in the recipe designer you will also get style guide ranges for these values.** ## Related docs * [Recipe Designer](/recipes/designer) * [Calculations](/recipes/calculations) # Folders Organize your recipes into nested folders with tags, colors, icons, and smart sorting. Recipe Folders let you organize your recipes into a nested folder structure, similar to how you organize files on your computer. You can create folders, nest them inside each other, assign colors and icons, tag recipes, and drag-and-drop recipes between folders. ## Creating a Folder 1. Navigate to the **Recipes** page 2. Tap the menu button or the **+ New Folder** option 3. Enter a folder name 4. Optionally select a parent folder to nest it inside 5. Tap **Create** Each folder name must be unique within its parent folder. You can have folders with the same name in different locations. ## Folder Nesting Folders can be nested one level deep — you can create subfolders inside top-level folders, but subfolders cannot contain further subfolders. This keeps your hierarchy simple and easy to navigate. The top level of your recipe list shows a **Default** folder alongside any folders you create. The Default folder contains recipes that haven't been moved into a specific folder. In the UI, it appears at the same level as your other top-level folders: ``` 📁 Default 📁 IPAs 📁 West Coast 📁 New England 📁 Session 📁 Lagers 📁 Pilsners 📁 Dark Lagers 📁 Seasonal 📁 Summer 📁 Winter 📁 Competition ``` To navigate your folder tree: * Click a folder to open it and view its contents * Use the **breadcrumb trail** at the top to navigate back to parent folders * Folders show the number of items and subfolders they contain ## Drag and Drop You can move recipes between folders using drag and drop: 1. **Press and hold** (or click and drag) a recipe card 2. **Drag** it over the target folder — the folder will highlight when ready to receive the item 3. **Release** to drop the recipe into the folder You can also drag recipes to breadcrumb items to move them to parent folders, or drag them to the Default (root) folder. ## Tags Tags allow you to categorize and filter recipes within folders. Recipes can have multiple tags, and you can filter by one or more tags at a time. * Tags appear as filter chips below the search bar when viewing a folder * Tap a tag to activate it as a filter — only recipes with that tag are shown * Tap multiple tags to filter with AND logic (recipes must have **all** selected tags) * Up to **24 tags** are displayed at once, with a count of hidden tags if more exist * Tap an active tag again to deactivate the filter ## Colors and Icons You can customize folders with colors and icons to make them visually distinct: 1. Open the folder menu (long press or right-click on a folder) 2. The folder menu provides: **Rename**, **Delete**, **Create Subfolder**, and **Order Subfolders** 3. To change a folder's color or icon, select the folder and use the available customization options 4. Choose a **color** for the folder 5. Choose an **icon** for the folder 6. Tap **Save** This makes it easy to identify folders at a glance — for example, use a trophy icon for competition recipes or a snowflake for winter beers. ## Searching Within Folders Each folder has a built-in search bar that lets you find recipes quickly: * Type a search term to filter recipes by name, style, author, tags, or other visible fields * Search works together with tag filters — you can combine both * Search results update in real-time as you type * The search term persists as you navigate between folders ## Sorting Recipes in Folders You can control how recipes are sorted within each folder: 1. Tap the **sort icon** in the folder header 2. Choose a sort field (name, date created, date updated, etc.) 3. Choose the sort direction (ascending or descending) Each folder remembers its own sort configuration independently. ## Reordering Folders You can customize the order in which folders appear: 1. Open the folder menu and select **Reorder Folders** 2. **Drag** folders up and down to set your preferred order 3. Alternatively, choose **Auto-Sort** to sort folders by name or date automatically 4. Tap **Done** when finished When auto-sort is enabled, new folders are automatically placed in the correct position. When auto-sort is off, new folders appear at the end and you can reorder them manually. ## Renaming a Folder 1. Open the folder menu (long press or right-click on a folder) 2. Select **Rename** 3. Enter the new name 4. Tap **Save** Renaming a folder automatically updates the path for all recipes and subfolders inside it. ## Deleting a Folder 1. Open the folder menu and select **Delete** 2. Choose what to do with the folder's contents: * **Move to parent folder** — recipes are moved up one level * **Move to Default folder** — recipes are moved to the top-level Default folder 3. Confirm deletion > Tip > > You cannot delete a folder that still contains subfolders. Delete or move the subfolders first. ## AI Organization If you have a large number of unorganized recipes, the AI Organization feature can help. When you have many recipes in the Default folder, a banner may appear suggesting automatic organization. 1. Tap the **Organize** banner or button 2. The AI analyzes your recipes and suggests a folder structure based on styles, ingredients, and naming patterns 3. Review the suggested organization in a preview 4. Accept to apply the organization, or dismiss to keep your current layout > Tip > > AI Organization is designed to migrate from the previous tag-based view, the previous view can still be selected by switching to list view on the recipes page. ## Related docs * [Recipes](/recipes) # Versioning Save snapshots of your recipes, lock versions, and restore previous versions at any time. Recipe Versioning lets you save snapshots of your recipe at different points in time, lock them as immutable references, and restore any previous version. This is especially useful when experimenting with recipe changes, preparing for competitions, or tracking how a recipe evolves over multiple brew sessions. > Tip > > Recipe Versioning requires a **Premium** subscription. See [Subscription](/account/subscription) for details. ## How Versioning Works Every recipe has a **working version** — this is the current, editable copy of your recipe. When you create a version, Brewfather takes a complete snapshot of the recipe at that moment. There are two types of versions: * **Working Version** — The current editable version of your recipe. Only one exists per recipe at a time. * **Immutable Version** — A locked snapshot that cannot be modified. These serve as permanent reference points. ## Creating a Version 1. Open a recipe in the [Designer](/recipes/designer) 2. Tap the **version selector** in the toolbar 3. Tap **Create New Version** 4. Enter a **description** for this version (e.g., "Competition entry 2024", "Before adjusting water chemistry") 5. Optionally check **Mark current version as read-only** to mark the current state as immutable before creating the new working version 6. Tap **Create** Brewfather saves a complete snapshot of the recipe, including all ingredients, profiles, and settings. A new working version is created with the next version number. > Tip > > It is recommended to lock the current version when creating a new one. This ensures you always have an immutable reference point to go back to. ## Viewing Versions 1. Open a recipe and tap the **version selector** 2. The **Version History** modal opens showing: * The **active version** at the top (highlighted) * **Other versions** listed below, sorted by version number (newest first) 3. Tap any version to preview it ### Preview Modes * **List view** (default on mobile) — Shows version list with descriptions and dates * **Split view** (default on desktop) — Shows the version list on the left and a full recipe preview on the right * **Preview view** — Full-screen preview of a single version On desktop, you can resize the split view panel by dragging the divider. ### Navigating Versions When previewing a version, use the navigation toolbar to move between versions: * **Previous** / **Next** arrows to step through versions * Position indicator shows where you are in the version list (e.g., "3 of 7") ## Restoring a Version You can restore any immutable version in two ways: ### Restore as Overwrite Replaces the current working version with the selected version's snapshot. 1. Open the Version History 2. Tap the menu on the version you want to restore 3. Select **Restore (Overwrite)** 4. Confirm the action This is useful when you want to go back to an earlier version and discard your current changes. ### Restore as New Version Creates a new working version from the selected version's snapshot while preserving all existing versions. 1. Open the Version History 2. Tap the menu on the version you want to restore 3. Select **Restore as New** 4. Confirm the action This is useful when you want to branch from an older version without losing your current work. ### Rollback Rollback is a special restore option available only for the immediately previous version. It deletes the current working version and restores the previous immutable version. 1. Open the Version History 2. On the most recent immutable version, select **Rollback** 3. Confirm the action This is the quickest way to undo your latest changes. ## Editing Version Descriptions You can update the description of any version to keep your version history well-documented: 1. Open the Version History 2. Tap the **edit** icon next to a version's description 3. Enter a new description 4. Tap **Save** When editing a version that is not yet locked, you can also choose to mark it as immutable at this point. ## Deleting a Version Only working (non-immutable) versions can be deleted. Immutable versions are locked to protect your version history. 1. Open the Version History 2. Tap the menu on the version you want to delete 3. Select **Delete** 4. Confirm the action ## Batch Integration When creating a batch from a recipe, you can select which version to brew from: 1. Open a recipe and tap **Brew** 2. In the Create Batch dialog, tap **Select Version** 3. Choose the version you want to brew 4. The batch is created with that version's recipe snapshot The selected version is displayed in the batch creation dialog with its version number, description, and lock status. This ensures your batch records reference the exact recipe version you brewed, even if you continue to modify the recipe later. ## Version History Limits * Versions are loaded 10 at a time with a **Load More** button for recipes with extensive histories * Version data is stored server-side and requires an internet connection to access * All version operations (create, restore, switch, delete) are performed through a secure backend API ## Related docs * [Recipes](/recipes) * [File Attachments](/file-attachments) # Color Adjuster Automatically adjust your grain bill to hit a target beer color while maintaining recipe balance. The Color Adjuster is a tool that automatically adjusts the fermentables in your recipe to achieve a target beer color. It intelligently modifies grain amounts to reach the desired SRM or EBC value while optionally maintaining your original gravity (OG). ## Opening the Color Adjuster 1. Open a recipe in the [Designer](/recipes/designer) 2. Tap the **Color Adjuster** option from the recipe tools menu 3. The Color Adjuster modal opens showing your current recipe color and adjustment controls ## Setting a Target Color The adjuster shows your current recipe color and lets you set a target: * **Slider** — Drag the color slider to visually select a target color (1–50 SRM or 2–99 EBC) * **Input field** — Type an exact value for precise control (supports decimal values with 0.1 step, up to 150 SRM / 300 EBC) * **Color preview** — A real-time color swatch shows both the current and target colors side by side The color unit (SRM or EBC) matches your Brewfather settings. The conversion between the two is: **EBC = SRM x 1.97**. ## Selecting Fermentables to Adjust By default, the Color Adjuster automatically selects which fermentables to modify using a smart classification algorithm. It identifies: * **Base malts** — Fermentables with an explicit "Base" grain category, or those making up more than 30% of the grain bill, or extracts with low color values. These are adjusted in the opposite direction to compensate for specialty malt changes. * **Specialty malts** — All other fermentables. These are increased when darkening or decreased when lightening. You can also manually select which fermentables to include in the adjustment: 1. Tap any fermentable in the list to toggle its selection 2. Selected fermentables have a checkmark 3. Only selected fermentables will be modified ## Maintaining Original Gravity The Color Adjuster always maintains your recipe's original gravity by default. It balances extract contributions — if specialty malts increase, base malts decrease proportionally — so the color adjustment does not significantly change your OG. If the OG change exceeds 0.1%, a warning is displayed showing the original and adjusted OG values. ## Maximum Percentage Limits The Color Adjuster respects typical brewing guidelines for ingredient percentages: * **Crystal/Caramel malts**: Maximum 25% of the grain bill * **Roasted malts**: Maximum 15% of the grain bill * **Base malts**: No maximum limit You can **disable** these limits in the adjuster settings if you want full control over the adjustment range. ## How the Adjustment Works The Color Adjuster uses an iterative algorithm based on the Morey equation for color calculation: 1. Calculates the Malt Color Units (MCU) needed to reach the target SRM 2. Classifies your fermentables as base or specialty malts 3. Iteratively adjusts specialty malt amounts to approach the target color 4. Compensates base malts to maintain OG (if enabled) 5. Verifies the final color using Brewfather's calculation engine 6. Repeats until the target is reached or the best achievable result is found The algorithm uses adaptive dampening to converge smoothly, preventing large swings in ingredient amounts. ## Applying the Adjustment 1. Review the preview showing adjusted fermentable amounts and the achieved color 2. Check for any warnings (OG changes, color tolerance, etc.) 3. Tap **Apply** to update your recipe with the adjusted grain bill 4. The recipe designer updates with the new fermentable amounts If the exact target color cannot be achieved (e.g., it requires removing a fermentable entirely), the adjuster gets as close as possible and shows the achieved color alongside the target. > Tip > > For best results, make sure your fermentables have accurate color values (Lovibond or EBC) entered. The Color Adjuster uses these values for its calculations — inaccurate color data leads to inaccurate adjustments. ## Common Use Cases * **Darkening a Pale Ale** — Increase specialty malts like Crystal 60 or Munich to add color and body * **Lightening a Brown Ale** — Reduce roasted or dark crystal malts to bring the color down * **Matching a style** — Set the target SRM to the middle of a style's color range (e.g., 6 SRM for an American Pale Ale) * **Experimenting** — Try different target colors to see how grain bill changes affect your recipe ## Related docs * [Recipe Designer](/recipes/designer) # Water Calculator Adjust water mineral content, pH, and acid additions to match target profiles for any beer style. {% hint style="warning" %} **Beta 3.1.0:** Selectable pH engines, Water Engine 3 Grain pH Profiles, expanded acids, mash acid auto-calculate, Potassium Carbonate, and liquid Calcium Chloride units are in public beta. The existing Water Calculator remains available in the stable app. See [Public Beta](/beta). {% endhint %} ## Set up your Source water profile Go to profiles in the main menu and select Water. Select the default source profile, and adjust the values to match your water report. For more info click the link below. {% content-ref url="/pages/-LF4S8rfwyLBc\_nYbrol" %} [Water](/profiles/water) {% endcontent-ref %} ## Quick Start Workflow 1. **Set up your source water** — Go to Profiles > Water and enter your municipal water report values (see [Water Profiles](/profiles/water) for unit conversions) 2. **Open the water calculator** — In your recipe, scroll to the Water section and click **Calc** 3. **Check your source** — Your default water profile is pre-selected. Click **Change** if you need a different source 4. **Pick a target profile** — Select a target matching your beer style (e.g., "Pale Ale", "Hoppy", "Lager") 5. **Click Auto** — The magic wand button calculates mineral additions (Gypsum, Calcium Chloride, Epsom Salt) to reach the target 6. **Adjust acid for pH** — In the Acid section, select your acid type, set the concentration, and adjust the amount until the estimated mash pH reads 5.2–5.4. You can also use **Auto calculate** to calculate the mash acid amount from your target pH 7. **Set sparge acid** — If sparging, enter your source pH and target sparge pH (5.5–6.0 recommended) 8. **Save** — The mineral and acid additions are saved with your recipe ## Locate the water calculator Normally you do not want to start adjusting your water until the rest of your recipe is done. When you have created your recipe and are ready to start adjusting your water you will find the water calculator in the water section of the recipe designer. ![Click the CALC button to open the water calculator](/files/-LF9tiQxak3RTkEvj_oA) This will open the water calculator. ![](/files/-LF9uKkvHzjpvUc1jI1Q) At the top you will see your current mash water room temperature pH. **All pH values should be measured when the wort is cooled down to room temperature**. {% hint style="info" %} *Temperature note:* The measured pH will vary depending on what temperature you measure it at, and this is not an equipment shortcoming. Brewfather predicts the 20°C mash **pH which should be 5.2-5.6 ideally.** *Measuring pH at mash temperatures might damage your equipment and is not recommended.* {% endhint %} The top of the calculator also shows the selected **pH calculation engine**. Use the edit button beside the engine name, or open the cog icon, to choose the engine and adjust water calculator settings. ## pH calculation engine Brewfather includes multiple pH calculation engines so you can choose how you want the Water Calculator to estimate mash pH: * **Water Engine 1 (Default)** — The default Brewfather pH engine. * **Water Engine 2** — An alternative engine that is tuned differently from the default engine, with extra settings for crystal, roasted, and acidulated malts. * **Water Engine 3 (Advanced)** — An advanced engine with Grain pH Profiles and per-malt profile assignments. The selected engine affects the estimated mash pH and acid suggestions in the Water Calculator. Water Engine 2 and Water Engine 3 can give different estimates than the default engine for the same recipe. If you change engine on an existing recipe, review the estimated pH and acid additions before saving the adjustments back to the recipe. ## Grains ![](/files/-LF9uqcXGDYuu3EX3KZv) The first section of the water calculator shows your grain bill, and the calculator automatically assigns a grain type to it. Verify that the grain and **grain color** matches the grains you will be using, and that the **grain type** is correct. If you use any **crystal**, **roasted** or **acidulated malt**, make sure they are assigned the right category as they have a big impact on the estimated pH. Adjust if needed. ![](/files/-LF9vBP-hMDxA7UIXhRa) You can also ignore the grain, making it not count towards the pH calculation. Useful if you are just steeping that specific grain. ### Grain pH Profiles for Water Engine 3 When **Water Engine 3 (Advanced)** is selected, the grains section shows Grain pH Profile controls for each fermentable. These controls let you: * Use automatic matching * Choose a built-in malt profile * Choose a custom Grain pH Profile * Enter custom values for one grain in the recipe * Mark acidulated malt * Ignore a grain for mash pH Use **Manage** in the Grain pH Profiles section to add, edit, delete, and assign custom profiles. Assignments are useful when a malt name in your recipe should always use a specific profile. ## Water Volumes Next section shows your water volumes, pulled from your recipe and equipment profile. Make sure they are correct. Adjust levels if needed. For example you might want to add more sparge water volume if you have some dead-space in the sparge water heater. ![Water Volumes](/files/-LF9wobmyRK7lOevPBd6) ## Water Source Your default water source profile is preselected and should normally not need any alterations if you have already set up your water profile. If you have multiple source water profiles, you can click the change button as needed to choose another profile as your source. ![Source Water Profile](/files/-LF9x_BEh8qkZpHt0qrT) ## Target Profile (optional) If you want to target a specific water profile for your water adjustment you can optionally select or create a target profile. The target profile is used for when you want to use the auto adjust feature to match your source water against this target. The target water profile is also what shows as a diff under your total water profile when adjusting. ![Target Water Profile](/files/-LF9y0yhRh4Zl5YHXFH8) ## Style Comparison ![General style recommendation](/files/-LF9yjUGoye8Hc7gv7FH) The style section allows you to compare your total water profile against a general recommended range or against a specific style recommendation. If your target profile is above or below the recommended range it will show as red. And green if you are within the recommended range. ![American IPA recommended style range](/files/-LF9zGPVL3MWha00Y-aB) To select other style range recommendations click the dropdown to the right and select the style you want to compare against. ## Adjusting your minerals ![Unadjusted Water](/files/-LFA-5ps8d5GNtR9bxbb) This section of the water adjustment calculator is where you alter the actual water mineral additions. If you have created or selected a target profile, you can click the AUTO button to get a close match or starting point to fine tune the additions. {% hint style="info" %} The default water calculator settings only AUTO adjusts Gypsum, Calcium Chloride and Epsom Salt. As these minerals only adjust the Calcium, Chloride, Magnesium and Sulfate levels the rest will be left as is. This can be changed in the Water Settings. {% endhint %} With a click on the auto button you will get a closer match to your target profile depending on what ingredients are activated and set to be auto adjusted. ![](/files/-LFA33bCLckERQ5B0Eoi) In this example we got a good match on the values that the activated ingredients adjust and more or less hit our desired Calcium, Magnesium, Chloride and Sulfate levels and our desired Sulfate/Chloride ratio. Fine tune as needed or manually adjust your values to hit your desired total water profile. {% hint style="info" %} The auto adjustment will not adjust your ingredients so you exceed any of your target profile values. So if you have trouble hitting your desired calcium or sulfate/chloride ratio with the auto adjust feature. Try increasing other target values, to allow for more room. {% endhint %} {% hint style="info" %} Mineral boxes with a green tint will reduce pH, and minerals with a red tint as background will increase the pH. Gray boxes are neutral. {% endhint %} Potassium Carbonate is available as a water agent. It can be enabled or disabled for mash and sparge additions from Water Settings, like the other water adjustment ingredients. ## Sparge Water ![](/files/-LFA4orhzLo9afiSs_Yx) When adjustment of sparge water is enabled, it will automatically calculate the needed amount to match your desired total water profile. When deactivated these minerals will be added to your mash water. **Note:** In the current UI the sparge mineral addition fields are calculated automatically and shown as read-only (greyed out). If you want to tweak the numbers manually, disable sparge adjustments and adjust the mash additions instead. ## Acid ### Mash ![](/files/-LFA5G1uWFgg7G4YWgY9) This section allows you to adjust your mash pH down with acid. Select your acid type with the dropdown, set the concentration to your acid strength, and adjust the amount to match your desired mash pH. The mash acid selector includes Acetic, Hydrochloric, Lactic, Phosphoric, Sulfuric, Citric, Tartaric, Malic, and CRS. Use **Auto calculate** to calculate the acid amount from the target pH entered in the acid row. After using Auto calculate, review the resulting amount and save the water adjustments to the recipe when you are ready. ### Sparge ![](/files/-LFA5hJt5ALwjtOBTmpt) This section allows you to get a calculated amount for how much acid to add to your sparge water to reach a desired target pH. Enter your source pH and sparge water target pH. Usually you want your sparge water pH between 5.5 and 6 to reduce tannin extraction. ## Save adjustments to your recipe Changes made in the water calculator are applied to the recipe only when you click **Save adjustments to recipe**. If you close or cancel the water calculator, the recipe keeps its previous water settings and misc additions. To automatically save your ingredients to the Misc section of your recipe, click the green **Save adjustments to recipe** button at the bottom. ![BOOM. Adjustments saved to your recipe. Ready to brew!](/files/-LFA6L2iaKm1Dity8GkX) ## Water Settings To show the water settings click the cog in the top right of the water calculator. ![Water Settings](/files/-LFA1mK7P_ktZ8nqFGCM) \ In the water settings you have a list of all the ingredients available to the calculator. By default only a few of them are activated as these are the most common ingredients used in water adjustments. And only Gypsum, Calcium Chloride and Epsom Salt are activated for auto adjustment by default. In the advanced section you can **choose what form of Calcium Chloride** you are using. The default is Dihydrate (flake). You can select Dihydrate, liquid or anhydrous. If you select liquid you can enter your concentration. You can also select if your sparge water adjustment should be activated by default. ### pH engine settings Water Settings includes the **pH calculation engine** selector. The extra settings shown below the selector depend on the selected engine: * **Water Engine 2** can remove crystal malts and roasted malts from the main mash calculation and lets you adjust acid malt strength. * **Water Engine 3 (Advanced)** shows the malt buffering correction factor and enables Grain pH Profiles in the Water Calculator. ### Liquid Calcium Chloride unit When Calcium Chloride is set to **Liquid**, you can choose whether the liquid amount is entered as **g** or **ml**. Set the concentration to match the solution you are using, then use the selected unit consistently when weighing or measuring your addition. ### Potassium Carbonate Potassium Carbonate can be enabled for mash and sparge additions in Water Settings. Enable it only when it is part of your water adjustment process. ### Chalk Using **Chalk** is **not recommended**, it is much preferred to use **Baking Soda NaHCO3** (*or Slaked Lime*) to increase pH. The reason for this is that under normal conditions Chalk reacts slowly and you will not get the effect on pH that you want when you need it. Much of the Chalk you add to mash will end up sitting on the grains after sparging and some will make it through into the kettle and fermenter where it will continue to react and raising pH during parts of the process where you would want it to be falling. There are work-arounds such as dissolving it in acid but you need to be careful that you don't acidify below pH 8.4 (at which pH all the carbonate has been converted to bicarbonate which does react rapidly enough to do what you want to do). One of the acids for this purpose is carbonic acid. To use it the Chalk (CaCO3) is placed in a pet bottle with water and CO2 injected to raise the pressure to the point where enough H2CO3 is dissolved to, in turn, dissolve the CaCO3. The goal is to get the CO3-- converted to Bicarbonate (HCO3-) and the tricky part is that as soon as the pressure is released the HCO3- will convert back to CO3-- and re-precipitate as microcrystals you cannot see and you think you have dissolved all the Chalk. And some of it is still dissolved. The problem is that you won't really be able to tell exactly how much you have dissolved. (Source: [AJ Delange](https://www.homebrewtalk.com/forum/threads/am-i-calculating-my-ph-right.652497/#post-8347271)) The option to activate Chalk is still there but use it carefully knowing the limitations. ## General help ### Solubility of minerals Calcium Chloride is quite soluble.\ Calcium Carbonate (Chalk) is quite insoluble.\ Gypsum (Calcium Sulfate) is not as soluble as Calcium Chloride, but much more soluble that Calcium Carbonate.\ Calcium Carbonate and Calcium Sulfate are both **less** soluble in **hot water than cold** (which is the reverse of the usual case). (Source: [AJ Delange](https://www.homebrewtalk.com/forum/threads/a-brewing-water-chemistry-primer.198460/#post-2324604)) ### Calcium Chloride form In the water calculator settings you can select between **Anhydrous**, **Dihydrate** and **Liquid**. #### Anhydrous **Anhydrous** is defined as without water. Therefore the anhydrous Calcium Chloride has a higher overall amount of calcium by weight. **CaCl2** which has a molecular weight of 110.98 g/mol. Allegedly this would mean it is 100% Calcium Chloride. Anhydrous Calcium Chloride can be sold in pellet form. #### Dihydrate Calcium Chloride **Dihydrate:** **CaCl2·2H2O** has a molecular weight of 147.0 g/mol This means the dihydrate is **theoretically at most**: (110.98 g/mol/147 g/mol x 100%) = **75.50 %** Calcium Chloride. In the real world the Calcium Chloride **Dihydrate is said to vary from 77% to 80%** Calcium Chloride. But selecting **Dihydrate / Flake** in the settings is recommended. **Dihydrate** is typically in a flake form. #### Liquid When selecting Liquid as form you can enter the strength/concentration of your solution. When using liquid as form for the Calcium Chloride it will still save to your recipe in grams since the most accurate method to measure the liquid is by weighing it. Since the liquid can change volume based on temperature and other factors. This is intentional and means you should weigh the solution. ([Source](https://www.researchgate.net/post/Can_I_use_calcium_chloride_dihydrate_instead_of_calcium_chloride_for_the_preparation_of_buffer)) ## Related docs * [Water Profiles](/profiles/water) * [Recipe Designer](/recipes/designer) * [Brewing Knowledge: Water Chemistry](/brewing-knowledge/water-chemistry) # Calculations Reference formulas for wort color calculations using MCU, SRM, and EBC methods. This page documents the key formulas Brewfather uses in recipe calculations. You can choose which ABV, Final Gravity, and IBU formulas Brewfather uses in [Settings > Formulas](/settings#formulas). ## Wort Color Brewfather estimates the color of your wort using a three-step calculation that converts grain color contributions into the SRM and EBC color scales displayed in the recipe designer. ### Malt Color Units (MCU) The first step calculates the raw color contribution of each grain addition. MCU represents the combined color intensity based on each grain's Lovibond rating, its weight, and the total batch volume. Brewfather sums the MCU for all fermentable additions in the recipe. $$ MCU = (Grain ColorLovibond \* Grain Weight Lbs)/VolumeIn UsGallons $$ ### Morey Equation (MCU to SRM) The raw MCU value is then converted to the SRM (Standard Reference Method) color scale using the Morey equation. This non-linear formula accounts for the fact that color perception does not scale linearly with grain additions -- doubling the grain does not double the perceived color. The Morey equation is widely regarded as the most accurate single-equation method for predicting beer color. $$ SRM Color = 1.49 \* (MCU^0.69) $$ ### SRM to EBC Conversion Finally, for users working in the EBC (European Brewery Convention) color scale, Brewfather converts the SRM value to EBC using the standard conversion factor. The EBC scale is commonly used in Europe and produces higher numeric values than SRM for the same color. $$ EBC = SRM \* 1.97 $$ ## Related docs * [Recipe Designer](/recipes/designer) * [Brewing Knowledge: Fundamentals](/brewing-knowledge/fundamentals) # Batches Track your brews through planning, brewing, fermenting, conditioning, and completed stages.

The Batches screen in Brewfather with Completed, Fermenting and Planned batches

## Batch Cards Batches are displayed as cards with a color-coded left border matching the beer color from the recipe. Each card shows key information at a glance: * **Batch name and number** (e.g., "My IPA #42") * **ABV badge** — Measured ABV if a final gravity reading is available * **Brew date** — Upcoming brew date for planned batches * **Status badges** — Contextual indicators such as: * "Brew Day!" for batches scheduled today * "Overdue X days" for past-due planned batches * "Day X" for fermenting batches showing fermentation progress * "in X days" for upcoming brews * Age badge for completed batches * **Taste rating** — Star rating if the batch has been rated * **Cost badge** — Cost per liter for completed batches (when inventory costs are set) * **Attachments** — Attachment count indicator if files are attached ## Batch Sections Batches are organized into collapsible status sections: * **Planned** — Batches with a scheduled brew date * **Brewing** — Batches currently on brew day * **Fermenting** — Batches in active fermentation * **Conditioning** — Batches in the conditioning phase. Conditioning is a sub-status within the Fermenting stage. The batch displays "Conditioning" as its status, but it uses the same Fermenting view with all the same features (readings, carbonation, measured values, etc.). A batch transitions to Conditioning when you advance it forward from Fermenting. From Conditioning, you can move the batch to Completed. * **Completed** — Finished batches * **Archived** — Older batches that have been archived. Archived batches are read-only — all measured value fields become non-editable. To archive a batch, advance it from the Completed stage. To unarchive, open the batch and use the status transition button to move it back to Completed. Archived batches are stored in a separate section to reduce clutter and save bandwidth. Each section header shows the batch count for that section. Tap a section header to collapse or expand it. The Archived section uses lazy loading — batches are only loaded when you expand it. ## Batch Overview Tap the info button in the toolbar to open the **Batch Overview** popover, which gives a quick dashboard overview: * **Brew Day Today** — Batches scheduled for today * **Overdue Planned** — Planned batches past their brew date * **Upcoming Brews (7d)** — Batches planned within the next 7 days * **Ready to Bottle** — Fermenting batches past their bottling date * **Bottling Soon (7d)** — Fermenting batches approaching bottling date * **Ready to Drink** — Conditioned batches ready for consumption * **In Progress** — All active batches (brewing, fermenting, or conditioning) * **Completed This Month** — Batches completed in the current month Tap any stat card to see the list of matching batches. ## Device Status and Progress For fermenting batches with a connected device, the batch card displays a device icon and fermentation progress: * **Device icon** — Shows the logo or icon for the connected device (Tilt, iSpindel, RAPT, Float, BrewPiLess, Custom Stream, etc.) * **Progress bar** — A visual indicator showing fermentation completion percentage * **Stats grid** — Key readings including specific gravity, temperature, attenuation, ABV, and time of last update ## Creating a Batch To create a batch, go into the recipe you want to brew in the [Recipe](/recipes) list and then click the brew button at the top of the recipe screen or choose brew from the menu button The **Create Batch** dialog lets you configure: * **Brew Date** — Defaults to today, can be changed to any date * **Recipe Version** — If the recipe has versions, you can select which version to brew from. The batch records the exact recipe snapshot for that version. (Requires Premium — see [Recipe Versioning](/recipes/versioning)) * **Batch Number** — Auto-incremented from your settings, can be overridden * **Brewer** — Auto-filled from your account name, or the recipe author if not signed in * **Batch Notes** — Optional notes for the batch (up to 500 characters) When moving a batch through status transitions, the app automatically prompts you to set key dates: the brew date when moving to Brewing, the fermentation start date when moving to Fermenting, and the bottling date when moving to Conditioning or Completed. ## Sorting Batches By clicking the sort button at the top of the screen, you can choose to sort the batches by the following parameters: * Batch Number * Last Updated * Batch Name * Recipe Name * Brew Date * Brewer - this is probably of more use in a commercial environment than for home brewers ## Searching through your batches

Batch Search function

By clicking in the search bar, you can search by pretty much anything you wish, including things like: * Batch Name * Brewer or Author * Batch Number * Ingredient used in the batch * Style * Tags ## Batch Sharing Batches can be shared via a public URL so others can view your batch information. To share a batch, tap the Share button in the toolbar. This generates a unique URL you can send to anyone — recipients see a view-only copy of the batch. To stop sharing, tap "click to unshare" shown at the bottom of the batch page, or use the share option again. Shared batches remain read-only for recipients; they cannot modify any data. ## Menu options in the Batch After clicking on a batch, you can click the menu button which gives a selection of options listed below:- * - Deletes the batch * - Duplicates the batch * - Gives you the ability to export the batch in PDF, BeerXML, BeerJSON, or Brewfather Batch JSON. BeerJSON exports the batch's recipe data for interoperability; use Brewfather Batch JSON when you need Brewfather-specific batch data, readings, and notes. If a custom endpoint is configured, you can also send the batch JSON directly. Fermentation readings can be exported separately as CSV or Brewfather Readings JSON. * - This provides access to a URL that others can use to view your batch information * - This gives you the option of adding notes to the batch * - Takes you back to the Batches screen after saving any changes made to the batch On desktop, these actions appear as individual buttons in the toolbar at the top of the batch page. On mobile devices, they are grouped into a floating action button (FAB) menu in the bottom-right corner. Tapping the FAB opens a vertical list of action buttons including Close, Add Log, Share, Export, Duplicate, and Delete. ## File Attachments Batches support file attachments. You can attach files to any batch, and the attachment count is displayed as a badge on the batch card. This is useful for attaching photos, lab reports, or other documents related to the brew. ## Data in the Batches When clicking on a batch it will take you to the relevant data screen based on the status of the batch, e.g., * [Planning](/batches/planning) * [Brewing](/batches/brewing) * [Fermenting](/batches/fermenting) * [Completed](/batches/completed) These screens will be covered in more depth in each of the relevant sections. ## Related docs * [Planning](/batches/planning) * [Brewing](/batches/brewing) * [Fermenting](/batches/fermenting) * [Completed](/batches/completed) * [Brew Tracker](/batches/brew-tracker) * [Recipes](/recipes) # Planning Review water volumes, grain bill, and hop schedule before brew day and check off inventory.

The first steps on the way to brewing your next batch

## Batch Details The Batch planning screen starts by filling in the main details of the batch, such as the batch name, number, and the brewer. You can choose your brew date here as well. This becomes particularly useful in the commercial environment due to the ability to plan brews and inventory requirements. Still, it can also benefit homebrewers because it means you can start planning your batch and ensure you have everything you need in advance. Immediately under the Batch information is the Batch Recipe name and information. The recipe and any modifications made at this point are saved just in the batch, so you can maintain a master recipe and then adjust each batch recipe for the ingredients you have on hand without changing the overall master recipe. This is ideal for brewing in a commercial setting with ever-changing batches of ingredients that need recording. To modify the recipe, click the edit button and it will take you to the [Recipe Designer](/recipes/designer) page for the recipe. This will allow you to substitute any ingredients or change equipment profiles, for example. Any changes made now will only be saved to the batch recipe, not your master recipe. The batch includes a copy of the recipe, any changes you make to the recipe in batch mode will only change the recipe in the batch section. If you change the original recipe on the [Recipe Designer](/recipes/designer) page in the recipes section, you must click the Update button if you want the changes to be reflected in the batch. This way, the batch will always contain a copy of the recipe the way it was when it was brewed and will then also function as a version log for your recipes. If you want to make the recipe used in your batch a new master recipe, you need to click the save button, and it will save it to your recipes in the recipe section. ## Batch Inventory

Inventory section of the Batch Planning screen

The batch inventory section shows what ingredients you need for your recipe and the total amount in your inventory stock, including fermentables, hops, yeast and miscellaneous ingredients. This allows you to see what ingredients you may need to buy, if any, to brew the recipe. Ticking the checkbox to the left of each ingredient removes the amount from your inventory stock, providing you with a means to maintain an accurate inventory. ## Cost Section

The cost section gives a breakdown of the costs of the batch

If you have entered the details for the cost of the ingredients, when you enter them into your inventory, you will be able to get a cost breakdown for your batch of beer. If you have any ingredients you haven't entered pricing information into the inventory, this will obviously not give you a correct cost, so enter those values into your inventory when you add your ingredient stock. ## Water Section

The water section gives you an overview of the total water needed, including the totals for each part of the process, and the approximate mash pH

The water section summarises the total water needed and the amount used in each part of the process. This is particularly useful if you are using RO water or pre-treating all of your water before brewing. ## Log Section

The Log section allows you to record notes for the batch

The Log section displays any batch notes that have been added during the planning and brewing process of the batch. This can be used for anything, including notes about any issues you had during the brewing and any extra values you may wish to record, like first running gravity, pH at different times during the process like pre-boil, etc. ## Yeast Starter Section When the batch recipe includes a yeast starter, the Planning stage displays a Yeast Starter section. This section appears when the yeast mode is set to "starter" and starter steps have been configured, or when the primary yeast has a starter size defined. For multi-step starters, each step is listed with its starter volume and the required amounts of DME (dry malt extract) and LME (liquid malt extract). If overbuild cells are configured, the section also shows the overbuild volume, harvest ratio, and the final pitch amount for each step. For simple starters (configured directly on the yeast), the section displays the total starter volume and DME requirement. ## Events Section

The events section can list all the key dates in your brew schedule based on your brewing and fermentation profiles used

The events section helps plan all the jobs that need doing. Click the slider at the top right to display all the dates based on your planned brew date, brewing schedule, and fermentation profile. This allows you to double-check your calendar or plan your work schedule in a commercial brewery. Events can include brew day, fermentation step transitions, dry hop dates, and bottling or packaging dates. You can configure notification settings for events so you receive reminders when action is needed. ## File Attachments Batches support file attachments (images, PDFs, lab reports, and other documents) accessible from the File Attachments section at the bottom of the batch page. You can add files using the Add button, and the section can be collapsed to save space. For more details, see [File Attachments](/file-attachments). ## Status Transition At the top of the batch page, status transition buttons allow you to advance the batch to the next stage. From Planning, you can change the status to Brewing, Fermenting, or Completed. When you navigate to a different stage tab, a "Change status to..." button appears at the top, letting you move the batch forward. A secondary button also shows the next logical status (e.g., "Change status to Brewing" when viewing the Planning tab). ## Related docs * [Brewing](/batches/brewing) * [Recipe Designer](/recipes/designer) * [Equipment Profiles](/profiles/equipment) * [Batches](/batches) # Brewing Record brew day measurements, check off ingredients, and advance your batch to the brewing stage. Enter brewing mode, by clicking on the **BREWING** tab.

Changing the status to brewing

Click the button to 'Change Status to Brewing', which will prompt you to 'Change Batch Status to Brewing'. ![](/files/8cXn4XmapAk2OEzSm2pK) Clicking on 'Yes' updates the batch status and prompts you to update the 'Brew Date'; click yes to proceed with the current date. This is particularly useful if you plan your brews and have to swap batches around. Your brew dates will match the actual brew dates rather than the scheduled date. The brewing process starts in the 'Mash Tab' and prompts you to prepare the ingredients to start brewing.

Mash preparation

Brew Controller option

There is the option to connect to Brew Controller, details can be found [here](/integrations/grainfather), which enables you to control your Grainfather. **NOTE: this is in Beta at the moment, so it may not work as expected.** The brewsheet section follows this. This gives you all the vital information about your brew, including gravities, color and volumes. It also gives you a breakdown of all your ingredients and process steps. The mash section of the brew sheet also shows the planned mash actions pulled from your recipe, including strike water, infusion additions, decoction pulls, and direct heat steps. You also have a button to take you to the Batch Recipe if you need to make any last-minute changes to your planned recipe, including things like ingredient batch/lot numbers, etc.

Brewsheet section

When all your ingredients are prepared and you are ready to start, click the Play button to start the brewing process. Brewfather will prompt you to perform each step, e.g. mash in, start boiling, add hops, etc. This will also start timers for the relevant section of the brewing process and will sound an audible notification whenever you have to do anything. See the [Brew Tracker](/batches/brew-tracker) guide for full details on stages, timer controls, notifications, and multi-device sync. There is also an edit timer button to allow you to modify the timer value on the fly should you wish to. The button to the right of this is the 'Skip to Next Step' button which jumps to the next step in the brewing process. ## Brew Controller When a brew controller device is enabled in Settings (Grainfather, SmartPID, or Brewtools), a Brew Controller section appears on the Brewing stage. This section lets you control your brewing device directly from the batch page. You can start a brew session, and if the device is connected, a live device display shows the current status. The controller section includes a show/hide toggle so you can collapse it when not in use. ## Brew Sheet Toggle The brew sheet section can be shown or hidden using a toggle in the section header. When visible, it displays all the vital brew day information including gravities, color, volumes, ingredient breakdowns, process steps, and mash action guidance. A button to edit the Batch Recipe is available in the header for last-minute changes. For mash profiles with decoction steps: * Brewfather shows the pull-and-boil action on the relevant mash step * Thick or thin decoction pulls and optional decoction rests are included in the mash action text * If the mash profile has a decoction boil-off rate configured, the brew sheet can show an approximate return volume * If no decoction boil-off rate is set, the brew sheet still shows the decoction pull, but avoids implying a precise return volume ## Measured Values Under the Measured Values section, you also have a section for recording information about your relevant measurements related to the brewing process. Recording the values here allows you to keep track of your brew day and how your brew has gone. These values are used to calculate things like your mash and brewhouse efficiency, ABV, etc. You can also click the +Add button to add any extra values that you wish to record, such as first runnings, finishing sparge gravities, etc.

Measured Values section

The following measured value fields are available during the Brewing stage: * **Mash pH** — The measured pH of the mash (placeholder defaults to the recipe's target mash pH or 5.4) * **First Wort Gravity** — Appears when Conversion Efficiency is enabled in experimental settings and the recipe has a first wort gravity defined * **Boil Vol** — The measured pre-boil volume * **Pre-Boil Gravity** — The measured gravity before the boil begins * **Post-Boil Gravity** — The measured gravity after the boil * **Post-Boil Kettle Vol** — The measured volume remaining in the kettle after the boil * **Original Gravity (OG)** — The measured original gravity of the wort going into the fermenter * **Fermenter Top-Up** — Any water added to the fermenter after the boil * **Fermenter Vol** — The total volume in the fermenter These values carry forward to the Fermenting and Completed stages, so you only need to enter them once. Custom measured values can be added with the +Add button for anything else you want to track (e.g., sparge runnings, mash-out gravity). ## Related docs * [Planning](/batches/planning) * [Fermenting](/batches/fermenting) * [Brew Tracker](/batches/brew-tracker) * [Devices](/devices) # Fermenting Log fermentation readings, track gravity and temperature, and monitor progress to completion. When you have finished your brew and transferred your wort to the fermenter, you can move on to the fermentation stage. To do this, click the Fermenting tab at the top of the page, then click the Change Status to Fermenting button at the top.

Changing the status of your brew to Fermenting

Under the fermenting tab, you can attach devices such as iSpindels, Tilts, Rapt pills, and other electronic hydrometers to measure and update your brew if you have them. Doing so will produce a graph for you that looks like the example below

Fermentation Graph created using an iSpindel

## Fermentation chart colors {% hint style="warning" %} **Beta 3.1.0:** The primary gravity series is red and the primary temperature series is blue, matching the gravity and temperature reading text shown with the chart. Other device series continue to use distinct chart colors. See [Public Beta](/beta). {% endhint %} This can also be replicated if you take manual readings and enter them in by hand, for example if you are working in a commercial brewery and take daily readings, just click the to add a manual reading. This opens a dialog box that lets you set the date and time of the reading and add details including gravity, temperature, pH, pressure, and a comment.

Add Reading Dialog

The Readings section header includes several management buttons: * **Toggle Raw Values** — Switch between the chart view and a raw values list, which is useful for inspecting individual data points * **Export** — Export your fermentation readings as CSV or Brewfather Readings JSON (requires Premium) * **Edit** — Open the readings editor to edit or delete individual readings * **Devices** — Configure connected fermentation monitoring devices (appears when a device integration is enabled) * **Add Reading** — Manually add a new reading entry After the reading/progress graph is the fermentation profile section Here you can see your fermentation profile set for your batch, including the relevant dates of any changes that need to take place. It also allows you to modify the profile here, should your fermentation have proceeded faster than expected or the cold crash need longer as the beer hasn't clarified as much as expected for example. Following this in the process is a section listing your fermentation start date and the planned bottling date. This is followed by a section listing additions during the fermentation process, including yeast, finings, etc. This also has an edit button, allowing you to modify the recipe to include auxiliary finings, for example, if you decided your beer wasn't clear enough. ## Measured Values There is a section to record important measured values. The Original Gravity, Fermenter Top-Up, and Fermenter Vol values carry over from the Brewing tab. The following measured value fields are available during the Fermenting stage: * **Original Gravity (OG)** — Carried over from Brewing, or can be entered here * **Fermenter Top-Up** — Water added to the fermenter, carried over from Brewing * **Fermenter Vol** — Total volume in the fermenter, carried over from Brewing * **Final Gravity (FG)** — The measured final gravity of the finished beer * **Bottling Volume** — The volume of beer going into bottles or kegs * **Peak Ferm. Temp** — The highest temperature reached during fermentation (used for carbonation calculations when bottle or keg conditioning with sugar) * **Carbonation Temp** — Appears when using Keg (Force) carbonation type, for calculating the required CO2 pressure Custom measured values can be added with the +Add button for any additional data you want to track.

The Measured Values section

## Carbonation

Carbonation Section

The carbonation section gives you a chance to work out how much priming sugar you need or the pressure you need to set your CO2 to carbonate your beer to your desired level. This automatically uses the highest temperature your beer reached during fermentation when using bottle or keg conditioning with sugar, and defaults to the carbonation level recommended for the style of your beer that you chose when designing your recipe. The carbonation type can be selected from three options: * **Sugar** — Bottle priming with sugar. Shows the amount of table sugar needed for your bottling volume and peak fermentation temperature to reach the target CO2 volumes. You can add the calculated carbonation sugars directly to the batch recipe. * **Keg (Force)** — Force carbonation in a keg. Shows the required CO2 pressure at a given carbonation temperature to reach the target CO2 volumes. Instead of Peak Ferm. Temp, this mode uses a Carbonation Temp field. * **Keg (Sugar)** — Keg priming with sugar. Similar to bottle priming, but calculates the sugar amount for keg conditioning rather than bottle conditioning. ## Stats The Stats section displays calculated values based on your measured data: * **ABV** — Alcohol by volume, calculated from your measured Original Gravity and Final Gravity * **Attenuation** — Apparent attenuation percentage * **Conversion Efficiency** — Appears when enabled in experimental settings and when the recipe has a first wort gravity defined * **Mash Efficiency** — Efficiency of the mash process * **Brewhouse Efficiency** — Overall efficiency from grain to fermenter (shown when the equipment efficiency type is not set to "Kettle") These values are automatically calculated and read-only. ## Conditioning When fermentation is complete, you can move to the Conditioning stage by changing the batch status. The Conditioning stage is a sub-status within the Fermenting view — the batch shows as "Conditioning" in its status, but you continue to use the same Fermenting interface with all the same features including readings, carbonation calculations, measured values, and stats. From Conditioning, you can advance the batch to Completed. ## Related docs * [Brewing](/batches/brewing) * [Completed](/batches/completed) * [Devices](/devices) * [Notifications](/notifications) # Completed Rate, review, and archive finished batches with tasting notes and nutritional information. When your beer is finished and packaged, you can click on the Completed tab and mark your beer as complete. This section allows you to see various information about your recipe and add notes to the batch about how it turned out.

The Taste section in completed

The first section is the Taste section, which allows you to rate the taste of the beer and record tasting notes for it. The rating uses a star rating component, allowing you to rate your beer from 0 to 5 stars. Underneath the slider is a section that allows you to record tasting notes and comments on the beer. Definitely worth filling out if you plan to come back and brew the beer at a later date as it allows you to add comments on what you may change in the future.

Additional Information section

## Additional Information (Nutrition) You then get the Additional Information section where you can see the approximate calorie and carbohydrate content of your beer. This section only appears when two conditions are met: Nutritional Information must be enabled in your Settings, and the batch recipe must have nutrition data calculated (i.e., the recipe includes carbohydrate and calorie values). When visible, it shows calories (kcal and kJ) and carbohydrates (grams) per serving. ## Cost Breakdown When cost tracking is available (requires Premium) and your ingredients have pricing information in the inventory, the Completed stage shows a Cost Breakdown section. This section displays costs grouped by ingredient type: * **Fermentables** — Cost and percentage share * **Hops** — Cost and percentage share * **Miscs** — Cost and percentage share * **Yeasts** — Cost and percentage share * **Total** — Combined cost of all ingredients * **Cost per volume unit** — Cost per bottled liter (or your configured volume unit), calculated from the total cost and bottling volume The Cost Breakdown section also appears on the Planning stage. ## Stats The Completed stage displays the same statistics as the Fermenting stage, calculated from your measured values: * **ABV** — Alcohol by volume, calculated from measured Original Gravity and Final Gravity * **Attenuation** — Apparent attenuation percentage * **Conversion Efficiency** — Appears when enabled in experimental settings and when the recipe has a first wort gravity defined * **Mash Efficiency** — Efficiency of the mash process * **Brewhouse Efficiency** — Overall efficiency from grain to fermenter (shown when the equipment efficiency type is not set to "Kettle") ## Archiving From the Completed stage, you can archive the batch by advancing it to the Archived status. Archived batches are moved to a separate section to reduce clutter and save bandwidth. Once archived, a batch becomes read-only — all measured value fields are locked and cannot be edited. To unarchive a batch, open it and use the status transition button to move it back to Completed. ## Related docs * [Fermenting](/batches/fermenting) * [Batches](/batches) # Brew Tracker Use the Brew Tracker to guide you through each step of your brew day with countdown timers, automatic step notifications, and multi-device sync. The Brew Tracker is Brewfather's guided brew day timer system. It automatically generates a step-by-step timeline from your recipe's mash schedule, boil additions, and hop stand, then walks you through each stage with countdown timers and notifications. {% hint style="warning" %} **Beta 3.1.0:** Native mobile timers, Live Activities, Brew Tracker widgets, and the expanded infusion/decoction action guidance are in public beta. The standard Brew Tracker remains available in the stable app. See [Public Beta](/beta). {% endhint %} ## Enabling the Brew Tracker The Brew Tracker must be enabled in your settings before it appears on batch pages. 1. Go to **Settings** 2. Under **Features**, toggle **Brew Tracker** on When disabled, the brew tracker section and all associated timers will not appear on your batch pages. ## Starting the Brew Tracker The Brew Tracker appears on the **Brewing** tab of any active batch. Once you change a batch's status to **Brewing**, the tracker is initialized from the batch recipe. To start the timer: 1. Open your batch and navigate to the **Brewing** tab 2. The Brew Tracker section shows the stage bar at the top with your brew stages 3. Press the **Play** button to begin the first stage The tracker records a start time when you first press Play, so you have a log of when your brew day began. ## Stages The Brew Tracker generates stages automatically based on your recipe. The possible stages are: ### Mash Appears for **All Grain** and **Partial Mash** recipes that have mash steps defined. The mash stage includes: * **Heat mash water** -- Prompts you to heat mash water to the strike temperature with the calculated water volume * **Mash action prompts** -- Each mash step shows the planned action, such as `Mash in with X @ Y`, `Add X @ Y`, `Pull X thick mash and boil`, `Pull X thin mash and boil`, or `Heat mash to X` * **Mash step timers** -- Each mash step (e.g. Saccharification Rest, Mash Out) runs as a countdown with the target temperature displayed * **Ramp times** -- If your mash profile includes ramp times between steps, these are tracked as separate sub-steps * **Decoction return step** -- Decoction steps add a separate paused return step after the boil so you can confirm when the boiled mash has been returned to the mash * **Mash additions** -- Any fermentables, hops, or miscs with a "Mash" or "Steep" use timing are shown at the appropriate countdown point * **First Wort additions** -- Hop and other additions marked as "First Wort" appear as steps within the mash stage * **Sparge water reminder** -- If sparge water is configured in your equipment profile (with a reminder time set), the tracker notifies you to prepare sparge water during the mash * **Sparge step** -- At the end of the mash, the tracker prompts you to sparge with the calculated water volume and temperature. For batch sparges, the individual batch volumes are listed * **Mashing Complete** -- A final confirmation step at the end of the mash stage ### Boil Appears when the equipment profile has a boil time greater than zero. The boil stage includes: * **Top-up water** -- If the recipe calculates a top-up water amount, the tracker prompts you to add it before starting the boil * **Boil timer** -- A countdown for the full boil duration * **Boil additions** -- Hops, fermentables, and misc additions timed during the boil (60 min, 30 min, 15 min, 5 min, 0 min, etc.) appear as steps at the correct countdown time * **Flameout additions** -- Additions marked as "Flameout" appear at the end of the boil * **End of Boil** -- A final confirmation step ### Hop Stand Appears when the recipe has a hop stand/whirlpool time or "Aroma" use hop additions. The hop stand stage includes: * **Start Hop Stand** -- Prompts you to begin the hop stand at the target temperature (from your equipment profile or the hop stand temperature setting) * **Hop stand addition timers** -- Timed hop additions during the hop stand period with their temperatures * **End of Hop Stand** -- A final confirmation step ## Stage Navigation At the top of the Brew Tracker, a stage bar shows all stages with their names and a progress indicator. You can tap on a stage name to jump directly to that stage (after confirming). The current stage is highlighted. ## Timer Controls The Brew Tracker provides five control buttons below the stage bar: | Button | Action | | ---------------------------------- | ------------------------------------------------------------------------------------------------------------- | | **Previous Step** (skip backward) | Go back to the previous step. If you are at the first step of a stage, it moves to the previous stage. | | **Restart Current Step** (refresh) | Restart the timer for the current step from the beginning. | | **Play / Pause** | Start or pause the countdown timer. When paused, the timer holds its current position. | | **Set Time** (pencil) | Manually set the current timer position. Enter a value in MM:SS format to jump the timer to a specific point. | | **Skip Forward** (skip forward) | Skip to the next step. If you are at the last step of a stage, it advances to the next stage. | ## Step Types Within each stage, the tracker shows a list of steps. Each step displays: * A **description** of what to do (e.g., ingredient additions with amounts, temperature targets) * A **progress bar** showing time remaining for the current step * A **checkmark** for completed steps * A **Continue** button for steps that require manual confirmation before proceeding (such as "Mashing Complete" or "Start Boil") Some steps pause the timer automatically and wait for you to press **Continue** before proceeding. These include stage transitions and events that require your action (like adding sparge water or confirming end of boil). For decoction steps, the initial tracker step tells you how much thick or thin mash to pull and boil. If the decoction step has an optional rest temperature and time, the tracker includes that rest in the pull-and-boil guidance. After the decoction timer finishes, the tracker inserts a separate paused return step. If the mash profile has a decoction boil-off rate configured, the return step can include an approximate return volume. ## Notifications and Alarms When the tracker is running and a new step is reached, Brewfather can alert you with: * **In-app notifications** -- A toast notification appears in the app with the step name and description * **Push notifications** -- If enabled, a push notification is sent to your device * **Audio alarm** -- An audible alarm sounds when a new step begins You can toggle notifications and the alarm on or off per tracker using the buttons in the Brew Tracker section header: * **Bell icon** -- Toggle push/in-app notifications on or off for this tracker * **Volume icon** -- Toggle the audio alarm on or off for this tracker * **Power icon** -- Turn the entire tracker on or off ## Active Trackers Sidebar Widget When one or more Brew Trackers are running, an **Active Trackers** widget appears in the sidebar navigation. This widget shows: * The number of active trackers * For each active tracker: * The **batch name and number** * The **current stage name** (Mash, Boil, Hop Stand) * The **remaining time** in MM:SS format * The **current step description** * A **power button** to turn off the tracker Clicking on an active tracker in the sidebar takes you directly to that batch's Brewing tab. This is especially useful if you are navigating elsewhere in the app during a brew and want to quickly return to your active batch. ## Native Timer (Mobile App) The Brewfather mobile app for iOS and Android can run the active Brew Tracker stage through the phone's native timer, notification, and widget systems. ### Checking the Native Timer Setting 1. Go to **Settings** 2. Under **Features**, make sure **Brew Tracker** is enabled 3. Review the **Native Timer** toggle The **Native Timer** setting only appears in the native mobile app when Brew Tracker is enabled. It is not shown in the web app. ### Android Foreground Notification While a brew timer is active on Android, Brewfather starts an ongoing foreground notification. The notification can show: * The **batch name** * The **current stage and step** * The remaining time, or paused state when the timer is paused * The next step and time until it begins * Progress through the current stage Tapping the Android notification opens the related batch in Brewfather. ### iOS Live Activity On iOS devices that support Live Activities, Brewfather can show the active brew timer on the **Lock Screen** and in the **Dynamic Island** on supported iPhone models. The Live Activity can show: * The **batch name** * The current stage and stage number * The current step and step temperature when available * A live countdown timer or paused state * Progress through the current stage * The next step preview Tapping the Live Activity opens the related batch in Brewfather. ### Step and Stage Notifications When the native timer is running, Brewfather schedules native step and stage notifications with the brew timer alarm sound: * Step notifications use the step name, or the step description when available * Stage-complete notifications show the completed stage * Android step and stage notifications also vibrate and open the related batch when tapped ### Brew Tracker Widget The Brew Tracker widget is available in the mobile app on both iOS and Android. When an active brew timer is running, the widget can show: * Batch name and current stage * Current step with countdown timer * Step temperature when available * Next step preview * Stage progress * Paused state When no brew timer is active, the widget shows the first available batch list from your synced batches: **Fermenting**, **Completed**, or **Planning**. Depending on the batch status and available data, it can show values such as gravity, temperature, ABV, brew date, and rating. On iOS, the widget can also refresh and expand fermenting batch details on supported iOS versions. Widget taps open the active batch, or the shown batch when a batch list is displayed. ## Multi-Device Behavior The Brew Tracker state is synced to your Brewfather account in real time. This means: * If you start a tracker on one device (e.g., your computer), it appears and updates on other devices logged into the same account (e.g., your phone) * The device that is actively controlling the timer is tracked. When you interact with the timer controls (play, pause, skip, etc.), that device takes control * Alarm sounds can be stopped from any device -- when you dismiss an alarm on one device, it stops on all others * If you close the app and reopen it, active trackers resume from their synced state ## Tips * **Start the tracker when you are ready** -- The tracker does not auto-start. Press Play when you are actually ready to begin your mash or boil. * **Use Set Time if you get ahead or behind** -- If you started a step early or late, use the pencil button to adjust the timer to match reality. * **Keep your recipe accurate** -- The tracker generates stages directly from your recipe's mash steps, boil time, hop additions, and hop stand settings. The more accurate your recipe, the more useful the tracker will be. * **Use mash-profile overrides intentionally** -- Manual infusion and decoction overrides are supported, but they change the generated mash actions and can trigger warnings if the entered amount is unlikely to hit the requested rest. * **Check sparge water reminder settings** -- In your equipment profile, you can configure when the sparge water reminder appears during the mash. This is controlled by the **Sparge Water Reminder** time setting. ## Related Pages * [Brewing](/batches/brewing) -- The batch Brewing stage where the Brew Tracker lives * [Equipment Profile](/profiles/equipment) -- Configure boil time, whirlpool time, sparge settings, and other values that affect tracker stages * [Settings](/settings) -- Enable or disable the Brew Tracker feature * [Notifications](/notifications) -- Configure push and email notification preferences # AI Brewing Assistant An AI-powered brewing companion that helps you create recipes, get brewing advice, and analyze your inventory. The AI Brewing Assistant is a chat-based companion built into Brewfather that helps you create and modify recipes, get answers to brewing questions, analyze your inventory, and more. It understands brewing concepts and has access to your Brewfather data to provide personalized advice. > Tip > > The AI Brewing Assistant requires a **Premium Plus** subscription and uses AI credits. See [Subscription](/account/subscription) for details on plans and credit allocations. ## Opening the Assistant The AI Assistant is available from any page in Brewfather: * **Mobile**: Tap the AI Assistant button to open a full-screen chat overlay * **Desktop**: Click the AI Assistant button to open a floating panel. On larger screens (1680px+), it can dock as a sidebar The panel remembers its open/closed state and size between sessions. ## Chat Interface The assistant uses a conversational chat interface: 1. Type your question or request in the text box at the bottom 2. Tap **Send** to submit 3. The assistant streams its response in real-time with a typing indicator 4. Continue the conversation with follow-up questions Messages have a **5,000 character limit** per message. The assistant shows brewing-themed thinking animations while processing your request. ## What You Can Ask ### Recipe Creation Ask the assistant to create complete recipes from scratch: * "Create a West Coast IPA with Citra and Mosaic hops" * "Design a low-ABV session stout for summer" * "Make a clone of Sierra Nevada Pale Ale" * "Create a Belgian Witbier with orange peel and coriander" The assistant generates a full recipe with fermentables, hops, yeast, mash profile, and fermentation schedule. ### Recipe Modification When you have a recipe open, the assistant can modify it: * "Substitute the Cascade hops for Centennial" * "Adjust this recipe to lower the ABV to 4.5%" * "Scale this recipe down to a 10-liter batch" * "Convert this extract recipe to all-grain" * "Adjust the hop schedule to match BJCP style guidelines" The assistant understands your current recipe context and makes targeted changes. ### Brewing Knowledge Ask general brewing questions: * "What's the difference between ale and lager yeast?" * "How does mash temperature affect body and fermentability?" * "Explain water chemistry basics for IPAs" * "What is a protein rest and when should I use one?" * "How long should I dry hop a NEIPA?" ### Inventory Analysis The assistant can look at your inventory to give recommendations: * "What recipes can I brew with my current inventory?" * "What ingredients am I running low on?" * "Suggest a recipe using the hops I have in stock" * "Do I have enough ingredients to brew this recipe?" ### Recipe and Batch Lookup The assistant can search and retrieve information from your data: * "Find my recipes tagged with 'competition'" * "What was the OG of my last IPA batch?" * "Show me my most recent batch details" ## Context Awareness The AI Assistant is aware of what you're currently viewing in Brewfather: * **Recipe context** — When you have a recipe open, the assistant can reference and modify it directly. A recipe badge appears in the header showing the linked recipe. * **Batch context** — When viewing a batch, the assistant can reference batch details. A batch badge appears in the header. This means you can say things like "adjust this recipe" or "what went wrong with this batch" without having to specify which one. ## Applying Generated Recipes When the assistant creates or modifies a recipe: 1. The recipe preview appears in the chat as a version notification 2. For modifications, this creates a new version of the existing recipe (see [Recipe Versioning](/recipes/versioning)) ## Quick Suggestions Below the text input, the assistant offers suggestion categories to get you started: * **Modify Current Recipe** — Suggestions for adjusting your open recipe (ingredient substitution, hop schedule changes, style guideline improvements, etc.) * **Create New Recipe** — Suggestions for generating new recipes (style-specific, seasonal, clones, session versions, etc.) * **Brewing Basics** — Common brewing questions (yeast types, mashing, water chemistry, dry hopping, etc.) * **Inventory Management** — Suggestions for inventory analysis (summaries, low stock alerts, recipe matching, purchase lists) Tap a category to see specific suggestions, then tap a suggestion to auto-fill the message box. ## Conversations The assistant maintains conversation context throughout a chat session: * **Continue Previous Conversation** — When re-opening the assistant, you can choose to continue your last conversation * **New Conversation** — Tap the menu icon and select **Clear Chat** to start fresh * **Message History** — Scroll up to review previous messages, with a **Load More** button for longer conversations * **Conversation Titles** — Titles are generated automatically from the conversation content. New chats may appear as **Untitled conversation** until a title is generated. * **Rename Chat** — Open the conversation history, tap the **⋯** menu for a conversation, then select **Rename chat** to give it a custom title. * **Delete Chat** — Open the conversation history, tap the **⋯** menu for a conversation, then select **Delete chat** to remove it from your history. ## AI Credits Each message you send to the assistant consumes AI credits from your monthly allocation: * **Premium Plus**: 500 credits per month * Credits reset monthly on your billing date * Tap the **credits indicator** in the assistant header to see your remaining credits, usage this month, and days until reset When you run out of credits, the send button is disabled until your credits reset. You can check your credit balance at any time from the credits popover. ## Rate Limiting To ensure service quality, the assistant limits messages to **10 per minute**. A warning appears when you approach this limit (at 8 messages), and a countdown timer shows when you can send again if the limit is reached. ## Feedback You can provide feedback on any assistant response: * **Thumbs up** — Tap to mark a response as helpful (submitted immediately) * **Thumbs down** — Tap to submit negative feedback. A modal opens where you can describe the issue (20-1000 characters) Your feedback helps improve the quality of the assistant's responses. ## Message Actions Hover over (or long-press on mobile) any assistant message to access: * **Copy** — Copy the message text to your clipboard * **Print** — Print the message content * **Share** — Share the message through your device's share options ## Disabling the Assistant If you prefer not to see the AI Assistant: 1. Tap the menu icon on the assistant panel 2. Select **Disable AI Assistant** 3. The assistant button is hidden from the interface You can re-enable it from the **Settings** page at any time. ## Related docs * [Recipes](/recipes) * [Batches](/batches) * [Settings](/settings) # Devices Manage active device integrations, per-device settings, and batch attachment. The **Devices** page is where you manage device integrations that are already enabled in **Settings → Power-ups**. Use it to: * See discovered devices and latest readings * Enable/disable device groups * Configure per-device offsets * Delete stale device entries * Open batch-level attach/detach flow from fermentation ## Before devices appear in this list A device is shown after both of these are true: 1. Its integration is enabled in **Settings → Power-ups** 2. The device has sent at least one reading to Brewfather (using the URL/ID shown in that integration’s setup) If no integrations are active, Devices shows a message telling you to enable one in Settings. ## Supported integrations shown on this page Depending on what you enabled in Settings, Devices can show: * Tilt™ Hydrometer * iSpindel * Brewbrain Float Hydrometer * DIY Floaty Hydrometer * RAPT * BrewPiLess * Custom Stream * Plaato Airlock * Plaato Keg * SmartPID * Grainfather Bluetooth Controller (GFCC) — accessed from the Batch > Brewing tab > Brew Controller section (requires Premium) ## Device list actions For each discovered device entry, Brewfather can show: * Device name * Last update timestamp * Latest values (for example gravity, temperature, etc.) Available actions per device: * **Configure** (gear): set offsets * **Delete** (trash): remove device entry ### Offset configuration Offset fields are device-type dependent, and can include: * Gravity Offset * Temp Offset * Fridge Temp Offset * Room Temp Offset If your gravity input mode is **SG**, gravity offset uses whole points (for example `-3`, not `-0.003`). ## Batch attachment flow (Fermentation) Attach/detach is done from a batch, not from the main Devices page. 1. Open a batch in **Fermenting** status 2. In the **Readings** section, click **Devices** 3. Use **Attach** on a device to log to that batch 4. Use **Detach** to stop logging to that batch In the batch Devices modal you can also: * Keep only selected series for charting (non-Tilt devices) * Configure offsets per attached device Brewfather checks Premium access when you tap **Attach**. ## Log frequency guidance In batch mode, Brewfather explicitly warns not to log more than once every **15 minutes per device**. If you just attached a device and still see no readings, wait for the next reporting interval (often 15–60 minutes depending on device setup). ## Webhook forwarding (optional) In **Settings → Power-ups**, supported device integrations expose **configure webhook**. Webhook options: * Enable/disable forwarding * Target URL * Format: **Processed** or **Raw** ## SmartPID and Plaato Keg notes * **SmartPID**: use **Configure** from the Devices page to sign in/manage SmartPID devices. * **Plaato Keg**: use **Configure** from the Devices page to add/manage keg device keys. ## Troubleshooting checklist If devices are missing or stale: 1. Confirm the integration is enabled in **Settings → Power-ups** 2. Re-copy URL/ID from the integration setup and verify it in the external device app 3. Send a fresh reading from the device 4. Open Devices again and check if it appears 5. For fermentation logging, confirm the device is **attached** to the current batch ## Troubleshooting ### Readings not appearing in my batch 1. **Attach the device to your batch** — After the device sends its first reading, go to your batch in the Fermenting stage, open Readings > **Devices**, and attach it. Readings are not recorded until the device is attached to a batch. 2. **Check the logging interval** — Brewfather ignores readings sent more often than every 15 minutes. Ensure your device's update interval is 900 seconds or higher. 3. **Verify the integration is enabled** — Go to Settings > Power-ups and confirm the device type is toggled on. Re-copy the Server URL or Logging ID if needed. 4. **Check the batch stage** — Device readings are only recorded when the batch is in the **Fermenting** or **Conditioning** stage. Move the batch to Fermenting if it is still in Brewing or Planning. 5. **Wait for the next interval** — If you just attached a device, wait for the next reporting cycle (typically 15–60 minutes depending on your device settings). ### Gravity reading looks wrong * **iSpindel showing 1.004 or similar low value**: Your iSpindel formula is probably outputting SG while Brewfather is interpreting it as Plato. In the batch's **Fermentation > Readings > Devices** list, use the iSpindel **Plato** / **SG** gravity-unit button and set the device to **SG**. You can also change the iSpindel formula to output Plato. The **\[SG]** name suffix remains supported for older setups, but the toggle is preferred. * **Readings seem offset**: Use the calibration offset fields on the device's settings page to apply a correction. * **Graph starts in 1970**: This is typically caused by the brew date or fermentation start date not being set in the batch. Edit the batch and set or re-set the date to fix the graph. ## Related docs * [Settings](/settings) * [Tilt Hydrometer](/integrations/tilt-hydrometer) * [iSpindel](/integrations/ispindel) * [Float Hydrometer](/integrations/float-hydrometer) * [Floaty Hydrometer](/integrations/floaty-hydrometer) * [RAPT](/integrations/rapt) * [BrewPiLess](/integrations/brewpiless) * [MyBrewbot (discontinued) and OurBrewbot](/integrations/mybrewbot) * [Custom Stream](/integrations/custom-stream) * [Plaato Airlock](/integrations/plaato/airlock) * [Plaato Keg](/integrations/plaato/keg) * [SmartPID](/integrations/smartpid) # Inventory Manage your ingredient stock levels, costs, and best-before dates across all brewing supplies.

The inventory screen allows you to manage all of your brewing ingredient stock and add custom ingredients

The inventory allows you to manage all of your stock of brewing ingredients. The main sections are for [Fermentables](/inventory/fermentables), [Hops](/inventory/hops), [Yeast](/inventory/yeasts) and [Miscellaneous](/inventory/miscs) ingredients. #### Search A search bar is available at the top of the inventory to filter items across name, notes, substitutes, lot number, supplier, origin, and type. This makes it easy to quickly locate a specific ingredient. In addition to the common fields, search also covers type-specific fields. For fermentables this includes grain category and used-in styles; for hops it includes alpha %, harvest year, and usage (Aroma/Bittering/Both); for yeasts it includes laboratory, product ID, form, and attenuation %; and for misc ingredients it includes the "use for" description. #### Filter A filter button opens a popover with additional filtering options including **Show Negative Only** (display only items with negative inventory) and **Show Zero Stock** (include items with zero stock in the list). The filter button is only visible when **Allow Negative Inventory** is enabled in Settings. Filter settings persist across sessions via local storage, so your selections are remembered when you return to the inventory page. #### Section Collapse Each inventory section (Fermentables, Hops, Miscs, Yeasts) can be expanded or collapsed independently, allowing you to focus on the ingredient categories you need. The collapse/expand state of each section is saved to your account settings, so it persists across sessions and devices. #### Sorting You can sort the inventory in a number of ways to help you find what you are looking for by clicking the sort button and selecting your chosen sorting method from the options below * Default * Inventory Amount * Name * Best Before Date * Lot# To reverse the sort order just click the sort button and then click your chosen sorting method again The sorting by Best Before Date is a good way of seeing what you need to use up. Sorting by Batch number becomes particularly useful in a commercial environment where you may have on hand multiple batches of the same ingredient. #### Importing and exporting inventory {% hint style="warning" %} **Beta 3.1.0:** Inventory import and export, including Brewfather JSON, CSV, BeerXML, BeerJSON, and export scope selection, are in public beta. See [Public Beta](/beta). {% endhint %} Use the Import button to bring ingredient or inventory files into Brewfather. Import options include: * **Ingredients BSMX / BeerXML** — Import ingredient files from BeerSmith or BeerXML sources * **Inventory Brewfather JSON** — Restore or transfer Brewfather inventory data * **Inventory CSV** — Import inventory from a spreadsheet-friendly CSV file * **Inventory BeerXML** — Import inventory items from BeerXML * **Inventory BeerJSON** — Import inventory items from BeerJSON Use the Export button in the inventory toolbar to export your inventory. First choose **Export filtered inventory** to export the items in your current filtered view, or **Export all my inventory** to export every inventory item owned by your account. The all-inventory option does not include global/default ingredients that you have not added to your own inventory. Then choose an export format: * **Inventory Brewfather JSON** — Best when moving inventory between Brewfather accounts or keeping a Brewfather-specific backup * **Inventory CSV** — Best for spreadsheets and stocktaking workflows * **Inventory BeerXML** — Best for exchanging ingredients with brewing software that supports BeerXML * **Inventory BeerJSON** — Best for exchanging ingredients with brewing software that supports BeerJSON When exchanging files with other brewing software, review the imported items after import. Different apps may support different ingredient fields. #### Printing your ingredient list You can print a full list of the ingredients in stock, this is particularly useful for stock inventory/audit processes in a commercial brewery. Printing requires a **Premium** subscription. Just click the Print button and check the boxes from the options below of items to include in the printout. Fermentables, Hops, Misc and Yeast are checked by default. * Fermentables * Hops * Misc * Yeast * Negative Only * Exclude Negative > Tip > > The particularly useful feature here though is when you need to create a shopping list, although for this to work you will have had to enable 'Allow Negative Inventory' in settings. Plan your brew by creating your recipe, choosing brew and putting in the date in the future you want to brew. > > * Check the boxes for the inventory in the [Planning](/batches/planning) section of your brew. > * Come back to your Inventory and click print > * Check 'Negative Only' > * Print and you have a ready made shopping list for your next batch > > This can be done for multiple batches by choosing brew on several recipes, setting the dates in the future. This is a great way of planning your ingredient orders and minimising shipping costs and chances of not having something on hand when you need it. This is especially useful in commercial breweries ***Should there be nothing visible in your inventory double check the 'Toggle Inventory'*** ***hasn't been clicked, as this will hide all of your inventory contents*** To add a new inventory item click the Add button next to the category of ingredient you want to add. This will take you to the relevant page for you to add your ingredient type, [Fermentables](/inventory/fermentables), [Hops](/inventory/hops), [Misc](/inventory/miscs) or [Yeast](/inventory/yeasts) Multiple entries for the same item To track different batches of the same ingredient, you can create multiple entries for it. To do this, click on the ingredient you want to record multiple batches of, then click on the Copy button. This will then take you back to your inventory screen and you will see 2 copies of the ingredient you just copied

Copied Malt in the inventory

You can modify the details of an entry, such as quantity, batch numbers, Best before dates, etc., by clicking on it. #### To remove inventory stock To remove stock from your inventory, click on the inventory item and then click the Clear button at the bottom left of the pop-up box. This will zero the inventory quantity but not remove the ingredient from your ingredient database, so you can always add it back into stock at a later date if you buy some more. ## Related docs * [Recipes](/recipes) * [Batches](/batches) * [Settings](/settings) # Fermentables Manage your fermentable inventory including grains, extracts, sugars, and adjuncts with cost tracking. Brewfather maintains a large database of different fermentables and this is growing all the time as new malts, etc., are added to the database. To add a Fermentable from the database to your inventory click Add button on the right of the Fermentables title

Fermentables section of the Inventory

This will bring up the Fermentables selection pop-up window

Search for your Fermentable

Here you can type the name or part of the name of the fermentable you are looking for. If nothing comes up for your search, you can add a new fermentable by clicking the Add button at the bottom right. This will take you to the screen to [add a new fermentable](/inventory/fermentables/adding-new-malts). If the malt you want to add comes up in the search you just click on it to be taken to the screen to add the details. This screen will already have certain details filled in by default such as Name, Category, Supplier, Origin, Potential and Yield. You can just add a quantity by clicking in the inventory amount field and typing the amount you have

Malt inventory

It is worth then adding a cost if you want to get an idea of how much each brew costs. You can also click the Plus button to the right, which will prompt you for the amount you want to change your inventory to and the cost paid for it.

Adjust inventory

This same box can be used to adjust your inventory if you have to dispose of some of your ingredients. Finally just click the Save button to save your changes to the inventory. #### Adjusting Inventory If you wish to adjust stock levels for ingredients already in your inventory, find the ingredient and click on it. You can now adjust the amount by either following the method described above or clicking in the Inventory Amount field and then just editing the value in there before clicking Save ## Fermentable Fields {% hint style="warning" %} **Beta 3.1.0:** **Juice** and **Honey** are new fermentable types in public beta. Existing fermentable types remain stable. See [Public Beta](/beta). {% endhint %} When adding or editing a fermentable, the following fields are available in the inventory editor: * **Type** — Grain, Sugar, Liquid Extract, Dry Extract, Adjunct, Juice, Honey, or Other * **Color** — Color value displayed in SRM or EBC by default. You can switch to Lovibond or show both Lovibond and SRM/EBC simultaneously via **Settings > Units > Grain Color**. The available options are Default (SRM/EBC), Lovibond, Lovibond + Color, and Legacy. * **Potential / Yield %** — Extract potential (in PPG, i.e. specific gravity points per pound per gallon) and yield percentage. These two fields are linked: editing one automatically recalculates the other. These values are used in recipe calculations to estimate original gravity. * **Moisture %** — Moisture content of the grain * **Diastatic Power** — Enzymatic power of the malt * **Protein %** — Protein content percentage * **Max In Batch %** — Maximum recommended percentage in a recipe * **Attenuation** — Attenuation contribution * **Exclude from Total** — Checkbox to exclude this fermentable from the total grain bill percentage * **Not Fermentable** — Checkbox to mark the ingredient as non-fermentable * **Fermentability %** — Individual fermentability contribution of this grain (visible when advanced attenuation mode is enabled in Settings) * **Total IBU per unit** — IBU contribution per weight unit, available for Liquid Extract, Adjunct, and Other types only * **Grain Category** — Category classification for the grain * **Use** — When the fermentable is used (Mash, Boil, etc.) and **Time** for the duration * **Best Before Date** — Expiration date for the ingredient * **Manufacturing Date** — When the ingredient was produced * **Lot Number** — Batch tracking identifier * **Supplier** — The manufacturer or supplier name * **Origin** — Country or region of origin * **User Notes** — Personal notes about the ingredient * **Substitutes** — Suggested alternative fermentables * **Notes** — General notes from the database * **Used In** — Styles or recipes this fermentable is commonly used in * **Cost** — Price per unit for brew cost tracking * **Inventory Amount** — Current stock quantity Use **Juice** or **Honey** when the ingredient is better represented as a juice or honey fermentable rather than a generic sugar, adjunct, or extract. These types are also supported when importing and exporting recipes or inventory with Brewfather-supported formats. The following grain-specific fields are available under the **Edit details** section for fermentables of type Grain: * **Coarse/Fine-Diff %** — Difference between coarse and fine grind extract * **Extract (Fine Grind Dry Basis) %** — FGDB extract percentage * **Calc Yield** — Button that calculates yield/potential from FGDB, Coarse/Fine-Diff, and moisture values * **Acid %** — Acid content of the grain * **Friability %** — Friability percentage * **Free Amino Nitrogen** — FAN content in mg/L * **Max Recommended Amount %** — Maximum recommended percentage of this grain in a recipe ## Related docs * [Inventory](/inventory) * [Recipes](/recipes) # Adding new malts Add custom fermentable entries with correct extract values for accurate recipe calculations. This document is based on this [blog post](https://famouslastworts.com/2019/05/24/calculating-potential-extract-from-malt-coas/?fbclid=IwAR06mrOklbeq7c9B_v7orOXN582TbV8XbREWxe7ge_Nzu1Guya77JgZzcMA) by Chris Saunders. ## Calculating Potential Extract for Brewfather from Malt COAs How much sugar (extract) can we get from malt? When we first start learning to brew, the numbers seem like magic and we try our best to take what our software or lookup tables (such as those in Palmer’s “How to Brew”) for granted. It’s possible to generalize a grain into one of the known categories, but with the rise of new malts and craft malsters those assumptions may end up being further off than expected. The end result? Missing gravity targets. However, calculating potential extract is quite straightforward and only requires a little bit of math. ### Understanding a Malt Certificate of Analysis ![Weyermann Certificate of Analysis for Colonge Malt](https://famouslastworts.files.wordpress.com/2019/05/screenshot-2019-05-24-06.52.25.png?w=800) In the above Weyermann COA we can see they include a lot of information that brewers can use to understand how a certain malt lot may impact brewhouse performance. In order for us to calculate the potential extract we are interested in two items: **moisture content, extract** and **fine grind – coarse grind difference.** In the above certificate we are lucky because the malster has provided us with the extract brewers are concerned with; **extract dry basis**. The terminology for this field can vary from maltster, it’s also sometimes known as **extract coarse ground, dry basis**. In either case, we want to be working with the dry basis (db) extract and can work backwards from there. As you might guess, the dry basis extract isn’t what we can expect from our grain because there’s still some moisture trapped in the malt. This moisture provides no extract whatsoever, so we will need to calculate what the actual extract of the malt will be. With this information we will be calculating **percent extract coarse grind, as is (%extract cg, ai)**. We also need to know what the **fine grind to coarse grind difference** is, which can sometimes be included on the certificate of analysis. The reason for the difference is because malsters perform their lab mashes (also known as the congress mash) on very finely crushed grain. This doesn’t represent the real world because mashing with such highly crushed grain would clog up lauter tuns! Some malsters may provide the difference, however it’s not always provided. Usually the difference between a coarse grind and fine grind won’t be more than 2% extract. A good rule of thumb is to use 1% as the fine grind to coarse grind difference. ``` %extract gc,ai = %extract cg,db x (1 - %moisture) ``` From the Weyermann Cologne malt we have the following numbers: * %extract (fine grind) dry basis: 81.6% * %moisture: 4.2% * fine grind – coarse grind difference: unknown; use 1% ``` %extract cg,db = %extract fg,db - 1% = 81.6% - 1% = 80.6% %extract cg,ai(WEY Cologne) = 80.6% x (1 - 4.2%) = 80.6 x (1 - 0.042) = 77.21% ``` So what does this mean? We now know that from every unit of Weyermann Cologne malt we will get 0.7721 units of extract (sugar) out of it (77.21%). #### [Spreadsheet to help calculate can be found here](https://docs.google.com/spreadsheets/d/1JcAMBRRWAhd9pZi-c7WgXc6l389Dg6dHjsfl9gluFPg). ## Adding a New Malt to Brewfather For this example, the Weyermann Cologne malt will be added to the [Brewfather](https://brewfather.app/) database. All that needs to be provided is the coarse grind as is extract. In this example 77.21% is set as Yield, then the Potential SG field is filled in automatically. ![Add new malts from the inventory page, click Fermentables, then Add.](https://famouslastworts.files.wordpress.com/2019/05/screenshot-2019-05-24-07.43.17.png?w=800) The **ppg**s line up with what was calculated, which is a great way to validate that the new fermentable has been entered correctly. ### (Optional) How Potential/“Homebrew Units”/PPG is calculated In Brewfather you don't need to do this conversion or calculation, since you can enter the Yield % directly, but it can be useful for other use cases. The most common homebrew unit is **ppg** which stands for **p**oints per **p**ound per **g**allon. There’s another unit that metric users can use called the **pkl** which stands for **p**oints per **k**ilogram per **l**itre. It’s possible to actually calculate out how many ppgs or pkls one would get from their malt however there is an easier way to do it. There’s an adjunct that provides 100% extract and is very well documented in homebrewing books; sucrose! ``` ppgSucrose = 46 pklSucrose = 384 ``` With the known maximum for our homebrew unit of choice, we can figure out what our potential extract will be: ``` ppgWeyColonge = 46 * 0.7721 = 35.5 (1.036) pklWeyColonge = 384 * 0.7721 = 296.5 ``` The potential number in Brewfather is PPG in the format of 1.0XX, so the example above would be 1.036. ## Different Maltsters, Different COAs Every maltster's COA will look different; however, armed with the knowledge above, it should be possible to find the required information to determine how much sugar a new malt will contribute to a brew. Instead of substituting a specialty pilsner malt from your local micro malster as “Canadian Pilsner Malt” with a note, it can be listed in recipes as the proper malster and product. ## References * How to Brew (4th Edition) John Palmer; Brewers Publications * A Handbook of Basic Brewing Calculations; Stephen Holle; MBAA # Hops Track hop inventory with alpha acid percentages, types, quantities, and cost for accurate bitterness calculations. This section is very similar to the [Fermentables](/inventory/fermentables) section and works similarly. To add a hop to your inventory, click the Add button to the right of the Hops title. This brings up the select hop window
Here, you can search or add a new hop like you do for fermentables. Type in the search box for the hop you are looking for, then click it to open the Edit Hop screen.

Edit Hop screen

Here you can type the quantity directly into the Inventory amount or click the button to the right to adjust the inventory amount. You can add the cost per unit (g/oz) to track your brews' cost. You can also choose between various types as this affects the bitterness calculation, so it is important to choose the right type from the list shown below * Pellet - Standard hop pellets * Whole - Whole cone hops * Cryo - Yakima Chief Hops enhanced hop pellets * CO2 Extract **Alpha** You will almost certainly need to change the Alpha %. This can be done by clicking on the field and typing the value in, or you will not get an accurate bitterness calculation for the beers using the hops. The alpha acid changes from harvest to harvest and farm to farm so it can vary a lot between batches It is also worth entering the information for the following fields * Year - The year of harvest * Best Before date - If you can't find one and are storing your hops in the freezer consider using 2 years * Lot Number - if this is available this is worth recording and a necessity in a commercial brewery Finally click the Save button to add the hop to your inventory To add a Hop to your inventory click the Add button to the right of the Hops title.

Hops Section of the Inventory

This brings up the select hop window

Select Hop window

Here you can search or add a new hop. ## Additional Hop Fields Beyond the basics above, the hop editor includes the following fields: * **Beta Acid %** — Beta acid content of the hop * **Cohumulone %** — Percentage of cohumulone in the alpha acids * **HSI %** — Hop Storage Index, indicating how well the hop stores over time * **Oil Content** — Total oil content in ml/100g * **Myrcene %** — Myrcene oil composition percentage * **Humulene %** — Humulene oil composition percentage * **Caryophyllene %** — Caryophyllene oil composition percentage * **Farnesene %** — Farnesene oil composition percentage * **Origin** — Country or region where the hop is grown * **Usage** — Aroma, Bittering, or Both * **Notes** — General notes from the database * **Substitutes** — Suggested alternative hops * **Used In** — Styles this hop is commonly used in * **User Notes** — Personal notes about the hop * **Manufacturing Date** — Production or harvest date * **Temperature** — Temperature setting for hop stand additions * **Amount per Volume** — Amount per volume unit for scaling * **Loss After 6 Months %** — The percentage of alpha acid lost after 6 months of storage at 20°C, used together with the harvest/manufacturing date to estimate current alpha acid potency ### Adjust Alpha When the alpha acid percentage of a hop changes (e.g., between harvests or purchases), the **Adjust Alpha** feature can automatically scale the hop amount in your recipe to maintain the target bitterness contribution. To use it, open the hop in the recipe editor and click the Adjust Alpha button. You will be prompted to enter the new alpha acid percentage. When you confirm, Brewfather calculates the ratio between the old and new alpha values and scales the hop amount accordingly. For example, if a hop was at 10% alpha with 50g and the new batch is 8% alpha, the amount will be scaled up to 62.5g to produce the same bitterness. ## Related docs * [Inventory](/inventory) * [Recipes](/recipes) # Miscs Manage miscellaneous brewing ingredients like water chemicals, fining agents, spices, and nutrients. The Miscellaneous (Miscs) section of the inventory is where you manage all non-fermentable, non-hop, non-yeast ingredients used in your brewing process. This includes water treatment chemicals, fining agents, spices, flavor extracts, nutrients, and other additives. ## Common Misc Ingredients Miscellaneous ingredients cover a wide range of categories: * **Water Chemistry** — Gypsum (CaSO4), Calcium Chloride (CaCl2), Lactic Acid, Phosphoric Acid, Campden Tablets * **Fining Agents** — Irish Moss, Whirlfloc, Gelatin, Biofine, Isinglass * **Spices & Herbs** — Coriander, Orange Peel, Cinnamon, Ginger, Vanilla Beans * **Sugars & Extracts** — Honey, Maple Syrup, Vanilla Extract, Coffee, Cacao Nibs * **Nutrients** — Yeast Nutrient, Yeast Energizer, Servomyces * **Other** — Oak Chips, Fruit Purees, Lactose ## Adding a Misc Ingredient 1. Navigate to the **Inventory** page 2. Click the Add button next to the **Misc** title 3. Search for the ingredient in the selection window — Brewfather maintains a database of common misc ingredients 4. If the ingredient is not found, click the **Add** button at the bottom right to create a custom entry 5. Click on the ingredient to open the edit screen ## Editing Misc Details When adding or editing a misc ingredient you can set the following: * **Name** — The ingredient name * **Type** — The category of ingredient (Spice, Fining, Water Agent, Herb, Flavor, Other) * **Recommended Amount (Amount Per Liter)** — A per-volume rate (displayed in your chosen unit per volume unit, e.g. g/L or g/gal). When set, Brewfather automatically calculates the total amount needed in a recipe based on the relevant volume for the selected Use stage. For example, a Boil addition uses the post-boil kettle volume, a Mash addition uses the mash water volume, a Bottling addition uses the bottling volume, and so on. If you manually type an amount in the recipe, the auto-calculation is overridden. * **Amount** — The quantity used per batch * **Use** — A dropdown that specifies *when* the ingredient is added during the brewing process (Mash, Sparge, Boil, Flameout, Primary, Secondary, Bottling). This determines the timing and also affects which volume is used for the Recommended Amount calculation. * **Time** — Duration of use in minutes (shown when Use is set to Boil) * **Use For** — A free-text field describing *what purpose* the ingredient serves (e.g., "water pH adjustment", "clarity", "flavor"). This is distinct from the Use dropdown: Use controls timing, while Use For describes the reason or goal. * **Inventory Amount** — How much you currently have in stock * **Cost** — Price per unit for tracking brew costs * **Best Before Date** — Expiration tracking * **Lot Number** — Batch tracking, especially useful for commercial breweries * **Manufacturing Date** — When the ingredient was produced * **User Notes** — Personal notes about the ingredient * **Substitutes** — Suggested alternative ingredients * **Unit** — The unit of measurement (default: g). Available units include g, mg, kg, ml, l, pkg, items, drops, tsp, tbsp, cup, pt, qt, oz, lb, and gal. ## Managing Inventory Amounts To adjust the inventory amount for a misc ingredient: * Click on the ingredient in your inventory list * Either type directly into the **Inventory Amount** field, or click the adjust button to the right to add or subtract stock * Click **Save** to store the updated amount When you brew a batch and check off misc ingredients in the [Planning](/batches/planning) section, the inventory amounts are automatically reduced. ## Tips for Misc Ingredient Management > Tip > > Water chemistry additions like Gypsum and Calcium Chloride are tracked per gram. When you set up water adjustments in the [Water Calculator](/recipes/water-calculator), the required amounts are calculated automatically and matched to your misc inventory. * **Track expiration dates** — Ingredients like Irish Moss and yeast nutrients lose effectiveness over time. Use the Best Before Date field and sort by expiration to use older stock first. * **Use consistent units** — Make sure the units match between your recipe and inventory entries (grams vs. ounces) to ensure accurate inventory tracking. * **Group by type** — Use the sort options to group misc ingredients by type, making it easier to find what you need. ## Related docs * [Inventory](/inventory) * [Recipes](/recipes) # Yeasts Track yeast strains in your inventory with viability dates, attenuation, and starter recommendations. The Yeast section of the inventory is where you manage all your yeast strains, including dry yeast, liquid yeast, and yeast harvested from previous batches. Accurate yeast tracking helps you plan pitching rates using the [Yeast Calculator](/tools/yeast-calculator) and ensures you always have the right yeast on hand for your next brew. ## Adding a Yeast 1. Navigate to the **Inventory** page 2. Click the Add button next to the **Yeast** title 3. Search for the yeast strain in the selection window — Brewfather maintains an extensive database of yeast strains from major labs (Fermentis, Lallemand, White Labs, Wyeast, Imperial, Omega, and more) 4. If the strain is not found, click the **Add** button at the bottom right to create a custom entry 5. Click on the yeast to open the edit screen ## Editing Yeast Details When adding or editing a yeast you can set the following: * **Name** — The yeast strain name (e.g., "Safale US-05", "WLP001 California Ale") * **Laboratory** — The manufacturer/lab * **Product ID** — The lab's product identifier * **Type** — Ale, Lager, Wheat, Wine, Champagne, etc. * **Form** — Dry, Liquid, Culture, or Slurry * **Attenuation** — The primary attenuation percentage used directly in recipe calculations to estimate final gravity. This is the value you set on the main edit screen. * **Min Attenuation** — Minimum expected attenuation percentage (available under Edit details). This is a separate informational field from the main Attenuation value and represents the low end of the yeast's published range. * **Max Attenuation** — Maximum expected attenuation percentage (available under Edit details). Like Min Attenuation, this represents the high end of the range. Both Min and Max Attenuation are displayed in the information panel when available. * **Flocculation** — Low, Medium-Low, Medium, Medium-High, High, or Very High * **Temperature Range** — Recommended fermentation temperature range * **Alcohol Tolerance** — Maximum ABV the yeast can tolerate * **Inventory Amount** — Number of packages or volume of slurry in stock * **Cost** — Price per unit for brew cost tracking * **Best Before Date** — Expiration tracking (important for liquid yeast viability) * **Lot Number** — Batch tracking for quality control * **Manufacturing Date** — When the yeast was produced (affects viability calculations) * **Max ABV** — Maximum alcohol tolerance of the yeast * **Starter Size** — Volume of the yeast starter. When a starter is enabled on a yeast in a recipe, this field sets the starter volume. * **Starter Extract / DME** — Amount of dry malt extract for the starter. This value auto-calculates based on the starter size (approximately 100g per liter) but can be manually overridden. The unit follows your hop weight setting (g or oz). * **Description** — Detailed description of the yeast strain * **Best For** — Beer styles the yeast is best suited for * **Attenuates Complex Sugars (Ferments All)** — Checkbox indicating whether the yeast can ferment complex sugars (e.g., diastaticus strains or souring cultures). When enabled, the label displays "Yes" as a warning since these strains can over-attenuate and pose contamination risks in a shared brewery. * **Unit** — The unit of measurement (default: pkg) ## Managing Yeast Inventory To adjust the inventory amount for a yeast: * Click on the yeast in your inventory list * Either type directly into the **Inventory Amount** field, or click the adjust button to add or subtract stock * Click **Save** to store the updated amount When you brew a batch and check off yeast in the [Planning](/batches/planning) section, the inventory amount is automatically reduced. ## Multiple Entries for the Same Strain You may have multiple packages of the same yeast with different production dates or lot numbers. To track these separately: 1. Click on the yeast strain in your inventory 2. Click the **Copy** button to duplicate the entry 3. Edit each copy with its specific lot number, best before date, and quantity This is especially useful for liquid yeast where viability decreases over time — older packages may need a starter while newer ones can be pitched directly. ## Yeast Viability and Starters The [Yeast Calculator](/tools/yeast-calculator) tool uses your yeast inventory data to calculate pitching rates: * **Manufacturing date** and **best before date** help estimate cell viability * **Form** (dry, liquid, slurry) determines the appropriate cell count per package * The calculator recommends whether a starter is needed based on the target pitching rate for your recipe > Tip > > Liquid yeast viability decreases approximately 0.7–1% per day after manufacturing. Always enter the manufacturing or best before date on your liquid yeast entries so the Yeast Calculator can provide accurate viability estimates and starter recommendations. ## Tips for Yeast Management * **Track best before dates** — Sort by Best Before Date to identify yeast that needs to be used soon. Dry yeast typically lasts 2+ years while liquid yeast should be used within a few months for best results. * **Record lot numbers** — In a commercial setting, lot numbers provide traceability for quality assurance. * **Note harvested yeast** — If you harvest yeast from a batch, add it as a new inventory entry with the harvest date and estimated cell count. Set the form to "Slurry" and note the generation count in the name or description. * **Check before brew day** — Review your yeast inventory as part of brew day planning. Liquid yeast may need a starter prepared 24–48 hours in advance. ## Related docs * [Inventory](/inventory) * [Recipes](/recipes) * [Yeast Calculator](/tools/yeast-calculator) # File Attachments Attach files and images to your batches and recipes with cloud storage. File Attachments let you upload files and images to your batches and recipes. Attach brew day photos, lab reports, label designs, tasting notes, and any other documents you want to keep with your brewing records. > Tip > > File Attachments require a **Premium Plus** subscription. See [Subscription](/account/subscription) for details. ## Supported File Types You can upload the following file types: * **Images**: JPEG, JPG, PNG, GIF, WebP, HEIC, HEIF * **Documents**: PDF * **Spreadsheets**: XLS, XLSX * **Word documents**: DOC, DOCX * **Text files**: TXT, CSV ## Upload Limits * **Maximum file size**: 20 MB per file * **Maximum files per item**: 20 files per batch or recipe * **Storage quota**: 5 GB total for Premium Plus (see [Storage Quota](#storage-quota) below) ## Uploading Files ### From the File Browser 1. Open a batch or recipe 2. Scroll to the **Attachments** section 3. Tap the **Upload** button 4. Select one or more files from your device 5. Files upload with a progress indicator ### Drag and Drop (Desktop) 1. Open a batch or recipe 2. Drag files from your computer onto the **Attachments** section 3. The drop zone highlights when files are over it 4. Release to start uploading Multiple files can be uploaded at once. Each file is validated for size and type before uploading. ## Viewing Attachments Attachments appear in a list within the Attachments section of your batch or recipe: * **Images** show thumbnail previews (generated in multiple sizes: 72px, 192px, and 640px) * **Documents** show a file type icon (PDF, spreadsheet, word document, etc.) * Each attachment displays the file name and file size Tap an image attachment to open a full-screen preview. Tap a document attachment to download it. ## Deleting Attachments 1. Tap the delete icon on the attachment you want to remove 2. Confirm the deletion Deleting an attachment frees up storage quota immediately. This action cannot be undone. ## Collapsing the Attachments Section The Attachments section can be collapsed to save screen space: * Tap the section header to toggle between expanded and collapsed views * The collapsed header shows the number of attachments ## Storage Quota Your file attachment storage is shared across all batches and recipes. The storage quota depends on your subscription plan: | Plan | Storage Quota | | ------------ | ------------- | | Premium Plus | 5 GB | ### Checking Your Storage Usage Your current storage usage is displayed as a progress bar showing: * **Used storage** out of your total quota * **File count** — total number of files across all batches and recipes * **Color indicator**: * Normal (under 75% used) * Warning (75%–90% used) * Danger (over 90% used) You can view your storage usage from the storage indicator in the Attachments section or from the Account page. ### When Storage Is Full If you reach your storage quota, you will not be able to upload new files until you free up space by deleting existing attachments. > Tip > > To free up storage, review older batches and remove attachments you no longer need. Images tend to use the most space — consider resizing large photos before uploading. ## Related docs * [Recipes](/recipes) * [Batches](/batches) * [Versioning](/recipes/versioning) # Library Browse, search, and share community recipes in the Brewfather public recipe library. ![](/files/-Lnb8W57N5X5Jlxza6s6) The **Library** page is Brewfather’s public recipe community. Use it to discover recipes, compare brewing stats, open full recipe details, and copy recipes into your own account. ## Open Library In the app menu, open **Library** (route: `tabs/community`, page title: **Recipe Library**). ## Search and browse At the top of the page, use **Search recipe library**. What you’ll see in each result card: * Recipe name and style * Author handle (with profile type styling) * Tags (when available) * Key stats: **ABV, OG, FG, IBU, Color** * Community stats: upvotes, views, downloads Tap any recipe card to open the full viewer. ### Search scope Text search matches visible recipe text, including: * Recipe name * Style * Tags * Profile name (author handle) ### Result loading Library loads results progressively: * Starts with a limited result set * Loads more automatically as you scroll ## Filter recipes Use the filter button in the top-right corner. ### Numeric filters * ABV * IBU * Color (shown in your selected color unit) * OG * FG ### Facet filters * Type * Style * Origin * Tags * User * Country * Profile Type * Equipment * Fermentables * Hops * Miscellaneous * Yeasts Each facet includes per-value counts. Some facets also support in-filter search. ### Style conformity filter Enable **True to style** to only show recipes marked as style-conforming. ### Active filters When filters are active: * A badge shows total active filters * Active filters appear as chips above results * Tap a chip to remove that filter * Use **Reset Filters** to clear everything ## Sort results {% hint style="warning" %} **Beta 3.1.0:** The **Trending** sort is in public beta. The other Library sort modes remain stable. See [Public Beta](/beta). {% endhint %} Available sort modes: * Trending * Most relevant * Last updated * Upvoted * Views * Downloads **Trending** is the default sort for the public Library. It is based on recent community activity, so it can surface recipes that are currently active in the community. ## View and copy recipes Open a result to access the full recipe viewer. From there you can: * Review complete recipe details * Vote up/down * Share the recipe link * Report image (if needed) * **Copy** the recipe to your own account ### Copy behavior When copied, Brewfather creates a private recipe in your account (not public by default). Copied recipes are placed in your **Default** folder (you can move them after copying). If you are on the free tier, recipe count limits still apply when copying. ## Share your own recipe to the Library To publish your own recipe: 1. Open your recipe 2. Tap the lock/eye public toggle in the recipe toolbar 3. Confirm sharing 4. Fill required sharing fields: * **Teaser text** (20–140 characters, no links) * **Origin**: Original, Clone, or Official * Confirmation checkbox ### Requirements * All users can browse, open, and copy public library recipes * You need an active paid subscription to publish recipes * Sample/default recipes cannot be made public ### Validation Only recipes that pass public-library validation are shown in Library search results. If a recipe is public but invalid, Brewfather shows the validation issues directly in the recipe page so you can fix them or make the recipe private. ## Public Profile A public profile is required before you can share recipes publicly. ### Where to create/edit it * **Account** page → Create/Edit Public Profile * Automatically prompted the first time you try to publish without a profile ### Profile fields Required: * Profile image * Brewery name * Profile name (handle) * Country Optional: * City * Bio * Opt-in to upcoming sharing features ### Profile name rules * 5–28 characters * Lowercase letters, numbers, `_` and `.` * Checked for availability before save * Can be changed **once per month** When you change your profile name: * A one-month cooldown starts before the next change * The old name is released and may be claimed by others * Your public recipes automatically show the new handle ## Match copied recipes to your equipment After copying a recipe, open **Change equipment**, select your own equipment profile, and save/scale so Brewfather recalculates targets and ingredient amounts for your setup. Before brewing, double-check: * Hopstand temperature alignment between the copied recipe and your equipment profile * Water adjustments in the water calculator for your own source water * Yeast pitch in the yeast calculator (especially if you prefer whole-package counts) ## Practical workflow example 1. Search for a style (for example: “Pilsner”). 2. Narrow with filters (ABV/IBU, style, ingredients). 3. Sort by **Upvoted** or **Downloads**. 4. Open a promising recipe and tap **Copy**. 5. Run **Change equipment** and scale for your own system. 6. Re-check water and yeast calculations before brewing. ## Related docs * [Recipes](/recipes) * [Recipe Designer](/recipes/designer) * [Import Recipes](/getting-started/import-recipes) # Profiles Save and reuse equipment, mash, fermentation, water, and style profiles for consistent brewing. Profiles in Brewfather allow you to save and reuse equipment configurations, mash schedules, fermentation plans, water chemistry, and custom beer styles. Create once, use many times – perfect for maintaining consistency across your brews. ## Available Profile Types ### Equipment Profile Define your brewing system's specifications including batch size, efficiency, losses, and boil-off rate. Essential for accurate recipe calculations. ### Mash Profile Save your favorite mash schedules with infusion, temperature, and decoction steps. Mash profiles can include manual infusion amounts and temperatures, manual decoction amounts, thick or thin decoction pulls, optional decoction rests, and an optional decoction boil-off rate for return-volume planning. Reuse proven mash profiles across different recipes. ### Fermentation Profile Plan and save multi-stage fermentation schedules including temperature ramps, cold crashing, and conditioning phases. ### Water Profile Store your water chemistry data including mineral content and pH. Build a library of water profiles for different beer styles. ### Custom Styles Create your own beer style guidelines with target ranges for gravity, color, bitterness, and other characteristics. ## How to Use Profiles 1. **Access Profiles**: Navigate to the Profiles section from the main menu 2. **Select Profile Type**: Choose the type of profile you want to create or edit 3. **Create New**: Tap the + button to create a new profile 4. **Edit Existing**: Select a profile from the list to modify it 5. **Apply to Recipe**: When creating or editing a recipe, select saved profiles from the dropdown menus ## Benefits * **Consistency**: Use the same settings across multiple recipes * **Time Saving**: No need to re-enter common configurations * **Organization**: Keep all your brewing configurations in one place * **Sharing**: Export and share profiles with other brewers * **Experimentation**: Compare different profiles side-by-side ## Tips * Name profiles descriptively (e.g., "5 Gallon BIAB Setup" instead of "Equipment 1") * Create seasonal water profiles based on your local water reports * Save successful mash profiles from great batches for future use * If you use decoctions, set a decoction-specific boil-off rate on the mash profile for more accurate return-volume guidance, and choose thick or thin pulls to match your process * Use fermentation profiles to replicate successful temperature schedules ## Related docs * [Equipment Profiles](/profiles/equipment) * [Mash Profiles](/profiles/mash) * [Fermentation Profiles](/profiles/fermentation) * [Water Profiles](/profiles/water) * [Custom Styles](/profiles/custom-styles) # Equipment Configure equipment profiles with batch volume, efficiency, losses, and boil-off settings for accurate recipe calculations. {% content-ref url="/pages/-LF3ety-wpkAIUS-t78I" %} [Setting up your equipment profile](/getting-started/setting-up-your-equipment-profile) {% endcontent-ref %} ## Overview Equipment profiles define your brewing system's physical characteristics and efficiency settings. Accurate equipment profiles are essential for proper recipe scaling, water calculations, and achieving your target volumes and gravities. ## How to Use 1. **Create Profile**: Go to Profiles → Equipment → tap the + button 2. **Enter Basic Settings**: * Name your equipment profile * Set batch volume and batch volume target * Enter boil time * Input efficiency percentage 3. **Configure Losses**: * Trub/chiller loss * Fermenter loss * Mash tun dead space 4. **Set Boil-off Rate**: Enter your typical evaporation per hour 5. **Save**: Tap save to store the profile 6. **Apply to Recipe**: Select this profile when creating or editing recipes ## Key Settings ### Volumes * **Batch Volume Target**: Choose whether batch volume should match the final fermenter volume or the hot end-of-boil kettle volume (Post-Boil Volume) * **Batch Volume**: Your target volume based on the selected batch volume target * **Boil Size**: Pre-boil volume in kettle * **Fermenter Top Up**: Water added directly to fermenter ### Efficiency * **Brewhouse Efficiency**: Overall system efficiency (65-75% typical) * **Mash Efficiency**: Conversion efficiency in mash (often 5-10% higher than brewhouse) * **Efficiency Type**: Choose between "Fermenter" or "Kettle" based on your measurement point ### Losses * **Trub/Chiller Loss**: Volume left in kettle after transfer (liters/gallons) * **Fermenter Loss**: Volume left in fermenter after packaging * **Mash Tun Dead Space**: Unrecoverable volume below mash tun outlet ### Evaporation * **Boil-off Rate**: Volume lost per hour during boil (liters/hour or gallons/hour) * **Boil Temperature**: Adjusted automatically based on altitude if enabled * **Boil Expansion**: Volume expansion percentage during boil ### Hop Settings * **Hop Utilization Multiplier**: Adjusts hop utilization calculation. Normally left at 100%. * **Aroma Hop Utilization**: Option to calculate aroma hop utilization separately, with a "Calc aroma hop utilization" checkbox. * **Whirlpool / No-Chill Time**: Extra minimum whirlpool or hopstand time. ### Volumes (Additional) * **Calc Boil Volume**: Toggle to automatically calculate boil volume. * **HLT Deadspace**: Hot Liquor Tank dead space volume. * **Sparge Water Overflow**: What to do with excess sparge water (default: Top-Up). * **Sparge/Mash Water Volume Limits**: Min/max limits for sparge water, HLT water, and mash water volumes, with an enable toggle. ### Losses (Additional) * **Mash-Tun Loss**: Unrecoverable mash volume (distinct from Mash-Tun Deadspace which is recoverable). ### Efficiency (Additional) * **Calc Mash Efficiency**: Toggle to automatically calculate mash efficiency. ### Water Calculations * **Water/Grain Ratio**: Mash thickness (liters/kg or quarts/lb) * **Grain Absorption**: Water retained by grain (liters/kg or gallons/lb) * **Sparge Water**: Calculated automatically or set custom formula * **Sparge Temperature**: Target sparge water temperature. ## Advanced Settings ### Temperature Settings * **Hop Stand Temperature**: Default temperature for hop stand additions (°C/°F) * **Grain Temperature**: Default grain temperature for strike water calculations * **Ambient Temperature**: Room temperature for heat loss calculations * **Mash Tun Heat Capacity**: Thermal capacity of the mash tun for strike water calculations. Higher values calculate a higher strike temperature; lower values calculate a lower strike temperature. * **Calc Strike Water Temperature**: Toggle to calculate strike water temperature from equipment settings. ### Altitude Adjustment * Enable to automatically adjust boil temperature based on elevation * Enter your altitude for accurate calculations ### Custom Formulas * **Mash Water Formula**: Override default mash water calculation * **Sparge Water Formula**: Override default sparge water calculation * **Water Calculation Type**: Choose from Default, No Sparge, or Custom ### Other * **Description / Notes**: Free text notes field for the equipment profile. ## Tips for Accuracy 1. **Measure Actual Volumes**: Track your actual volumes over several batches 2. **Calculate Efficiency**: Compare expected vs actual gravity to determine your efficiency 3. **Account for All Losses**: Include losses from transfers, sampling, and equipment 4. **Temperature Calibration**: Verify your thermometer accuracy 5. **Boil-off Test**: Measure actual evaporation rate with a water-only boil test ## Common Equipment Profiles ### All-in-One Systems * Grainfather G30/G40/G70 * Brewzilla/Robobrew * Anvil Foundry * Clawhammer Supply ### Traditional 3-Vessel * HERMS (Heat Exchange Recirculating Mash System) * RIMS (Recirculating Infusion Mash System) * Direct Fire Systems ### BIAB (Brew in a Bag) * Single vessel with bag * Full volume mash * No sparge method ### Extract Brewing * Simplified profile * No mash efficiency needed * Focus on boil volume and fermenter size ## Troubleshooting **Missing Target Volume?** * Check boil-off rate * Verify all losses are accounted for * Confirm grain absorption rate **Wrong Original Gravity?** * Adjust efficiency percentage * Check mash efficiency vs brewhouse efficiency * Verify grain crush quality **Water Calculations Off?** * Review water/grain ratio * Check dead space volumes * Verify sparge water settings ## Profile Management * **Set as Default**: Star/mark an equipment profile as your default. * **Copy**: Duplicate a profile. * **Reset**: Reset default profiles to factory settings. ## Related docs * [Setting Up Your Equipment Profile](/getting-started/setting-up-your-equipment-profile) * [Recipe Designer](/recipes/designer) * [Mash-Tun Calibration](/tools/mash-tun-calibration) # Mash Create and reuse mash profiles with infusion, temperature, and decoction steps for consistent results. ## Overview Mash profiles allow you to save and reuse mash schedules with multiple temperature steps. Perfect for consistent results with your favorite mash techniques, from simple single infusion to complex step mashes. {% hint style="warning" %} **Beta 3.1.0:** Manual infusion amounts and temperatures, thick/thin decoctions, manual decoction amounts, pulled-portion rests, and decoction boil-off guidance are in public beta. Standard mash profiles and step types remain stable. See [Public Beta](/beta). {% endhint %} The mash profile drives the action guidance shown across Brewfather: * Recipe Designer mash section * Brew sheet / read mode / PDF * Batch Brewing page * Brew Tracker mash stage ## How to Use 1. **Create Profile**: Go to Profiles → Mash → tap + button 2. **Name Your Profile**: Give it a descriptive name (e.g., "Single Infusion 65°C") 3. **Add Mash Steps**: * Tap "Add Step" for each temperature rest * Enter step name (optional) * Choose step type (Infusion, Temperature, Decoction) * Set temperature and time for each step * Add ramp time if needed (optional) * Optional: for Infusion steps, enter a manual infusion amount and infusion water temperature * Optional: for Decoction steps, choose calculated pull volume or set a manual amount by volume or percent of mash * Optional: for Decoction steps, choose thick or thin mash, and add a rest temperature/time before boiling 4. **Optional Decoction Boil Off Rate**: * Appears when the profile contains at least one Decoction step * Enter a decoction-specific boil-off rate in `%/hr` if you want Brewfather to estimate the return volume after boiling 5. **Save Profile**: Tap save to store for future use 6. **Apply to Recipe**: Select this profile in the mash section when creating recipes ## Mash Step Types ### Infusion Adding hot water to reach target temperature * Used for initial strike water * Step mashing with boiling water additions * Automatically calculates the water volume needed * Optional manual infusion amount override * Optional infusion water temperature override; when left empty, Brewfather uses the boil temperature * Shows a warning if the manual amount would require hotter water than the configured infusion temperature or boil temperature ### Temperature Direct heating to reach target temperature * Used with RIMS/HERMS systems * All-in-one brewing systems * No additional water added ### Decoction Removing portion of mash, boiling, and returning * Traditional technique for certain styles * Enhances malt character and color * Calculates decoction volume needed * Supports manual pull amounts by volume or percent of mash * Supports thick mash pulls or thin/liquid-only pulls * Supports an optional decoction rest before boiling * Optional decoction boil-off rate lets Brewfather estimate the return volume after boiling ## Common Mash Profiles ### Single Infusion One temperature rest for entire mash * **Light Beers**: 63-65°C (145-149°F) for 60 minutes - highly fermentable * **Balanced**: 65-67°C (149-153°F) for 60 minutes - balanced fermentability * **Full Body**: 68-70°C (154-158°F) for 60 minutes - less fermentable, more body ### Step Mash Multiple temperature rests for specific enzyme activity **Protein Rest + Saccharification**: 1. 50°C (122°F) for 10 minutes - protein rest 2. 65°C (149°F) for 45 minutes - beta amylase 3. 72°C (162°F) for 15 minutes - alpha amylase 4. 78°C (172°F) for 10 minutes - mash out **Hochkurz (Short High) Mash**: 1. 62°C (144°F) for 30 minutes - fermentability 2. 72°C (162°F) for 30 minutes - conversion 3. 78°C (172°F) for 10 minutes - mash out ### BIAB (Brew in a Bag) Full volume, no sparge method * 66°C (151°F) for 60 minutes * Optional mash out at 75°C (167°F) * Higher water/grain ratio ### Decoction Profiles **Single Decoction**: 1. 50°C (122°F) for 15 minutes - protein rest 2. Pull 1/3 thick mash, boil 15 minutes 3. Return to reach 65°C (149°F) for 45 minutes 4. 72°C (162°F) for 15 minutes 5. 78°C (172°F) for 10 minutes - mash out **Double Decoction**: 1. 50°C (122°F) for 15 minutes 2. First decoction to reach 65°C (149°F) 3. Second decoction to reach 72°C (162°F) 4. Mash out at 78°C (172°F) ## Step Parameters ### Required Fields * **Step Temperature**: Target temperature for the step * **Step Time**: Duration in minutes ### Optional Fields * **Step Name**: Custom name for the step (e.g., "Protein Rest", "Beta Rest") * **Ramp Time**: Minutes to gradually reach target temperature * **Step Type**: Method to reach temperature (Infusion, Temperature, Decoction) * **Infusion Amount**: Optional manual water addition for infusion steps * **Infusion Water Temperature**: Optional temperature for the added infusion water. If left empty, Brewfather uses the boil temperature. * **Decoction Thickness**: For decoction steps, choose thick mash or thin mash depending on what you plan to pull. * **Decoction Amount Mode**: For decoction steps, choose calculated, fixed volume, or percent of mash * **Decoction Amount**: Required when using a manual decoction volume or percent * **Decoction Rest Temperature / Time**: Optional rest for the pulled decoction before boiling ### Profile-Level Decoction Setting * **Decoction Boil Off Rate**: Optional `%/hr` value for decoction steps only * When configured, Brewfather can show more exact `return about X` wording for decoction actions * When left empty, Brewfather still shows the pull amount and return step, but avoids implying a precise return volume ### Import and Export * Brewfather BeerXML import/export preserves Brewfather-specific mash planning fields such as infusion amount, infusion water temperature, decoction amount mode, decoction thickness, decoction rest, and decoction boil-off rate. * Other brewing apps may ignore these Brewfather-specific BeerXML fields, but Brewfather can read them back when you re-import the file. ### Managing Steps * **Reorder Steps**: Steps can be reordered using move up/move down buttons. ## Temperature Targets by Style ### Light & Crisp * **Pilsner**: 63-65°C (145-149°F) * **Belgian Tripel**: 64-65°C (147-149°F) * **Brut IPA**: 62-63°C (144-145°F) ### Balanced * **Pale Ale**: 65-67°C (149-153°F) * **IPA**: 65-66°C (149-151°F) * **Wheat Beer**: 65-67°C (149-153°F) ### Full Body * **Stout**: 68-70°C (154-158°F) * **Porter**: 67-69°C (153-156°F) * **Scottish Ale**: 69-70°C (156-158°F) ## Tips 1. **Name Clearly**: Include temperature and technique in profile name 2. **Test and Refine**: Track efficiency and adjust profiles as needed 3. **Consider Grain Bill**: Adjust temperatures based on grain types 4. **Mind the Clock**: Longer mashes increase fermentability 5. **pH Matters**: Stay within 5.2-5.6 for optimal enzyme activity 6. **Mash Out**: Optional but helps with lautering efficiency 7. **Use manual overrides carefully**: Manual infusion and decoction overrides are useful for matching your process, but large overrides can make the projected step temperature miss the intended rest ## Troubleshooting **Poor Efficiency?** * Check grain crush * Verify temperature accuracy * Extend mash time * Check pH **Stuck Mash?** * Add rice hulls * Check water/grain ratio * Slow down lautering **Wrong Body/Mouthfeel?** * Adjust mash temperature up or down * Change rest times * Consider different mash profile ## Profile Management * **Set as Default**: Star/mark a mash profile as your default. * **Copy**: Duplicate a profile. * **Reset**: Reset default profiles to factory settings. ## Related docs * [Recipe Designer](/recipes/designer) * [Rest Temperature](/tools/rest-temperature) --- [Next Page](/llms-full.txt/1)