Birdwatcher's Diary™

for iPhone / iPod Touch / iPad

from Stevens Creek Software

Latest released version: 4.2

Go to the iTunes store to purchase a copy of the software

Version history

Introduction

Birdwatcher's Diary™ from Stevens Creek Software is the perfect birdwatcher's field companion. In seconds, you can make a note of birds you see or hear, including time and exact location (both automatically recorded), and additional field notes if you wish. Later, you can review the sightings, save them on your iPhone, iPod Touch, or iPad for later reference, and upload the recorded information to desktop software or online databases like eBird. Birdwatcher's Diary™ is designed to be useful for your "big day" efforts, Christmas Bird Counts, and for your everyday birding outings alike. This manual will introduce you to the features of the software, which include:

Registering your copy of the software

When you use the software for the first time, you are asked to register the software with us. Doing so entitles you to technical support on the software, and will help us keep you posted about updates to the software, and also provide an opportunity for you to suggest future enhancements of the software. We hope you will take the time to do that so we can best support you (we get no information about our customers from Apple, so if you don't register, we have no way of knowing who you are). If you don't do so the first time you run the software, you can always register later by tapping the "i" (information) icon on the upper-right of the Input/Output screen.

Configuring the software

Some aspects of Birdwatcher's Diary, ones you aren't likely to need to change very often, are configured in the iPhone (or iPod Touch or iPad; from this point on in the manual, we'll refer only to "iPhone," but we mean all three) Settings application, which is accessed from this icon on the Home screen of your iPhone: Settings Icon. We'll discuss each of these settings in the course of this manual. When you see the name of a parameter in this manual shown in Bold Italics, you'll know it's a parameter that you set with the Settings application.

Basic concepts

Birdwatcher's Diary is designed first and foremost to record sightings during a day's birding. To do this, there are four concepts to understand:

  1. The master list or checklist you are using
  2. The location of the sighting
  3. Your list of sightings
  4. The archive of your previous sightings

The master list or checklist is the list of all the possible birds you might see. The software preconfigures itself with either a complete United States list (for most users), or a UK or Mexico list if the software detects you are in either of those two countries. We'll learn later how you can install any list you want, from a complete world list containing 10,000 or more species to your county list containing just a couple hundred species. Many lists are available for download from our website, or, as you'll again learn later, you can make your own as well. For now we'll assume you will start with the pre-installed list.

A location is a named place that you bird, and for which you will be recording sightings with the software. It could be as specific as "My Yard", the name of a local park or other birding spot like "Rancho San Antonio Open Space Preserve" or "Charleston Slough", or a much broader location like the name of a county, a state, or even a country. It's really up to you how specific you want to be in identifying the location of sightings.

The third concept is your list of sightings. In typical usage, you will start each day with a clean slate, a checklist with nothing checked. You'll select the location and then start ticking off species. You can tick each species once, if that's all you are interested in, or you can use the software to count the number of birds of each species seen. If you change locations during the day, just select the new location and keep going. If you're counting, of course you'll continue counting at the new location. If you're "just ticking," you have the option of ticking the species you've already seen at previous locations, which will give you a complete list for each location, or you can just tick the new species that you see — it's up to you.

At the end of the day (or at any intermediate time, if you like to be cautious), you'll take advantage of the fourth basic concept of the software — archiving. Archiving means saving a file of information just as you would on a desktop, but in the iPhone instead. Archiving makes your list of sightings permanent, so that you can clear the list to start anew the next time you go birding. If you want to do something else with the list of sightings — upload it to eBird, email it to your local bird list, import it into a desktop database, or just print it out — you can do that as well.

We started this section by saying that the software was designed first and foremost to record new sightings. Of course you can record old sightings as well, but we'll discuss that later.

One word before we start regarding eBird, the site maintained by the Cornell Lab of Ornithology which allows birders to submit lists of sightings to their online database. You'll find various mentions of eBird throughout this manual, but there are certain aspects of the software which need to be elaborated in more detail for eBird users. You'll find all those covered at length in a special section near the end of the manual. If you're an "eBirder," be sure to read that section before using the software.

Quick Start

This manual explains all the features of the software in complete detail. If you want to get started quickly, just to get a feel for things, here's a quick step-by-step guide to getting started:

  1. Set up a location for birding. Why not start with your home? Tap on NONE on the bottom of the screen, and then on + on the top right of the Set Location screen that appears.
  2. Enter "Home" (or "Neighborhood") as the Location, "HOME" as the Abbreviation, and fill in the Country, County, and State appropriately.
  3. Tap Capture Coordinates to fill in your current Latitude and Longitude.
  4. Tap Find on Map to see where you are. If it isn't sufficiently accurate (as it may not be if your unit doesn't have GPS), tap Update Coordinates and move the map so that the cross-hairs are centered on your home. Then tap Hide Map, and then Save, and finally Done.
  5. You're ready to go. Spot some birds in your yard, and, as you do, tap the bird to record the sighting.
  6. Done? Tap the File button (the folder icon), check that you're in Archive mode with Save selected, enter some Trip Notes, tapping Done when you're finished doing so, and then tap Archive Sightings, and a file of the day's sightings will have been saved on the iPhone. Later you can learn how to transfer this data to your computer (and from there to such places as eBird or Google Maps).

That's all you need to do to use the software, but the software has lots of powerful features, and lots of options. Now it's time to learn all the details about how the software works.

The Main Screen

The main screen that you see when you open the software, looks like this (after having recorded a few sightings):

The central part of the screen displays a scrolling view of the birds in your list. The left-most part of each line is the key to the sighting. A binoculars icon indicates you have seen the bird on this trip. An ear shows you heard the bird, and, obviously, no icon at all is a bird you have not seen or heard.

To "tick" a bird, just tap the name of the bird. If you are counting birds, repeated ticks will increment the count, one for each tap (in a minute we'll discuss how to increment the count by a large number). On your first tap, the software assumes you have seen the bird and displays the "seen" icon (the binoculars) next to it. If you actually only heard the bird, you have one second to tap on the binoculars which appear (not on the name of the bird) to change it to the "heard" icon (the ear). If you do see the bird later on, tap on the ear to access the Edit Sighting screen (discussed below) to change it back to a "seen" bird.

The numbers show the count of each species. On some bird trips ("Big Day" birdathons, for example), numbers may not be of interest. To turn off the display of the numbers (and make a little more room for the names of the birds), set Show Quantity to Off (remember, the fact that Show Quantity is in Bold Italics means that you do so in the iPhone Settings app). On other occasions, like Christmas Bird Counts, the quantities are essential, so you'll want Show Quantity set to On in those cases. Whether you count birds or just tick them off is entirely up to you.

Another configuration option, Display, determines what is displayed in each row. The screen above shows the simplest display, with only the Name of the bird in each row. There are two other options. Name, Note uses two lines to display not only the name of the bird but also a note you have entered about the bird. This might be the Latin name of the bird (which is what it is in the lists we provide), a reminder to yourself about the song ("Rosita, rosita, roseet"), a helpful visual ID reminder ("spectacles"), or anything else you have added. The third option, shown in the next screen, is Name, Time, Location. Here, we see that of the four birds ticked so far on this trip, Bewick's Wren was seen at "GLRWPCP" (more on locations later) on 4/17/10 at 9:17 am, House Wren heard at MTMADONNA at 8:26 am, and so on.


Down the right-hand side of the list is a standard iPhone feature, something we named "Intelliscroll™" when we began using it years ago in our PalmOS software. If you look at the first screen above, you'll see the letters go from A to Y (no Z because there aren't any birds on this list beginning with "Z"). That's the typical way you'll see things on the iPhone, for example, in the Contacts app. But Birdwatcher's Diary goes one step further with Enhanced Intelliscroll™, shown in the second picture. Here, we see what happens when we actually tap on the "W" in the first version. Instead of continuing to display the full A-Z (or A-Y) set of letters, Enhanced Intelliscroll expands the list to include two-letter combinations not only of the letter you tapped ("W"), but also the letter before ("V") and the letter after as well (but since there are no birds starting with "X", you don't see that). The purpose of this is two-fold. First, when you have the full A-Z display, it's common to "miss" and actually tap a letter one above or one below the one you really wanted. Enhanced Intelliscroll allows you to quickly recover from that "mistake" by simply tapping the letter you really wanted. And second, when you have a list of 960 items (here, the birds of North America taken from the list of the American Birding Association), tapping one letter still leaves you with as many as 50-60 birds, of which you're really only looking for one. Rather than scrolling through seven or eight screens to find the bird you want, tapping a two-letter combination will get you that much closer. Once you are in two-letter mode, you can tap "TOP" to return to the top of the list or, more simply, tap the "status bar" (where the time and battery status appear) on the very top of the screen. The latter is a general iPhone technique for scrolling to the top of a displayed list.

Sort Order

Which brings us to the question of sorting order. On the bottom right of the screen, this is the Sort icon: . If you tap it, a list will slide onto the screen giving you five options for sorting the list of birds: First Name, Last Name, Code, Original Order and Time. The list in the screen shots above is ordered by Last Name. This ordering has its pros and cons. For scrolling, as we have just been discussing, a lot of birds start with "SW" (all the Swallows) or "WA" (all the warblers), or many other two-letter combinations. So even with the two-letter Enhanced Intelliscroll, you still may have to scroll through a few screens to find the bird you want. That's the con. The pro is that you don't have to remember that a "Dipper" is really an "American Dipper" or that a "Starling" is really a "European Starling"; you just have to think of the common one-word name of the bird in order to find it. If you're a bit more of an expert, though, you won't have any trouble thinking "American Dipper" or "European Starling," and in that case, you might want to simply sort by First Name. There are many birds with the same first name as well, of course ("American" this or "Black" that or "Lesser" something else), but the duplications aren't nearly as many as when sorted by Last Name. Use whatever works for you. Similar to First Name sorting, but not identical, is sorting by (typically 4-letter) bird banding Code. If you find that mode preferable, it's there to use. Not all birds worldwide have 4-letter bird banding codes, however. The species in the built-in list in the software for United States all have codes attached to them, but that isn't true of the other bird lists we provide.

If you do choose Last Name sorting, there is one more subtlety. If you look in the index of some bird books, you'll find, e.g., Black-crowned Night-Heron listed under "N" and Western Scrub-Jay listed under "S"; in others, you'll find them listed under "H" and "J" respectively. Birdwatcher's Diary provides you with both options, using the Sort "–" as " " setting. If On, "Scrub-Jay" becomes two words and will sort as "J'; if Off, "Scrub-Jay" is treated as one word as sorted as "S".

The other two sorting options are really not optimal for ticking birds, but become appropriate when you want to review or output a list of the birds you've seen. Original Order shows the list in the order in which it was read into the software (again, details on that later). Typically, that list will be in Taxonomic Order, so Original Order will really be Taxonomic Order, but it isn't necessarily so. Time shows the birds in the order you've ticked them (with unticked birds at the bottom). This is useful if someone in your group has been keeping a written list of birds, and you want to compare your electronic list with their written list. You can, of course, quickly switch back and forth between the sorting methods.

Changing what is displayed

The top line of the screen looks like this:

On the left are three grouped icons which determine what we display on the screen below. All shows us the complete list of birds, the "green-eyed binoculars" show only the birds we've seen or heard on the list, and the "red-eyed binoculars" show the birds we haven't seen or heard. This is particularly useful for "big-day" efforts towards the end of the day, when you want to review the birds you still "need."

In the center of the top of the screen are two numbers. The first (151 in this example) represents the number of birds recorded (or, if the "red-eyed binoculars" are highlighted, not recorded) on this trip at all the different locations you've visited, while the second (960 in this example) represents the total number of birds on the list. Your full master list does not have to include the entire list of North American (or British, Venezuelan, etc.) birds, it might just be a list of, say, 200 target birds you might possibly expect to see on a particular trip. Obviously, the fewer the birds on the full list, the easier it is to quickly find and tick them off. We'll discuss later in the manual how you install such lists into the software, but the key point here is that you are not limited to a single master list, but can use as many as you like to make your recording easier.

