Welcome to Edibles!

Welcome to Edibles the most reliable and versatile diet journal available for iPhone and iPod touch. It comes with everything you need to achieve a healthy lifestyle.

How to read this help file online

You can read this help file online on your computer by visiting http://www.random-ideas.net/Software/Edibles/Help . You may find this helpful, in particular when you're configuring the calculator.

Note : A lot of folks have been asking where to find the Settings for Edibles. The Settings are located in the Settings App on the main screen of the iPhone. This is the way the Apple User Interface Guide suggests we do our settings.

Feel free to send us feedback. Our email address is at the bottom of this help file. In the meantime, read on for instructions on how to use Edibles!

NEW Searchable Food Database

Version 2.5 of Edibles uses the power of Edibles Online to add a new searchable database of 500,000 common foods. These foods come from users of Edibles Online, and is constantly growing. You can contribute to this list by using Edibles Online.

To use the searchable database, you simply touch inside the search box on your food list, then select the "Edibles Online" tab from the search scope selector, and then type the name of the food you want to search for and hit search.

I Don't Track Calories How Do I Change That?

Edibles is designed to be extremely configurable, and can be configured for almost any diet plan on the market. In particular, you don’t have to use Edibles to track calories, you can configure it to track any value that you want. For example, many of our customers use it to track carbs, sodium, gluten, or any of a number of other diet related values. To do this, you need to configure the Unit Label. Once you have configured this, everywhere in the program where it says “Calories” Will be replaced with whatever value you want to track.

To configure the Unit Label you must exit Edibles, and go to the Settings application on your iPhone or iPod Touch home screen. Inside there, you’ll find a section for edibles. There you will find the “Custom Units Label” And “Custom Units Abbreviation” settings. Set these to whatever value you want to track. So for example, if you wanted to track carbs, you would set this to “Carbs”.

Note : For the purposes of this help file in order to keep things as simple as possible, everything that we describe will talk about calories. However, if you don’t track calories simply mentally replace the word calories with whatever value you track.

For more information on this see the customization section of the manual.

A Brief Tour

Let’s take a brief tour of the Edibles interface so that you can familiarize yourself with how to use it.

The first screen that comes up when you start Edibles is the food log screen. It’s from this screen that you will do most of your day-to-day interaction.

We’ve tried to optimize the user interface around logging your meals. The first section in this screen shows your daily allowances. The second section is for logging foods for today and viewing today’s log. Finally, the third section shows your historical data from all of your previously logged days.

We will discuss each of these sections in detail.


Calorie Pools

Edibles allows you to track three different allowances. They are: Daily; Exercise; and Weekly.

The Daily pool is where you will track your day to day calorie allowance. So, for example, if you want to eat no more than 1500 calories per day, then you would set your daily allowance in the Daily pool to be 1500.

The Exercise pool is where you track calories that you have burned. This means that if you burn 500 calories exercising, then you can allow yourself an additional 500 calories of food for that day. So you would enter 500 for your exercise allowance.

Finally, the Weekly pool is a separate pool that resets weekly, that you use to track any extra calories that you allow yourself on a weekly basis. Think of this as splurge calories. This is for weekly treats or special occasions.

It’s important to note that each of these pools are independent of each other meaning that, the Weekly is not simply a sum of the Daily multiplied by seven. It is in fact a separate pool altogether.

To set the allowance for each of the pools, you simply touch the pool line and it will take you to a screen that enables you to set its value.

Each of these pools resets in a particular way. The Daily pool reset each day. This means that at the beginning of each day your daily pool will have the full allowance available on it, and as you log your meals, the allowance will decrease to show how much you have left. The exercise pool can be configured to reset either daily or weekly. If you configure it to reset weekly, it will reset on the same day that your weekly pool resets. Finally, the weekly pool resets weekly. To configure the day that the weekly and exercise pools reset, see the section on customization.

When you log food with Edibles, it subtracts the calories for the food that you have logged from these pools in order from top to bottom. So, by default, calories are subtracted first from the Daily, then from Exercise, and finally from Weekly.

If you want to change the order in which these are subtracted, simply touch the Edit button. This will enable each of the pools to be moved. You can then order them in whatever order you prefer. Just remember that the subtraction occurs from top to bottom.

So, in summary, you configure allowances for whatever you want to track on a weekly and daily basis. When you exercise, you also "earn" a certain number of calories. For example, you might burn 100 calories, so you earned 100 more calories you can eat. Finally, you configure calorie amounts for the foods you eat, and as you log that you have eaten particular foods, it subtracts the calories for that food item, first from your daily calories, then your exercise calories, and finally from your weekly calories. When you reach 0 calories left, you should stop eating for that day. The weekly calories reset each week on the day that you configure. The exercise calories reset each day, or weekly if you configure them to "roll over." Daily calories reset each day.

Actions For Today

The actions for today section has three rows, they are: Calories Used; Log Food; And View Today’s Log.

The Calories Used row displays how many calories you have used today. This will update as you log food.

