How it all works

General

Welcome

KegNinja™ is a homebrewery planning tool that will let users keep track of how much beer they have, how much beer they are going to have, and how much beer they should have. It allows you to plan brews from current too into the future. It has a "Pipeline" tool that will guess when your brews will be at various stages and estimate when they will run out. We provide a custom digital tap list to help you display your brews and log when drinks are taken. You can easily set up this system with a Cheap Tablet ($49), and since our application is all web based it can run on windows / mac / android all without issues. You can set up Untappd integration as well so when you log a drink in our system it will automatically log it for you on Untappd. We have a full feature recipe builder that rivals the best out there, and many more features with more planned in the future!

Donate

100% Free always and forever for everyone. This site is run out of pocket, no fees and no ads. If you want to help us keep it that way feel free to send us a donation with Paypal so it's easier for us to keep the lights on. Or, you can feed our developer so he can keep coding for us!

Feed the developer Poptarts!

Still Need Help?

The blue contact button in the bottom right corner of your screen Alternate Text is the best way to get ahold of us any time! Heck we might even be online right now.

Outside of that you can email us any time info@keg.ninja or find us on most social networks, links at top of page!

Where To Start

Overview

Keg ninja manages your brewery from start to finish. We have four main objects that you will use to accomplish this.

Recipes | Brews | Packages | Drinks & Tap Lists

Recipes work like any other recipe builder you have encountered in the past. You can configure equipment profiles, efficiency, mash schedules. We have an extensive list of ingredients you can add to your recipes and if we don't have it you can create any ingredient (Fermentable, Hops, Yeast, Misc and Water). Recipes can be shared publicly and searched on the site if desired. They can also be cloned. You canhave as many recipes as you want and they are all sorted in your online recipe book that allows you to create folders and organize them any way you see fit. When you are planning on making a recipe you can “Brew” it. When you brew a recipe, it will create a brew object and will copy the recipe in its current state to a brewed section inside your recipe book.

Brews represent recipes that you have brewed or plan on brewing soon. These objects can store information related to brew day such as OG FG, brew day notes. You can add a label to the beer, and a decent selection of more options. Brews control your pipeline, a tool that will show you an overview of our brewery (more info on pipeline here). Brews when ready can be packaged. Packaging represents bottling or kegging your beer and stores information about quantity.

Packages represent packaged brew, kegs bottles etc. If your beer is packaged inside a keg it will be allowed to be placed on a tap, if not it can begin being drank. Packages store and keep track of how much they have, this powers the pipeline and tap lists to let you know how much of each package you have left. You can adjust this quantity by drinking.

Drinks represent when you drink a package. When you log a drink, the amount of that drink will be removed from the package so you can have an accurate quantity measurement of how much beer you have in a keg at any given time. We have a custom tap list system that you can design with your packages and taps to digitally display your beer and it is touch sensitive so you can log drinks against your packages right off your kegerator!

We hope you find the system as a useful and powerful tool to help you manage your brewery from grain to glass. More information about each step in the process can be found in their respective part of the documentation. If you need further help, feel free to contact us any time.

Cheers.

Your Profile

To begin using KegNinja you will need an account. Accounts are free and take very little time to create. You can make a local account or log in through Facebook or Google if you prefer. Once your account is complete and ready you will receive an email to let you know you can log in and begin using the system.

Access your profile settings any time by clicking on your logo in the upper right of the screen

Alternate Text Alternate Text

Inside your profile you can set up defaults for ease of system use, upload a logo for your brewery, connect to Untappd, and adjust security settings. There is also a decent selection of preferences available for the recipe builder located here as well such as using lb vs kg and gallons vs liters for measurements.

Alternate Text

Inventory

Commercial Beer

Alternate Text

Commercial beer inventory, will help you keep track of beers in your cellar. If you have Untapped integration turned on you can even search for these beers using Untappd. Quick buttons on the grid make it easy to add and remove beers as you drink them so you always know what's in your cellar.

Ingredients

Alternate Text

Much like the commercial beer section of inventory, Ingredients lets you keep track of your brewing ingredient inventory. Here you can add Hops, Yeast, Misc, and Fermentables. At any time you can add remove or edit quantity of these items so you always know what you have one hand.

Recipes

Getting started with recipes

Our recipe builder is totally redesigned since beta to be faster, more accurate and easier to use. If you have used other beer recipe builders before the system should feel familiar and you should be able to get up and running without much trouble.

Recipes are calculated based upon ingredients selected and equipment profiles chosen. To begin making a recipe it is recommended you make or modify an equipment profile and set up your default recipe before you begin. You are allowed unlimited recipes and they are always hosted and saved automatically to the cloud so you can access them any time on any device. Recipes can be private or public to be shared with friends and the community. For more detailed instructions on how to use and maintain recipes, check out the sections below.

Equipment Profiles

Alternate Text