On the right-hand side of the top line are two planet icons, one plain, and one with a red "pin." When the first is highlighted, the list displays your sightings at all the locations you've visited on this trip. Highlighting the second shows only the sightings at the current location. Now the first number in the center of the line will show the number of sightings at that particular location.

The bottom line of the screen looks like this:

Before we discuss the function of the buttons, one important note: each of these buttons, with the exception of the calculator button at the extreme right, must be tapped and held down for 0.1 second or more to activate it.This isn't a lot of time, and most people will normally tap a button that long anyway. The reason for this is that, in the field, it's very easy to accidentally brush one of the buttons on the buttom (as you pull the unit out of your pocket for example), and put the software into the wrong mode. The short but finite time required to "push" the button minimizes such accidents, and since the calculator button is the only one of these buttons that you will use with any frequency, other than preventing accidents this feature has very little impact on the operation of the software.

In the middle of this line is the most important item, a button showing the abbreviation of our current location ("EEC" in this example). Tapping on the button brings us to the Location screen, and allows to select the relevant location, or add a new one. This is an essential part of the operation of the software. Every time you move to a new location (that is, a new "named" location, not just a new position within the same park or preserve), you need to tap this button and change the location, so that sightings are properly recorded as belonging to that location.

Tapping the Edit button puts the master list into edit mode, and now you'll see this:

Now we have three options. Done puts us back into normal display mode. Tapping the + icon will allow us to add a new species onto our list, in case we started with a shorter list of target birds and suddenly have a vagrant on our hands. Tapping on the blue and white arrow (or, actually, anywhere in that particular rectangle) lets us view or modify the information about that species using the Edit Species screen that will be discussed below (this is not the information about a particular sighting of the bird, but just about the species itself).

The "Folder" icon Folder Icontakes us to the Input/Output screen, where we can save (archive) our day's sightings, access our previously saved sightings, read in master lists of birds, and also output the data back to the desktop (more on this later).

We've discussed the Sort icon, and the final icon on the right end of the bottom line is the Calculator icon: . This icon only appears if, as in the screen shots pictured so far, you are displaying the number of each bird seen. When you are displaying numbers, each tap on the bird increments the count. But what if you are doing a Christmas Bird Count and a flock of 45 Cedar Waxwings flies overhead? You aren't going to tap the screen 45 times! Instead, you tap the bird first to select it (and increment its count by one), and then tap the Calculator icon and you'll see this:

Now you use the screen like a typical calculator. Tap 4 then 4 then + and 44 will be added to the current count for that bird (44, not 45, because when you tapped to select the bird, that added one to the count), and you'll return to the main screen showng 47 Cedar Waxwings. The minus () button is there if you make a mistake and want to subtract out a quantity, and the equals sign (=) is there if you simply want to set the number to a certain number. If you see a huge flock of Western Gulls and you count 1050 of them, tap the species once to highlight it, then tap the calculator and enter 1050 and then tap the equals sign (=) to set the count to that number (or you could enter 1049 and then tap the plus sign; the result is the same).

The Location Screen

To get to the Location screen, tap on the location button in the bottom center of the main screen.

To select a location for your trip, just tap on the name of the location, using the alphabet key which appear down the right-side to scroll quickly to the location of interest if you have many of them. To modify the details of a location tap the "detail disclosure" icon (the white arrow in the blue circle) to the right of the name. To add a new location, tap the + button. When you do either of those things, you'll see this screen, titled either "New Location" or "Edit Location", as appropriate:

The Location name can be as long as you want. The Abbreviation is used on the bottom center of the main screen, which allows enough space for about 9 characters, although 4-8 is probably optimal. The Abbreviation is what is saved with each sighting, so when you add a location, give it a bit of thought, since you won't be able to change it. We recommend using uppercase letters only, but this is not mandatory. Country, County, and State aren't absolutely essential, but are provided for the ability to export that information to external software including eBird, and also for use in filtering life list searches. Note that if you plan to export sightings to eBird, the required country abbreviation for the United States is "US", not "USA".

Finally, we come to the coordinates of the location — Latitude (Lat.) and Longitude (Long.). Depending on your hardware, there are two different ways to obtain this information (actually three, since for some locations you probably can look up the coordinates online and just type in the values). If your unit is equipped with GPS, and/or is in a location where triangulation from either WiFi signals or cellular signals is sufficiently accurate, and you are currently at the location in question, tap Capture Coordinates to capture the latitude and longitude (note that you must have "Location Services" turned on in the iPhone Settings app and with access by Birdwatcher's Diary allowed, or the Capture Coordinates button will not appear). If your unit isn't appropriately equipped, or you are setting up the locations at home before your trip occurs, the second method is to tap Find on map. This method will display a Google Map (which means your unit will need to be online, either via WiFi or cellular connection) like this:

Now you'll use standard scrolling and zooming techniques to zoom in on the location of interest. Note that in addition to putting two fingers on the screen and spreading them apart to zoom, you can also just double-tap on the screen. As you scroll and zoom, the cross-hair cursors move with you, until you finally end up with something like this:

Where you center the location is up to you. We prefer to center it on the parking area for a particular location, but you could place it in the center of the park or lake itself if you prefer. When you're satisfied, tapHide Map to return to the main Location screen where the latitude and longitude will now be filled in with the values from the map.

Finally, tap Save to save the information about the new location.


What is a location?

Exactly what you establish as a "location" for the purposes of the software is entirely up to you. It could be as small an area as your backyard, or as large an area as a state or even an entire country. Most likely all the local spots that you bird frequently should have their own unique location in the software. But if you're only likely to make one trip to, say, Panama in your life, you might well just set "Panama" as a location, and use the Trip Notes field (to be discussed below) to enter more detailed information about the specific location or locations that you actually birded on any given day. Of course if you're recording GPS coordinates for each sighting, those too will specify the precise location of the sighting. But, even if you're only going to visit Panama once, you can, if you want to, establish multiple "locations" for that trip. It's entirely up to you.

If you're an eBird user, you should be aware (and probably already are) that eBird has many of its own "locations" already established (basically because of other users entering data for those locations). If you establish the names (not the abbreviations, which are basically internal to Birdwatcher's Diary) of your locations to match the names of already established eBird locations, then as your sightings are transferred to eBird, they will automatically show up in the "correct" location.


The special location "NONE":

It's impossible to create a "location" to correspond to every single place you spot a bird you want to record. Perhaps you spot an Osprey while you're driving on the highway. You could create a "location" named "Hwy. 280", but then maybe you'll need another one named "Hwy. 85" and another one named "Hwy. 101". Besides, "Hwy. 280" might be 70 miles long, so as a location, it's not very specific! You simply can't create a new location each time, and really need to set up locations only for your "main birding spots," typically local parks and open space preserves, plus probably one called "Home". So what to do about the other sightings? Birdwatcher's Diary automatically includes a "location" named "None", which of course doesn't mean you were nowhere when you made the sighting, but simply that it wasn't at a "named" location. "None" is always displayed on top of the list of locations. You can delete (using the standard iPhone "sideways swiping motion" on the name, followed by tapping the Delete button which appears) or rename (using the Edit Location screen) any of your other locations, but "None" is permanent (ensuring that there will always be at least one "location").

The Sighting Screen

To display (or modify) information about a particular sighting, tap on the binoculars or ear icon to the left of the name of the bird (except within the first second of adding a sighting, in which case tapping on the binoculars ("seen") changes to the ear ("heard only")). You'll see this:

This screen displays, and allows you to modify, many aspects of a sighting:

Tap Hide Map to return to the Sighting screen, or tap Update Coordinates if you want to change the location of the sighting. The recorded coordinates (and the pin location) show where you were standing when you saw the bird, so if you want to record the actual location of the bird itself, this provides you a way to do that.

More now about some of these features:

Sighting Notes:

To insert a standard phrase in your sighting notes, just tap on Insert Phrase, and a scrollable list of phrases will appear:

Tap on any phrase and it is inserted into the Sighting Notes. Tap on another phrase to insert another note, separated automatically by a comma, or tap in the Sighting Notes field to use the keyboard to enter your own words. To add your own word or phrase to the list for frequent use in making notes, enter it in the box at the bottom, and tap Add new. Finally, to delete phrases from the list or to reorder them so that the words and phrases you use most appear at the top and don't require you to scroll, tap the Edit List button and the list will look like this (and the Edit List button will change to read Done):

Tap the minus sign on the left side to delete the item, or use the "handles" on the right side to move an item up or down to reorder the list. Tap Done when you are finished modifying the list.

Recording multiple sightings of the same species at the same location

In general, Birdwatcher's Diary records the details (time, coordinates) of only one sighting of a species at each location. If you tap the name of the bird on the main screen multiple times, the quantity is incremented, but the coordinates and time are not changed and only correspond to the very first sighting. In some cases, however, you may wish to record the coordinates and time of every sighting. Perhaps you are doing a survey of all the Bluebird boxes in a particular preserve, or want to record the location of every Burrowing Owl burrow. Setting the Multiple Sightings setting to "On" activates this mode. Then two additional settings, Min. Time and Min. Distance, specify how far away you have to be to record a new sighting when you tap that species. Min. Distance applies if you have GPS enabled, while Min. Time applies if you do not. So with GPS enabled and Min. Distance set to 1000 ft., for example, if you tap on a species and move less than 1000 ft and then tap again, you will have one sighting with a count of two. If you moved more than 1000 ft. between taps, then after the second tap you would have two sightings with a count of one each.

When you have multiple sightings enabled, if you are displaying sightings from the current location only (on the top right of the main screen, the globe with the red pin is highlighted), then there is a special mode for the display of the sightings:

The number superimposed on the binoculars represents the number of sightings at this location, while the number to the left of the name of the species is the number of birds observed in the most recent sighting. This makes it easy to confirm that a new sighting has been recorded. If you are displaying sightings from all locations (the plain globe on the upper right of the main screen), then the number adjacent to the name of the species shows the total count of all birds of this species, and will simply increment with each tap.

Recording Coordinates (Latitude/Longitude):

Birdwatcher's Diary provides three different modes for recording the precise coordinates of each sighting, controlled by the Lat./Long. setting. All Sightings uses either GPS (if present, as it is on the iPhone 3G and 3GS and the iPad with 3G service but not on the original iPhone, the iPod Touch, or the iPad with WiFi only) or WiFi or cell tower triangulation to pinpoint the coordinates (latitude and longitude) of each recorded sighting (either the first sighting at each location or all sightings, depending on the Multiple Sightings setting).

You may not want to record the precise location of every bird. Perhaps you only want to record "special" birds, like a Pileated Woodpecker or a Bald Eagle. In that case, set Lat./Long. to Manual. In this mode, when you want to record the coordinates of a sighting, you edit the sighting as described above, and use either the Capture coordinates or the Show on map button to record the coordinates. Other sightings adopt the general coordinates of the location itself.

The third mode is called No Location Sightings. With named locations, you will at least know you saw the bird at Arastradero Preserve, or Rancho San Antontio, etc., and, if you have set the coordinates for those overall locations, the software will know approximately where the sighting occurred. But when the location is set to the special value "None," the software has no information about where you are, so there are no approximate coordinates (the coordinates of the location itself) to rely on. So if you set Lat./Long. to No Location Sightings, when and only when you have the "location" set to "None," coordinates of each sighting will be automatically captured and recorded. When you are at any named location, No Location Sightings functions exactly in the same way as Manual, that is, it does not record coordinates for any sighting automatically, but of course you can always do so manually for a bird of interest.

