Farm Report User's Guide

Add Products to the Products Table

  1. In the Add Product area, select the item type (for example, Crop) and the specific item (for example, Peanut).
  2. Specify the Started Time in one of the following ways:
    • Now – The product was started within the last few minutes. This method is typically used as you start new products. Shortly after starting the products in Farm Town or FarmVille  add them to the Products Table.
    • Percent Done – You can select what “percent done” the product is currently (as shown in the game). This method is typically used when you first start using Farm Report. You can add your already started items, by using the “percent done” that the game displays for each item. Farm Report will then estimate the started time.
    • Ready In - You can select the "ready in" time (as shown in the game).  This method is typically used when you first start using Farm Report. You can add your already started items, by using the “ready in” time that the game displays for each item. Farm Report will then estimate the started time.
  3. Add an optional Note, for example "use in bakery".
  4. Set or clear the Alarm checkbox, to enable or disable the alarm for this product.
  5. Set or clear the Star checkbox, to signify whatever you like.
  6. (Farm Town only) Set or clear the Irrigate checkbox, and select a sprinkler type.
  7. Click Add Product.  The product will be added to the Products Table.
Some notes about the Products Table:
  • The Filter check boxes can be used to control which products are displayed in the table.  You can choose to display all products (Show All), hide all products (Hide All) or display any subset of the available item types (for example Show Crops).
  • To print the Products Table, click Print. The table will be printed as it currently appears in the window.
  • To sort the contents of a single table, click on the table column headers.
  • To sort the contents of all tables, use Options->View->Sort By Column.
  • To show/hide a column (applies to all tables), use Options->View->Show Columns.
  • The Ready Date and Wasted Date can be displayed as a date (for example: "Thu 5:35 PM"), or as remaining time (for example: "11:58 hours").  The format is controlled via the Show Remaining Time checkbox.
  • When the Ready Date and Wasted Date are being displayed as a date, they can be displayed in AM/PM format (for example: "Thu 5:35 PM") or in 24 hour format (for example: "Thu 17:35").  The format is controlled via the Options->View->Use 24 Hour Format checkbox.
  • The Notes column can be used to record a note to yourself (for example: "use in bakery").  The note will be displayed in the Product Ready alarm.
  • The Star checkbox can be used to signify whatever you like.

Add Farm Tabs

By default, there is one Farm Tab for each game.   You can add additional tabs, if you like.  You can have one tab for each of your farms, or you can split up your products in any way you like.

  • To add a new Farm Tab, click the '+' button.  Choose a name for the new tab.
  • To move items from one Farm Tab to another:
    • Select the items to be moved
    • Click Move To Select the Farm Tab to move the items to
  • To rename a Farm Tab, right-click on the Farm Tab's name and select Rename tab

You can control the layout used when there are too many Farm Tabs to fit on one line:

  • Options->View->Farm Tab Layout->Wrap Tabs - display Farm Tabs on multiple lines
  • Options->View->Farm Tab Layout->Scroll Tabs - display Farm Tabs on one line, with scrolling (default)

Product Ready Alarm

When a product is ready, a Product Ready alarm will be displayed on your desktop, telling you which product is ready, which farm it is on, and when it will go to waste (if appropriate).  If you have added a note for the product, it will be shown.  The alarm window has the following buttons:

  • Close: Close the alarm window (same as clicking on the X button).
  • Close All: Close all alarm windows.
  • Delete: Delete this product from the Products Table.
  • Delete All: Delete all currently alarmed products for this game and farm tab from the Products Table.
  • Reset: Reset the Started Date for this product.
  • Reset All: Reset the Started Date for all currently alarmed products for this game and farm tab.
  • Snooze: Snooze this alarm for the specified time.
  • Snooze All: Snooze all alarms for the specified time.

When resetting a product or group of products (via Reset or Reset All), you will see the Confirm Reset dialog. This dialog allows you to set some options for the reset operation.