The Log Food row is actually a button that takes you to your food list. Initially, your food list will be empty. As you use edibles, you will populate this database with the food you eat. So our customers ask why we don’t ship a food database prepopulated. The reason for this is because many of our customers don’t want to wade through a large list of foods that they don’t eat. By allowing our customers to add their own foods the food in your list is the food you eat.

Finally the View Today’s Log row will take you to the log entries that you have entered for today.


The last section in the Food Log screen is the historical section. This is where you can see a list of all the days that you have log food for.

Each row shows how many calories were logged on that day as well as, the exercise calories were burned.

You can add entries to any prior day by touching the row associated with that day and then logging the food accordingly. If you want to delete a day simply swipe your finger across the row that you want to delete and a delete button will appear.

Food List

When you touch the Log Food row it will take you to the food list screen. Initially, this list will be empty. To add a food you simply touch the plots in the upper right-hand corner. This will bring you to the new food entry screen. From this screen you enter in the food type, serving size, and calories. You can also categorize the food if you want to track particular foods by category.

Once you touch the Done button, you can then edit the servings and press the log this button to actually log an entry in today’s log for that food. After the food is entered, you won’t need to enter it again, you simply go back in your food list and scroll through the list to find the food that you entered and you can choose to log it again.

Using these screens, it’s really easy and fast to log your foods as you eat. We worked very hard to streamline this process to make it as easy as possible and as fast as possible.

Weight Log

The Weight Log screen works much like the Food Log screen.

At the top of the screen is a chart that shows your last 10 weight entries, and your goal weight.

Under the graph is the actions section.From here, you can weigh in for today or for another day.

Next is the statistics. This will show you things like your average lost, you’re lost to date, and so forth. It should be noted, that anywhere that your weight is displayed we also put your BMI, and whether your BMI is healthy, overweight, underweight, et cetera.

Finally, the entries section shows all of your weights that you have entered so far. For each row, it shows What your weight was, your BMI, and whether you gained or lost or maintained as compared to the previous entry. Your gain or loss will be displayed in red for a a gain and green for a loss.

To delete a weight entry, simply swipe your finger across the row that you want to delete and a delete button will appear.

Programmable Calculator

The programmable calculator is provided so that you can configure edibles to calculate nutritional information for you on the go. It can be configured with virtually any formula. We have provided a few in the Programming the Calculator section.

The important thing to note here is that once you have configured a formula, you can simply touch each of the rows that represent values and enter the value that you want to calculate with their. When you’re finished entering all of the rows the result of your calculation will be displayed in the result row. You can clear all the values by touching the clear row.

This calculator is also available from the food entry screen.

Edibles Online

The final screen is the Edibles Online screen.

From here you can backup and restore your data and share your food list journal or weight Journal with your friends, doctor, or whoever you choose.

We recommend that you at least do a backup once a day so that if anything happens to your iPhone your data will be safe on Edibles Online.

For each of the options shown here, you have the ability to simply do a backup or to also e-mail a link to your data to whoever you want to share your data with.

If at some point you lose your data, as long as you have done a backup, you should be able to return to this screen and touch the Perform Sync button to restore your data from the last backup that you did.

Finally, in order to use edibles online to add foods to your database, you will need to do a full backup. See the edibles online help screen for more information on how to do this.

Important: when working with Edibles Online, you should start by doing a sync, make whatever changes you want in Edibles Online, and then sync again. This effectively saves your database to Edibles Online, then you make your changes, and then you load them back into edibles.


Most of the settings and customization features for edibles are located in the settings application on the iPhone. This means that you need to exit edibles completely, to the iPhone home screen and look for the application Settings. In this application you will find a section for edibles.

In the Settings application, you'll find a button specifically for Edibles. Inside here, you'll find the settings for edibles broken up by category.

Appearance Settings

The first settings group controls the appearance of the application. Edibles has the ability to place your unused calories count as a badge on your application. The first option controls whether it does that or not. The next two options control the label used in the application in place of calories if you're tracking something other than calories.

What if I decide that I want to change what I am tracking?

Its fairly simple to change eating plans in Edibles, just change your Units in the settings area. You will need to adjust your Daily <Whatever you change it to> to your new eating plan. The next thing you'll need to do is adjust the information for your foods in your database, which at this time will need to be done manually. Just edit the foods as described in the Log Food section of this document.

Food Journaling Settings

Next up are the settings for the food journaling. This allows you to configure things like if you want your exercise calories to roll over from one day to the next if you don't use them, or what day of the week your weekly calories reset. Additionally, Edibles has the ability to automatically delete old journal entries. You can configure when this occurs by using the setting "Keep Entries". This ONLY affects journal entries.

Food Categories

Edibles includes the ability for you to categorize your foods. This helps you to track your servings of particular types of foods. For example, if your diet plan requires that you track how many fruits, vegetables, and liquids you eat, then you would create categories for each of these and set your foods to be in each of these categories. The number of servings of each of these items that you have eaten on a given day is tracked on that day's food list. To view this for today, touch the "View Today's Log" button on the main screen.