Of course you can always modify or update the coordinates of any sighting, no matter what the mode you have chosen, using the Capture coordinates or the Show on map buttons.

So that you'll know the status, the color of the text on the bottom of the screen showing your current location changes color based on the current accuracy of the reading, compared to the value of Max. Inaccuracy, which you can set to values of 100 meters, 250 meters, 500 meters, or 1000 meters (For the metric-challenged, a meter is approximately one yard; 1000 meters is approximately 0.6 mile, and for the technically-minded, this is really "precision," not "accuracy"). If the inaccuracy is 150% or more of your desired accuracy, the text will appear in red; between 100 and 150% and it will be yellow, and if it is less than or equal to your desired accuracy, the text will be green. If you are not currently in a mode where you are recording coordinates (either Manual mode, or No Location Sightings mode and a location other than "None"), the text is white.

If you are recording sighting coordinates automatically, and you tap on a bird when the text is red or yellow, the software will decline to record the coordinates, notify you that it is doing so, and give you three options: Try Again will re-measure the location and attempt to get better accuracy, and Record Anyway will record the sighting without specific coordinates (which will be equivalent to the "generic coordinates" you established for the overall location).

Depending on the kinds of places you bird, and the density and proximity of cell-phone towers, you may find that capturing coordinates (either automatically for each sighting or manually for special sightings) is insufficiently accurate to be of any use whatsoever unless your unit is equipped with GPS. If your unit does not have GPS, you most likely will find that, outside of urban settings, only the Manual mode of recording coordinates, and only the Find on Map method of specifying the coordinates, is of any use.

Mapping all your sightings

We saw on the Sighting screen how we can display on a map the exact coordinates of a particular sighting, and on the Location screen how we can display the coordinates of that location itself. If we go to the Location screen after having recorded a bunch of sightings, and now tap the Show on map button, we'll see something different than we saw before:

In this view, the "home" coordinates of the location are shown by a Bird House icon. Green pins mark the location of birds which were seen or heard. Tapping on any pin shows a label which includes the name of the bird (with an "(H)" at the end if the sighting was a "heard-only" sighting), and the date and time of the sighting. The map is automatically scaled so that all of the sightings will fit on screen. Of course you can zoom in on the map and view the map in a "hybrid" mode too, like this:

Birdwatcher's Diary doesn't allow you to save one of these screen maps. However, you can do a "screen capture" of any screen on an iPhone by holding down the power button on the upper-right (top) of the unit, and then pressing and releasing the round "Home" button on the bottom front of the unit. A picture of the screen is then put into your photo library, just as if you had snapped it with the camera. When we get to the Output section of this manual below you'll learn how you can export information to Google Maps and Google Earth to view full-size maps you can view on your desktop.

Archiving: Saving and Recalling Lists of Sightings and Generating Life Lists

Saving each day's sightings

The Folder icon on the main screen brings you to the Archive/Input/Output/Lists screen, which looks like this when in Archive mode (as selected on top of the screen):

At the end of each day's sightings, we recommend visiting this screen. The software keeps track of the date of your most recent sighting, and it will appear in the Date field, although of course you can change it. The number of sightings for that day is displayed, which will help confirm that you've got the right day. Enter some Trip Notes to describe the trip, after (typically) first using the Clear Note button to erase the previous notes. Finally, tap the Archive Sightings button at the bottom to actually save the data into a file on the iPhone (it's automatically named so you don't need to provide a name). After you have saved your data, if you add or delete a sighting, or you decide to update the Trip Notes, just return to this screen and tap Archive Sightings again; the updated data will replace the earlier data (after you confirm that you really do intend to overwrite the previous archive for that day with the new archive). If you're done with birding for the day, and have saved or outputted your data in one or more formats, feel free to go ahead and tap Clear all sightings to be ready for your next outing.


Archives are always daily, with a maximum of one per day

The archive system built into the software is designed as a daily archive. Each archive contains only a single day's sightings, and there is only one archive per day. This allows the software to generate internal filenames without having to trouble you with naming each archive, and later recalling the name that you used, as you have to do with "normal" files on your desktop computer.

As you'll see shortly, when you want to recall older sightings (that is, archives from previous days), it's a simple matter to recall multiple days at the same time, so if you've taken a multi-day trip, you'll be able to see the complete list from the entire trip with no problem. However, each day of the trip will be stored in its own archive.

It is possible to record multiple day's sightings on the main screen, if you simply continue from one day to the next without archiving each day and without clearing the sightings to begin the next day anew. However, if you do that, either deliberately or accidentally, and then want to archive the data, you will still need to archive each day of the multiple days one at a time. You do this simply by changing the date on the Save Archive screen and then tapping Archive Sightings to archive the sightings for that particular day.

Of course, if you routinely output (described below) your sightings in order to upload them to, e.g., eBird or some other desktop-based or web-based software, you don't need to archive the sightings within Birdwatcher's Diary at all. We recommend you do so, however, because the archives take up very little room in the memory of your unit, and they will make the software that much more useful to you as time goes on.


Recalling previous sightings

To recall previous sightings, tap the Recall button (we'll be discussing the Edit button below), and the screen's appearance will change so that it looks like this:

The main part of the screen is occupied by a list of your stored files in chronological order, latest at the bottom. The list will automatically scroll to the bottom when you first view it so you'll see the most recent sightings; scroll up to view earlier days. To scroll to a particular date (perhaps the date of last year's CBC or birdathon), tap the calendar icon and select the date you want.

The screen shows the date of the trip, the one or more birding locations you visited during the trip, and the first part of your trip notes to help you decide which is the correct entry. Tapping any entry will recall the sightings from that day's trip. Replace or Merge specifies what will happen when you recall the sightings. If Replace is selected, those sightings will now be the only sightings displayed on the main screen of the software, while if Merge is selected, those sightings will be added to those already on the main screen.

As most birders know, particularly those who record their sightings, periodically the birder's world is treated to the phenomena of "splits" and "lumps." Two sub-species of the same species are now treated as two separate species, or, conversely, two separate species are now treated as two sub-species of the same species. There are also cases of simple re-naming of species. In all these cases, if you have sightings recorded in your Birdwatcher's Diary archives, those archives are suddenly "wrong." What to do? You'll find step-by-step instructions for updating your old sightings in a later section of this manual.

Generating Life Lists (or Year Lists, County Lists, State Lists, Trip Lists...)

Instead of recalling just one day's sightings, you may wish to read in a group of sightings. Reading in all the stored data will produce a "life list," or at least as much of a life list as you have been recording with Birdwatcher's Diary. But you may wish to produce a life list which is restricted in some way – by date, by location, by state, etc., and Birdwatcher's Diary is designed to let you do that as well. To create any list (full or partial), tap the Year/Life List on the screen above and you'll see this screen:

The From/To dates set the time period for the list that will be generated. Leave the From field blank to start with the oldest of all your saved data, and leave the To field set to today's date (which it defaults to) to include all sightings through the present, or change both of them to specify a particular date range (e.g., this month, this year). Location is the abbreviation of the location you want to restrict the list to; tapping on this field will display a list of your locations, allowing you to choose one. Country, State, and County should be self-explanatory. Trip Notes lets you restrict the recalled sightings to those which occurred on trips whose notes include that word or phase. In this example, we had a series of days of saved sightings which occurred during a trip to "Lake Almanor," although the actual locations for each day's sightings varied (e.g., LASSEN, WILLOWLK, ALMANOR, etc.). But because we entered "Lake Almanor Trip" in the notes for each day's sightings, this selection will recall all five day's sightings at once, thereby producing a multi-day trip list. Sighting Notes searches for particular sightings whose notes match the word or phrase you enter. For example, you might enter "Breeding Plumage," thereby producing a life list of all the birds that you've seen in breeding plumage (assuming you entered that phrase in the sighting notes for each of those sightings). Or you might enter "Photo" and produce a year or life list of all the birds you've photographed (again, assuming you entered the word "Photo" in the sighting notes). And finally, First Sighting Only lets you recall only the first sighting of each species, which is actually what most people think of when they talk about their "life list." If you do not check this box, all sightings of a species which fit the specified criteria are recalled.

You can use multiple criteria at once, so, for example, you can generate a list restricted to this year of all the birds you've seen in Santa Clara County which you have photographed.

Once you've entered your criteria (or not entered any criteria, in which case you are requesting a real "life list"), tap the Create List button on the upper right (or tap the Cancel button to change your mind). The software will generate the list, and also display a summary of what you've produced, like this:

If your main screen display is set to display quantities, as in the image above, the number displayed is the total number of birds across all the sightings of that species. If your main screen display is set to a two-line display, with the second line showing location and date, then the location and displayed date shown is that of the first recorded observation of that species. To review all the sightings of a particular species (assuming you did not check the First Sighting Only box), tap the binoculars icon and the complete recorded details of the first sighting of the species will be displayed on the Edit Sighting screen. Now you can use the forward arrow icon in the lower-right of the screen to page through the different sightings of that species.

There is one subtle point when recalling archived data (and life lists, which are just a way of recalling more than one set of archived data at a time). If a sighting includes a bird which is not part of the currently active master list, it will be added to the list. If, for example, your currently active master list is your state list, the recalled life list will still include birds you saw in other states or countries (unless you limited the criteria for the search, of course).

Master Checklists

The final option on the Archive/Input/Output/Lists screen is Lists, which allows you to save and recall master lists of birds. While Birdwatcher's Diary includes Enhanced Intelliscroll™ for what we believe is the fastest possible method of searching through long lists, you'll be able to tick off the bird even faster if you are using a shorter list containing only the birds you might possibly see. Having the software search through a complete list of world birds makes no sense; even searching through a complete list of North American birds may be unnecessarily time consuming.

Recalling an existing master list

In Recall mode, the Lists screen looks like this:

There are two options when you recall a master list: Replace and Merge. In Replace mode, the list you recall you completely replace the list you have been working with, and will delete any existing sightings which you have recorded on the main screen. Typically you will only load a new list when you have gone to a new county, state, or country, and are just beginning birding, so this won't be a problem.

Merge mode has two principal uses. The first is to expand your list by geography. Let's say you are working with a Santa Clara County list, and you see a first sighting for the county. Or perhaps you just stray over into San Mateo county, and see a species which isn't on the Santa Clara County list. If you don't have any sightings recorded, you can just recall a "bigger" list (e.g., a California list) using the Replace mode, but if you do have sightings recorded, just recall the bigger list using Merge mode. This will merge the two lists (that is, it will not produce any duplicates), without affecting the sightings you've already recorded on the main screen.

The second use for the Merge function is to merge a separate list of so-called "spuhs" like "Gull sp" into a main list which doesn't include them. Our standard lists (United States, Mexico, United Kingdom) contain only "real species," not "spuhs." If you create a separate list of the latter, you can use the Merge function to merge those in with any of the other lists.

Default is one special case on the list of master lists that you can recall. It's "grey'ed out," but that doesn't indicate it's not active, only that you can't delete it (you can delete any of the others by swiping to the right and tapping the Delete button that appears). Default will restore the "factory default" list that appeared when you first installed the software, which is either the U.K. list if you're iPhone is configured to indicate that's your home, the Mexico list if that's where you are, or otherwise the U.S. list.

Downloading new master lists from Stevens Creek Software