Equipment profiles are a digital representation of your brewery. You can set attributes like batch size, boil kettle size, evap rate etc. These fields help us calculate your recipe to your brewery. You can create your own equipment profile from scratch or modify an existing one.

Brewing Styles

Alternate Text

By default, the system is loaded with the complete style guidelines from BJCP 2015, you can add additional styles to the system at any time. The recipe builder has a style guide section provided to let you know how well your beer fits into certain beer styles and to help give you an idea of what the balance of the beer will be like.

Alternate Text

Ingredients

Alternate Text

Ingredients consist of Fermentables, Yeast, Hops, Misc Items and Water. You can modify and add to the pre-built lists at any time if you find we are missing something you want. Ingredients are simply added to a recipe by clicking on their respective buttons on the ingredient grid inside the recipe builder and selecting what and how much you want.

Alternate Text

Your Recipe Book

Alternate Text

Your recipe book gives you a place to create and organize recipes. The folder tree system allows for custom organization of recipes. You can add, name and nest folders in any fashion you desire so you can sort by style or year or any criteria you desire.

The Recipe Book has three root items. A Recipe and Brewed Folder and a Default Recipe. Your Recipe Folder stores all your recipes, you can organize in any fashion you see fit. The brewed folder holds copies of recipes that you have brewed or are going to brew soon. When you click “Brew” on a recipe it will create a brew object and take a snapshot of the recipe and transfer it over to your brewed folder. This allows you to do easy versioning of recipes and lets you know exactly how the recipe was on brew day. More on brew objects and brewing below. The default recipe is the recipe from which all your new recipes are cloned from and it is located just inside your recipes folder of the recipe book.

When you click on a recipe inside the recipe book, a preview pane will open and display the recipe. Available actions will be located there that allow you to delete, edit, view, clone, brew etc.

There is no limit to the number of recipes you can have and they are all stored and saved automatically.

Default Recipe

Alternate Text

Every time you make a new recipe it will start as a copy of this. You can set up default equipment, add ingredients you always add to every batch etc to this to save time when making new recipes.

Example, I like to add Whirlfloc Tablets to all my batches, so my Default Recipe has that added to the ingredients so its there every time I make a new recipe.

Recipe Builder

The Recipe Builder saves your recipes automatically so you don't have to every worry about saving before changing tabs or accidently closing the browser. The builder is broken up into several sections where you can enter information and we will help you dial in your recipe.

The Basics section contains basic recipe information such as brewer, batch size, if it's all grain etc. Here you can set what equipment profile you would like to brew with as well. This section will show estimated color of beer along with some other calculated fields such as water volumes and recommend yeast pitch size.

Alternate Text

The Style Guide shows how in style your beer is to your selected style.

Alternate Text

Ingredients is where you add Fermentables, Hops, Water, Misc Items and Yeast

Alternate Text

If you are not doing extract, you will have a mash section where you can set up mash temps and times, we will calculate temp your water needs to be and volumes needed.

Alternate Text

Finally, the notes section is for any additional notes you may want to make about this beer. These are full rich notes so you can attach images if desired.

Alternate Text

Brewing a Recipe

Alternate Text

You can brew any recipe inside your recipe book. Clicking on brew will create a snapshot of that recipe and copy it into your Brewed folder of the recipe book. This Action will also create a Brew object. Brew objects are used to manage pipeline information and keep track of brewday specific information such as OG FG measurements and brew day notes. More on Brew Objects in the Brew section.

Brews

Alternate Text

Brews represent recipes that you have brewed or plan on brewing soon. These objects can store information related to brew day such as OG FG, brew day notes. You can add a label to the beer, and a decent selection of more options. Brews control your pipeline, a tool that will show you an overview of our brewery (more info on pipeline here). Brews when ready can be packaged. Packaging represents bottling or kegging your beer and stores information about quantity.

Packages

Alternate Text

Packages represent packaged brew, kegs bottles etc. If your beer is packaged inside a keg it will be allowed to be placed on a tap, if not it can begin being drank. Packages store and keep track of how much they have, this powers the pipeline and tap lists to let you know how much of each package you have left. You can adjust this quantity by drinking.

To package a brew, go to your current brews page when ready and hit the package button. (This should be done on bottling / kegging day)

Pipeline

Alternate Text

Pipeline lets you see an overview of your whole brewery pipeline. You can see when a beer will be fermenting, conditioning, and an estimated amount of time it will be being drank. We use stats from the brew object and use account statistics on how fast your normally drink beers so we have a good estimation of when your kegs will kick. This tool should aid you in planning your brew day so you know how far out you need to brew and age beers so that you never have taps run dry again!

Pipelines are also shareable if desired, here is my live brewery pipeline Live Pipeline View!

Taps

Alternate Text

If you have a kegerator or keezer at home chances are it has taps on it. We attempt to set this section up for you on account creation but if you get more or less taps in the future you can edit them here. All packaged beer that is packaged inside a keg must be connected to a tap to drink. Taps power part of our taplist and drinking system. For more information check out those sections below.