An alarm sound is played when the Product Ready alarm is displayed.  You can select the alarm sound via Options->Alarm Sound. If you prefer not to have an audible alarm, it can be turned off with the Options->Play Alarm Sound checkbox.

The default 'snooze time' can be set via the Product Ready alarm, or by using the Options->Preferences->Set Default Snooze Time... menu item.

Reset Product(s)

A product or group of products can be reset by:

  • Selecting the product(s) in the Products Table, and clicking Reset in the tool bar, or
  • Clicking the Reset or Reset All button in the Product Ready Alarm
Started Date

The Started Date can be set to 'Now', or you can select the 'Ready In' time or the 'Percent Done' (depending on the game).

Alarm and Star

By default, Alarm and Star are marked Don't Change.  This means that as each selected product is reset, that product's setting for Alarm and Star will stay the same.  For example, if you reset a product whose Alarm check box is checked (in the Products Table), and whose Star check box is unchecked (in the Products Table), after the reset the  product's Alarm check box will still be checked, and the Star check box will still be unchecked.

Alternatively, you can choose Check All or Uncheck All.  For example, if you choose Check All for Alarm and Uncheck All for Star, after the reset, all of the reset products will have Alarm checked and Star unchecked in the Products table.

You can change the default setting by using the Options->Preferences->Default settings for Reset option.

Irrigate (Farm Town only)

If you want to irrigate the products in conjunction with the reset, check the Irrigate check box, and select a sprinkler type.  The products will first be reset (according to the value specified in the Started panel), and then irrigated.

Default Settings For Reset

The default setting for Alarm and Star in the Confirm Reset dialog is Don't Change. This means that as each selected product is reset, that product's setting for Alarm and Star will stay the same.  For example, if you reset a product whose Alarm check box is checked (in the Products Table), and whose Star check box is unchecked (in the Products Table), after the reset the  product's Alarm check box will still be checked, and the Star check box will still be unchecked.

You can change the default to Check All or Uncheck All via Options->Preferences->Default settings for Reset.

For example, if you always want Alarm to be checked, and Star to be unchecked when you reset products, change their defaults to Check All and Uncheck All, respectively.

Alarm

The Alarm button can be used to "toggle" the 'Alarm' setting for all of the selected products.  For each product, if the alarm was previously enabled, it will be disabled, and vice versa.

Irrigate

(Farm Town only) The Irrigate button is for use with the Farm Town Red, Orange, Green, and Purple Mobile Sprinklers. After you use one of the sprinklers on your farm:

  • Select alll Product Table entries for that farm.
    • If you have a separate tab for each farm, you can use File->Select All (short-cut: Ctrl-A) to select all of the entries on that tab.
    • If you have all of your farms on a single tab (and you have included the farm name in the Notes column), you can  'sort' by the Notes column (by clicking on the column header), to make it easier to select all of the entries for a given farm.
  • Click Irrigate.
  • Select the sprinkler type (Red, Orange, Green, or Purple).
  • Click OK.

If the Red Sprinkler is selected, the Irrigate button will reduce the remaining growth time for all eligible products (crops and flowers) by 50%.

If the Orange Sprinkler is selected, the Irrigate button will reduce the remaining growth time for all eligible products (crops, flowers, and trees) by 50%.

If the Green or Purple Sprinkler is selected, the Irrigate button will reduce the remaining growth time for all eligible products (crops, flowers, and trees) by 50%.  It will also extend the waste time as follows: For crops with a growth time of one day or less, 24 hours will be added. For crops with a growth time of more than one day, 48 hours will be added.

Items that are not eligible will not be irrigated.  Eligible items that have already been irrigated once will not be affected by subsequent irrigations.

Google Calendar

Farm Report can work with Google Calendar to notify you when your crops are ready.  To use this feature, you just need to have a Google account.  You do not need to use Google Calendar for anything else.  If you are interested in using this feature, but do not have a Google account, you can sign up for one here.

