eBird to AviSys checklist import (Version 3.2)

Note: To be current with eBird, install the current Taxonomy Update for AviSys.

Checklist input
Click to fetch the specified checklist(s) from eBird.
Options Summarize by

What's this?

Do you need to upload CSV files? If so, you will need use eBird to AviSys checklist import (Version 1). Click here

What it is

eBird to AviSys checklist import will convert one or more eBird checklists into an AviSys stream file with which you can import the data into AviSys (Version 6).

What you do

  1. In the “Checklist input” form above, list one or more checklist names and click “Go!”. eBird to AviSys checklist import (Version 3) will fetch the checklists directly from eBird. If you have a large number of checklists, an easy way to handle them is to create an eBird Trip Report for the checklists that you want to import to AviSys. Then just enter the URL of the trip report in this form. After downloading, you can delete the Trip Report if you want.

    Let's say you have a checklist https://ebird.org/checklist/S46116491. You can copy-and-paste just the "S46116491", or you can copy-and-paste the whole "https://ebird.org/checklist/S46116491". If you enter multiple checklists, enter them on separate lines, or else just separate them with spaces or commas. For example you could enter

    S60513355, S60533760, S60593564, S60652303
    S60513355 S60533760 S60593564 S60652303

    Likewise for a trip report you could enter

    or just

    You can enter more than one trip report.

  2. On the next screen that you see, each eBird location that is in your input will be displayed. If the corresponding AviSys place has a different name, you can enter the correct AviSys place name. Then click the “Download” button that you will see. More details on this screen will be shown when you get there.
  3. Your AviSys stream file will be downloaded. Save it on your computer, then run Avisys to import it.
  4. That's it!

What's a stream file?

Read the tutorial on using AviSys stream files to import data if you are not familiar with the process.

What are excludes?

You might have some species recorded in eBird that you don't want recorded in AviSys. These might include domestic forms like Muscovy Duck (Domestic type), non-countable exotics like Red-masked Parakeet, or others. Maybe you don't record these species yourself, but they show up on lists someone shares with you. You can exclude these species from the import from eBird by listing them, one per line, in the "Excludes" input.

"Slashes", "Spuhs", and Hybrids are automatically excluded, because AviSys does not support these names.

About species names

If AviSys does not recognize a species name while importing a stream file, it will skip that sighting record. (It will tell you!) You will need to be sure that you have AviSys up-to-date with current taxonomy.

One prominent difference between eBird names and AviSys names is that eBird accepts certain names with parenthetic qualifiers, e.g., “Northern Flicker (Yellow-shafted)”. You don't need to worry about these cases! eBird to AviSys checklist import will remove the parenthetic part of the name and insert it at the beginning of the AviSys comment.

Another difference is that eBird allows “sp” or “slash” entries (e.g. Downy/Hairy Woodpecker). AviSys does not allow such names.

Warning about system-hidden checklists or sensitive species.

A checklist that is flagged for some reason with a comment similar to “This checklist and its observations do not appear in public eBird outputs” cannot be imported with this version. You will need to use Version 1

Any species designated sensitive will be omitted from checklists, so if you have any records of sensitive species, you will likewise need to use Version 1, or else enter the sensitive species manually.

Can I import from other sources?

Yes, but not with this version of eBird to AviSys checklist import. You will need to use Version 1 which supports csv files.

What about eBird's “Download My Data”?

eBird provides a feature to download all of your eBird data in one file. eBird to AviSys checklist import will process that file too! But again, you will need to use Version 1.

Summarize by location or checklist

Before you generate the AviSys stream file, eBird to AviSys checklist import gives you a summary of what is in the checklists that you specified. In the summary, you can correct the AviSys place name, and you have the option to enter a global comment that will be added to all observations for that location.

By default, the summary is by location. In other words, no matter how many checklists you select for a location, the summary will only have a single entry for the location. This is "Summarize by location".

Sometimes you might prefer to be able to enter a custom comment for each checklist rather than for each location. In that case, select "Summarize by checklist", and the summary will contain an entry for each checklist. Each entry will display the time and effort data for the checklist, so that you can recognize it.

Whichever type of summary you choose, the generated stream file will be the same, except for anything that you enter in the Global comment field.

eBird locations vs. AviSys places

In many cases, your eBird location names may not match up exactly with your AviSys place names, and you will need to manually enter your corresponding AviSys place name for each eBird location. As a convenience, eBird to AviSys checklist import remembers AviSys places from one session to the next. Once you "train" it by entering the AviSys place name for an eBird location, the name pairing will be saved for future use. The Places data is stored locally in your browser. This has a couple of consequences.


AviSys can only record dates between Jan 1, 1930 and Dec 31, 2029. Any dates older than 1930 will be recorded with a year of 1930. Dates after 2030 will be recorded with a year 100 years earlier.

More eBird tools

Questions or comments?