Drinking Your Brew

Drinkers

Alternate Text

Drinkers are people who drink your brews. They can be you, common friends, family or whoever you want. They are used so you can log stats on who is drinking how much and how often. You can tie drinkers to the respective Untappd account so that when you or they drink and log it in the system it will auto log in Untappd for them for free (more about how to tie up multiple Untappd accounts in the Untappd section). We have some cool fun charting set up on the drinkers detail page that shows how much of each brew they have drank and when they drank it. Drinkers are assigned a color that will help them quickly click their user when logging a drink. To Delete a drinker, all drinks by that drinker must be deleted. You can change the name or color of a drinker at any time. By default, there are 2 drinkers, you and guest.

Alternate Text

Custom Measurements

Alternate Text

Every brewer is different, this is why we allow the ability for everyone to have custom serving and batch measurements. Some brewers enjoy regularly serving 4 oz samples, others think anything under 750ml is a waste. Some brewers use metric, some brewers have no idea what metric is. The custom measurements allows you to tailor serving and batch measurements to you. Say you want to measure your batches in 12oz units, this is awesome if you bottle since you can just count how many bottles a batch made, for those who keg though, measuring in 12 oz units would be really hard and they probably prefer to measure in liters or gallons.

You can add new measurements at any time, just give your new measurement a name (12oz, Liter, My favorite Mug, etc) and then tell us what that measurement is in liters. Don't worry this is the only time you are going to have to tell us the l value, we use this number a lot behind the scenes to track all sorts of information about your beer and it allows you to have w/e measurements you want. Google makes conversion really easy, just Google "(your measurement) to liter" and it should get you a number pretty fast.

To delete measurements you don't want to use or never plan on using, simple click the delete button. If the delete button is not there it is because you have something in the system using that measurement. It could either be one of the defaults in profile settings or you possibly have a package using that measurement or drinks logged with that measurement. You must first delete those if you really wish to delete the measurement. In general you should hardly ever delete things in the system, delete is reserved for accidents or things that never happened. In the screen shot above, you can see that the delete button is only showing up on the 4oz measurement, this is because I user or have used all the others. The more data you have in the system the better the system will work for you.

Logging A Drink

Alternate Text

The Drink tab provides fast access to all beer taps and packages that can be drank. You can get a quick overview of quantity of each package and there is a button located on the top that will allow you to log your drinks to a given user. This is a fast interface that should be accessible easily from any device so you can always see how much beer you have on hand and quickly log drinks against them. However we have a great tap list option with touch screen available that you can customize and attach to your kegerator for the ultimate logging and display of your beer!

Tap Lists

Alternate Text

Tap Lists are the ultimate way to display what you have on tap and they make logging your drinks into the system so easy! Since KegNinja is web based you can run a tap list on pretty much any device, we recommend a cheap tablet so you can get all the benefits of a touch screen. Something like this tablet ($49) will get the job done perfectly.

Tap Lists are quite customizable from changing fonts, colors, what to display and the order it is displayed in. Our Editor works like the recipe builder and saves automatically and shows you what your tap list looks like in the preview window.

When you are logged in as the owner of a tap list, you can click or touch the tap you want and it will bring up a fast dialog for you to log a drink.

Alternate Text

Tap lists can be shared publicly too so you can share with your friends and family what you have on tap all the time. Here is mine for example.

Tap Lists are smart and connect to the server to receive updates. So, if you log a drink on your phone or change the name of a beer on the website, the tap list will update and change display as needed without user interaction needed. This allows your tap lists to always be up to date and ready to log drinks when you are!

Untappd

Alternate Text

Untappd integration allows Keg Ninja™ to checkin on your behalf when you log a drink in our system. To get Untappd integration up and running please do the following.

Go to your profile settings and link your account by clicking the button and allowing us access to post on your behalf.

Then go to your drinker and tie your account to that drinker.

If others have drinkers on your account they can tie their drinkers to their respective untappd accounts as well. (You will have to log out of untappd before you tie additional drinkers to their Untappd accounts so they are able to sign in to their account)

Then go to your packaged brews, on the edit page you can search and link them to their untapped counterpart.

Before you are able to search you must first go to Untappd and add your beer on their site. (Sorry their API does not allow us to do that upon your behalf)

Now any time you drink a beer in the system with a drinker tied to Untappd and on a beer you have linked, it will automatically Checkin on Untapped for that drinker!

API

We have a simple to use API available for all users, the API provides access to system pieces that will allow users to display tap lists and log drinks. All API calls require authentication via token, and you will need a local user account password (Not sigining in through facebook / google). If you do not have a local user account, you can easily make one via account management page (and still be able to sign in with other services to the main website). We have a demo of the API as an example of how to get and hold your token and make web requests with it against the API. For a full list of available API calls please check out our swagger API doc page located here.

This API is for the people so please let us know if you make some cool things with it and we will consider putting those features into our site. If further API calls are desired, please contact us and we can hopefully work it out for you.