Enabling Farm Report’s Google Calendar feature provides the following advantages:

  • Google Calendar will notify you when your crops are ready, even if Farm Report is not running.
  • Google Calendar can notify you via any of the following methods:
    • Pop-up Alarm
    • Email Message
    • Text Message*

The Google Calendar notifications are in addition to the usual Farm Report pop-up alarms.  So, whether or not you use the Google Calendar feature, you will still get the Farm Report pop-up alarms when your crops are ready (provided that Farm Report is running).

*In order to receive text messages from Google Calendar, you must provide it with your cell phone number.  This is the process:

  • Log in to your Google account (https://accounts.google.com/ServiceLogin)
  • Go to your Google Calendar
    • Click on the Apps icon
    • Click on the Calendar icon (it may be under More)
  • Click on the Settings icon and select Settings
  • Click on Mobile Setup
  • Follow the instructions there

To Enable the Google Calendar Feature

  • Click on Google Calendar…
  • Select Add to Google Calendar
  • Select the Reminder Type(s) (Popup, Email, Text Message)
  • Click on Apply

The first time Farm Report attempts to connect to your Google Calendar, you will be asked if you want to grant Farm Report that authorization. This is the dialog you will see:

 

A new tab will open in your browser (Firefox, Chrome, Internet Explorer, etc.). If you are not already logged in to your Google account, the following page will appear in the browser tab.  Enter your Google email and password to log in to your Google account.

 

Once you are logged in to your Google account, you will see the following page in your browser tab.  Click Accept to authorize Farm Report to add Product Ready reminders to your Google calendar.  (Or you can click Cancel if you do not want to grant the authorization.)

Please do not close this browser tab (by clicking X on the tab).  Just click Accept (or Cancel).

After you click Accept (or Cancel), you will see the following page in your browser tab.  You can now safely close the browser tab (by clicking X on the tab).

If you authorized Farm Report to access your Google calendar (by clicking Accept), Farm Report will connect to the calendar and add your Product Ready reminders. The Google Calendar button on Farm Report's tool bar will show a green dot to signal that it is connected:

Closing or Exiting Farm Report

Closing Farm Report

When you close Farm Report (by clicking the Close button, or the X button in the upper right corner of the window), Farm Report will continue running in “hidden” mode (in the background). This enables the alarms you have set to continue running.

You will see the Farm Report icon in your “system tray” (the lower right corner of your screen). (Windows 7/8 users, please read the information on accessing the icon in Windows 7/8.) To re-display Farm Report, just double click the icon.

Exiting Farm Report

You can exit Farm Report by clicking the Exit button. It will ask you to confirm that you really do want to exit. When you exit Farm Report, it will stop running, and any alarms you have set will be canceled. The next time you run Farm Report, those alarms will be started up again.

Accessing the Farm Report Icon in Windows 7/8

In versions of Windows prior to Windows 7, icons for programs running in the background (like Farm Report) are always visible in the System Tray (known as the "Notification Area" in Windows 7/8).  In Windows 7/8, however, these icons are handled in a different way.  By default, the icons are placed in the "Notification Area Overflow".  You can customize the display behavior of an icon to place it in the Notification Area instead of the Notification Area Overflow.

To access the Farm Report  icon , you can use either of the following techniques:

  • Leave the icon in the Notification Area Overflow.  When you want to access it (to re-display the program for example):

    1. Click the small white arrow to the left of the Notification Area.  This will display the Notification Area Overflow.
    2. Click the Farm Report icon to re-display Farm Report.

     

  • Promote the icon to the Notification Area

    1. Click the small white arrow to the left of the Notification Area.  This will display the Notification Area Overflow.
    2. Click “Customize”.
    3. Next to each icon you’ll see a pull-down menu with 3 options for the icon’s display behavior.
    4. Next to the Farm Report  icon  , select "Show icon and notifications".
    5. Click "OK".  The icon will now appear in the Notification Area.  When you want to re-display Farm Report, just click on the icon in the Notification Area.

Custom Items

Farm Report includes all items currently available  in Farm Town and FarmVille.  However, the game developers are continually adding new items to their games.  If you cannot find an item in the pull-down list under Add Product, it is likely that the item in question was added after the release of Farm Report.

You can "teach" Farm Report about new items by clicking the Manage Custom Items button.  It will show the Manage Custom Items dialog.

To create a custom item:
  1. Specify the item’s name (for example “FruitOBerries”).
  2. Choose the item’s type (for example Crop).
  3. Choose the item’s duration (for example “1 Hour”).
  4. Click Add Custom Item to add the new item to the Custom Items Table. The custom item will also be added to the Add Product pull-down list.

Custom items can be edited and deleted; provided that they are not currently “in use” (i.e. they do not appear in the Products Table).

Hide Game Tabs

The Options->View->Game Tabs menu can be used to display or hide individual game tabs.  For example, if you do not play Farm Town, you can hide the Farm Town game tab.  If you subsequently start playing Farm Town, you can choose to display its game tab.

The game tabs can also be hidden by clicking on the X button on each game tab.

Show/Hide Columns

The Options->View->Show Columns menu can be used to show or hide individual table columns.  For example, if you do not use the Notes column, you can hide it.

Sort By Column

The Options->View->Sort By Column menu can be used to sort all tables by the specified column.  For example, you can sort all of the tables by 'Ready Date'.

If a column has been hidden (via Options->View->Show Columns), you will not be able to sort by that column.

Note: To sort the entries of a single table, you can click on the column header.

Alarm Sounds

You can use the Options->Alarm Sound menu to choose from several stock alarm sounds.  You can also add custom alarm sounds by using the Add Alarm Sound menu item to select your own sound file (supported types: au, wav, aif, mid, rmi).

If you prefer not to have an audible alarm, it can be turned off with the Options->Play Alarm Sound checkbox.

Personal Tab

The 'Personal' tab can be used to track whatever you like, just add Custom Items.  It has a 24 hour day.

Start in background (Windows only)

By default, when Farm Report starts running, the Farm Report window will be displayed on your screen. If Options->Preferences->Start in background is selected (available on Windows only), the next time Farm Report starts running, it will start itself in 'background' mode.  (The Farm Report window will not be displayed.  It can be manually displayed by clicking the Farm Report icon in the Notification Area.)

This option is typically used when Farm Report has been added to the computer's startup folder, to avoid displaying the Farm Report window each time the computer is restarted.

Set Directory

Farm Report uses a database file (FarmReport.db) to store the Products Table and Custom Items you have created.  If an error is encountered, it will also create a log file (FarmReport.log).  By default, these files will be saved in your "default" directory (for example, Documents on Windows, or your home folder on OSX).

The Set Directory option can be used to specify an alternate location for the data files, for example Documents\Farm Report Data. Click the Select Directory button to bring up the directory selection dialog.  The Reset button can be used to reset the data directory to the default.

Run Farm Report on Multiple Computers

You can use Farm Report on multiple computers, sharing a data file.  The Farm Report data file must be in a location visibile to all of the computers, and you must use the Set Directory option on each computer, to tell Farm Report where to find the (shared) data file.

Method #1 (Networked Computers)

To be used if the computers are on the same network.  This method allows you to run Farm Report simultaneously on multiple computers.

Initial Set Up
  • Create a folder Farm Report in a location visible to all of the computers (a shared network location)
  • Put Farm Report.jar in the shared folder Farm Report
  • On the first computer
    • Run Farm Report (by double-clicking on Farm Report.jar in the shared folder Farm Report)
    • Use the Set Directory option to set the data directory to the shared folder Farm Report
    • Farm Report will write its data file to the shared folder Farm Report
    • Use Farm Report normally, it will update its data to the shared folder Farm Report
  • On the other computer(s)
    • Run Farm Report (by double-clicking on Farm Report.jar in the shared folder Farm Report)
    • Use the Set Directory option to set the data directory to the shared folder Farm Report
    • You will be asked to "Choose Data File", click Replace
    • Farm Report will read the data file from the shared folder Farm Report
    • Use Farm Report normally, it will update its data to the shared folder Farm Report
Going Forward

Once you have completed the inital set up process on a given computer, you can run Farm Report again on that computer by just double-clicking on Farm Report.jar in the shared folder.  You do not need to do the Set Directory step again.

Method #2 (Cloud Storage)

To be used if the computers are not on the same network, but you have access to cloud storage (Google Drive, Dropbox, etc.).  This method allows you to run Farm Report simultaneously on multiple computers.

Initial Set Up
  • Put Farm Report.jar on each computer
  • Create a folder Farm Report in your cloud storage folder
  • On the first computer
    • Run Farm Report
    • Use the Set Directory option to set the data directory to the cloud storage folder Farm Report
    • Farm Report will write its data file to the cloud storage folder Farm Report
    • Use Farm Report normally, it will update its data to the cloud storage folder Farm Report
  • On the other computer(s)
    • Run Farm Report
    • Use the Set Directory option to set the data directory to the cloud storage folder Farm Report
    • You will be asked to "Choose Data File", click Replace
    • Farm Report will read the data file from the cloud storage folder Farm Report
    • Use Farm Report normally, it will update its data to the cloud storage folder Farm Report
Going Forward

Once you have completed the inital set up process on a given computer, you can run Farm Report again on that computer by just double-clicking on Farm Report.jar.  You do not need to do the Set Directory step again.

Method #3 (Thumb Drive)

If the computers are not on the same network, and you do not have access to cloud storage, you can use a thumb drive.  This method allows you to run Farm Report on multiple computers, but only on one computer at a time.

(A more detailed version of the Initial Set Up instructions (including screen shots) can be found here.)

Initial Set Up
  • Create a folder Farm Report on the thumb drive
  • Put Farm Report.jar in the thumb drive folder Farm Report
  • On the first compuer
    • Insert the thumb drive
    • Run Farm Report (by double-clicking on Farm Report.jar in the thumb drive folder Farm Report)
    • Use the Set Directory option to set the data directory to the thumb drive folder Farm Report
    • Farm Report will write its data file to the thumb drive folder Farm Report
    • Use Farm Report normally, it will update its data to the thumb drive folder Farm Report
    • Exit Farm Report
  • On the other computer(s)
    • Insert the thumb drive
    • Run Farm Report (by double-clicking on Farm Report.jar in the thumb drive folder Farm Report)
    • Use the Set Directory option to set the data directory to the thumb drive folder Farm Report
    • You will be asked to "Choose Data File", click Replace
    • Farm Report will read the data file from the thumb drive folder Farm Report
    • Use Farm Report normally, it will update its data to the thumb drive folder Farm Report
    • Exit Farm Report
Going Forward

Once you have completed the inital set up process on a given computer, you can run Farm Report again on that computer by inserting the thumb drive and double-clicking on Farm Report.jar in the thumb drive folder.  You do not need to do the Set Directory step again.

Check for Update of Farm Report

By default, Farm Report will check for updates to the Farm Report program every seven days.  If a newer version of the program is available for download, a message will be displayed.  The Auto update Farm Report check can be disabled via the Options->Preferences menu.

You can also check for a newer version of the program at any time via the Help->Check For Farm Report update... menu option.

Update Stock Items

By default, Farm Report will check for updates to the stock item lists every seven days.  If updates are available, they will be downloaded automatically.  Auto update 'stock items' can be disabled via the Options->Preferences menu.

You can also check for updates to the stock item lists at any time via the Help->Update Stock Items... menu option.

Thanks to The Dirt Farmer for helping us keep the FarmVille stock item lists up to date.
Revised: 10/22/2014