Update showroom (#828)

* Added BirdOMatic to showroom

* updated species list guide

* shortened the text

Author: Josef-Haupt

docs/_static/birdomatic.jpg

@@ -87,7 +87,7 @@ Once you have uploaded and mapped your files, the system automatically extracts
 Customize the evaluation process by adjusting the following parameters:
 
 * **Sample Duration (s)**: The length of each audio segment. (Default: 3 seconds – matching BirdNET’s prediction segment.)
-* **Recording Duration **: Explicitly set the recording duration. (Default: The recording duration is automatically inferred from your files.)
+* **Recording Duration**: Explicitly set the recording duration. (Default: The recording duration is automatically inferred from your files.)
 * **Minimum Overlap (s)**: The minimum time overlap between an annotation and a prediction for them to be considered a match. (Default: 0.5 seconds)
 * **Threshold**: The cut-off value to decide if a prediction is positive. (Default: 0.1)
 * **Class-wise Metrics**: Toggle this option if you want to compute performance metrics for each class individually. If disabled, metrics are averaged across all classes.
@@ -143,40 +143,40 @@ After configuring your files and parameters, use the action buttons to execute t
 9. Step-by-Step Usage
 ---------------------------------
 
-1.	File Upload
-######################
+1. File Upload
+##############
 
 * Navigate to the File Selection section.
 * Upload your annotation and prediction files using the provided file dialog or drag-and-drop interface.
 
-2.	Column Mapping
-######################
+2. Column Mapping
+#################
 
 * Review and adjust the column mappings using the drop-down menus to match your file’s structure.
 
-3.	Optional Class Mapping
-######################
+3. Optional Class Mapping
+#########################
 
 * If your class names differ between annotation and prediction files, download the JSON template, update it, and then upload the class mapping file.
 
-4.	Select Classes and Recordings
-######################
+4. Select Classes and Recordings
+################################
 
 * Use the checkbox groups to select the specific classes and recordings you want to evaluate.
 
-5.	Set Parameters
-######################
+5. Set Parameters
+#################
 
 * Adjust the sample duration, recording duration, minimum overlap, and threshold values.
 * Toggle the Class-wise Metrics option if you require individual class evaluations.
 
-6.	Select Metrics
-######################
+6. Select Metrics
+#################
 
 * Check the boxes for the performance metrics (AUROC, Precision, Recall, F1 Score, AP, Accuracy) you wish to compute and visualize.
 
-7.	Execute Evaluation and Visualizations
-######################
+7. Execute Evaluation and Visualizations
+########################################
 
 * Click Calculate Metrics to process the data.
 * Generate visualizations by clicking on Plot Metrics, Plot Confusion Matrix, or Plot Metrics All Thresholds 

docs/best-practices/evaluation-tool.rst

@@ -6,9 +6,17 @@ When editing your own `species_list.txt` file, make sure to copy species names f
 You can find label files in the checkpoints folder, e.g., `checkpoints/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels.txt`.
 
 Species names need to consist of `scientific name_common name` to be valid.
+If you want to use the Perch model, you have to use their naming convention, which is just `scientific name`.
+For examples check the respective label files.
 
 You can generate a species list for a given location using :ref:`birdnet_analyzer.species <cli-species>`.
 
+.. note::
+    The checkpoints folder can be found in the installation directory of BirdNET-Analyzer.
+    If you're using BirdNET-Analyzer from GitHub, you can access the checkpoints folder once the analyzer has run at least once, because the model is downloaded in the background.
+
+    Alternatively, you can manually download the model checkpoint `here <https://tuc.cloud/index.php/s/886x39f5N3sdsAM/download/V2.4.zip>`_.
+
 Practical Information and Considerations
 ----------------------------------------
 

docs/best-practices/species-lists.rst

@@ -166,6 +166,21 @@ These are some highlights, make sure to check them out!
 
         | Learn more at: `ribbit.edi.eco <https://ribbit.edi.eco/>`_
 
+    * - .. image:: _static/birdomatic.jpg
+            :alt: Birdomatic
+            :align: center
+            :target: https://www.birdomatic.com/
+
+      - | **BirdOMatic**
+
+        BirdOMatic is a fun personal "workbench" project that allows users to slice and dice the millions of IDs that BirdNET found in our 40 terabytes of audio data (5+ years, 40 hours a day across 6 recorders).
+        It offers flexible filtering, sorting, and search functions and provides access to spectrograms, weather data, and recording files
+        Available to anyone (researchers, teachers, birders) on the web.
+        The full BirdNET-ID dataset is available on request.
+        The project code is on GitHub and there's lots of documentation for those who would like to replicate all this for your own project.
+
+        | Learn more at: `BirdOMatic <https://www.BirdOMatic.com>`_, `Docs <https://docs.birdomatic.com/>`_ and `GitHub <https://github.com/PGBWB-team/bird-workbench>`_
+
 **Other cool projects:**
 
 * BirdCAGE is an application for monitoring the bird songs in audio streams: `BirdCAGE at GitHub <https://github.com/mmcc-xx/BirdCAGE>`_