Version 15.7.2, June 2022
Welcome, and thanks for giving Scythebill a try!
Scythebill is software for keeping track of a birdwatcher’s sightings across the world. It can keep track of your life lists and generate reports, follow taxonomic updates with ease, and much more. Perhaps most importantly.
Scythebill supports both the eBird/Clements checklist (including all subspecies and groups) and the IOC World Bird List. Its fast species entry, including over 7000 alternate names, lets you enter sightings in a flash - even with “sp.”s and hybrids. And you can easily import sightings or export to eBird. It even lets you add additional, extended taxonomies, so you can keep track of mammals, insects, or anything else that lives.
Scythebill is not a phone application or a website. This is intentional. Birding websites can and do disappear. And while it’s great having apps for entering sightings in the field, phones are not long-term storage! I’ve been birding for 30 years already, and plan to keep going for decades. Birders need their sightings around for the long haul.
This section talks about how to get started with Scythebill. It largely gives you links to other parts of the manual that talk about things in more depth, but will hopefully save you time.
First, you probably have a lot of data already in another program. You could just re-enter all that data, but you’re almost certainly going to want to import it without starting from scratch. Luckily, Scythebill supports more than a dozen different import formats, including many of the most commonly used birding software packages, like eBird, Avisys, and Birdbase. If you’ve been tracking your sightings in a spreadsheet of your own, it can import from that too, though you’ll need to spend a bit of time massaging your spreadsheet into a format Scythebill can understand.
If this is you, before you run Scythebill for the first time, you’ll want to export your data:
Now, launch Scythebill. You’ll see this screen the first time you run:
If you’ve got data from another program, click Import records… Choose the appropriate import format (eBird if you’re coming from eBird, Avisys if you’re coming from Avisys, etc.), and find the files you exported just before. Depending on what software you’re installing from - how old its taxonomy is, how well it describes its locations - you may need to do some work. Read the Imports documentation to see how that works (and read up on Scythebill’s “Choose-your own abbreviations” feature if you get stuck at all choosing species or locations).
If you’re coming into Scythebill with no existing data, then just click New file…
Either way, you will now have a “.bsxm” file - a file named something like “List-YourName.bsxm”. Keep track of this file! This has all of your information in it. And I strongly encourage enabling backups as soon as you can.
At this point, continue with the Scythebill overview.
This overview is a quick walk-through of Scythebill to get a flavor of what Scythebill can do. There’s a lot that it leaves out, for the purposes of brevity, but I’d recommend that once you get through “Getting started”, have a skim through this section.
Scythebill was built to be both powerful and easy-to-use, and many users have downloaded and used it before this manual was written. But before you get started, a few basic ideas might help you familiarize yourself with Scythebill.
Scythebill stores all of your records in a single “.bsxm” file - not in the application - so you can download, upgrade, or even delete the Scythebill application without affecting your data. You can also have multiple record files on a single computer (for multiple users). The very first time you open Scythebill, you’ll need to create that records file, from this screen:
Note: the screenshots here are taken (mostly) on MacOS. But Scythebill works essentially the same on MacOS, Windows, and Linux, so these screenshots apply across the board.
If you haven’t used Scythebill before, you’ll either want to click New file… or Import records... If you’ve got records from Avisys or eBird that you’d like to start with, then you can use the import button; this is described thoroughly in a later section. Here, let’s assume you’re just starting from scratch, and you’ve clicked New file… Pick a filename - and remember, this is not a file for just one day’s sightings or one trip’s sightings - this is one file for all of your sightings.
Once you’ve saved the file, Scythebill will remember this and re-open the file every time you open Scythebill. (If you ever need to find this file, and can’t remember where you saved it, use the Open containing folder option in the File menu.) If you need to have multiple records files, you absolutely can - just use the New sightings file... option in the File menu - but this is only really necessary when you have multiple birders sharing one computer.
So, when reopening Scythebill, you’ll skip this screen and go right to this one:
This screen lets you:
All of the features of Scythebill are described in detail later in the document; if you’re looking for a thorough explanation, this section isn’t it! But if you’re looking for a fast overview, and you’re the kind of person who wants to jump in and figure things out yourself, you’ve come to the right place.
… then, if necessary, tell Scythebill about the new location:
… enter some (completely optional) information about your visit as a whole:
… then, finally, add species, attach photos, and enter additional details.
Once species are entered, you can get a variety of reports about your species from the Show reports page:
From here, you can set up rules to view a slice of your sightings, you can also print, export to several formats (including a spreadsheet), produce trip or family reports, edit single records, or bulk edit large numbers of records.
You can also browse all of your records in two different pages. In Browse by species, you can browse and jump around all the birds of the world:
This page also lets you edit sightings, move sightings from one species (or subspecies) to another, delete sightings, and add single sightings.
Finally, the Browse by location page lets you browse and jump around built-in and custom locations:
You can use this page to quickly get lists of your sightings per location. You can add, remove, and edit locations, move locations around, and add, delete, and edit sightings. You can also explore the built-in checklists, and create spreadsheets for your upcoming trips. And you can even build your own checklists in a flash.
Scythebill comes with a full list of 255 countries, as well as all three-and-a-half thousand states/provinces of the countries of the world, and also:
Picky details: “Country”, “state/province”, and “county” is defined in occasionally surprising ways. A number of Scythebill “countries” here are not independent countries - like Pitcairn Islands or New Caledonia. If you really care, “country” here means “location with an ISO-3166-1 two-letter code”, and state/province means “subdivision of a country with an ISO-3166-2 code”. Scythebill’s “states” are called territories, parishes, governates, emirates, districts, departments, cantons, regions, unitary authorities, and so forth.
Not at all coincidentally, these are the same definitions used by eBird.
These countries and states come pre-grouped into continent and ocean regions which - again, not coincidentally - map nicely onto standard bird reporting regions. And Scythebill knows about reporting regions that don’t exactly map onto continents - ABA, AOS, Western Palearctic, Southern Africa, and USA (lower 48 states, “continental” 49 states, or all 50 states).
Picky details: for countries that cross listing regions - the United States, Russia, Turkey, and Indonesia, states are pre-sorted into these regions for you. So you’ll find three “United States” locations - one in North America, one in the West Indies, and one in the Pacific Ocean. And while most US states are inside the North America “United States”, Hawaii and Guam are in the Pacific Ocean “United States”, and Puerto Rico is in the West Indies “United States”.
Scythebill also makes sure that islands and exclaves that are politically part of a country are located in the right region. So:
Scythebill also lets you define arbitrary hierarchies of locations inside these built-in locations. If you don’t much care about keeping this level of detail, don’t bother! But if you do, you are perfectly welcome to have a location of:
Scythebill will keep track of each of these lists automatically.
Scythebill also comes with built-in checklists for 342 of those regions - nearly all of these countries, all of the states of the United States, the provinces of Canada, the states and territories of Australia, and 7 regions of Indonesia, as well as checklists for all of the continents and other regions, and lets you define and share your own checklists.
Scythebill comes with both the eBird/Clements checklist and the IOC World Bird List. But you don’t have to choose which one you like! At any time, you can use the menu at the top of the Scythebill window to switch from one taxonomy:
… to another:
That’s it! Everything you’re doing will immediately switch to the new taxonomy.
Upgrades of eBird/Clements and IOC come automatically with new versions of Scythebill, and automatically upgrade your sightings (though you may have to reconcile some splits).
Scythebill has historically been - as best as I can tell - faster than any other application at delivering taxonomic upgrades. eBird/Clements updates have been released in about 1 week, and IOC updates usually within 1 or 2 days! And Scythebill taxonomic upgrades automatically update all of your old sightings (more on that later).
Scythebill also includes 25+ as-yet undescribed species in both the eBird/Clements and IOC taxonomies (though some of these have in fact been described since the respective taxonomies were last updated).
Finally, in both taxonomies, you can choose to have common names displayed in one of about 30 languages.
Scythebill uses a simple and powerful method to speed data entry. Instead of making you memorize abbreviations or scroll through long lists, just imagine an abbreviation, type it, and you’re done!
For example (if you’re a North American birder), can you remember whether “bwwa” is a Blue-winged Warbler or a Black-and-white Warbler? It doesn’t matter - type it, and both will appear. Or, actually more - that’s also a valid abbreviation for the African Brown Woodland-Warbler, the Asian Blunt-winged Warbler, and more.
That could be overwhelming. But Scythebill uses its built-in checklists and your sightings to make it simpler. If you say you saw a “bwwa” in New Jersey, you’ll see that list up top, with Blue-winged Warbler first. With Blue-winged Warbler selected, hit the Return key or Enter (or double-click on it), and you’re done.
If you enter “bwwa” in China, you’ll see Blunt-winged Warbler at the top:
Just hit the Return key or Enter (or double-click on it), and you’ve picked Blunt-winged Warbler. (Or use the up and down arrows to move to a different species)
In Kenya, Brown Woodland-Warbler jumps up.
And in Nigeria, it’s Black-capped Woodland-Warbler.
In each case, the most likely species are up top.
And Scythebill learns from your own sightings - even the time of year of those sightings - to figure out which species are most likely in any one place or time.
Scythebill also knows about alternate names - with 7,500 alternate names for its species, so should you remember Gavia immer as “Great Northern Diver”, a simple “gnd” brings it up:
This also works for locations. So, “quny” will bring up “Queens” in “New York”:
In all cases, you enter a species or an (existing) location by:
If you’re not concerned with exactly what abbreviations work, do skip this section… Mostly, it’ll just work.
Put simply, take any number of letters from the start of any of the words, in order, and that’s a valid abbreviation.
Let’s take some examples. First, Black-and-white Warbler, starting from reasonable to rather silly, but all “legal”:
Now, San Francisco, California:
One more thing… I found I could never remember whether I entered mountains as “Mount” or “Mt.”. Or whether “Saint Vincent” would be “St. Vincent” instead. So Scythebill lets you enter abbreviations either way.
Whether you entered Mount Kinabalu or Mt. Kinabalu, you can find it as “mtki” or “moki”.
Whether you entered Saint Thomas or St. Thomas, you can find it as “stth” or “sath”.
If you’ve got questions, you can reach Scythebill by any of:
Do know, however - the Scythebill “support team” is just me… I’m usually quite good at responding quickly, but if I’m travelling or otherwise out-of-contact, it might take a little while.
If you should ever want to express your gratitude at having this software made freely available, I don’t accept donations or payment, but I’d be thrilled to have donations made on behalf of Scythebill to a conservation organization. If you don’t have one in mind, consider one of these, all of which have global scope in their efforts
Scythebill can always be downloaded from http://downloads.scythebill.com.
Scythebill can run on Windows XP, or newer (that includes Vista, Windows 7, Windows 8, and Windows 10). As of Scythebill 14.1, a 64-bit version of Windows is required. 1 GB of memory is recommended, though it probably works with less. To install:
Many thanks to BitRock for making their installers freely available for open-source software!
If you’ve ever forgotten where you’ve installed Scythebill, don’t forget about Spotlight, part of MacOS that makes it really easy to find things you’ve misplaced!
Scythebill’s Linux version requires a 64-bit version of linux.
You can use an ordinary JAR file to run Scythebill on just about any modern operating system - from the well-known ones like Mac, Windows, Linux, to less well-known ones like IBM AIX, HP-UX, eCS-OS2, you name it… It does requires a Java installation (Java 10 or later), and is missing many of the niceties of the native applications above.
If you’ve got a 32-bit system, you might be able to use the 32-bit-compatible versions of Java 10 from Azul.
Scythebill periodically “phones home” to see if an update is available. When one is available, you’ll get a screen like this one:
Click Download now to open a web browser and read the full release announcement. That page has links to download the new version, or you can always use the Download updates… item in the help menu, or visit http://downloads.scythebill.com.
Click Ask me later to postpone downloading and proceed with using Scythebill. Scythebill won’t ask you for at least another 5 days.
Click Skip this version if you don’t want to be reminded about this version again. Scythebill will still notify you when an even newer version becomes available.
After downloading, make sure you’ve quit Scythebill, saving your work if any first. Then:
For Scythebill 14.1.1 or later, on Windows, if you see a “Could not create the Java Virtual Machine” error, please re-run the installer as an administrator (by right-clicking on the installer application).
If the new version of Scythebill comes with an updated version of the eBird/Clements taxonomy (about once a year), you’ll be prompted with a screen like this one (this screen being an example from the Scythebill 9.3.0 release in 2013):
As this page says, all of your records get updated automatically.
If the new version of Scythebill comes instead with an updated version of the IOC taxonomy (about twice a year), and you use IOC, then Scythebill will send you through a similar process.
If you’re unaffected - either because you haven’t recorded any affected species, or because you’ve already chosen subspecies, then this page is a lot simpler, just telling you that the upgrade has been a success. If you’ve got a larger list (like mine), and you’ve not consistently kept track of subspecies (ditto), then you’ll have a bit more work - but not much!
Scythebill’s checklists are then put into play - they may make it clear which of a species pair (or 16-way split!) might apply. If they can be used, you’ll get a dialog telling you what Scythebill can do:
In this example, 17 sightings are affected by the upgrade, and of those, only 6 can’t be fully resolved. If you want to handle this all manually, click No. If you want Scythebill to handle it automatically, click Yes.
After clicking OK, you’ll be taken to a screen that lets you resolve all of the remaining splits.
Note: These updates are necessary even if you only use the IOC checklist, as Scythebill’s primary storage is against eBird/Clements.
This screen has a list of all the new splits to resolve. Select each split, select one or more sightings, and then use the rightmost panel to resolve the split. In the above page, Venezuelan Tyrannulet was split into Venezuelan and Specious Tyrannulet; my 1991 sighting was nominate Venezuelan. So to resolve that, I’d:
Repeat as necessary. If you’re not sure, you can always leave these sightings alone for now and resolve these splits later, with the technique described here.
You can also see the full effect of the splits and lumps in a version with the “Splits and lumps” report under Special reports.
To enter a group of sightings from the main menu, click on Enter sightings.
The first page asks you to enter a date (day, month, and year), a start time, and a location. It’ll look like this:
The date field is always pre-initialized to “today”. You can enter as much or as little of a date as you want. If you don’t have a day, just clear out the day field. You can enter a sighting with no day, month, or even year.
Hint: you can enter a two-digit year into the year field, and Scythebill will make a pretty good guess as to whether you meant the 1900’s or 2000’s.
The start time, if you want to enter it, should be the time you started birding. If you live in a location that uses AM/PM, 12-hour time, there’ll be an AM/PM option - otherwise it will be 24 hour time. You can leave the minute field blank, or just leave the whole thing blank if you want.
For the location field, if you want to pick an existing location (either built-in to Scythebill or one you’ve added yourself), then use the “Choose-your-own abbreviation” feature of Scythebill to pick the location:
If you want to edit an existing visit, you can use the “Or choose a recent visit” popup here. This menu includes the last 10 visits for which you’ve entered sightings. Or if you simply enter a location, date, and start time that matches existing sightings, you’ll be able to edit that recent visit.
If you want to add a new location, then:
Example: You want to add “Santa Cruz”, the city in California. Scythebill knows about “Santa Cruz” in California (the county, not the city), as well as Arizona, Argentina, and Bolivia. But this is the first time you’ve recorded anything in the city. So type “Santa Cruz” into the location field, hit “Esc”, and click Next >. It’ll look like this when you’re done:
You picked the name of the location on the previous screen; now it’s time to tell Scythebill where this location is.
Hint: If you want to change the name of the location once you’re on this screen, you’ll need to click on “< Previous”, and then change it..
If the location is a private location, like (say) your home address, or some other private property without public access, you may want to select “Private location?”. If you do this, Scythebill will never export data for that location to eBird or BirdTrack.
Example 1: you’ve been to Natural Bridges State Park in Santa Cruz County, California.
Scythebill has done a lot here for you:
Example 2: you’ve been to Bolsa Chica in Orange County, California, but also want to tell Scythebill that this beach is in Huntington Beach.
If you want to enter multiple levels of hierarchy all at once, just click “even more specific” multiple times. Whenever you’ve got a location ready to enter, Scythebill shows you a summary of the location hierarchy at the bottom of the form, as seen above.
Again, Scythebill has automatically found the location’s county, latitude, and longitude (this time, using eBird’s location data), and displayed a map.
And don’t worry, if you make a mistake with location entry, you can easily edit it later.
As seen in the two examples above, Scythebill can automatically place locations for you using Google and eBird. When it finds results, Scythebill will use them to pick a county (and even a state/province) for your sighting, and a latitude/longitude.
Loading these results does require an internet connection. Scythebill does not send any information about you to either Google or eBird - specifically, it does not send or store any cookies.
Scythebill looks for information by looking for results from both Google and eBird, then merging those together.
If there’s just one result, the “geocoding” feature will immediately display it. (And if that result is poor, you can click “Ignore Google result” or “Ignore eBird result”, and Scythebill will drop it.)
If there’s more than one result, you’ll see a Multiple results from eBird: or Multiple results from Google, eBird: menu, and you can choose one of the results:
eBird sometimes finds multiple results, in which case you’ll see a Multiple results from eBird: menu, and you can choose one of the results:
If Scythebill can’t find a location with either Google or eBird, you can try editing the name - every time you edit the name or change the “is in…” location, Scythebill will search again (after a brief pause).
If Scythebill found a location, and a latitude and longitude, but the latitude and longitude aren’t quite right, you can simple click on the map to change the latitude and longitude. Use the plus (+) and minus (-) buttons to zoom in and out for fine-tuning.
If you look on the above screens, once there’s a latitude and longitude, Scythebill offers a “Search nearby” button. Click that and you’ll get a new drop-down menu, which merges answers from Google and eBird hotspots. The locations are ordered from nearest to furthest, and each one tells you whether the result comes from Google or eBird. Pick one, and the location will switch to that exact location (including name, latitude, and longitude). If you’re an avid eBirder, and want to select exact eBird locations for the simplest importing possible, this will be a great help!
If you want, you can tell Scythebill what type of location the new location is. (This is only for your own bookkeeping.) The commonly used types are:
… and you can also mark locations as “State/Province” or “Country” - but it’s usually not necessary, since these are built-in to Scythebill.
After picking a location, you can enter visit data - information about your visit applicable to all the sightings. Some of this information is specific to eBird, but some is useful even if you’re not submitting sightings to eBird. All of it is optional - you can skip it by just clicking Next >. Here’s what the screen looks like:
At the top, a comment field lets you enter any notes you’d like to enter for the visit.
Next is eBird Observation Type. This lets you choose one of a multiple of eBird protocols sighting types. (An article here describes some of these observation types, but it is sadly very much out-of-date.) Only two of these are allowed if you have not entered a start time (or you aren’t entering sightings for an exact date):
Others may also be chosen if you have entered a start time:
Note: not all of the eBird protocols can be submitted directly to eBird at this time - they simply don’t support uploading them. The Pelagic protocol will be reported as Traveling; Banding and Nocturnal birding will be reported as Historical; and Nocturnal Flight Counts will be reported as Stationary. I’ll eagerly change this if and when eBird supports uploading these protocols, but in the meantime you have to edit such checklists inside eBird after uploading them.
Each observation type has a set of allowed fields and required fields, so as you change observation type, you’ll see fields appear and disappear, and see fields be labeled in bold with a red asterisk (like so: * Duration) - which means the field is required for that observation type.
Hint: The “Historical” observation type lets you enter all fields, with no fields required. If you’re uploading to eBird, it’s essential to pick a proper observation type, but if you’re just using the data for yourself, “Historical” is a fine default!
The fields that can be entered are:
And if you’re planning on uploading this data to eBird, you might want to check the … and export to eBird checkbox at the bottom right of the window - more on that later.
Now that Scythebill knows when and where you were, and you’ve entered information about the visit, you can enter what you saw. If this is an existing visit that you’re editing, the page will have all species already entered from the visit, and you can add new sightings or remove existing sightings.
The very quick summary is:
If Scythebill has a checklist for this location - or one of its parents, you can also turn on checklist entry, in which case you’ll get a full list of all the species, and can page through and select species.
What follows is the full details!
Screenshot and overview:
At the top of the page, you’ll see a menu for choosing whether to use a checklist (here it’s turned off), a checkmark for noting that you’ve entered a Complete list of sightings (for eBird), then the location and date, followed by a field for entering the species name. After that are three buttons:
Below this is a block of text about the current species (or subspecies). It shows:
Below that area comes the main species entry table, which has eight columns, from left to right:
The species detail options are:
Finally, there’s a row of buttons:
As described above, you can attach photos to a sighting either by:
Photos can either be files or web pages - though the only way to attach a web page is by dragging the web page’s URL from a web browser (Chrome, Internet Explorer, Firefox, Safari, Opera, and so forth all should work). Dragging photos does not currently work on Linux.
Once a photo is attached, just click on the photo’s name to open it. If the photo is a file, and the file has been moved, you’ll get a warning dialog and can relocate the file.
Scythebill doesn’t actually care that what you’re attaching really are photos - you can attach any file or website.
There’s also a star next to each photograph - click that to mark it as a “favorite” (you can generate reports including favorite photos).
Before you click Done, if you’re using eBird, you’ll want to pay attention to two more options.
First, there’s a checkbox for Complete list of sightings? When this is selected, eBird knows that anything you didn’t enter simply wasn’t there; without that, eBird can’t make that assumption.
Second, there’s another checkbox for … and export to eBird? When this is selected and you click Done, you’ll be able to save a CSV file that’s ready for upload on the eBird Import a file page.
When your sightings are somewhere that Scythebill has a checklist, it’ll offer the choice of checklist entry. Just change Use [Location name] checklist? to Yes, and a full checklist will appear below. You can switch back and forth between standard entry and checklist entry as often as you want.
If you happen to be birding where Scythebill’s checklist includes rarity status, there’ll be one more option in the “Use checklist” menu - Yes, with rarities. By default, checklist entry does not include any rarities or extinct species (though they can be manually entered). Choosing “Yes, with rarities” includes rarities (and extinct species).
Checklist entry looks and works very similarly to non-checklist mode - but there’s a column of check-marks on the left, and no red “X” to remove a species:
To add a species, either:
With the other keyboard shortcuts, you can whip through species entry just using up- and down-arrow keys and the spacebar, and right-arrow and Tab keys to enter details.
To remove a species, you can click on the checkbox, double-click a species name, or use the space bar with a species selected.
If you want to add a species that is missing from the checklist (or enter a “sp.” or hybrid), use the species-name field and click Add species. If you want to enter two subspecies of a single checklist species, then:
The species entry field here uses the same “Choose-your-own abbreviation” feature as everywhere else in Scythebill, but includes some additional niceties specific to data entry.
As noted elsewhere, it automatically sorts the list of matches based on the location. It even goes one better and takes advantage of the time of year! With my list, if I enter “e” in San Francisco in April, the first entry is Dark-eyed Junco. But if I enter “e” in October, the first entry is Elegant Tern!
Scythebill also will let you short-circuit to subspecies (or eBird/Clements groups). Below the top result, Scythebill will add the most likely subspecies based on your prior entries. For example, if I enter “dej” (for Dark-eyed Junco) in California, the result just below is “Dark-eyed Junco (Oregon)” (if I’m using eBird/Clements):
Finally, remember Scythebill also knows about alternate names for species entry. If you enter “gnd”, you’ll see “Common Loon (Great Northern Diver)”, or “Great Northern Loon (Great Northern Diver)”, in the eBird/Clements or IOC taxonomies.
Subspecies are entered by first entering the species, then choosing the subspecies from the Subspecies column.
You can enter two subspecies of the same species as well. For example, if you’d seen both the collybita and tristis subspecies of Chiffchaff on the same day in the same place, then enter Chiffchaff and choose collybita in the subspecies column; then enter Chiffchaff again and this time choose tristis. (If you’re using checklist entry, then you have to use the “Type a species name” field to enter the second subspecies. You can’t just do this with the checkboxes.)
Scythebill supports both “sp.” entry and hybrids, so these sightings aren’t relegated to unreliable memory. Other bird listing software either doesn’t support this at all, or requires manual taxonomy editing; this seems a fairly unique feature!
“Sp.” (pronounced “spuh”) is used for this inevitable moments when a sighting can’t be identified to just a single species. Think of notorious identification problems - in my neck of the woods, the unidentifiable-if-not-singing Pacific-slope and Cordilleran Flycatcher pair is particularly thorny. Scythebill lets you enter such pairs; and you can even . And it lets you enter hybrids as well.
You could even, at step 3, click “Sp.” once again to produce a three-way “Sp.” - useful for same particularly thorny identification problems (like ZIno’s/Fea’s/Soft-plumaged Petrel).
Hybrids and sp’s will be reported to eBird, and will appear on reports, but they don’t “count” for list totals.
Hint: Instead of clicking Sp. in step 2, just hit the forward-slash key - “/”.
Hint: You can even issue reports to explicitly find all your records of hybrids or sp’s. Use the “Sp./Hybrid” report option.
Scythebill includes a few shortcut keys to make navigation much faster when entering species.
Just after you’ve added a species - with the cursor still in the field to enter the next species’s name - type a number. The cursor will immediately move to the number field, and you’ll set the number for that species. Once you’re done, hit the Enter key, and you’ll jump right back to the species name field.
If you’re using checklist entry, then you can do this same trick while you’ve got a species selected - even before clicking the checkbox or tapping the spacebar, you can start typing a number. It’ll add the species to your list, move the cursor to the number field, and set the number for that species. Once you’re done, hit the Enter key, and you’ll jump back to the species table.
And while the cursor is in the number field, you can use several shortcuts to quickly toggle the checkboxes. Hit any of the "h", "p", "i", "f", or "m" keys, and you'll immediately toggle:
Also, when you’ve got the cursor in the field to enter a species name, you can press Shift-Alt-Right Arrow (Command-Option-Right Arrow on Macs) to jump to the species table, automatically expand the selected species’ detail form, and move the keyboard focus directly to the first checkbox in that area.
And when you’ve got the focus anywhere in the species table, you can press Shift-Alt-Left Arrow (Command-Option-Left Arrow on Macs) to jump right back to the species entry field.
Together, these let you enter species, add details, and enter more species quickly. For example:
When the focus is in the table (you should see a big ring around the table to let you know), you can:
Now that you’ve entered some sightings, let’s walk through the reports page, accessible by clicking Show reports on the main screen.
Here’s a screenshot, showing a report for everything I saw in Peru in 2000. (It was a pretty good trip - over 500 species, including some pretty good ones):
There’s a lot going on in here. The main parts of the screen, which we’ll walk through one at a time, are:
Scythebill lets you choose from 12 different kinds of rules together to pick your sightings.
Location rules let you restrict sightings by where they happened:
Usually, you’ll just want to use “is in” to limit the report to species you saw in a particular location.
But you can change is in to be:
Location also supports several “magic” location names, widely used by birders for listing:
There’s also a number of “magic” location names to reunify countries that are split across geographic boundaries, or geographic regions that are split across political boundaries:
Date rules let you restrict sightings by when they happened:
In this example, Scythebill will find all sightings that happened in the month of June, in any year. You can set any or all of day, month, or year.
There are six options for what sort of date rule to use!
First records (lifers) rules let you zero in on sightings that were lifers for you - whether for the world, or your local patch.
This rule can be configured in two ways. First, you can choose the location that you’re focused on - by default, the whole world, but this can be any country, state, or even local patch. Second, you can choose whether you want those “lifers” highlighted or included:
In either case, you’ll get a lifer count at the top of the report.
If you output a spreadsheet with this rule included, lifers will be marked with “Y” (for “yes”) in a Lifer column.
This rule is most useful when combined with other rules. For example, if you wanted to find out how many lifers you got on a trip to Peru in 2000, you’d have three rules:
… and it’d look like this:
Heard only rules lets you find sightings where Heard Only is selected or not selected.
IUCN Redlist rules let you find sightings of species that are endangered, etc… For example, here I’ve got a report rule that will find your sightings of species that are Endangered or worse, which would be Endangered, Critically Endangered, Extinct in the Wild, or Extinct.
By default, Scythebill will not include all sightings in report lists, but sightings marked as either “Not established” or “Uncertain ID” will be dropped from numeric counts. Status rules can override this. You can choose one of the following types of status rule:
Breeding code rules let you select from the four broad types of breeding codes:
… or from any specific breeding code.
You can select is, is not, and is at least among these categories.
Photographed rules let you find sightings where the “Photographed” flag is selected. (That flag is automatically selected when you add a photo to a sighting, and automatically deselected when remove the last photo.) You can select:
Note that “has no favorites” includes both sightings with no photographs as well as sightings with photographs, none of which are starred as favorites.
Sighting Notes rules let you find sightings by free-form text associated with that sighting. You can search either for:
Visit Comments rules let you find sightings by the free-form text associated with the visit. You can search either for:
Sex and age rules let you find sightings
Times sighted rules let you restrict to taxa that you’ve seen a certain number of times. If you’re looking for a bird you’ve seen only once, or one you’ve recorded more than a hundred times, this can do the trick. There’s five options:
Family rules let you restrict your sightings to just a single taxonomic family. This is particularly useful for some of the “special” reports (discussed later), like “Big” days or “total ticks” - in which country have you seen the most hummingbirds?
Subspecies rules are useful for those of you out there who’d like to ensure that sightings are assigned to a subspecies when possible. There’s two choices:
Last but not least, Sp./Hybrid rules let you find sightings that are “sp.” or “hybrid” sightings. This is particularly useful for resolving splits and other differences between taxonomies.
You’re not limited to just one rule.
To use multiple rules, click the small plus sign (+) at the right. To remove a rule, click the small minus sign (-) to the right of the rule.
You can choose, for each rule, whether that rule should be an And, an Or rule, a Never, or a Never All rule. Any sighting must:
If there’s any Never rules, then you’ll only get species if none of the sightings for that species match any one of those rules, each one taken separately. If there’s any Never all rules, then you’ll only get species if none of those sightings match all of those rules together. (See below for an example that should be clarifying.)
So if you want “Endangered species I saw in Ecuador or Peru, but only in 2000”, then that would be:
The order of rules does not matter. Here’s what that report looks like:
An example of a Never rule: if you want to find out “all the species that I’ve recorded as “Heard only” but never seen”, then that would be:
Never and Never all are the same thing when you have just one such rule, but very different when you have multiple “Never” or “Never all” rules together. The following example might help... If you were working on a big year for California, you might want to find a list of birds that you have seen in California at some point, but you haven’t seen in California this year, then you might try:
But this will always give you an empty report, because any sighting that matched rule #1 couldn’t possibly match rule #2. Again, each Never rule is applied on its own.
In contrast, if you tried this:
… then you get exactly what you’re looking for. This is anything you’ve seen in California, but has not been seen in California during this year. All of the Never all rules are applied together.
Once you’ve selected rules, you can scroll through the list of recorded species.
Scythebill will only show species if at least one sighting matches the rules you’ve chosen. Scythebill also shows family totals (5/11, etc.) if it has a checklist for that location, or for world lists.
If you select a species, Scythebill will show you all the matching sightings (again, only those sightings that match the rule). There’s a field near the top where you can enter a species name and click Jump to to jump straight to that species.
If you select a sighting, Scythebill will show you the sighting details, and let you edit in-place. You can set any of the sighting fields here, even if changing that value means the sighting doesn’t match the report rules anymore! Sightings that don’t match the report rules will still appear in the report until you click Update report…, so there’s no need to worry about sightings disappearing out from underneath you. (This button doesn’t appear unless you’ve made an edit that would call for this button.)
Example: You’ve generated a report of sightings from 2002. One is incorrect, and should have been in 2003. You make that edit and click Save. The 2003 sighting is still visible - so if the edit was a mistake, or needs more changes, you can fix it. Now, you click Update report… The 2003 sighting disappears.
If you’ve made a mistake in your edits, click Revert before clicking away.
If you want to see (and maybe edit) information about the overall visit that includes that sighting, click Visit data...
You can edit more than one sighting at a time. Select multiple sightings by shift-clicking to extend the selection, or command-clicking (MacOS) or control-clicking (others) to add additional sightings one-by-one. You’ll get a screen like the following example:
This screen lets you set most (but not all) of the fields of a group of sightings. (Specifically, you cannot currently edit the notes field at this time.)
Note in this example that the day and month fields are blank, but the year field and all other fields have a value. It’s this way because all of the sightings are in the same year, were not “Heard only”, etc. - but they are in different months and days-of-the-month.
Set all the fields as needed, then click Save to make those changes and Revert to ignore those edits.
You can also edit all of the sightings for an entire report, across all species! Click the Bulk edit… button at the bottom of the report window.
Example: You’ve entered a lot of sightings in Peru from 2000, but then realize you actually took that trip in 2001! Just:
Once you’ve generated a report, you can:
The next few sections will describe each of these features.
Clicking the Export… menu, and choosing … to a spreadsheet brings up the following dialog:
In turn, these options are:
Once you click OK, Scythebill will you prompt you to save the spreadsheet, with a default name based on the report rules. When you save it, Scythebill will automatically open the spreadsheet in the default program installed for spreadsheets (if you have one).
The spreadsheet has the following columns:
Reports can be saved for importing into eBird. To import, you’ll need to:
Even if you use the IOU list for your own record keeping, Scythebill will always export to eBird with the eBird/Clements taxonomy - which is what eBird uses. Scythebill will also automatically send eBird/Clements groups but not subspecies - again, matching eBird’s support.
Scythebill will only send a record to eBird if it:
The first two rules are to comply with eBird’s sighting policy; they want detailed data, and can’t do much with data missing this much information. (I’ve been told that there is a way to import sightings with vague locations or dates; I’m looking into it.)
Scythebill will send hybrids and sp’s to eBird. eBird supports some but far from all possible hybrids and sp’s, so some of these will need to be ignored from within eBird.
Scythebill will send visit data for the “protocol”, number of observers, duration, distance covered, and area covered fields, and will use the “Complete list of sightings?” checkbox as well when entered.
eBird has a 1 megabyte limit for imports. Scythebill will automatically split the export into multiple files (ebird-export.csv, ebird-export-1.csv, etc.) when you’re getting near the 1MB limit.
Reports can also be saved in Scythebill’s own CSV format, which provides a high-fidelity way to extract sightings for a single report with all the data attached. Click the Export… menu, then … to Scythebill.
This is not a particularly good way to backup your data, as it just saves sightings for a single report. For example, it can only save sightings for a single taxonomy at a time; when you export for an extended (non-bird) taxonomy, it’s saving the sightings but not the extended taxonomy itself; it doesn’t preserve saved reports; it doesn’t save custom location checklists.
For backups, please use either the “Save a Copy as…” menu item, which saves the entire .bsxm file, or even better, enable automatic backups in the Preferences screen.
The trip report feature lets you take all the sightings from a trip and get a quick start on writing a report for an entire trip - pick a report like "Location" is in "Brazil" and "Date" is in "2010", then create the trip report. Once you’ve got a report generated, click the Export… menu, then … as a trip report.
You’ll get a dialog like this:
The four choices here:
This all feeds off of your report settings, so if you request “Show subspecies”, then the trip report will include subspecies. And, perhaps most interestingly, if you request “First records (lifers), first records in World, should be highlighted”, then species that are lifers will appear in bold.
After you click OK, you’ll get a screen like this (these three screenshots show the three parts of the report for a trip I took to Guatemala) :
If all you want is to look at the report, you can scroll through it and read it here. Scythebill will also automatically put the report into your computer’s clipboard, so you can go to a word processor, text editor, or email program and paste the report.
Many birders are interested in seeing at least one bird in as many families as possible, or in seeing all the birds in a family. The family report makes this easy. Once you’ve got a report generated, click the Export… menu, then … as a family report.
You’ll get a dialog like this:
First, you can choose whether you want to include the scientific names of each family. Then, you have three choices for how to order the families:
After clicking OK, you’ll get a screen like this:
Down at the bottom, there’ll be a families total, e.g. “Families: 224 of 250”. (In future versions, this will move to the top.)
If all you want is to look at the report, you can scroll through it and read it here. Scythebill will also automatically put the report into your computer’s clipboard, so you can go to a word processor, text editor, or email program and paste the report.
This all feeds off of your report settings, so if you want to know “how many families have I photographed”, for example, that’s as easy as you can imagine. And more importantly, as much as possible, this also takes into account the location you’ve chosen, at least if Scythebill has checklists that would let it do so. So if you want to know if you’ve seen at least one bird in every family recorded in, say, the ABA listing region, you can do that!
Scythebill can export records into a CSV format that iNaturalist can import. Once you’ve got a report generated, click the Export… menu, then … to iNaturalist. Save the CSV file, then:
Note that these imports do not include any photos you’ve added to your Scythebill sightings; you'll have to upload those manually to iNaturalist if wanted.
Scythebill can export records in a CSV format that BirdTrack can import. Once you’ve got a report generated, click the Export… menu, then … to BirdTrack. Save the CSV file, then:
For BirdTrack to import sightings successfully, your locations will need latitudes and longitudes. Use Browse by location to ensure your locations have these associated with your locations.
I’ll admit it… Scythebill cheats here. It doesn’t directly print - instead, it creates a simple file and asks your web browser to print it. In practice, this works quite well, and saved me a ton of time.
Clicking the Print… button brings up the following dialog:
In turn, these options are:
When you click OK, Scythebill will open up your web browser and show you a print dialog. Scythebill is absolutely not loading or sending anything to the internet here - it’s only using the web browser as a convenient tool for printing.
Most birders have a few lists they care deeply about - whether it’s your local patch, your world list, a year list, or anything else. Scythebill can remember these reports so that they’re always at your fingertips.
After defining a report, just click Remember… Pick a name for the report (Scythebill will guess one for you), and that’s it! From this point on, when you go the main menu, you’ll see reports. Here’s four I’ve got:
You can delete a list by clicking on the red X. Or go straight to the report page by clicking on the report name. The report totals are always up-to-date, and flipping between the eBird/Clements and IOC world lists updates those totals instantly.
The Browse by species page lets you look through all of your sightings by species, rapidly seeing what you have (and haven’t) seen. It also lets you edit your sightings, add and remove them, and move them between species (or subspecies).
When you first click Browse by species, you’ll see a page like this:
From top-to-bottom, left-to-right:
The main species browser has one column for each major taxonomic level. In the leftmost column are all the Orders of birds (given by scientific name). When you select an order, the next column to the right shows all the Families in that order (given by English name and scientific name). And when you select a family, you’ll see all the species in that family (again, by English name and scientific name).
Note that Scythebill doesn’t use genera as another column in the browser, though you can certainly see it in the scientific names of the species.
If you’ve chosen to display groups or subspecies, those will be in columns even further to the right.
If you don’t keep track of orders and families, remember, the Jump to button will take you directly to the species you’re interested in!
Once you’ve selected a family, the list of species will look like:
Each species is shown either in bold or italics. Bold means you have entered records of this species. Italic means you haven’t. Below the (scrollable) list of species is a box with a brief summary of the range, IUCN Red List status, and alternate names - in this example, the endangered Titicaca Grebe, also known as Short-winged Grebe, found only on Lake Titicaca in Bolivia. (And as you can see, I haven’t seen it.) The “Range:” text is underlined to show that it’s a link - click it, and a page will open in your browser with an interactive world map (like this one for Greater Crested Tern).
You can also see the Add sighting button is now enabled, since a species is selected. If you click Add sighting, Scythebill will add a new, entirely empty sighting - no date, no location, and select that sighting so you can enter details.
If you select a species, you’ll see the full list of sightings, like here:
These are sorted from newest (at the top) to oldest (at the bottom).
If you change the Show… menu to show subspecies, there’ll be an extra column when using the IOC taxonomy; here’s a sighting of the “leucogaster” subspecies of Northern Slaty Antshrike:
… and one or two extra levels in eBird/Clements; here’s a sighting of the “leucogaster” subspecies of the Marañon “group” of Northern Slaty-Antshrike:
You can also change the Show… menu to just show groups. This will have no effect unless you’re using the eBird/Clements taxonomy - the IOC taxonomy only supports subspecies.
If you select a single sighting, you’ll get details about the sighting and a chance to edit it.
This panel lets you edit all fields in the sighting, including date and location, and lets you attach photos to the sighting.
If you want to change the location to one that already exists, just use “Choose-your-own abbreviation” to pick that location. To enter a new location, then:
If you’ve changed anything about the sighting and would like to discard it, click Revert. Otherwise, click Save or just click anywhere else to keep those changes. Click Visit data… to open a dialog letting you see (and edit) information about the overall visit.
You can select multiple sightings by either:
Once you’ve done this, you’ll see a panel like the following:
This is the same screen as shown when editing multiple sightings of a single species in Show reports, so follow the same instructions here .
In “Browse by species”, you can only edit multiple sightings of a single species at one time; if you need to edit multiple sightings across multiple species, you’ll have to do that with the Bulk edit… button in Show Reports.
The “Browse by species” page also lets you move sightings between species and other species (or subspecies).
You can do so either with drag-and-drop or with Cut and Paste.
To move one or more sightings from one taxon (a species, a subspecies, or an eBird/Clements group) to another, just:
Of course, you don’t have to paste - so you can use Cut… to delete sightings as well.
The Browse by location page lets you:
When your first click Browse by location, you’ll see a screen like this:
Up top is a typical Scythebill “Choose-your-own abbreviation” field; pick a location, click Jump to, and you’ll jump directly to a single location. A second choose-your-own abbreviation field lets you enter a species name and jump to that. Finally “Only visited locations?” lets you hide places you’ve never visited when it’s checked.
There’s also a tree on the left - here, you’re just seeing the top-level continents and oceans. Click to a select a location, and double-click to expand so you can see that location’s contents (all the locations within). Or, once any location is selected, use the up and down arrows to change the selection, and right arrow to expand and left arrow to collapse.
Once you’ve selected a location, you’ll see a list of everything you’ve seen in that location. Here, I’ve selected North America, and expanded it:
At the top of the species list is a Visits entry; if you select that, you’ll get a list of all the visits. Up above the species list, you can see a species total (1343 species that I’ve recorded in North America, including Central America and the West Indies), along with more information: there’s 2,111 species recorded in North America, 412 of which would be lifers for me. And I’ve seen 565 of the 815 North American endemics. You can also see a list of locations within North America, and a number of those locations have green checkmarks - . Every one of those locations is one with a Scythebill checklist (342 different checklists in all)!
Let’s see what happens when I select the United States checklist:
You can still see a species total - 629. And the United States (counting Alaska, but not Hawaii) has 15 endemics. There’s also 139 species on the United States checklist that would be lifers for me. Many of those are “category 5” vagrants (in ABA lingo); selecting “Hide rarities?” shows a more realistic 38 lifers.
Also, instead of just seeing a list of all the species you’ve seen, you’ll also see:
You’ll also notice that the family headings have numbers attached. These show how many species you’ve seen in the family and how many are possible. In the above picture, I’ve recorded 46 waterfowl out of 63 total possibilities.
There’s also a few more options specific to checklists, which I’ll describe later in the checklists section.
Now, select a species, and you’ll see a list of all sightings of that species in that location, with the most recent at the top:
Finally, select one or more of those sightings, and you’ll get the standard sightings editing window discussed in earlier sections:
When you select the Visits entry, you’ll see all the visits you’ve made to that location:
… and then if you select one of those visits, you’ll see a list of species from that visit.
You can also select Visit data... to edit that visit’s data, or jump straight back to editing all of the sightings for that visit with an “Edit sightings…” button.
That’s a very quick overview of browsing; following sections will talk about using these pages to edit.
Once a location is selected, you can edit it with the fields at the bottom of the page:
From here, you can change the name directly.
You can also Edit… the location, which will bring up a window to let you edit the name, the latitude/longitude, the description of the location, or change whether a location is private (private locations won’t show up in exports to eBird or BirdTrack). Simply clicking the Edit… button will start Scythebill’s “geocoding” support, so you can use it to attach latitude/longitude to existing locations. Once you do attach a latitude/longitude to a location you’ll see a new place marker icon next to the name - as with Sunol Regional Wilderness above.
You can also Delete… the location. Deleting locations does not delete sightings. Any sightings will simply get moved to the parent location. In the above screen shot, deleting “Hayward Regional Shoreline” would reassign all of those sightings to “Alameda (County)”.
Note that these editing options are not available for built-in locations, whose name and type are permanent, and cannot be deleted.
You can add new locations right from this screen. Select the desired parent location, then click New… . You’ll get a dialog box for entering the new location:
You want to add a location for Point Reyes in Marin County, California, USA.
You can delete locations, too. Find the location in Browse by location, then click Delete…, then click OK.
This does not delete any sightings! It will simply reassign any of the sightings currently assigned to that location to that location’s parent.
You cannot delete built-in locations (like the countries, states, and US counties). You also cannot delete locations that still have child locations; you need to first move all of its children elsewhere, as explained in the next section.
If you’ve added a location to the wrong parent, you can fix that here as well. Select a location, and drag and drop it onto the new parent. If the new parent is off-screen (either above or below), just drag the location near to the top or bottom of the screen, and Scythebill will start scrolling the window for you, slowly at first and then faster.
You can also select multiple locations at once and move them all to a new parent, but they must all start as children of the same parent location.
One caveat: you cannot have two locations with the same name as direct children of the same parent. So, for example, if you accidentally added “Point Reyes” to California and another “Point Reyes” to Marin County, you cannot add the first one inside Marin County as well. If you run into this duplicate location problem, then (for this example):
This action doesn’t delete any sightings - you’ll have just one “Point Reyes”, and all sightings will belong there.
You can rearrange locations that contain “children” - all the children will come along for the ride. However, you cannot delete locations that contain children locations. If you need to delete such a location, you have to either move the children locations out from underneath it first, or delete all the children first.
When you select a single visit (atop the species list for a location), you have a chance to see the full list of species seen at that location (in the rightmost column):
If you then select Visit data…, you can edit the data for that visit:
You can edit all of the visit information described above for Enter sightings (visit comments, observation types, start time and duration, etc…)
You can also, very conveniently change the date or location of all the sightings for that visit. Just change the date or location (or both), and click “Save”.
Finally, if you want to edit the list of species recorded on that visit, click the Edit sightings… button, and you’ll jump straight to the species entry list.
The Browse by location screen is mostly for editing locations, but you can also add, remove, and edit sightings.
To add a sighting, simply select a species inside any location, and click Add sighting. (This is most useful for locations with checklists, since they’ll let you pick species you haven’t seen there yet.) This will give you a new sighting of that species in that location, without any date or other information.
To remove sightings, just select one or more sightings of a species and click Remove sighting…
To edit sightings, again, select one or more sightings, and change values of sightings. If it’s more than one sighting, you must click Save explicitly for anything to be saved.
Scythebill comes with built-in checklists for 342 of its built-in locations - virtually all of the countries of the world, all of the states of the United States, the provinces of Canada, the states and territories of Australia, and 7 regions of Indonesia. It also lets you define and share your own checklists.
The built-in checklists - which are defined for both the eBird/Clements and IOC taxonomies - provide a list of species recorded in that location, and also identify whether species are endemic to a region, an introduction, an escaped (but not yet established) species, locally (or globally) extinct, or if they are locally rare.
Note: “rarity” is now defined for the vast majority of the world. Where defined, it typically means “would require review before the record would be accepted”, so think “vagrant”, not “endangered”. This tracks the judgement of rarity committees where they exist (and have publicized their declarations), independent checklist sources where they exist, and my own judgement in the portions of the world where I couldn’t find any such information.
Checklists improve the “choose-your-own-abbreviation” feature when entering sightings - ensuring that even though Scythebill has world taxonomies, you get the locally plausible species first - but are most visible in Browse by location. As noted above, whenever you see a location with a green checkmark - - then that location has a checklist.
You can also select multiple locations at once to merge those checklists! Just control-click (command-click on MacOS) additional locations, and Scythebill will immediately show you a merged checklist. Species will be listed as endemics if they are found only in that combined set of countries.
And whenever you select such a location, you’ll get a new dropdown list near the top, just left of “Save as spreadsheet…”:
This list has six options:
For each of these options, you can select or deselect “Only rarities…” to remove any checklist species that are rarities; the lifer count will immediately update to reflect that choice.
The last of these options - New for a custom report… - lets you rapidly answer some fairly complicated questions about checklists. For example, let’s say you care about your Western Palearctic list, and you’re looking to see what species in Spain (or any other country with a checklist) would be new for that list. To do this:
You can use this feature to answer questions like:
When you’ve got an especially interesting checklist, click Save as spreadsheet…, and you’ll get a spreadsheet limited to just those species. This makes it easy to work up a “target list” for an upcoming trip.
If you find errors in the built-in checklists, please let me know.
Checklists can be saved as spreadsheets, which makes a convenient format for printing or otherwise manipulating the contents. Select a location with a checklist, click Save as spreadsheet…, and you’ll get the following dialog:
These options are:
In all cases, the choice of “Show everything”, “Your potential lifers”, etc. will be honored, and only those species will be included in the spreadsheet.
The spreadsheet contains a column that contains, for each species, a number. This makes it easy - if you’re doing checklists in a group - to get everyone on the right line.
Scythebill also lets you define your own checklists for locations. These behave just like built-in checklists except:
Best of all, Scythebill makes it easy to add checklists - if you’ve got a checklist on the web or even just a few trip lists, you can have a custom checklist in Scythebill in a few minutes!
To get started:
You’ll get two ways to start your checklist (in this example, I’m building a San Francisco checklist):
Start with your sightings gives you a checklist of just the species you’ve already seen in that location. This is a fine choice if it’s a location you’ve heavily birded, but it’s obviously useless for places you haven’t been to. Once you’ve started there, you can edit your checklist to add species you haven’t recorded yet but know to be present, or remove mistaken entries (see below).
Use copy-and-paste auto-magic is much more powerful. Instead of using your sightings, you’ll use existing published checklists or trip reports. It just needs to be something you can copy-and-paste. And it doesn’t even have to be just one source - if you’ve got five trip lists to a location, you can rapidly build a checklist that merges the sightings from all those lists.
If you click “Use copy-and-paste auto-magic” , you’ll get a page like this:
This page is just a big text box. When you paste in a checklist (for this example I’m pasting a 2007 San Francisco checklist), Scythebill will be ready to go.
Hint: before getting started, you might choose a taxonomy - eBird/Clements or IOC - that most closely aligns with the document you’ve found. It’ll give Scythebill the best chance to find as many species as possible. Whichever taxonomy you use to create the checklist, you’ll be able to use it with your preferred taxonomy.
Click Start, and Scythebill will scan this document, looking for any English or scientific names it can find in the mass of text. When it’s done, it’ll strip everything it found out of the document, and leave you with what it couldn’t parse into the name of a species:
Scythebill found 389 species. (“Carduelis tristis” is left behind because this is a 2007 checklist, and American Goldfinch is now Spinus tristis - but it found the common (English) name anyway.)
At this point, you can click Try harder, which will search once more, looking also for alternate names.
Searching for alternates found only one new species (and even that wasn’t new - it had found it by the scientific name in the first pass). This wasn’t especially useful here, but it’s invaluable for lists using non-standard names.
At this point, you can scroll through the remainders looking for any names that were still missed, and get ready to add those manually - in this case, there were just two. (Common Moorhen and Sage Sparrow, both of which were split since that 2007 checklist was released.)
You can also paste in a new checklist or trip report, to augment this one, and merge the species from that source with the first one, now by clicking the Add more button and Try harder.
Once you’re satisfied with everything extracted here, click Create a checklist, and you’ll have a chance to edit the checklist results (Or, if you’re just not satisfied with the results, click Cancel.)
The text analysis here is smarter than you might guess. Instead of looking for exact matches, it ignores hyphenation, spacing, capitalization, “gray” vs. “grey”, and more. If you find names you think should have been found, let me know! But also: the automatic detection here is strictly limited to species found in the parent checklist, if one exists. So for San Francisco, only species on the California checklist would be considered. For Capetown, only species on the South Africa checklist would be considered.
Once you’ve clicked Create a checklist (either from auto-magic checklists, or from your original sightings), you’ll get a chance to edit the checklist:
This is a large table of all the species you’ve placed in the checklist.
If you want to add species, choose a species in the field near the top, and click Add species.
To remove a species, click the red X on the right on that line.
To update the species status - Introduced, Escaped, Extinct, Endemic, Rarity - use the drop-down menu in the third column. Note that values here automatically default to the status in the parent checklist - Rock Pigeon is an introduced species in California, so that same default is chosen for the San Francisco list, and Snowy Owl is a statewide rarity. (You’ll have to manually select site-specific rarities as needed.)
When you’re satisfied, click OK. (Or click Cancel if you’ve decided not to - but you will lose your work.) The checklist will be saved in your sightings .bsxm file not in Scythebill, so you can upgrade Scythebill or move your sightings file to another computer without losing the checklist.
You can always come back and edit the checklist:
… and if you want to get rid of the checklist, click Delete checklist… from the Edit checklist page.
Once you’ve created a custom checklist, all it takes to create a file suitable for sharing is to
Now share the file - email, your own website, DropBox, Google Docs, anything you want. (Checklists are small - the San Francisco list is only 29k).
Hint: These checklist files are ordinary CSV files that you can open in any number of programs like Excel, OpenOffice, or Apple Numbers. Just ignore or delete that first column (which has a Scythebill code), and you’ve got a spreadsheet of common (English) names and scientific names.
When you get checklist files and want to import them, just:
If you already have that checklist, you’ll get a warning:
Once imported, you’re free to edit that checklist and share your edited version.
Scythebill’s built-in checklists can’t be edited from within Scythebill. Instead, fixes come in new versions of Scythebill. This ensures that all users benefit from corrections, and that taxonomic changes make their way to everyone.
That said, I still need your help! Many users have used the Verify against checklists… item in the File menu to find problems and send them my way, and the checklists are much stronger as a result. If you want to help even more, you can use the Correct checklist… feature.
When you’re done, you’ll have generated corrections I can quickly and easily apply to Scythebill and include in the next version. If you’re doing this, though, there’s some basic ground rules.
First, records should generally be official, in some way. Many countries and states have an official body that maintains a checklist. Please tell me what source you’ve used for the records. I don’t doubt your first-country records, but if they haven’t been submitted and approved officially, I’d rather not include them in the checklist. Do not use Wikipedia or Avibase; neither are official (and copying from Avibase without permission is not cool).
Second, please be careful and consistent with the status field.
Third, please make sure you have permission to use the checklist. For checklists made publicly and freely available by the official body, this is usually clear. As open-source freeware, I need to be very careful about intellectual property, and avoid anything that could endanger my ability to distribute Scythebill.
Few of you will come to Scythebill without any old sightings. If those sightings are all written down in notebooks, Scythebill’s fast data entry will get that data in fairly quickly. But if that data is already in computer files, you can get it into Scythebill much, much faster.
Scythebill supports thirteen import formats! Six are from free software:
BirdTrack is a popular bird recording site for Great Britain and Ireland.
Scythebill also supports importing from these seven pieces of commercial software:
These imports all pretty much get imported into Scythebill the same way, so the next section will talk about how to use the imports in general, and afterwards, each of these formats will be discussed.
Note: As of 15.0, the Flickr, iNaturalist, BirdTrack, Birder’s Diary, Wildlife Recorder, HBW Alive, and Wings imports are all fairly new - if you run into any glitches with these (or any other formats, really), please let me know! The only way I can improve results, especially for commercial software, is by working with you. Many improvements have already been made in just this way.
To start an import, use the Import sightings… option in the File menu (from anywhere). You can import any number of files, any number of times. Or - if you’ve just started using Scythebill, click the Import records button from the first window. You’ll get this screen:
eBird and Scythebill formats appear by default - the other seven are inside the “Import from…” menu. (But after you use one, it’ll automatically get its own big button to make future imports of that type easier.)
Click to choose your format, then pick a file to import. If everything neatly lines up, that’s it - you’ll get a confirmation of the successful import, and you’re done! But you may need to give Scythebill a helping hand for species or locations it can’t identify automatically.
If Scythebill can’t identify a species, you’ll need to resolve it with a window like this one:
In this example, an import refers to Long-tailed Antbird - but that species has been split multiple ways, and nothing has that name anymore. (Scythebill does automatically find species if it matches an alternate name it knows, but only if that’s an alternate name for exactly one species) Choose a species (or a sp. or even a hybrid), then click OK. The page tells you how many species you have to resolve in total and how many you’ve handled already - here it’s 1 of 4, so there’s three more species after this one.
You can also click Drop species, which means that Scythebill will fail to import any of the records for that species. But it’s not so bad - Scythebill puts all of those failed entries into a new CSV file, so you can look through them and manually enter anything Scythebill couldn’t handle.
If Scythebill can’t identify the location, you’ll tell it about it with a window like this one:
If you’ve used location entry before, this is exactly that - Scythebill has a name already, and you need to tell it where that location is. You can read how to do this earlier in the manual.
Some import types - like BirdLasser - may give Scythebill a latitude and longitude without a name. In that case, Scythebill will try to identify that location using latitude and longitude, and give you a screen like this:
Here, someone’s been birding right on the border of Argentina and Brazil (so Scythebill can’t figure out what country is involved, just the continent!). But there’s a whole host of possible locations identified using Google and eBird; you can choose one of those, or manually enter a location name, as described earlier in the manual.
If Scythebill has a possible match for a location, you might see a window like:
… which will let you either pick an existing location, or enter a new one.
Once you’ve identified the location, either a Next or an OK button will become clickable (depending on whether there’s more locations to identify).
Finally, once all species and locations have been identified, you’ll get a window like this one:
If any of the sightings are “new” in some way - whether for your world list, a country list, a state list, a country list, or even an oft-visited site, or new for your current year list, Scythebill will immediately tell you this:
Everything has been imported successfully, and is ready to be added to your records file. You can still back out - click Cancel, and the import will be ignored. Click OK to accept the import.
If you clicked Drop species, or if some rows simply couldn’t be handled (perhaps because a Date field contained something that Scythebill couldn’t understand), you’ll get a window like this telling you of partial success:
In this case, almost all sightings were successfully imported, but I clicked Drop species for one species with two sightings. Both of those sightings are stored in a separate CSV file, so you can easily look at those rows and manually enter the data if desired. Again, you can always click Cancel to drop the import.
You might, on occasion, see a window like this:
This warns you that it looks like you’re importing a lot of sightings that you’ve already imported! You’ll most likely want to click Cancel. This protection is really useful for saving you from an annoying and tedious cleanup job. You can also click Import anyway, which will give you duplicate sightings, or Overwrite duplicates, which will drop any of your existing sightings in favor of the new content (really handy if you’ve made some edits outside of Scythebill and want to keep them).
After you’ve imported, I highly recommend using Verify against checklists… (in the File menu). You may find errors in the Scythebill checklists (and if so, please send them to me!), but you may also find mistakes in your original data, or even better, some “armchair ticks” when your data hasn’t kept up with the latest taxonomic changes.
You might also use Find checklist rarities… (in the File menu). While you may have seen rarities, it’s worth occasionally double-checking that your rarity sightings are intentional, and not mistakes in data entry. You may find errors in the Scythebill checklists - “rarities” that aren’t rare at all, and if so, please send them to me.
eBird is, of course, a popular destination for uploading sightings. And because of that popularity, many, many programs support uploading to eBird. Scythebill takes advantage of that by letting you import not only files you download from eBird, but also files you upload to eBird.
Scythebill supports four different eBird formats - but it figures this all out on its own, so you don’t need to tell it which of the formats you’ve supplied:
A few special features are worth noting.
First, Scythebill is specifically good at automatically filtering “My Data” imports - you can import “My Data”, then come back later after you’ve added more checklists and grab a new set of “My Data”, and Scythebill will automatically only import checklists from new dates.
Second, some people use zero counts of a species in eBird to indicate that while the bird is present, they did not see it. Accordingly, Scythebill will automatically detect this and change the sighting status to “Not by me” (which is not countable).
Third, while Scythebill does support two-species “spuhs” (Common/Barrow’s Goldeneye, for example - in eBird terminology, “slash” taxa), it does not support genus or family spuhs (“duck sp.”, “gull sp,”). Accordingly, Scythebill will automatically drop such entries from imports (and tell you how many such sightings were dropped).
Finally, eBird has a lot of locations like “Yosemite NP–Half Dome” - multiple hotspots within a larger park. These are great for more precise locations, but annoying if you want to find out your total checklist for the entire park. If you’ve imported a few of these locations, you can put them inside of a “Yosemite NP” parent location, and Scythebill will automatically put new eBird “Yosemite NP” hotspots inside the parent location for you.
Avisys was one of the oldest pieces of commercial birding software, though it recently (August 2015) ceased operations. The most recent version does support exporting directly to eBird, and those files can then be imported to Scythebill as eBird imports, but Scythebill also supports using its built-in CSV export format.
Start by using Avisys’s List Records option, then click List. After that, click the Export button. Choose a "Comma-delimited, ASCII file”.
After that, Avisys will ask three questions:
Take the exported file (name it ending in either “.csv” or “.txt”).
If you don’t care about Avisys “field notes”, continue with Scythebill’s import page. Otherwise, you’ll need to produce a second file with the following instructions:
Back in Scythebill, after clicking Import from Avisys…, choose the first export file generated by Avisys. You’ll then see a dialog:
If you created a field notes file, click Yes, and locate that file. If you didn’t, then click No and the import will proceed.
Scythebill understands some of the Avisys flags - male, female, immature, heard-only, and photographed. Other attributes are still preserved in the “Notes” field in Scythebill, so you call still query for them on the reports screen, and bulk edit from there when helpfull.
Avisys’s location lists in general did not supply a full, modern set of locations, so Scythebill’s taken a few necessary liberties:
After importing, it’s always a good idea to use Scythebill’s Verify against checklists feature, especially when you’re importing from an older export with an old taxonomy to catch issues caused by species name and taxonomic changes.
A note of caution: Avisys failed to export place names and species names containing double quotes (“) correctly. When left present in the export, some records may fail to import, but the overall import should still succeed, and Scythebill will produce a file containing exactly the failed records.
BirdBase/BirdArea was another mainstay of the birding community, and it has also recently closed its doors. Scythebill directly supports BirdBase CSV exports, so those users have an easy home for all their data. You’ll want to use BirdBase’s Display feature with an Output Destination of “Data exchange file”. That’ll give you a CSV file, which you can open with Scythebill using the Import from BirdBase… button on the Import screen.
Generally, the import should proceed smoothly - Scythebill will correctly import data like species counts and “uncertain” sightings - but there are a few things to know.
First, the "S1" through "S4" custom flags cannot be directly interpreted by Scythebill. But they are kept in the Notes field. You can use Show reports to find all notes containing those strings, and then bulk edit to set a Scythebill field like "Heard only" en masse.
Second,the Home, Region, and Local options of BirdBase are added as "BirdBase Home", "BirdBase Region", or "BirdBase Local" locations when those BirdBase flags are set, so this data should be preserved.
BirdBase’s location lists in general did not supply a full, modern set of locations, so Scythebill’s taken a few necessary liberties:
Finally, BirdBase did not properly escape double-quotes (“) in description fields. Some description fields may be partially truncated because of this (but the rest of the data should be imported without issue).
After importing, it’s always a good idea to use Scythebill’s Verify against checklists feature, especially when you’re importing from an older export with an old taxonomy to catch issues caused by species name and taxonomic changes.
BirdTrack is a popular site for bird recording in Great Britain and Ireland. Scythebill can import from the .xlsx files it exports. When logged in, visit Explore data, then Explore my records. This will take you to this page, which lets you choose years (if you want all of your data, choose “All” dates and “World” places.) Keep output as a table, then select “Create output”. When the table appears, choose Download. You should get an XLSX file which you can import directly into Scythebill.
Scythebill supports its own custom import format. This is useful for a few reasons:
The imports are in CSV format (that’s “Comma-separated Values”). The easiest way - by far - to get a properly formatted CSV file is to create a spreadsheet in Excel, OpenOffice, Numbers (or any other spreadsheet program) and save as a “.csv” file, but you certainly can use a text editor if you’d rather.
Scythebill CSV files require a header row. I can't promise to forever keep the order of columns exact, so if you're going to write code parsing these files, look for the values in the header row, rather than hardcoding indices. (This also means you don’t have to care about getting the order right if you’re tweaking your own spreadsheet content - but you do have to get the column header names correct.)
Scythebill also uses the UTF-8 character encoding. (If you don’t know what that means, don’t worry too much - this is an option you can select when you save a spreadsheet as a CSV file, and it affects how non-English characters are understood.)
Exports and imports use either the eBird/Clements or IOC taxonomies - whichever you've selected at the time of the import or export, that's the one Scythebill uses. (This also means that if you re-import, you should have the same taxonomy selected.)
Scythebill supports a lot of column headers, but you don’t have to use them all. See below for more info on just how little you can get away with, but here’s the full list of supported columns:
Extra location columns: the following headers can add additional information to a location, but only the first row per location that has this info is used, and it’ll be entirely ignored if you already have a location with a matching Country/State/County/City/Location 1/etc...
Extra visit columns: the following headers can add additional information to a visit, but only the first row per visit that has this info is used, and it’ll be entirely ignored if you already have a visit with a matching date/start-time/location combination:
The order of these columns does not matter (at all). All that’s necessary is that the header row have the correct title for each column.
It’s also preferred that the date be in YYYY-MM-DD format (for example, 2017-12-31); in versions of Scythebill before 13.9.1, this was absolutely required, but as of 13.9.1, Scythebill will work hard to interpret just about any date format.
That’s a lot of fields, but if you want to get your own data into Scythebill, you need far, far less. The only required columns are:
… and for that matter, you don’t even have to have values in the Date column; it can be an empty column. You can even leave values in the Country column empty too! If you are including countries, then Region is a really handy column to include, though; without it, countries Scythebill can’t interpret all end up in North America. Any other columns you supply will be used; any extra columns you have (which don’t match a name above) will be ignored. In all cases, it’s the header text - the first row of the CSV file - that is used to identify columns, not the content of subsequent rows.
Here’s an extremely minimal example of the format, with just a common name, a date (missing from one row), and a country.
Common, Date, Country
Ostrich, , Kenya
Wrentit, 2010-03-15, United States
If you need more data - comments on the sighting, more specific locations, etc. - then add more columns by adding extra entries in the header row, then extra data in each row as needed.
Here’s an even more minimal example - just a list of common names!
Common, Date, Country
Imported this way, you won’t have a date or a location attached to any of these sightings - but it will get your lifelist started if that’s all the data you have.
Scythebill can also import “trip” exports from Wildlife Recorder, and should preserve a large majority of your data entry. Please export with headers and coordinates enabled, and let me know if you have any issues.
These imports work much better - you have a lot less manual work to do - when you have location names and not just latitude and longitude. Some users may find they have more success with asking Wildlife Recorder to export to eBird, and then using Scythebill’s eBird import feature.
This support is relatively recent at this time (added in Scythebill 13.9.1), so please let me know if you have problems or if it works well for you.
Scythebill can also import CSV files exported from BirdLasser, South African software for entering field sightings. These files sometimes come with just a latitude and longitude for each sighting, so Scythebill leans heavily on eBird and Google support for discovering location names. Scythebill will automatically derive data like distance travelled and time spent in the field from all of your various locations.
To import from iNaturalist, visit https://www.inaturalist.org/observations/export.
The imports will automatically link Scythebill to any photos you uploaded on iNaturalist.
iNaturalist lets you store observations across far more than just birds. When importing, first make sure that you’ve downloaded and imported any Extended Taxonomies that you need for the relevant observations. Then, when importing in Scythebill:
You’ll need to go through this process once for each Scythebill taxonomy.
Scythebill can import file exports from observation.org, waarneming.nl, and waarneming.be. I’d describe this import as beta-level - for one, it seems like the CSV format used by these sites is evolving.
When exporting from the older waarneming sites, please make sure that “simple CSV” is not checked. I’d also recommend using either English or Dutch as the language (the language affects the exports, which is a bit unfortunate - I don’t think this issue applies to new observation.org exports).
The "Ornitho" platform encompasses a number of websites across Europe - Germany, Poland, Austria, Switzerland, Italy, and parts of France and Spain. Scythebill now supports imports from this platform - the seventh different import format supported by Scythebill!
From the import screen, click the new "Import from Ornitho..." button, and choose a "TXT" format that you've extracted from Ornitho. (Unlike with HBW, there are no limits on the number of sightings that can be imported into Scythebill in one go.)
Before importing, it is strongly recommended to set the "Species name in IOC" preference to your local language. This will significantly improve the accuracy of your imports.
This support is early, and there may be glitches - especially since I've only been able to test against German and Swiss imports. Let me know if you run into any problems!
Bird Brain is MacOS-only software for bird listing. To import, just:
As best I know, this only works for Bird Brain 7... it might or might not for earlier versions, and if you happen to use such an earlier version, please let me know one way or the other.
Birder’s Diary imports were added in Scythebill 14.2. As with any format, please let me know if this works for you or has issues - I’m eager to improve results, but can only do so with your help.
Use the “Import/Export Data” screen, and then save “Sightings” data.
If this gives poor results, let me know;. You might also try using Birder’s Diary eBird exports - Scythebill can import directly from those exports without uploading to eBird. But as best I know, it only supports the eBird checklist import format, which creates a single checklist at a time, rather than the eBird record format, which supports bulk export and import.
Flickr imports are a very new feature (as of 15.0). Scythebil can import entire albums of photos, and assign them to species. You’ll need to have entered the species names (common or scientific or both) into the title or description.
Flickr imports start with a page for entering a Flickr album URL and a location:
Visit Flickr, and visit an album of yours, then copy the URL from the browser and paste into the “Flickr album URL” field. (It should look something like “https://www.flickr.com/photos/YOUR_NAME/albums/72157711345111716”) It is possible to import single photo URLs too.
If at all possible, choose a location - a country, or state, for example - for the import. Scythebill has to look through the photos for species names, and it can do a much better job of that if it knows where in the world these pictures were taken. Scythebill will also do a much better job of handling future splits with that location information. You can import photo albums without a location if you need, just know it won’t give results that are quite as good.
There are some limitations:
When Scythebill finds multiple or conflicting names, it will create “spuh” sightings for them. So a photo with multiple species (a roost of terns, say), it’ll generate a single sighting with all those species as one very odd “spuh”.
Other information imported from Flickr:
HBW Alive was shut down in 2020, but if you exported your data from there before it shut down, you can import it into Scythebill. Either XLS or XSLX files should work. (DOC files do not.)
Wings has been defunct for some time, but Scythebill can now import directly from its exports. To prepare the exports from Wings, you'll need to do a series of exports, all in XML format:
From there, go to Imports in Scythebill, choose Wings imports, and in the file chooser that opens, select all eight XML files that you produced in Wings. (I wish Wings had chosen to support a simpler export format for its locations, but alas it did not!)
Scythebill 14 added support for multiple observers. This lets you track sightings for multiple observers in a single .bsxm sightings file. This is great for a couple of cases:
Support for multiple observers is mostly hidden explicitly enabled in Scythebill
To turn on this feature, visit the Preferences page, and click the “Enable multiple observers” button near the bottom:
After clicking this, you’ll get a dialog to create your first observer:
As you enter a name, Scythebill will automatically pick an abbreviation for you. If you don’t like the abbreviation, you’re free to edit it - but abbreviations must be unique among all observers. (Names do not have to be unique.)
Once you’ve chosen a name, you’ll get another window asking if you want to add that observer to all sightings:
If you click “Yes”, then all sightings up to this point will be updated to add that observer. If you click “No”, they’ll be left alone: you can still do this later. (See below for how.)
After this, you’ll be back on the Preferences page, which will have a new section:
Use the Add… button to add new observers. Use the Edit… button to change the name or abbreviation of an existing observer. Use Delete… to remove an observer. Delete… will give you three options if you have any sightings were the deleted observer was the only observer:
Cancel will halt the deletion. Leave empty will keep those sightings around, but with no observers. Drop sightings will remove the sightings altogether.
Now that you’ve enabled multiple observers, several parts of Scythebill will have additional features, each of which will be discussed below.
With multiple observers enabled, just to the right of the Taxonomy chooser at the top of every page will be an Observer field:
You can enter this to automatically filter everything in all of Scythebill down to that user’s sightings, so that:
You can always erase the value of this field to go back to generating reports across all observers.
With multiple observers enabled, the first page for entering sightings will change from “When and Where?” to “Who, When, and Where?”. Go to the “Who?” field and start entering either observer names (with the standard “Choose your own abbreviation” feature of Scythebill) or observer abbreviations, and click Add or use the Enter key.
If you add an observer and want to remove them, just click the red X to the right of that observer’s name. (Or use the tab key to select the X and tap the space bar.)
The observers you add here will be the default choice for any sightings (a much easier way to handle things when most species were seen by the same set of people), but as you’ll see you can add or remove observers for single species later.
Scythebill will also remember the list of observers
Afterwards, the last page - where species are entered - will have a new “Observers” column with a list of observer abbreviations.
Expand with the gray arrow (on MacOS) or plus icon (Windows and Linux) at the left, and you’ll have a new “Observers” box, where you can add additional observers for that species alone (by entering a name and clicking Add) or remove observers (by clicking the red X to the right of the name).
(It is not possible to have different flags per observer - for example, to have one observer that is “heard only” and another where it is not, or to have different numbers for the different observers.)
In Show Reports, you’ll get a new report option, Observers. This option has four choices:
In addition, the Bulk Edit screen has two new options:
In the first “Observer name” field, add observers, and click Add. Any observers entered here will be added to all the bulk-edited sightings when you click OK in the Bulk Edit dialog.
In the second “Observer name” field, add observers, and click Remove. Any observers entered here will be removed from all the bulk-edited sightings when you click OK in the Bulk Edit dialog.
For example, in the following example, one person (Peterson) would be added to all sightings and another (Audubon) removed from all relevant sightings if you click the OK button. (There’s no harm for adding an observer that is already present or removing on that isn’t present - Scythebill will just ignore those cases.)
Wildlife Recorder and Birder’s Diary imports both support observer information, and Scythebill will automatically register observers as you import.
Scythebill imports optionally support observer information, depending on the presence of at least one of the Observer and Observer Names columns. (Their format is defined in the next section).
If you’re using an import format that does not support observer information, then Scythebill will ask you to enter the list of observers for that import during the import.
Scythebill exports - once multiple observers are added - will contain two new columns.
These two columns are guaranteed to be in the same relative order - the first name corresponds to the first abbreviation, and so forth.
Scythebill 13 added support for extended taxonomies - so finally, you can keep track of more than just your bird sightings.
Unlike eBird/Clements and IOC, these taxonomies are not maintained by me! It’s enough work keeping these two avian taxonomies up-to-date (as well as the hundreds of checklists).
Extended taxonomies come in two forms;
(You can easily convert from one to the other: load as .btxm and export as .csv, or vice versa.)
Start by using the use the Manage taxonomies… item in the File menu; you’ll be taken to this screen:
Extra taxonomies can be downloaded by clicking Download taxonomies…, or just by visiting http://www.scythebill.com/download.html#extended , and downloading one of the “.btxm” files found there. Each of these represents a single extended taxonomy. (As described below, you can also build your own from a CSV file.)
Click the Add a new taxonomy… button, then open the .btxm file you just downloaded. That’s it! The taxonomy will now be included within your main sightings file, so you don’t need to hang on to the .btxm file.
This does mean that if you use multiple sightings files (for multiple people), you must import the taxonomy into each sightings file. But it also means that when you move your sightings file from one computer to another, you don’t have to re-import the taxonomy to use that sightings file, and you don’t have to worry about backing up the extended taxonomy anywhere. (Please do worry about keeping your sightings backed up!)
Once you’ve added a new taxonomy, it is immediately available in the Taxonomy menu at the top of every screen:
Just switch to that taxonomy, and everything changes to it. So, for example, if you switch from “eBird/Clements” to “Mammal Watching”, then:
In general, you can only operate on one taxonomy at a time: Scythebill does not support generating reports simultaneously across multiple taxonomies (not yet, at least). But there is an exception - you can enter species across multiple taxonomies in one go, as explained in the next section.
When entering sightings, you can switch between taxonomies and enter sightings across all of them in just one go. For example, let’s take an afternoon in San Francisco. A Barn Swallow was flying over North Lake:
But a family of Raccoons were also present; so switch to the mammal taxonomy:
As you can see, your Barn Swallow sighting has disappeared from the screen - but it’s not forgotten. Look up on the top right, and you’ll see “0 species, 1 other taxa”; that’s a hint that even though there’s no mammals yet entered, there’s 1 “non-mammal” entered.
Here’s the screen after adding a Northern Raccoon:
Now, it’s 1 species, 1 other taxa.
You can freely switch back to one of the bird taxonomies and enter more birds, or switch to a third taxonomy and add, say, butterflies. And they’ll all get saved with a single click of Done.
Scythebill’s importing works for extended taxonomies too! You can import sightings using:
You currently cannot import to extended taxonomies using:
(If you have sightings for an extended taxonomy in one of these formats, just let me know.)
In all cases, the critical thing to remember is that Scythebill uses the currently chosen taxonomy to perform the import. So, if you’re using the Avisys CSV format, and you’ve used Avisys to store mammal sightings, then you need to:
If you happen to have the wrong taxonomy selected when you start an import, the likely outcome will be that Scythebill can’t figure out any of the species in the import, and you’ll see a screen like this one:
Just click “No”, switch the taxonomy, and try again.
Standard Scythebill exports and reports all work as they do for birds. Just select the taxonomy in the taxonomy menu, go to Show reports, and export either as a spreadsheet or a Scythebill CSV file.
(Note that you cannot export to eBird, for reasons that should be fairly obvious!)
Extended taxonomies are limited in a few ways at this point, some of which will definitely change in the future, and some of which may change in the future. (These limitations start with the most onerous and conclude with the most trivial, in my estimation.)
Extended taxonomies do not currently support checklists. There certainly won’t be any built-in checklists - that’s inherent in the concept - but you also can’t write your own custom checklists.
There’s also (almost) no support for generating reports across multiple taxonomies at once. So, if you go on a trip and record birds, mammals, butterflies, and dragonflies, you’ll have to save 4 reports to see the full story. (An exception: the recently added “trip reports” feature, inside Show reports, does let you include species lists for multiple taxonomies.)
Another issue that will affect some taxonomies more than others is that Scythebill offers the same set of fields across all taxonomies - so, yes, there’ll still be a “Heard only” field for your butterfly sightings. I acknowledge the nonsensical nature of this, but have no short-term plans to fix.
Finally, Scythebill doesn’t offer any support for editing an extended taxonomy inside Scythebill. Instead, export as a CSV file, edit in a text editor or a spreadsheet application, then re-import. This might be added in the future, especially for very simple edits (like fixing names, tweaking ranges, etc.).
Scythebill supports a simple CSV format for taxonomy import that can be generated by any spreadsheet. There’s a few rules to follow, though!
The first few rows must include the following information:
Each of these rows has two columns. (I’m showing them here with commas separating the column, but that’s for the CSV output. In a spreadsheet, that’s two columns.)
An example of the start of a taxonomy file:
Name,Mammal Watching January 2016
Credits,Jon Hall mammalwatching.com
The ID row is used to permanently identify that taxonomy, across versions, so users won’t end up with multiple copies of a single taxonomy, and Scythebill can support upgrading sightings from one version of a taxonomy to the next. Keep it short, but clear, and don’t put a date or version number in the ID! (And the ID is never shown to users, so don’t worry about that.)
The name is what’s shown to users, and should probably include a date or version.
Finally, the credits are essential for recognizing the work that goes into building these taxonomies! The credits are shown to users when they first import the taxonomy, and in the About… page of the Scythebill app.
After this preface, you’ll need one header row, then all of the taxa from this taxonomy.
The header row must have the following columns (sequence and capitalization doesn’t matter):
And that’s it! Note that - yes - you must have orders and families, and Scythebill does not support specifying Phylum, Class, or any smaller breakdowns like “Infraorder” or “Subfamily”, etc. You also must have scientific names; no “common name-only” taxonomies.
There’s a slew of optional columns, too:
You don’t have to specify family, order, genus, or even species on every line. Those can all be left blank, in which case Scythebill will automatically assume the value from the prior line.
You also can choose to indicate a new order, family, or genus either by giving it its own row, or just by switching to a new order, family, or genus on the same line as defining the new species. So both of these are fine:
But common names are always attached to the smallest taxon defined on that row. So if you want to give orders and families their own common names, you must give them their own rows:
Cetartiodactyla,,,Even-toed ungulates and whales
,,Balaenoptera musculus,Blue Whale
Also, some taxonomies may come with the common name and alternate common names all in one column. Scythebill saves you from manually editing that, too: if you don’t specify an Alternate column, Scythebill will automatically look for commas, slashes, or blank lines in the Common column, and use the first such name as the primary common name, and the rest as alternates.
The rows must be in taxonomic order: you cannot have species from the same order, family, or genus appear in multiple locations.
Scythebill will also fix up capitalization of all scientific names, so don’t worry if the import you’re starting with has some taxa names in all-caps; just leave it, and it’ll be fixed on import.
A final note: the CSV file must be in the UTF-8 character encoding. (If you don’t know what that means, don’t worry too much - this is an option you can select when you save a spreadsheet as a CSV file, and it affects how non-English characters are understood.)
This is a complete example of a valid taxonomic import, for reference:
Cetartiodactyla,,,,Even-toed ungulates and whales
,,Balaenoptera musculus,,Blue Whale
,,,brevicauda,Pygmy Blue Whale
… which in your spreadsheet would look like this:
Note that subspecies are defined on their own rows, and “Common” names omitted for subspecies that don’t have their own names.
Once you’ve got a taxonomy imported successfully, you can export it from the Manage taxonomies… screen either as a “.btxm” file or a “.csv” file.
If you’re trying to export the taxonomy so that you can share it with other users, you’ll want to export it as a “.btxm” file. These files are designed for sharing between users - they’ll import cleanly, without any worry, and will be tagged with a Scythebill icon.
If you’re trying to export the taxonomy so that you can edit it and re-import it, or just display it in a spreadsheet, you’ll want to export as a “.csv” file.
Once the taxonomy is in good shape, if you’d like to contribute it to the wider Scythebill community, please contact me, and I can host it. Just send me the .btxm file after exporting the taxonomy (see the previous section for how to do so).
But - and this is really important - I need to know that I have permission to do so from the original author of the content. (I do not want to receive cease-and-desist letters from angry attorneys.) So, when you send me a taxonomy, please make sure that it:
Also, when I’m distributing a taxonomy on your behalf, I’d prefer to have permission to publish your email, so that when users find issues, they can contact you directly.
Of course, if all of this is too much of a bother - or if you want to use a taxonomy that will not allow redistribution, then you’re still free to build your own extended taxonomy and use it privately.
If you don’t need an extended taxonomy anymore, visit the Manage taxonomies… page, make sure the appropriate taxonomy is selected and click Delete this taxonomy…
Scythebill will confirm that you want to delete the taxonomy; after you click OK, Scythebill will delete the taxonomy and all sightings for that taxonomy. There’s no “undo”!
Just “add” the taxonomy once again. Scythebill will automatically upgrade your sightings. In the event of sufficiently significant changes, Scythebill may need to save an exported list of the sightings that could not be upgraded (for example, because a species is entirely missing from the updated taxonomy). Those sightings will be saved as a Scythebill-CSV format export file, and can be re-imported using the Import sightings… item in the File menu. You’ll get warned - and have a chance to cancel - any time the upgrade isn’t entirely automatic.
At this time, please export the taxonomy to CSV, edit that file, then re-import. (The lack of support for “upgrade” does make that especially onerous, which is why “upgrade” will be added soon!)
You certainly can add a bird taxonomy - say, the British List. However, Scythebill won’t see this is a “bird” list - just as any other extended taxonomy. So, for instance:
A few of Scythebill’s reports don’t fit into the Show reports screen, and can be accessed with Special reports on the main page.
The “Big” days, months, and years screen lets you rapidly find your top big days, big months, and big years - days, months, and years where you’ve seen the most species.
Up top, a menu lets you choose between “Big day”, “Big Month”, and “Big year” options.
Below that, the same options from Show reports let you limit the set of big days, month, or years (for example, to find your best big days in a single location).
And below that, on the left, a list of your best big day/months/years. In the screen above, a top big year - 1,949 species - occurred in 2000. Select one of those dates to see the full list. And if you want to get any of that content into a document or email, etc., just select list entries and use “Copy” from the Edit menu.
Some birders have started working on (and competing on) "total ticks" listing. A total ticks list adds up all of the totals from subregions into one big total. So, for example, a "state" total ticks list for the ABA Region requires you to:
These numbers are tedious to compute; Scythebill makes it easy. Select Total ticks from the Special reports screen:
The menu at the top lets you choose between “Country”, “State”, and “County” total ticks.
Below that, the same options from Show reports let you limit the set of sightings included. If, for example, you want “ABA area” state total ticks, then choose Location, is in, ABA Region, then “State” total ticks.
Below that, Scythebill shows the total ticks count: in the screen above, that’s a combined 9,577 species on the country lists for all countries.
At the bottom, three buttons let you take further actions with your total ticks results:
The total ticks map is supported for Country and State, not County. The state map also works for most countries, but not all - in particular, it does not work for the UK, Kenya, or Indonesia.
The Year Comparisons report lets you compare results, year-by-year for a particular report. It’s particularly handy for comparing results for a single location, like your local patch. It also gives you first-arrival and last-departure dates, and a sense for how often you recorded a species.
The main page is very simple: choose a “From” year and a “To” year (or leave one or both blank to include all years), choose a report to run (just like on the Show reports page), then click “Save as spreadsheet…”.
You’ll get a spreadsheet like this one:
Down the left, obviously, is a list of species.
The next three columns shows the total results across all years:
Then, for every year, this repeats; the total species count, earliest-day that year, latest-day that year, and the total number of times that species was recorded in that year.
You can also choose to Split years in two, which gives you a spreadsheet like this:
Instead of showing yearly totals, you’ll see “H1” and “H2” totals, first across all years, and then again for individual years. H1 covers January to June, and H2 July to December.
This makes the “First Seen” and “Last Seen” column much more useful for most species. For example, with annual counts a first arrival of January 1 and departure date of December 31st isn't particular interesting for a northern hemisphere overwinterer (or a southern hemisphere breeder). And April 20 to October 15 doesn't tell you when a passage migrant might stop appearing in the northern spring/southern fall, or start coming back in the northern fall/southern spring! But with the year divided in half, you can typically tell when passage migrants, overwintering birds, and summer breeders appear, no matter which hemisphere you’re in.
The Splits and lumps report helps you make sense of how your list has changed in response to taxonomic changes over the years. For example, this is what it notes for IOC 8.2 vs. the IOC 9.1 taxonomy, for my list:
At the top, you can choose a taxonomy version for your current bird taxonomy. (Switch between IOC and eBird/Clements with the taxonomy chooser at the very of the page, as always). You can pick IOC versions back to 5.1 (four years ago), or eBird/Clements versions all the way back to 2010 (a whopping 8 years ago), and see, for each version, how many splits and lumps you've gotten, and what they are.
It's even smart enough to detect "splits" (or lumps) that come from subspecies moving from one species to another. For example, when in 2018, eBird/Clements moved the subspecies of Whistler found on Lifou Island off New Caledonia from New Caledonian Whistler to Vanuatu Whistler, I picked up a species; the report notes that "New Caledonian Whistler (Pachycephala caledonica) is now Vanuatu Whistler (P.chlorura) and New Caledonian Whistler (P.caledonica)".
Sometimes, there isn't enough information to be sure of whether there's been a lump or not. For example, in 2015, Caribbean Coot was lumped with American Coot. But it was lumped without even leaving behind a subspecies, so many of you will see this as a "possible lump" - "Some or all ofAmerican Coot (Fulica americana) and Caribbean Coot (F. caribaea) are now American Coot (F.americana)". Scythebill doesn't have old checklists to note where Caribbean Coot was found, so this will be reported even if you've never been to the range of Caribbean Coot.
Just below the version is the typical report rule choices screen, just like in Show reports. So if you want to know how splits and lumps have affected your ABA checklist, or only want to see how the 2015 splits affected your list for all sightings in 2015 and earlier, you can do that too.
Finally, the world lifer map is a very simple toy for seeing how many lifers await you around the world in color-coded form. (Birds only: it relies on the Scythebill checklists.)
Above, you can see my needs: some time in India, China, and Indonesia would be very helpful! (And Brazil, Colombia, and Peru are simply species-rich; I’ve spent a lot of time in South America, but still… so much to see!)
Mouse over any country to see a total number, or use the “Zoom to... “ menu in the upper-left to limit to one part of the world:
Scythebill’s Preferences page gives you a number of choices for customizing Scythebill. Just click the Preferences button on the main page.
The “Observer preferences” page is described above, in its own section.
When using the eBird/Clements taxonomy, Scythebill lets you choose from 55 different internationalized options!
Some of these are global translations; but some are limited to species found in that country. Read more about these translations on the eBird site.
When using the IOC taxonomy, Scythebill lets you choose from over 25 languages for bird names:
Most of these are fairly complete, with 90-95% of names available in a translated form, but a few are much less fully available - Estonian, Hungarian, and Portuguese are all between 55% and 65% complete.
Note: If you’re using Linux, I have had reports that some of these translations may not appear correctly, and simply cause errors. (On the other hand, I’ve had no problems when I’ve tested on Linux.) I believe this has been fixed, but let me know if you still see this. I haven’t had reports of problems on MacOS or Windows.
Alternatively, you might prefer scientific names to common names. Or you might never want to see a scientific name if it can be helped. Another preference makes that easy. You can choose one of four options:
Some birders think introduced species are fine to count; others think that’s a waste of time.
Some birders think a “heard only” owl is worth a tick; others won’t consider counting a bird until they’ve seen it.
Whatever your preference, it’s a shame to skip entering a sighting just because you don’t want to include it in your numbers. Scythebill makes that easy:
These preferences don’t affect whether the sightings show up in reports, or whether they’ll be exported to eBird, etc. They only affect the total species (and family) numbers Scythebill reports.
Scythebill can show its text in any of English, Spanish, or German. By default, it uses your system language to pick, but you can use this option to make Scythebill choose a different language.
By the way: if you speak either German or Spanish, and any of the translations are in error, please let me know. I’m fluent in neither, and there are likely many silly mistakes.
Scythebill can automatically backup your sightings weekly or monthly to a folder of your choice. Choose one of those two options, then pick a folder for your exports by clicking the Choose a directory… button. I personally strongly recommend that users choose a backup directory using a cloud provider like DropBox or Google Drive. These services are free and will keep your data safe (and secure); storing your backups on your local drive will not help you if your disk crashes or something worse happens. Backups are automatically compressed as Zip files to minimize disk usage.
Scythebill won’t create a new backup unless something has changed since the last backup.
You can click the Backup now button to force an immediate backup of your current file (assuming you’ve chosen a directory, as above). You can also open up the directory where your files are backed up by clicking the directory name.
This section gives Scythebill users a set of “recipes” - instructions for very specific tasks that may not be immediately obvious. These are quick overviews - for detailed instructions on using the part of Scythebill they mention, read the part of the manual that discusses that page in detail.
In any Show reports or Browse by species, find and select the sighting, and enter a new location. Click Save.
Or in Browse by location, find the sighting, and drag-and-drop it onto the new location.
In Show reports, pick a report that covers all sightings that need to be edited. Click Bulk edit…; enter a new location, and then click OK.
Use Browse by location, and drag-and-drop the location to a new parent. (You can drag multiple locations all at once.)
You cannot have two locations with the same name as direct children of the same parent. So, for example, if you accidentally added “Point Reyes” to California and another “Point Reyes” to Marin County, you cannot add the first one inside Marin County as well. If you run into this duplicate location problem, then (for this example):
This action doesn’t delete any sightings - you’ll have just one “Point Reyes”, and all sightings will belong there.
You can rearrange locations that contain “children” - all the children will come along for the ride. However, you cannot delete locations that contain children locations. If you need to delete such a location, you have to either move the children locations out from underneath it first, or delete all the children first.
Go to Browse by species and find the sighting. Either drag-and-drop or cut-and-paste the sighting from its original species onto the new species.
Alternatively, you can use Enter sightings to edit the sightings from that visit and just remove one species and add the correct one.
You can do this just the same way as changing the species of a single sighting. Alternatively, you can select the sighting from any page, and use the subspecies chooser at the top of the sightings detail (just below Change to:):
Go to Browse by species and select all of the sightings. Either drag-and-drop or cut-and-paste the sightings from their original species onto the new species (or subspecies).
The IOC and eBird/Clements taxonomies have many differences! Scythebill makes it easy to rapidly go through your entire list and account for those differences.
First, you can choose the taxonomy where you need to make changes, and use the Reconcile sp.s automatically… option in the File menu. Scythebill will use its built-in checklists to quickly find any “sp.” that can easily be resolved. For example, if you saw “African Palm-Swift” before Malagasy Palm-Swift was split off, you might have a sp. of “African/Malagasy Palm-Swift”. Scythebill knows that if you saw it in Madagascar or the Comoros, it must be Malagasy, and otherwise it must be African Palm-Swift.
You can also use Show reports to look for sp.s and clean them up when the above technique can’t do it all (if, for example, both species are found in a given country).
Find the sighting in any of Browse by location, Browse by species, or Show Reports. Edit the date. Click Save.
If you accidentally mis-entered the date for an entire visit, visit Browse by location. Find the location of the visit, then look in the visit list (atop the species list) for this specific visit. Select the visit, then change the date and click Save.
It’s more work, but you could also
Bulk editing is particularly useful if you made a similar mistake in a series of visits (for instance, entering the month as May instead of June), as bulk editing can change just one part of the date for a larger set of data.
Your records are saved in a .bsxm file, not in the application. You’ll need to move that file to the other computer:
If you want to edit your sightings from two different computers, you can move the .bsxm file to a shared network drive like Google Drive, DropBox, iCloud, or Microsoft OneDrive. Open that file from either computer. Caution: this is not safe unless you are very careful. Specifically, you must save and quit Scythebill after each use, and never have Scythebill open on both computers at the same time. Scythebill does not (yet) notice changes made on other computers, so you will lose sightings if you don’t follow this rule!
If you’ve used other software in the past for multiple people, and you’d like to import it all into Scythebill, start by using that software to create an export file for each user (typically a .CSV file). There’s detailed instructions, per software, in the ”Importing into Scythebill” section of this manual.
Once you’ve got that ready, there’s two ways you could choose to use Scythebill.
Let’s explain each path separately. First, if you want to have two different .bsxm files:
After this, you have two separate .bsxm files, each containing the sightings for one person. All sighting entry and report generation is totally separate for each person.
Second, if you want to have just one .bsxm file with multiple observers:
After this, you have a single .bsxm file containing sightings for both people; each sighting will indicate whether it was seen by one or both people. You can still generate reports for each person’s lists separately, or even create lists where one person has a bird that the other is still missing.
Users have, on occasion, wanted to add extra flags to Scythebill - think “self-found” for rarities you found yourself, or “first-county” for a first county record, etc.
Scythebill doesn’t support extending the built-in flags (“Immature”, “Heard-only”, etc…) Instead, use the Sighting Notes field. Pick a syntax - like a preceding slash, as in. “/self-found” - and stick with it. Then use a Sighting Notes rule in a report to find these sightings.
You can delete sightings from almost any part of the program. Select a sighting (or multiple sightings) in Show reports, Browse by species, or Browse by location, and use “Cut” from the file menu (or Ctrl-X on Windows/Linux, Command-X on MacOS).
You can delete a lot of sightings at once by:
Visit Browse by location, then:
Visit Show reports, then:
(Only relevant if you’ve enabled multiple observers!) Visit Show reports, then:
Start with Browse by species. Find the species, then click “Add sighting”. Set a date if you want, or even leave the date blank.
That said, Scythebill can do more for you if you can provide a country, at least. For one, it can handle some taxonomic changes (like splits) automatically.
To copy a lot of sightings from one file two another is, start with the first file (the source of all the sightings):
Now open, the second file, and make sure it’s got the same taxonomy selected as the first file:
That’s it. if you accidentally try to import back to the first file, Scythebill will warn you that all sightings appear to be duplicates.
The “how-tos” section above addresses a number of frequently asked questions. This section provides answers to questions that aren’t really “how-tos”.
Two things commonly cause this.
First, taxonomic differences between your list and Scythebill’s up-to-date taxonomies can leave Scythebill unsure which species one of your observations refers to. When this happens, Scythebill will produce a “sp.” sighting, e.g. a Mew Gull might be imported as “Common/Short-billed Gull”. “Sp.” sightings do not show up in your lifer count, though when you go to Show reports, you’ll see an explicit list of how many “sp.” you’ve recorded. To look for these, use the same steps as “How do I reconcile differences in taxonomies?” earlier in the manual to pick exactly which species of the “sp.” you’ve observed.
Second, Scythebill has sighting statuses, and uses its built-in checklists to try to set these statuses correctly, specifically around introduced and not-established species. In the US, Canada, and Australia, state checklists can set this status even more accurately than the country lists. Scythebill does consider introduced species countable (though there’s a preference to change that), but not-established species aren’t countable. To find these species, go to Show reports and create a report for Status is Not established. It is your list, and your rules - so if you want to change one or all of those species to a different, countable status, you can.