We maintain what we hope will be an ever-growing list of bird lists you can download on our website. Click on this link to see the list of current lists (feel free to email us to ask for any that you need that aren't on the list). Here's how you can download any one of them directly into your software:

  1. In the iPhone Settings app, in the Birdwatcher section, find the Input Base URL setting and verify that it is set to www.stevenscreek.com/iPhone/BirdLists (if you purchased the software starting with version 4.2 or later, this will be the initial default value, so you shouldn't need to enter it; if you have been using the software prior to the release of version 4.2, you will).

  2. From a browser (either on your iPhone or your desktop), visit the page http://www.stevenscreek.com/iPhone/masterbirdlists.htm and decide on a list that you want to install.

  3. On the Input section of the File screen of Birdwatcher's Diary, make sure that On Download is set to Replace, and Contents is set to Master List. Enter the name you chose in step 2 into the Filename field, making sure to include spaces. For example, enter New Jersey. You don't need to add any extension; the software automatically adds a .lst extension if it's not there, which is what is appropriate for the files on our website.

  4. Tap Download and (assuming your iPhone has Internet access) the chosen master list will be downloaded. It will become the new active list on your main screen, and, simultaneously, it will be saved with the rest of your lists (accessed on the Lists screen) for later instant recall.

  5. Repeat steps 2-4 as often as you like to download as many lists as are appropriate.

Downloading your own master lists

In addition to the lists on our site, you can easily create your own lists on the desktop and install them. To do this, you create a text file on your desktop (a plain text file, not a Word or other formatted text file) contain three columns of information, separated by tabs. Those columns contain, in order, the name of the species, the bird-banding or other code for the species, and a note for the species (in our lists, we use the Latin name as the note). The second and third columns can be blank, that is, a line in the file could consist simply of a species name followed by two tabs, but they must be present. You must also give the file an extension of ".lst", e.g., MyState.lst (note that some text editing programs will require that the extension of the file be .txt; if this is the case, you'll then need to rename the file on the computer, after it has been saved. Now use iTunes to add the file to the iPhone as described in the section below entitled "File Sharing via iTunes." The next time that the software starts, it will notice the file ending in .lst and move it into the Master Lists folder (which you cannot do directly with iTunes), and it will appear on your "list of master lists" to choose from.

Creating and saving a master list directly on the iPhone

The Save lists screen is much simpler:

Filename is the name which will appear in the list of master lists on the Recall screen. Unlike other filenames we use for input and output in the software, in this case you will not want any kind of extension (e.g., ".txt"), just the name of the list (e.g., "My Backyard"). Internally, the file is given a ".txt" extension, but you'll never see that unless you export the list to your computer as described below in the Output chapter.

The Seen or Heard option is the simplest way to save a new list if you are creating a shorter version of an existing list. Perhaps you would like to take one of our state or country lists, and make a list of only the species which are regularly seen in that state or country (the standard lists contain every species which has ever been seen, even just once or twice). Another thing you might want to do is to make a target list for your Big Day effort, by pruning a county or state list to contain only those species that you have any chance of seeing on the chosen day. To do this, load the main list that you want to start with onto the main screen, and then go through the list, tapping on all the species that you want on your shorter list. Now come to the Lists screen, select Save and then Seen or Heard, and when you tap Save List, a new list of only those species will be created, ready to be recalled at any time. You'll probably want to then go to one of the other screens to tap the Clear all sightings button, since these were of course not actual sightings you wish to save.

All will save the complete list of species on the main screen. But how might that have changed? First, you could have used the Input section of this screen (described below) to read in a text file containing the new list, and now you simply use the Lists screen to save that list directly on the iPhone, where it will be available at any time, without having to download it again. Or second, you may have modified one of our standard lists. Perhaps there has been a "split," and we haven't updated our master list yet. You could simply add the new species (as described in the Edit Species section below), come to this screen, and save the list (it's ok to save a list by the name of an existing one; you'll be asked to verify that you want to overwrite the old copy). Or if there was a "lump" (two species now considered one species), you could use the Edit Species screen to delete the species which "no longer exists," and then save the list using this screen (again, simply overwriting the old copy).


IMPORTANT: There is one very important thing that you must do if you save your own lists in this way. Before you save a list, you should sort the list in "original" (taxonomic) order. If you save the list in, say, last name order, then when that list is recalled, "original order" will be last name order, and you will have no way to sort into taxonomic order. That may actually be unimportant to you, in which case, don't worry about it, but if being able to sort in taxonomic order is important, than make sure that when you save lists, they are in that order when you do.


Adding or Deleting Species using the Edit Species Screen

As mentioned earlier, tapping Edit on the main screen allows you to then tap the name of a species to modify the information about that species (not about a sighting of the species), or to tap the "plus" icon on the bottom line to add an additional species or "pseudo-species" (e.g., "Gull sp.") to your master list. You'll see this screen, either blank if you are adding a new species, or already filled in (with the top reading "Edit Species Info") if you are modifying an existing entry in the list:

The Name of the species is just that. Do not enter it in "Last Name, First Name" order; if you typically sort in that mode, the software will take care of things for you. The only restriction in entering the name is that, if you do want to enter a generic name like "Gull sp." or "Dowitcher sp.", do so exactly like that, with a space and then the letters "sp" and a period (rather than, e.g., "Gull, sp." or "Gull (sp.)" or any other variation). This is because, when the software sorts the names in alphabetical order by last name, it knows to look for "sp." at the end and ignore it, so "Gull sp." will be sorted with the gulls and not with the sparrows.

The Code is a place for a code such as the common 4- or 6-letter codes in use for bird identification, or any other coding system you want to use. Birdwatcher's Diary does not actually use this information itself unless you are sorting by code, but if you are exporting the data to other software which requires a code to properly read the information, then it will be essential.

Finally, Species Notes is a place for you to insert notes about the species which you'll find useful (notes about a particular sighting are entered on a different screen described below). In many, though not all, of the lists we provide, the species notes contains the Latin name of the species. As mentioned above, you might add notes about the bird's song or call, its appearance, its behavior, or anything else of interest (perhaps you're a photographer, and you want to add a note like "need photo" as a reminder). One display option allows you to show this information on the main screen. Your Species Notes can be as extensive as you like, but if you display them on the main screen, only a small space is provided. On the Species screen itself, however, the box you see pictured above is a scrolling box which accomodates as much text as you want to enter.

The Save and Cancel buttons are self-explanatory.

If you are modifying information about an existing species, you'll see at the bottom of the screen a button labeled Delete species from master list, which does just that after requiring confirmation. This might be of use if you want to prune out birds from a longer list that you are never likely to see, in order to make the software more responsive.

Dealing with Renames, Splits, and Lumps

Periodically bird species are renamed (e.g., Common Moorhen to Common Gallinule), split into two species (e.g., Winter Wren into Pacific Wren and Winter Wren), or two species are combined or "lumped" into one (Myrtle Warbler and Audubon's Warbler into Yellow-rumped Warbler). We attempt to keep up with such changes with the lists that we make available, but it's not always easy to do so (for example, some changes may be recognized in one country but not in another). Furthermore, even if all our lists were updated instantaneously, there would still be the issue of the sightings you have already recorded and archived in the software.

For this reason, we have built a tool into the software to allow you to make such changes yourself. On the Archive and Lists screens, next to Save and Recall you'll find an Edit option. Tapping on this button will reveal the new Edit Lists & Archives screen:

On top are the three different types of changes - Rename, Split, and Lump. On the bottom are the three choices for updating - Lists (only), Archives (only), or Both. In between are a number of fields which will change depending on which type of change you are implementing - splits and lumps obviously requiring more information than a simple rename. You must fill in the fields containing the names of the species - two such fields in the case of renames (as shown above), three in the case of splits of lumps. Bird-banding codes and Latin names (which go in the Note field) are optional; if you leave them blank and one of the names remains the same, they will be carried over (for example, if you split Winter Wren into Pacific Wren and Winter Wren, the existing code and Latin name for Winter Wren will be retained, while the code and Latin name for Pacific Wren will be left blank unless you provide it.

Archives contain only the species name, not the code or Latin name, so if you are only modifying your archives, you need not worry about the Code or Latin name values.

All three modes (rename, split, and lump) apply to Lists. Species in archives can be renamed or lumped, but they can't be split, since the software would have no way to know which of the two "new" species names was the relevant one. If there has been a split that affects your archives, you need to proceed as follows:

Let's say you want to deal with the split of Winter Wren. If your archives contain only sightings of the species which is still called Winter Wren, you obviously don't need to do anything to your archives. If they contain only sightings of the species which is now called Pacific Wren, just use the Rename mode, set the software to modify only Archives, rename your archives from Winter Wren to Pacific Wren, and then go to Split mode (which you don't actually need to do in this case, because the existing lists already reflect this split, but this is just an example) and apply the Split to Lists only. Now if you have archived sightings of both species, you'll need to go through your archives manually, after you have updated the lists. Here's a step-by-step example: Let's say you live in California and the bird formerly known as Winter Wren is now Pacific Wren (Winter Wren being the name for the eastern species), and that most of your sightings are of the species now known as Pacific Wren.

Here's how to update your sightings:

  1. Use the Rename feature of the Edit Lists & Archives screen, set to Archives only, and rename all sightings of Pacific Wren to Winter Wren.

  2. Go to the Archive screen and set Recall and Replace modes, then tap Year/Life List.

  3. Set the criteria to recall all your sightings, which should be the "default" mode in which the screen appears, with all fields blank except the "To" date set to today's date. Tap Create List (which may take a while). Tap OK when the life list information appears.

  4. Find the bird of interest (Pacific Wren in this example). Tap its binoculars icon.

  5. You now have all the recorded sightings of that species, indicated on the top of the screen as, e.g., "Edit Sighting 1/12." Using the "forwards arrow" at the lower right to step through the sightings, examine each sighting and decide which ones were of the eastern species (Winter Wren), writing down (on paper!) the various dates on which those sightings was recorded. When you're finished, tap Cancel.

  6. Return to the Archive screen (with mode still set to Recall and Replace). For each date you recorded in step 5, find that date on your list and tap it to recall that day's sightings. Find the sighting you want to edit and tap the binoculars to edit that sighting. Tap the species name, and change it (e.g., from Pacific Wren to Winter Wren), then tap Save. If you aren't 100% sure which species was the one you sighted, you could even add a note to the sighting like "Possibly Pacific Wren."

  7. Return to the Archive screen and go to Save mode. The Date should be set properly to the date of the sightings you are editing. Tap Archive Sightings and you'll get a message asking you to confirm that you want to Overwrite the previously archived sightings for that date. Tap Overwrite to proceed. Repeat steps 6 and 7 for each date on which the bird was sighted.

One special feature of the Edit Lists and Archives screen is that, when two species are lumped, when the software updates your Archives it will make a note of the original name in the Note field of the sighting. So if you had recorded sightings as Myrtle Warbler and Audubon's Warbler, and then lumped the two into Yellow-rumped Warbler, in the sightings of the former the Note field would read "Was: Myrtle Warbler" and in the latter would read "Was: Audubon's Warbler," so that you would still have a record of the appropriate sub-species.

Introduction to Input and Output

In addition to its internal archives, in which you save and recall your sightings for different days, Birdwatcher's Diary allows you to output your sightings. It also allows you to input lists of previous sightings and master checklists of species for different locations. There are multiple methods for doing both input and output. One is via "file sharing" which uses Apple's iTunes software on the desktop to let you copy files from computer to iPhone and vice-versa. A second method which can be used for both input and output is the iPhone "clipboard." Information can be copied onto the clipboard in Birdwatcher's Diary, and then pasted into another application on the iPhone, such as Notes or Mail or Safari (which lets you create an email containing your sightings in, e.g., Hotmail and send it out right from the iPhone). Conversely, you can copy information from another application, perhaps a list of birds, and paste it into Birdwatcher's Diary. You can also email information (like a sighting report) directly from within Birdwatcher's Diary, without having to use the clipboard and transfer to another application. Still another method of getting information into the software is by downloading directly from the web or from your own computer which has been configured as a "web server," and another method of getting information out of the software is by uploading using a technique called "ftp" (file transfer protocol). These last two methods of input and output are by far the most intimidating, but also the fastest and easiest in practice once they are set up.

There are other issues involved when files are input and output from th software as well. Depending on whether files contain only "plain" characters in the Roman (Latin) alphabet, or whether they contain accented characters or such things as "smart" punctuation, files can be "simple" text files or they may be the more unfamiliar "Unicode" text files. And, depending on whether the computer involved with the input or output is running MacOS, Windows, or Unix (Linux), the character or characters at the end of each line is different!

Suffice it to say that some of these subjects are rather complex, and you may not actually need to deal with any of them. For that reason, we cover them all in a separate document, which you can access by clicking here. To start with, you'll be most concerned with outputting data from the software to your desktop, and for that, you can start with email which is simplicity itself, involving only entering your email address and specifying what kind of computer you'll be reading the email on. You do both of those things (as well as all the other configurations necessary for the other methods of input and output, should you need them) in the iPhone Settings app in the Birdwatcher section.

Before we discuss specifics of output and input, let's discuss iTunes file sharing in general.

File Sharing via iTunes

Beginning with iOS 4, it is possible to share files between computer and iPhone. Files created on the computer can be installed in the iPhone, and files created on the iPhone can be transferred to the computer (the iPhone must be connected to the computer in order to do this). In iTunes (version 9.2 or higher), when you select your iPhone in the left (under "Devices"), and then select the Apps tab on the top of the screen, on the bottom portion of the screen (you'll need to scroll down) you'll see a section entitled "File Sharing."

On the left will be a list of applications which support file sharing; Birdwatcher's Diary (labelled "Birdwatcher") will be one of them. Select "Birdwatcher", and in the right-hand column you'll see a list of the files on the iPhone that you can upload to your desktop. Locations.txt is a tab-delimited file of your locations including all associated information (state, coordinates, etc.). Phrase List.txt is a list of your stock phrases for use in sighting notes. Archived Sightings is a folder containing a series of files, one for each day's sightings that you have archived, named using a "YYYYMMDD" format (e.g., 20100713.txt). And Master Lists is a folder containing the various master lists of birds in your software. To upload any of these, highlight the file or folder, tap the Save to... button (which will become active when a file or folder is selected), and specify the desktop computer location where you want the file or folder stored. At this time, iTunes doesn't support opening folders, so the entire Archived Sightings or Master Lists folders must be uploaded at once, and not just a single file within them.

iTunes normally backs up all the information (including these files) whenever you sync the iPhone, but it does so into an encrypted file which is only accessible by iTunes itself. Saving these files (which are all simple text files) using the method described in the previous paragraph is an excellent way to produce a redundant and potentially more useful backup, and doing so periodically (and then transferring the saved files onto a separate medium like a CD, DVD, or online backup site like Dropbox) is a highly recommended option. You are spending a lot of time birding, and you wouldn't want to lose your lists!

To transfer a file into the iPhone, tap the Add button and select the file from your computer to transfer to the iPhone. You might, for example, share your Locations.txt or Phrase List.txt file with a friend who could then install the identical list in their copy of Birdwatcher's Diary. Or you might transfer your Phrase List.txt to your computer, add a bunch of phrases to it, and then transfer the revised file back to the iPhone, rather than having to enter the new phrases on the iPhone.

Because you can't transfer files into folders in the iPhone, you can't add files directly into the Archived Sightings or Masters Lists folders. However, Birdwatcher's Diary provides a special way to do that. If you add a file ending in .lst (e.g., MyState.lst), the software will recognize that as a master list file, and the next time you start the software, it will move the file into the Master Lists folder and change its extension to .txt. Similarly, a file ending in .bwd (e.g., 20110612.bwd) will be recognized as an archived sightings file, and will be moved into the Archived Sightings folder with its extension changed to .txt the next time the software starts. CAUTION: you should not transfer .bwd or .lst files into the software in this way unless you are absolutely sure their format is 100% identical to the standard format used by the software, because no checking of the contents of the files is performed when you do this.

Output

Output Your Sightings

Selecting Output mode on the Archive/Input/Output/Lists screen puts you into output mode:

Output Format

Let's start here with what we are outputting (uploading) and return to the how and where after that. There are three choices for what to Include:

Beginning with version 3.6 of Birdwatcher's Diary, there are two options in the Settings app which affect the output. Output Orderspecifies the way in which the output will be sorted, independent of the way in which they are displayed on the main screen of the software. The options for Output Order are the same as the main screen Sort order (Last Name, First Name, Code, Taxonomic Order, and Time), plus one more: As Displayed (which outputs the information in the same order as on the main screen).

The second option is Group by Location. Until version 3.5, output was always grouped by location, with the consequence that if you birded at multiple locations in one day, and wanted to produce a single list of all the birds you saw all day in, say, taxonomic order, you couldn't do that. In 3.5, we changed the software so that the output was not grouped by location. Beginning with 3.6, Group by Location now gives you the control over whether or not this happens. The one exception is that, if you output data to eBird, they are grouped by location no matter what the setting, because eBird requires that (since it treats each location as a separate "checklist").

The Format of your output has four choices:

The Output Format Table on the bottom of the screen is a scrolling list (that is, you need to scroll to see all the items on the list) of the various items which are recorded by each sighting (Name, Quantity, Date/Time, etc.). You use this table to specify exactly which of those items are included when you output your sightings in either the Report or Custom formats (the formats for eBird and GMap are fixed). Items on the left side of the table in bold are included in the output, while items on the right side of the table in italics are excluded. To move an item from one column to the other, just tap on the item. To re-order the items (e.g., in the example above, perhaps you want the Name to come first, and then the Quantity), grab the "handles" on the right end of each line and move the item up or down. There are two pairs of potentially confusing items in the list of items you can output or export. One is Sighting Location and Full Location Name. The former is the abbreviation for a location used by the software, and will be most useful when re-importing this data back into your or another copy of the software (perhaps a birding companion). The latter is, as it says, the full name, not the abbreviation. The other confusing pair is Note, which is the note attached to the species (often the Latin name of the species in the lists we provide), and Sighting Note, which is the note attached to a specific sighting of the species.

The Filename is of your choosing, but if you enable Auto Filename in Settings, then the name is automatically generated by combining the current location and the date. Even with Auto Filename turned on, though, you can still change the name if you want it to be something different.

In all formats, there is one additional piece of information which is output along with the individual sightings — your trip Notes. This is a place for you to record overall notes - the weather, your companions, or other general observations pertaining to the day as a whole. Tap the Notes button and a screen will appear allowing you to enter whatever you like.

When you select eBird, you'll see four new things used for transferring data to eBird:

eBird has four "protocols" for reporting sightings – Casual, Stationary, Traveling, and Area. You can read the specifics at the eBird site, but for most typical birding outings, Traveling will be the protocol of choice. For the Traveling protocol, eBird wants to know the Distance you travelled and the time (Duration) you spent. You can enter these values manually or allow Birdwatcher's Diary to calculate estimates of those numbers by checking the Calculate box. The Duration calculation simply takes the time between your first sighting and your last sighting and rounds up to the nearest 15 minutes, which seems precise enough for eBird's requirements, and will work in all cases. The Distance calculation calculates the distance from one sighting to the next, which is obviously approximate since it assumes you walked in straight lines from one sighting to the next, but again, in most cases it will be perfectly adequate as an estimate (and of course if the estimates seem wrong you can simply uncheck Calculate and enter them manually.

Note that the manual entry will only work if you are uploading data to eBird for a single location. If you have data for multiple locations, and want to upload them all at once (that is, Seen or Heard is selected and not Location), then you must check Calculate to calculate the Distance and Duration at each location (if you don't, the same distance and duration will be uploaded to eBird for each location).

If you use the Area protocol, the word "Distance" will change to "Area", and only manual entry is possible (i.e., no automatic calculation).

# Observers is another parameter requested by eBird.

If you have not counted any species, but only ticked them off with all quantities as one, eBird does not want you to report them as quantity one, but as uncounted. In this case, however, you do not have to go through each sighting and mark them as uncounted as described above. Instead, when you go to transfer the results to eBird, you should select Report Only As 'Present' on this screen. If you have counted birds, then of course you'll select Report Counts.

Output Method

Now, for all these formats, how is this information being output from your unit? There are several choices:

One more parameter affects the output, and that is the Date/Time Format setting. Internally, the software always keeps track of both date and time, but you may not find that interesting or useful in files that you output. You can set the Date/Time Format to Date,Time, Date Only, or Time Only. In the latter mode, the date (if you are outputting sightings from a single day) is automatically appended to the Note field (on output only). And if you generate a Life List (or County List, Year List, etc.) and your preferred Date/Time Format is Time Only, the software will temporarily override that setting and include the dates and times, since your sightings were from different days so Time Only won't be very informative.

The Information ("i") icon on the upper-right gives you a choice of reading this online manual and registering your software with Stevens Creek Software (optional but allows us to provide you with support).

Sharing your sightings on Listserves and Facebook

On the bottom of the screen are two icons:

Listserve Email (the icon showing an envelope with a bird on it Listserve Icon) allows you to send an email to your local bird listserve (or to anyone else, but that is the intended purpose) to inform them in a timely manner (while the bird is still present!) of a particularly notable sighting. The "To" address will be filled in with the Listserve Email address (from the Settings app). The Subject line is preset to with the birding location. The body of the email includes a summary of your sightings, a list of the sightings (with individual items controlled by the items which are in the "Include" column in the Output Format table), as well as a URL will take the recipients of the email directly to a Google Map with pins showing the precise latitude and longitude of each sighting. Of course you can change any of these things, or add additional comments, before tapping Send to actually send the email. Note that for this feature to work, your unit (iPhone/iPod Touch/iPad) must be configured to send mail using the Mail application, and the email will actually be sent only when you have internet connectivity.

Facebook (the "f" in a blue box icon Facebook Icon) posts your sighting to Facebook. Of course you need a Facebook account to use this feature, and the first time you use it you will be asked (by Facebook) to give permission for Birdwatcher's Diary to post to your Facebook page. And of course you will also need internet connectivity for this to work. The screen which appears will look like this:

The content of the post will be preset to a summary of the sightings (the number seen, the location, and the date), along with your trip notes from the Archive screen. You can of course modify it as you wish. The "lock" icon allows you to specify the "Facebook privacy" of the post (your friends, just your birding friends, etc.). The Include map checkbox will add a link to a Google map showing each of your sightings, and the Include sightings, post as note checkbox does just what it says - includes a complete list of all your sightings and posts this update as a "Facebook note," because it would be too long for a Facebook status update (unless your list of sightings was awfully short!).

When you post to a listserve, or when you include a complete list of your sightings when posting to Facebook, the items which are included for each species (e.g., Name, Date/Time, Location, etc.) are controlled by the Output Format Table described above.


A note on maps

To create a Google map of your sightings which can be viewed by yourself or anyone else, one way is to output a GMap file as described above, and to then, as described in the next section, upload that file to Google under your own Google Maps account. Such maps are "permanent," or as permanent as Google allows them to be. However to include maps with listserve or Facebook postings, we need a way to generate such maps "on the fly," without requiring you to go through those two upload steps. To do that, the software uploads a Google map file to our website (stevenscreek.com), and then generates a URL which points Google to that file to generate its map. To the reader of your listserve or Facebook posting, the end result is identical. However, because we are a small company, unlike Google, we can't guarantee that we can leave that file on our website indefinitely. Depending on the number of users taking advantage of this feature, we may need to delete them after a few months or perhaps a year. Since no one will likely be reading your listserve email or Facebook post a week or two from now, much less three months or a year from now, we don't anticipate this being a serious problem. If you want a permanent map that you can refer to forever, just use the method described above (and then below) to generate your own map.


Input: Reading in Bird Lists or Previous Sightings

Selecting Input on the Archive/Input/Output/Lists screen puts you into Input mode, allowing you to read bird lists or lists of previous sightings from a website or your desktop computer:

You can input two different kinds of lists into the program — a Master List of birds (which might be a complete list of birds for the state or country you are visiting, or a shorter list of expected birds), and a list of Old Sightings recorded by Birdwatcher's Diary (or just output from a spreadsheet or database in which you had been maintaining records of old sightings). The settings on the screen determine what you are doing.

Note that this Filename is not the same as the one used for output, and the format table is not the same as the one used for output. Even though in both cases they appear in the same place on the screen, there are separate input and output filenames, and separate input and output format tables.

There are three methods of inputting information:

When you download (input) information into the software, the On Download buttons choose whether it will Replace the information already in the software, or simply Merge to it.

The file (or the information on the clipboad) must always be simple text (i.e., not a Word file or an Excel file but just plain text). If it has more than one piece of information per line, each item can be separated by either a tab or a comma; the software determines which it is so you don't need to specify it (as was the case in earlier versions of the software).

Finally, there is the issue of just what information you are inputting. The possibilities are these: Quantity, Name, Code, Note, Sighting Location, Date/Time, Latitude, Longitude, and Sighting Notes. Which of these pieces of information are found in the file you are reading, and in what order, is controlled by the Input Format Table which occupies the bottom half of the screen. Items on the left under Include are expected to be in the file, and items on the right under Exclude are not. To change the status of an item, just tap on the line. The order of items on the line is changed using the "handles" on the right side of each line.

To read in a master species list, say a list of birds in your state, select the Master List option. The Format Table will disappear, because in this mode, the input format is fixed to up to three columns of information — Name, Code, and Note. The file that you input can have one column of information (just the species name), two columns (the species name and bird banding code), or three columns (adding in a note such as the Latin name). These columns can be separated by tabs or commas. If you want to import a file of information containing just the Name and Note, you need to make sure there are two tabs or commas between the two fields, in other words, that there is an empty Code field between the two. After you read in a new Master List in this way, the list is automatically saved with your other master lists, using the same name (minus any extension like ".txt") as the file that you read.

To read in a list of a previous day's sightings, which is the case in the example in the screen shown here, then you'll need to make sure that the information you request on each line is precisely what is contained in the input file. To make things easier, you can omit the date by "pre-setting" the date by inputting a "fake sighting" and using the Edit Sighting screen to change the date of that sighting and make it the "active date" (see above). Furthermore, you can omit the location as well, by setting the location to the location of the sightings. Thus at a minimum, a simple list of bird names and nothing else can be used to input a list from a previous outing. Entering old sightings is described in detail in the next section of this manual. Please read that before attempting to do so.

Clear all sightings removes all sightings at all locations from the software, after requiring a confirmation. You'll typically do this at the start of each day of birding or at the end of a birding trip. Make sure you have uploaded (output) the recorded data before clearing it, because this operation is not "un-doable."

Adding Old Sightings into Birdwatcher's Diary

Birdwatcher's Diary was designed primarily as a tool to make it easy for you to record new sightings. However, the software has features which allow you to build life lists (full life lists, year lists, state lists, county lists, etc.), so after using the software for a while you may wish to add older sightings. There are two different scenarios — entering individual trip lists, and entering an existing life list.

Reading old sightings which you previously entered into eBird is covered in the separate eBird section below.

Adding Old Sightings into Birdwatcher's Diary "By Hand"

If you have a trip list from a specific trip, the simplest thing to do is to enter it just as you would sightings for a new day of birding. If you already have a computerized list, and the list is long, you can also transfer that list into the software; we'll return to that subject later.

  1. Set the Location.
  2. Tap on a bird to record your first sighting. Wait more than one second if it's not a "heard only" sighting, and tap on the binoculars icon to get to the Edit Sighting screen.
  3. Tap in the Date/Time field to bring up the scrolling date/time selector. Under the wheels you will see two alternatives: Date, Time and Date Only. Tap the Date Only button. This not only frees you from the obligation to enter times for sightings for which you don't know the actual time, but also adds a "year" wheel which makes it possible to add sightings from previous years.
  4. If you just have one sighting to enter for that date, tap Set as usual. But if you have multiple sightings for that old date, tap the Set & Keep button. The new date will be entered into the Date/Time field, with a "standard time" of noon (the software always wants to keep at least some time in its internal storage, for consistency with new sightings). At the same time, if the latitude and longitude had been recorded automatically (because you had the software set to do so), those values will be erased, since where you are standing right now is obviously not where you saw the bird yesterday or last year.
  5. Tap the Save button to save the edited sighting. When you return to the main screen, you will see at the top, just below the numbers which display the number of species sighted and the total number of species in the current list, the new "recording" date which will be used to record all subsequent sightings, highlighted in yellow to remind you that you are not entering current sightings, as shown below.
  6. Continue ticking off the species sighted on that day. Note that you will not need to repeat steps 2 and 3, because you have already set the recording date. Note also that because the recording date is not today, the software will not record any GPS coordinates for the sighting (which wouldn't make sense), even if you have Record Lat/Long set to All Sightings. Leaving the latitude and longitude blank means that, should you ever map your sightings, they will appear at the coordinates you set for the chosen location. It is, however, possible to use the Find on Map mode to enter actual coordinates for any particular sighting, if you happen to know where precisely (or even approximately) that sighting occurred, and if its precise location is important to you.
  7. When you're done entering sightings for that day, go to the Save Archive screen, enter a Note to describe the trip, and tap Archive Sightings.

The "recording" date remains active until you exit the application and re-enter the application, so to begin recording new sightings again, just tap the iPhone "Home" button and then the Birdwatcher's Diary icon. Or, to enter sightings for another old trip, just repeats steps 1-6 above.


Top line showing the entry of sightings on "old" dates

If you have multiple days of sightings, here are some additional points to consider:

If you want to enter your existing life list into the software, you'll want to think about how to proceed. If there are dozens or hundreds of different locations represented by the sightings, and dozens or hundreds of different days, entering each individual location and date, and then archiving each date separately, may be more work than its worth. To an extent it depends on what you want to do with the list. If you anticipate just wanting to construct new life lists as time goes on, entering all the old sightings on a single date (say, Jan. 1, 2000 or some other arbitrary date) and at a single location (probably our default location "NONE") will serve your purpose. If you anticipate wanting to construct country lists, then the proper approach might be to create a small series of new "locations" which are countries — United States, Trinidad & Tobago, Chile, Botswana, etc., and then enter the sightings for each country at the appropriate location (again, you could do this all on a single arbitrary date, but with multiple locations, just as you can record sightings at multiple locations on a new day of birding). Or, carrying the idea a step further, if you would like to construct state lists with the software, then you might create locations for each state. Remember that no matter which of these methods you choose, you can always record more specific information in the Sighting Notes field of the sighting.

If you do want to record every location and every specific day, of course you can do that, as outlined above in the discussion of entering lists from specific trips. To the extent that your records are accurate enough, this technique will have one advantage, which is that you'll be able to use the Google Maps feature of the software to output a map showing the locations of the life list's sightings. And again, if this information is already computerized in some kind of spreadsheet or database, you may be able to transfer it into Birdwatcher's Diary with a modest amount of effort.

Adding Old Sightings into Birdwatcher's Diary By Transferring from an Existing Database

If you have data on your computer in some kind of spreadsheet or database, and you are able to export the data into a simple text file (tab-delimited or comma-separated), you may be able to transfer it into Birdwatcher's Diary without needing to reenter it all by hand. Before we talk about how to do that, if you skipped the section above ("Adding Old Sightings 'By Hand'"), first read that section and think about the decisions discussed there. Do you want to create dozens or hundreds of different locations for the sightings, or just one or more general locations? Do you want to enter a single date for all of the sightings (and hence only need to create a single Archive within the software containing all of them), or do you want to enter individual dates for each sighting, and hence need to create dozens or hundreds of different Archives? Once you've decided, you can proceed.

Creating Locations on your Computer

If you intend to assign a location to each of the old sightings you will be importing, then you first need to create the corresponding locations for those sightings. If your iPhone is running iOS 4.0 or higher and you are running iTunes version 9.2 or higher, then you can create a file of locations (either with a text editor or by exporting from a database or spreadsheet which contains the requred information) on on your computer, and then transfer it into the software (otherwise you'll need to create them directly in Birdwatcher's Diary on the iPhone itself. Here's how to do it:

  1. First, setup at least one location on the iPhone (or iPod Touch etc.) yourself. This will help you to simply duplicate the proper format for the other locations on your desktop. Exit Birdwatcher's Diary back to your iPhone Home screen.

  2. Plug the unit in to your computer, go to iTunes. The name of your unit will appear in the letf-hand column of iTunes (under "Devices"). Select the Apps tab on the top of the screen, on the bottom portion of the screen you'll see a section entitled "File Sharing." On the left will be a list of applications which support file sharing; Birdwatcher's Diary (labelled "Birdwatcher") will be one of them. Select "Birdwatcher", and in the right-hand column you'll see a list of the files on the iPhone that you can upload to your desktop. Click on Locations.txt, then click on the Save to... button, and save the file to an appropriate location on your desktop computer.

  3. Open the file with a text editor. If the location you created on the iPhone (or any of the ones you plan to add) contain any accented characters or other "special" characters (e.g., smart quotes), or if you are working with a non-Latin alphabet, the file will be a UTF-8-encoded file and you will need to open it with an appropriate program, otherwise it will be a normal "ASCII"-encoded text file (for more on this subject, see this document).

    A single line in the file will look like this, where -> represents the "tab" character:

        MCCLEL->McClellan Ranch->37.31318->-122.0636->Santa Clara->CA->US


    In order, these items are:
    1. The abbreviation to be used for the location (8 letters or fewer suggested)
    2. The full name of the location
    3. The Latitude of the location
    4. The Longitude of the location
    5. The County
    6. The State (or Province)
    7. The Country (2-letter abbreviation)

  4. Now you'll simply add locations, one line per location. All seven items must be present for each location, but any but the first two (abbreviation and name) can be blank. That is to say, this would be acceptable:

       NEWLOC->New Location->->->->->


    where at the end, we have five consecutive tabs to mark the five blank items. Do not have more items on a line than are called for; immediately following the country code (or the final tab if country code is omitted) should be a "return."

    The trickiest part of this may be finding a proper Latitude and Longitude for the location. Here's the simplest thing to do - using your web browser, go to Google Maps (http://maps.google.com) and zoom in on the location. Now click the "Link" button on the top right of the map. You'll see something like this:

       http://maps.google.com/?ie=UTF8&ll=39.181175,-95.668945&spn=3.010225,4.21875&z=8


    The numbers following the letters "ll" (that's "el-el", not "one-one") are the latitude and longitude that you can plug into the file you are creating (or, to repeat, you can simply leave them blank).

  5. Once you are done adding all the locations you need (and remember, locations can be as specific, e.g., "My backyard", or broad, e.g., "Australia", as you like), save the file, using the same name (Locations.txt).

  6. Return to the iTunes File Sharing section, with your iPhone still plugged in to the computer, and click the Add button. Locate the Locations.txt file on your desktop, and click Choose. A warning will appear reading, "An older item named Locations.txt already exists in this location. Do you want to replace it with the one you are moving?" Click Replace and the file will be added into Birdwatcher's Diary on your iPhone. The next time you open the software, when you tap on the Location Selection button at the bottom of the main screen, you'll see your new list.

Importing Sightings from the Desktop

A file (or multiple files) of sightings can be created on the desktop, and transferred into Birdwatcher's Diary either using iTunes File Sharing (just as was just described for the Locations.txt file), or via other methods described in the main manual (web downloading or the iPhone clipboard). You can create this file with a text editor or by exporting existing data from a database or spreadsheet.

  1. As discussed in the main manual in the Input section, you actually have control over exactly what information you read in, and in what order it appears. The possible items of information relevant to reading in sightings follow.

    • Bird Name: the name should match exactly the name of a bird on the master list installed in the software, e.g., "Cassin's Finch", not "Cassins Finch", or "Ash-throated Flycatcher", not "Ash throated Flycatcher". Case is ignored, so "Ash-Throated Flycatcher" will match to "Ash-throated Flycatcher". The other exception for this exact matching requirement is that if the name in your file ends with " (H)" (e.g., "Cassin's Finch (H)"), then the sighting imported as a "Heard Only" sighting. If a name matching the one in the file you are importing is not found in your current master list, then a new species of that name will be added to the list.
    • Sighting Location: The is the abbreviation of the location name that you have previously created in the software, and should match exactly, including case. If the software does not find an existing location with that abbreviation, it creates one, with that abbreviation, a location name with the same characters except with only the first letter capitalized, and a blank latitude, longitude, county, state, and country. All of those (except the abbreviation) can be edited later. If you don't specify Sighting Location as one of the items being input, the software will set the location to whatever the currently chosen location is (from the main screen).
    • Quantity: The number seen. If this item is omitted, the quantity of the sighting is set to 1.
    • Date, Time: The date and time of the sighting. In the Birdwatcher section of the iPhone Settings app, you will almost certainly want to set the Date,Time Format to Date Only (you can change it back after the import). Once you do this, the Date,Time input will simply be a date in the standard format specified on your iPhone (a function of the country your iPhone is set to). In the United States, this is a simple Month/Day/Year format. Month and Day can be one or two digits, and the Year can be two or four digits. If the Year is 50 or greater, the date is assumed to be 19xx, while if the year is less than 50, the date is assumed to be 20xx (that may change when we get to 2050!). If the date is not one of the items being input, the software sets the date to today's date, which is certainly not what you want. However, as described in the section of the main manual entitled "Recording old sightings" (in the Sighting Screen section), there is a way to change "today's date." You can only do this by editing a sighting however. So if you want to import a file of sightings which doesn't contain the date, here's what to do: first make a "fake sighting," then tap on the binoculars to edit that sighting. Tap on the date, tap on Date Only, set the date, and tap the Set & Keep button. Now you can tap the Delete Sighting button, which will delete the fake sighting but leave "today's date" set to the date that corresponds to the file of sightings you are about to import. Don't forget to change it back before you record any new sightings, although it will revert back to the "real" today once you exit and re-enter the app, so it usually won't be an issue.
    • Latitude:
    • Longitude: The latitude and longitude in decimal degrees, to whatever precision you like. If you don't import these, the coordinates of the sighting become the coordinates of the overall Sighting Location, which is almost certainly what you want since you probably didn't record the coordinates of your old sightings anyway.
    • Sighting Note: This is a free-form note that can contain any information you like. As mentioned above, if the overall Sighting Location is a non-specific location, like "Arizona", you can use the Sighting Note field to record more detailed information about the location of the sighting. The one requirement here is that since each sighting in your input file must be on a single line, you cannot have a multi-line sighting note. The note can be as long as you like, but it can't have a "return" in it. If you want to have a multi-line note, you can, by using the special sequence of characters " | ", that is, a space, the vertical bar character (which is above the backslash on many keyboards), and another space. Finally, if you choose to separate the items on each line by commas and not tabs, if the sighting note contains a comma, then the entire note has to be enclosed in double quotes. Using tab separated items is simpler; we recommend it.

    The Bird Name is required, all other items are optional.

    What you need to do, then, if you do have this information in a file on the desktop, is to export only items on the list above, in any order, separated by tabs or commas, one sighting per line, and then set the table on the Input screen in Birdwatcher's Diary to match the order of the items you exported.

  2. Now use one of the several methods specified in the main manual to import this file into the software. After doing so, you need to Archive the sightings. If all the sightings that you imported were on a single day, go to the Save Archive screen, set the day in the Date field to match the date of the imported sightings (which should then display the proper number of sightings on that day), enter an appropriate note in the Trip Notes field, and tap Archive Sightings. If this was a specific trip, your Trip Notes will probably have information about the trip. If you were, as was suggested above, importing a list of your life birds, and imported them all on Jan. 1, 2000, then you might enter something like "Previous life list" in the Trip Notes before archiving. Note that the Trip Notes are the one thing you cannot import from the desktop, but must enter "by hand" in the software itself.

Some examples of files for importing sightings, again using -> to represent the "tab" character:

Example 1: In your Input Format table, set Name, Sighting Location, and Date,Time to "Include", put them in that order (vertically), and the rest of the items to "Exclude". Now your input file will look like this to input two sightings each from two different days visiting different locations:

    Bewick's Wren->MCCLEL->1/5/11
    Nuttall's Woodpecker->MCCLEL->1/5/11
    Cooper's Hawk->ARASTR->1/11/11
    White-tailed Kite->ARASTR->1/11/11

Example 2: In your Input Format table, set Name and Date,Time to "Include", put them in that order (vertically), and the rest of the items to "Exclude". Now your input file will look like this to input two sightings each from two different days visiting different locations:

    Bewick's Wren->1/5/11
    Nuttall's Woodpecker->1/5/11
    Cooper's Hawk->1/11/11
    White-tailed Kite->1/11/11

In both of these examples, make sure to set your Date,Time Format preference in the Settings app to Date Only. After you complete the import process, go to the Archive->Save screen, set the date to 1/5/11, and use the Archive Settings button to save that day's sightings permanently, then set the date to 1/11/11, and Archive Settings again (entering a appropriate information into the Trip Notes field in each case, if you want to.

Interfacing with eBird

Many of you will also be users of eBird, the site maintained by the Cornell Lab of Ornithology which allows birders to submit lists of sightings to their online database, and then aggregates those sightings to provide insights into bird behavior. Throughout this manual, there have been references to eBird; in this section, we discuss all the issues which affect the use of Birdwatcher's Diary when you are using it in conjunction with eBird.

Locations

Birdwatcher's Diary requires that you select a location to associate with each sighting; eBird does the same. In Birdwatcher's Diary, you have complete freedom as to the name you choose for the location, and furthermore, we also include a choice called "NONE" to record sightings which weren't any place "specific" that you want to establish as a "location." eBird is more constrained. eBird isn't going to be happy if you submit sightings with the location "Home," since everybody's home is someplace different, and we have heard that if you submit sightings at location "None" it places them in "None, Mississippi." Birdwatcher's Diary is happy if you set a location as "Pennsylvania" (appropriate if you are driving across country and recording sightings and won't be back to Pennsylvania). eBird allows this, but discourages it. So if you are collecting data for eBird, you'll want your location names to be specific. You'll also want to check the spelling, because if you spell things differently than the spelling that has already been established on eBird, your sightings won't be aggregated with others properly. For example in eBird there's a location "Monte Bello OSP." If you create a location called "Montebello OSP" or "Monte Bello Open Space Preserve," eBird may not realize it's the same place. So if there is any question, use the "Find it on a Map" option at Step 1 of the manual submission process of eBird to check the existing locations before setting up your own in Birdwatcher's Diary.

There is one other subtle issue with locations. To eBird, each location that you submit is a "checklist" (not to be confused with the more conventional use of the word "checklist" in birding circles, which is a list of birds you might see at a particular park or location, rather than a list of birds that you actually saw). Birdwatcher's Diary organizes data by day, and saves and typically exports data in that way, whether that day involved birding at one location or a dozen. The important thing to understand is that this is completely compatible with eBird. When you export a day's sightings from Birdwatcher's Diary and submit them to eBird, that single export may turn into a dozen "checklists" when imported into eBird. It is possible to export sightings from Birdwatcher's Diary one location at a time, but it is completely unnecessary if you intend to import them into eBird, with one exception we'll discuss below in the "Exporting" section.

One other note on locations: eBird requires that all Country abbreviations be two-letters. So when you are creating new locations, be sure to enter "US" and not "USA" (if the location is in the U.S.!), "CA" and not "CAN" for Canada, etc. (a complete list of two-letter country codes can be found here).

Species Names

Names of actual species are usually no problem when submitting data to eBird, but subspecies and "spuhs" can be, because eBird has some specific ideas about submitting such sightings, which are discussed here. As an example, eBird doesn't want you to submit "dowitcher sp.", instead, they want "Short-billed/Long-billed Dowitcher." "gull sp." is still ok! If you want to record such sightings in the "eBird approved" form, we have lists of "eBird Spuhs," "eBird Slashes," "eBird Hybrids," and "eBird Forms" which you can download and merge with other lists (your country, state or county list). Unfortunately those lists are fairly long lists, in which most of the names probably won't apply in your situation. So you might want to download those files, trim them down to just the relevant spuhs, slashes, hybrids, and forms, and then combine them and save them as a shorter "eBird special" list that you can in turn merge with other lists. Alternatively, you can just add "by hand" the few that you think are relevant to any other list, making sure that they are in the "eBird approved" format.

Counting

Birdwatcher's Diary let's you just "tick" birds, or count them. eBird also let's you submit either actual counts or just "present" (which eBird displays as an "X"), although they strongly encourage their users to do actual counts whenever possible. Whether you do is up to you. The important thing is that Birdwatcher's Diary will adapt to your preferences. If you were "only ticking," when you export the data in order to import them into eBird, you simply select the Report Only as Present option on the Output screen, and all the sightings will be imported into eBird with a count of "X", which means "present" (or "uncounted" if you prefer). If you were counting all the species, you select the Report Counts option on the Output screen and the counts are, as you would expect, imported into eBird. Note that this will be true even if you have the Multiple Sightings mode of Birdwatcher's Diary activated, the mode in which you record multiple counts for one species at a single location when the birds were seen at separate places within that location, separated by the minimum time or distance that you specified (note that in version of Birdwatcher's Diary earlier than 4.1, this wasn't the case).

Finally there is the case where you count most species but not others (often gulls, pigeons, or other species present in huge numbers that you simply don't care to take the time counting). To record a species as "uncounted" in Birdwatcher's Diary, here's what to do:

  1. Tap on the binocular (or ear) icon on the sighting to get to the Edit Sighting screen for that species.
  2. Tap in the Quantity field.
  3. An "X" in a circle appear at the right end of the field. Tap it to erase the contents of the field (do not set the quantity to 0, which will erase the sighting).
  4. Tap Save.

If you birded at multiple locations, and recorded that species at multiple locations, you need to do this at each location at which the species is uncounted. This is deliberate, because it's perfectly possible that at one location, there might be one gull, which you count, and then at another location there are a thousand which you don't want to count.

On the main screen, a species which has been marked as "uncounted" at all locations at which it has been marked as sighted will display a (a more typical way to represent "not applicable") in the quantity column. If, however, it has been counted at one or more locations, then a number will be displayed, which is the total number sighted at the locations where the species was counted, plus, somewhat arbitrarily, one each for each location at which you have marked it as uncounted.

When a "non-count" is exported and then imported into eBird, it imports as an "X" as it should. In this case (counting some species but not all), you will again select the Report Counts option on the Output screen.

Exporting from Birdwatcher's Diary

In general, exporting data from Birdwatcher's Diary for import into eBird is as simple as going to the Output screen, selecting Seen or Heard as what to Include, eBird as the Format, Traveling for the eBird protocol (collection method), setting the # Observers, and then exporting the data in one of the various ways discussed earlier in the manual. Of course you can also specify a different eBird protocol if appropriate (read more here). The final parameters, which apply especially to the Traveling protocol, is the Distance traveled (in miles) and the Duration (in minutes). For most purposes, you'll then check (or leave checked) the Calculate button. In this mode, Birdwatcher's Diary estimates your distance traveled by measuring the distance from each sighting you recorded to the next, and the duration by taking the difference between your first sighting and the last, and rounding up to the nearest 15 minutes. It does this for each separate location that you birded. For most purposes, and for the purpose to which eBird is using this information, this should be sufficiently accurate. If you feel that it isn't for whatever reason (you spent the last half of the day walking many miles without a single sighting, for example), you can uncheck the Calculate button and enter your own values. If you birded at multiple locations, and if you feel you need to enter the Distance and Duration manually, this is the one case in which you want to Include not all species Seen or Heard but only species at one Location (at a time). Return to the main screen, select a location, and then on the File->Output screen, with Include set to Location and with Calculate unchecked, enter the Distance and Duration for that location. Export the data. Now repeat this process for each location that you birded, entering the appropriate Distance and Duration for each (or, for one or more of those locations, checking Calculate to let Birdwatcher's Diary estimate the values for you).

There is one subtle issue that affects not how you export the data from Birdwatcher's Diary, but what you see when you examine the data after importing into eBird. Birdwatcher's Diary records the exact time of each sighting and, if you have GPS and Record Lat./Long. set to All Sightings, the specific coordinates of each sighting as well. eBird will not import the exact time of a sighting at all; it only imports the starting time and duration of the outing. And although it does import the specific coordinates, it doesn't appear to use them, and when you review your data on eBird, you won't see them. Because this is actual information, and we don't choose to throw it away, what we do is to put the specific time and coordinates of a sighting into the note field for that specific sighting (adding on to any specific not you already had entered yourself). So you will see this information (as well as whih "sightings" were "Heard Only" when you review the sightings on eBird, although you should be aware that eBird is not actually using this data.

Importing into eBird

Once you have a file on your desktop or laptop computer, as described above, here's how to import it into eBird:

  1. Log in to your account at eBird (these accounts are free, if you don't already have one, and establishing one is quite straightforward and not described here).
  2. Click on "Import Data" at the bottom of the screen.
  3. Click on "eBird Record Format (Extended)" in the "Format" section.
  4. Click "Browse" and locate the file of sightings on your computer.
  5. Click "Import File".
  6. If all is well, you should see two messages: "Your file "XXX.txt" has been successfully processed", and "Species, location, and checklist matching is complete". Assuming you do, you should see a further message reading "N checklists are ready to be submitted," where N represents the number of different locations which were part of the submission. Click "Submit these checklists" to add your sightings to eBird. That's it. If you did not get the proper messages at this step, your best bet is to open the file on your computer with a simple text editing program (e.g., TextEdit on the Mac or NotePad on Windows) and see if you can figure out what is wrong.

Importing Sightings from eBird

If you entered sightings into eBird before using Birdwatcher's Diary, and want to import those sightings into Birdwatcher's Diary, we've made it particularly easy to do so. You can do so either for individual day's sightings, or for the entire dataset of sightings that you have entered into eBird over the months or years that you've been doing so.

Step one is to export the information from eBird. Here's how to do that:

To export a single day's sightings:

  1. Login to eBird
  2. On the top line of the screen, tap on "My eBird"
  3. On the right-hand side of the screen, tap on "Manage My Observations"
  4. Select a day of sightings, and tap on "Share" to the right of the sighting information
  5. On the upper-right of the screen, tap on "Download". A file named something like S92213052_ebird_submission.csv will be downloaded to your computer. Save it whereever you like (just note where you are saving it!).

To export all your sightings:

  1. Login to eBird
  2. On the top line of the screen, tap on "My eBird"
  3. On the right-hand side of the screen, tap on "Download My Data"
  4. Tap on "Submit Request"
  5. Within a day, you will receive an email from eBird entitled "Your eBird data are now available for download". In the email will be a link to a .zip file containing your data. Click that link to download the data. If it doesn't "unzip" automatically, unzip it, and you will have a file named MyEBirdData.csv.

Before reading in the file you downloaded from eBird, there is one thing you may wish to do. The eBird files will contain full location names like "Rancho San Antonio." Birdwatcher's Diary uses location abbreviations to store data. If you don't do anything, when the software reads in the data, it will look to see if you already have a location called (in this example) "Rancho San Antonio" (case-insensitive). If you do, it will use your already-established abbreviation for that location (say, "RSA") to store the data. If you don't, it will establish an abbreviation automatically, simply by taking the first nine letters of the location, after removing spaces, commas, and similar things. So in this case the location would be established as "RANCHOSAN" if you let the software pick the abbreviation automatically. So this is what you need to do — if you want to set up what you may view as more appropriate abbreviations, you should create locations in the software corresponding to the various locations of the sightings you'll be importing. If you don't care, don't worry about it and let the software do it for you. Or you could use a mixed approach, setting up your own preferred abbreviations for some locations, and letting the software do the others.

Once the location issue is setted, in both cases (single day's sighting or a complete set of sightings), go to the File->Input screen of Birdwatcher's Diary, and set On Download to Replace and Contents to Old Sightings. Don't worry about the format table on the bottom half of the screen. The file that you downloaded from eBird has a "header" line (the first line in the file), which the software will use to determine that it an eBird sighting file, and also to determine what kind of file it is (a single day or a complete set of sightings). Once it does so it will automatically know the format of the data and read it in properly.

In the case of a single day's sightings, you can then go to the File->Archive->Save screen, enter a Trip Note if you wish, and tap Archive Sightings to archive the data. When you import your entire set of data from eBird, the process is even easier, because Birdwatcher's Diary will automatically archive each day's sightings, unless you already have sightings archived for that day, in which case the data from the input file is ignored. We do this because many of you have been using eBird and Birdwatcher's Diary for quite a while, before this new import feature was available, and eBird does not allow you to export your data by specifying data ranges; it's all or nothing. So for many of you, the eBird data will include some data which is not currently archived within Birdwatcher's Diary, and some data which is archived. Since we don't want to duplicate data, only the former is automatically archived.

Special Topics

Tip for Christmas (and other) bird counting efforts

As you can quickly find out for yourself, switching between "All" birds and "Seen or Heard Only" (the Green binoculars) is essentially instantaneous. This means that as soon as you've seen just a few different species, the fastest way to record sightings is to leave the software in "Seen or heard only" mode, because you're probably more likely to need to change the count of an already seen species than to record a new species. When you do see a new species, just tap "All," find it and record it, and then tap the Green binoculars again. In that mode, with 20-50 species on your list, it's almost certain you'll need just a single tap on the letters down the right-hand side of the screen to bring up your bird for recording, with no scrolling at all.

Tip for "Big Day" efforts

The first obvious tip for a Big Day is to prepare a list of just those birds you have any chance of seeing. Preparing and installing special lists is discussed above. Having done that, not only will it be faster to locate and tick off birds on a shorter list, but also you can take full advantage of the "red-eyed binoculars" or "not yet seen or heard" mode in which the software displays only those species that you haven't seen.

If you are counting birds as well as recording sightings, the "not yet seen or heard" mode will only be useful temporarily, by switching to it to review the species you haven't yet seen. But if you are only "ticking" species, and not counting the numbers of each, then instead of merely switching to "red-eyed binoculars" to review what you haven't yet seen, you can actually record birds in that mode, so your on-screen list will always display only those species you still "need." In earlier versions of the software, ticking a previously-unseen species would cause that species to immediately disappear from the screen (because it is no longer an unseen species) which would make it harder to realize that you had ticked the wrong species, and also harder to make any changes to that sighting (e.g., change it to "heard only"). Beginning with version 3.6, there is a three-second delay, that is, for three seconds after you tick the bird, it remains visible on the screen, marked with a green binoculars. After three seconds, the screen is refreshed and it will disappear. But in those three seconds, you have time to modify the sighting — quickly (within one second) tap the binoculars to mark the species as "heard only," or, after one second but before three seconds, tap the binoculars to edit the sighting, perhaps adding a note (editing sightings is discussed below), or perhaps deleting it if you ticked the wrong species by mistake.

Viewing sighting maps on the desktop

If you output data in the Google Maps format, you will have a file on your desktop which can be used to produce maps in 2-dimensional format (using Google Maps) and even 3-dimensional format (using Google Earth) through which you can "fly" and review your day's sightings. Here's the procedure by which you can use Google Maps:

  1. Go to the Google Maps website (maps.google.com)
  2. If you have never done so, establish a free Google Maps account (basically entering an email address, which does not have to be a GMail account, a password, and other information.
  3. On the upper-left of the screen, click on "My Maps"
  4. Click on "Create a new map"
  5. Click on "Import"
  6. Click on "Browse" and find the sighting map file that you uploaded from Birdwatcher's Diary.
  7. Click "Upload" and there's your map (for an example, see the picture below or click here for a "live" version)! Click on any "pin" to see what bird that was, or click on the name of the bird in the left-hand column to see which pin corresponds to it. Note that the Title of the map (which you can change, of course) is taken from the Upload Filename you used to upload the data, minus any extension like ".txt", while the Description of the map is taken from the trip Notes field that you entered on the Output screen. Using the "Link" button you can copy a link to the map to send to your friends.

Using Google Earth (which is a separate standalone application from Google, not accessed via your web browser) is even easier. There is only one constraint, which is that the file you upload (the Upload Filename) should end in ".kml" With this file on your desktop, and assuming you have downloaded and installed the Google Earth application, you'll simply double-click on the file to "fly in" to a 3-dimensional map of your sightings.

Battery usage and GPS

If you keep the iPhone (iPod/Touch, iPad) turned on, or if you simply turn it off but do not exit the Birdwatcher's Diary application, then the location is constantly updated, and will always be available, but this will use up battery power (a fully-charged iPhone 3GS will last about four hours). If you exit the application, and turn on the unit and start the application as you are about to record a sighting, then, depending on your location (for example, under thick tree cover), it may be several seconds or considerably longer before a precise location is available (of course it will also take a second or two for you to find the bird on the list).

If you are doing "high-volume" recording, such as might occur during a Christmas Bird Count, you may want to leave the unit on, so you don't even have to spend the second or so to unlock it. If you are doing "normal" recording (just recording new sightings during a typical day of birding), then turning the unit off but not exiting the application (unless you need to to use another app, obviously) is the best way to use the software. If you are doing a real "big day" involving pre-dawn to post-dusk observation, you might want to invest in one of the several "extended batteries" that are available to ensure your unit will last all day (this is one we have used, as well as this one). Alternatively, if you are driving from site to site (as is so often the case), you might consider one of the various "cigarette lighter chargers" which are available (for example, this one), which will allow you to plug in and recharge the unit as you move to the next site.

Using Birdwatcher's Diary in the cold and rain

An iPhone or iPod is an expensive device, and we don't recommend getting it wet. And the devices can't be operated when wearing gloves at all, with the exception of very thin gloves, which do work, but with diminished responsiveness. However...there are solutions to both of these problems!

Rain: Perhaps surprisingly, iPhones and iPods can be operated inside ZipLoc plastic bags. While any bag you buy in the store will work, the ideal solution is a 3x5 bag which fits the unit perfectly. The bad news is that they're only available in bags of 100 (!), but the good news is they're fairly inexpensive (just a few dollars). Here are two sources we've found; the first is the one we use:

Cold: As noted above, some very thin gloves will work, but most gloves will not, because the iPhone and iPod work on "conductance," that is, they rely on electrical contact with the finger. However, there are several manufacturers of special gloves for iPhones, which either have special metallic fingertips or other mechanisms for assuring proper electrical contact. We have not tried these products (except at trade shows), but here are three different manufacturers of such gloves:

Styluses: There are also "capacative styluses" (stylii?) that you can use with touchscreens, like this one from Griffin. Because this would require two hands (one to hold the iPhone, the other the stylus) leaving none for your binoculars, it's probably not the best solution for the field, but worth mentioning.

Visit the Stevens Creek Software Home Page

Visit the Stevens Creek Software iPhone Software Support Page

© 2010-2 Stevens Creek Software