How to create a custom list

[Mattk70]

If you find the available lists are missing species you want included, or include species you don't, you can create a custom list.

The best way to do this is to export the species that are on your Local Birds list, since this will most likely contain a reasonable approximation of the species you want:

Once you "Export the Included list" and save the file, you can amend it by removing species or adding new species. For these to be read correctly they should both
a) Be known to the model
b) added in the format scientific name,common name

If you want to have a list of all the species or classes known to the model you can repeat the export process, but this time select the "Everything" list.

Extended Custom Lists

List format extensions are introduced in Chirpity version 5.8.0 to allow Chirpity buy-me-a-coffee members to add optional rules for species to be included:

• During a specified date range
• At a specified confidence threshold (overriding the global setting)

The format of an extended list is as follows:

Scientific name	Common name	Earliest date (DD-MM)	Latest date (DD-MM)	Confidence threshold (> 0 & < 1)
Curruca curruca	Lesser Whitethroat	01-03	01-10	0.4
Turdus iliacus	Redwing	15-09	15-04	0.2
Gallinula chloropus	Common Moorhen			0.75
Cygnus cygnus	Whooper Swan	01-10	30-04

In turn, these examples represent:

1. A summer migrant, reported between 1st March and 1st October, only if the confidence is greater than 40%
2. A winter visitor, reported between the 15th September and 15th April, only if the confidence is greater than 20%
3. A resident, but only reported if the prediction confidence is 75% or greater
4. A winter visitor reported between 1st October and 30th April

The list containing these four species with their rules applied will look like this:

 Curruca curruca, Lesser Whitethroat ,01-03, 01-10 , 0.4
 Turdus iliacus,Redwing,15-09,15-04,0.2
 Gallinula chloropus,Common Moorhen,,, 0.75
 Cygnus cygnus,Whooper Swan,01-10,30-04

Important

If you want to override the confidence without specifying a date range, the extra commas are required - as shown in example 3

---

Once you are happy with the contents of your list, you can save the file and use it as your custom list:

Click "Select file" and find the file you just saved.

That's it!

Custom Lists for Perch

For a few reasons, Perch does not offer a Local Birds list. 'Locals Birds' lists are generated by another machine learning model that was trained for the BirdNET species. Perch
a) has additional species
b) uses a different taxonomy

So it is not possible for the list model to identify all the relevant birds.

If you export a local list from the BirdNET model, you can use it for Perch, but there will most likely be warnings about unrecognised species. Any unrecognised species will not be included in results. You should edit the list to either remove these, or update their scientific names with the nearest equivalents used by Perch (for comparisons, you can export the full Perch species list by selecting the Perch model, and exporting the 'Everything' list). Augment your Perch custom list by adding any additional species you want to include from the full Perch list.

[ceperman]

What is the species filter threshold?

[Mattk70]

That setting is for Local Birds lists and has no bearing on custom lists. It should probably read 'species frequency threshold', to be consistent with the setting in the UI.