The categories themselves are defined as a comma-separated list. Each item in the list, as seperated by commas, becomes a category.

So, for example, to create the categories for Fruits, Vegetables and Liquid. You would set the categories setting to be 'Fruit, Vegetable, Liquid'.

You may find it easier to configure this using Edibles Online , since the text entry window is fairly small on the iPhone.

Weight Journaling

After the food journaling settings, are the weight journaling settings. These allow you to set whether you use metric, and your current height. Your height is used to calculate your BMI and should be entered in inches if you are american, or meters if you use metric.

Edibles Online

Finally, the last settings section enables you to configure your Edibles Online username and password. We'll talk a bit more about this later, so for now, just ignore this setting.

Calculator Configuration - The Short Version

Many diet plans require that you calculate various nutritional information and statistics such as BMI, or BMR and so on, on a regular basis. You can use a plain old calculator for this, but Edibles provides a built-in programmable calculator that you can use instead. By using the programmable calculator you can configure it to prompt you for specific values and then to give you a result based on those values.

Before using the calculator, you must configure it with a formula. A formula consists of an expression made up of variables, functions, operations and constants.

Here's a few example formulas to get you started, just enter any one of these directly as you see it onto the iPhone screen:



Glycemic Index:

(<Carbs>/<Meal Carbs>)*<Carb GI>

Body Mass Index:

(<Weight in Pounds>/(<Height (in.)> * <Height (in.)>))*703

Calculator - The Long Version

If the formulas above don't help you, or you want to hack about with the calculator, then you need to do a bit more advanced calculator configuration.

In describing each of these parts, I will use quotation marks ('like this') to surround the thing you would put into the formula. When you put the item into the formula, you should not include the quotation marks.

Variables - A variable represents a value which you will be prompted for when you are performing the calculation. These are delimited in the formula by surrounding the variable name with angle brackets ('<>'). So for example, to define a variable called Calories you would put into your formula '<Calories>'.

Functions - Functions are mathematical operations which extend beyond the normal addition, subtraction, multiplication and division. Currently, there are three functions provided. They are MIN, MAX, and ROUND. Functions are entered into the formula by typing the function name, and then the parameters to that function in square brackets. For example, to calculate 7/9 and round it to the nearest first decimal place, you would put 'ROUND[(7/9), 1]' This would yield .8 since it would round .77777 to .8.

All current functions require two parameters. For ROUND, the first parameter is the value being rounded, and the second parameter is the place to round it to. For MIN and MAX, the two parameters are the values being compared. Parameters are passed to these functions via square brackets. So, to find the MAX of 4 and 5, you would do 'MAX[4, 5]'

Operations - These are your addition, subtraction, multiplication, and division operators. To use these in your formula, you simply type '+' for addition, '-' for subtraction, '*' for multiplication and '/' for division. So, the operation '10/2' would yield 5. '5*2' would yield 10, and so forth. To ensure your calculations get performed in the appropriate order, you should use parenthesis to group them how you want. So for example, to calculate '(10+2)/(4-2)' would calculate first 10+2, to yield 12. Then 4-2 to yield 2. Then it would divide 12 by 2 to yield 6.

Constants - A constant is a set value. These can be any number, but you are not prompted for them.

For the purposes of illustration, let's pretend that we're setting up Edibles for a hypothetical weight management system that uses Calories, Protein and Carbohydrates for calculating it's food value. Let's say that this system requires that you take the value for calories and divide it by 10. You then take the greater value of Carbs or Protein and then add that value to the calories value we got above. Finally, we round our result to the nearest whole number.

In this hypothetical system, the variables would be Calories, Protein and Carbs. The constants would be 10. Operations would be division and addition. And the functions would be MAX and ROUND. We would enter the formula into Edibles as follows:

ROUND[((<Calories>/10)+MAX[<Carbs>, <Protein>]), 0]

This would result in the calculator screen having 3 values the user is required to enter, Calories, Carbs and Protein. Once entered, the larger of Carbs or Protein would be added to Calories divided by 10. Finally the value would be rounded to the nearest 0 digit, which means the nearest whole number.

I realize this all may sound very complicated, but the truth is, if you understand that <> allow you to define variables, and functions are invoked like MIN[4, 5]. The rest is pretty straight forward. Using this system, the Edibles calculator can be configured to work with almost any program on the market. We encourage people to use it as a tool to fit their needs and create a healthy lifestyle.


Thanks again for choosing Edibles. And remember.... Success is the progressive realization of a worthy goal or ideal. ~ Earl Nightingale


Contact Us! We want to hear from you! Tell us what you like, what you don't like, and what kind of features you'd like to see!

Be the first to hear about new products from Random Ideas by signing up for our newsletter or subscribing to our Blog! Simply email "SUBSCRIBE" to random-ideas-announce-request@random-ideas.net , or visit the list server for more info!

To subscribe to our Blog, visit http://www.random-ideas.net/Blog .

We have some truly exciting announcements coming up in the next few months and you don't want to miss them!