birdnet-analyzer 2.0.0__tar.gz

birdnet_analyzer-2.0.0/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2024 birdnet-team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

birdnet_analyzer-2.0.0/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: birdnet_analyzer
+Version: 2.0.0
+Summary: BirdNET analyzer for scientific audio data processing and bird classification.
+Author: Stefan Kahl
+Maintainer: Josef Haupt, Max Mauermann
+License: MIT
+Project-URL: Homepage, https://birdnet.cornell.edu/birdnet
+Project-URL: Documentation, https://birdnet-team.github.io/BirdNET-Analyzer/
+Project-URL: Repository, https://github.com/birdnet-team/BirdNET-Analyzer
+Project-URL: Issues, https://github.com/birdnet-team/BirdNET-Analyzer/issues
+Project-URL: Download, https://github.com/birdnet-team/BirdNET-Analyzer/releases/latest
+Keywords: birdnet,birdnet-analyzer
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: librosa
+Requires-Dist: resampy
+Requires-Dist: tensorflow==2.15.1
+Requires-Dist: scikit-learn==1.6.1
+Requires-Dist: tqdm
+Provides-Extra: train
+Requires-Dist: keras-tuner; extra == "train"
+Provides-Extra: server
+Requires-Dist: bottle; extra == "server"
+Requires-Dist: requests; extra == "server"
+Provides-Extra: gui
+Requires-Dist: birdnet-analyzer[embeddings,train]; extra == "gui"
+Requires-Dist: gradio==5.25.2; extra == "gui"
+Requires-Dist: pywebview; extra == "gui"
+Requires-Dist: matplotlib; extra == "gui"
+Requires-Dist: plotly[express]; extra == "gui"
+Requires-Dist: seaborn; extra == "gui"
+Requires-Dist: pywin32; platform_system == "Windows" and extra == "gui"
+Provides-Extra: embeddings
+Requires-Dist: perch-hoplite; extra == "embeddings"
+Provides-Extra: all
+Requires-Dist: birdnet-analyzer[gui,server]; extra == "all"
+Dynamic: license-file
+
+<div align="center">
+  <h1>BirdNET-Analyzer</h1>
+    <a href="https://birdnet-team.github.io/BirdNET-Analyzer/">
+        <img src="https://github.com/birdnet-team/BirdNET-Analyzer/blob/main/docs/_static/logo_birdnet_big.png?raw=true" width="300" alt="BirdNET-Logo" />
+    </a>
+</div>
+<br>
+<div align="center">
+
+![License](https://img.shields.io/github/license/birdnet-team/BirdNET-Analyzer)
+![OS](https://badgen.net/badge/OS/Linux%2C%20Windows%2C%20macOS/blue)
+[![Python 3.11](https://img.shields.io/badge/python-3.11-blue.svg)](https://www.python.org/downloads/release/python-3110/)
+![Species](https://badgen.net/badge/Species/6512/blue)
+![Downloads](https://www-user.tu-chemnitz.de/~johau/birdnet_total_downloads_badge.php)
+
+[![Docker](https://github.com/birdnet-team/BirdNET-Analyzer/actions/workflows/docker-build.yml/badge.svg)](https://github.com/birdnet-team/BirdNET-Analyzer/actions/workflows/docker-build.yml)
+[![Reddit](https://img.shields.io/badge/Reddit-FF4500?style=flat&logo=reddit&logoColor=white)](https://www.reddit.com/r/BirdNET_Analyzer/)
+![GitHub stars)](https://img.shields.io/github/stars/birdnet-team/BirdNET-Analyzer)
+[![GitHub release](https://img.shields.io/github/v/release/birdnet-team/BirdNET-Analyzer)](https://github.com/birdnet-team/BirdNET-Analyzer/releases/latest)
+
+</div>
+
+This repo contains BirdNET models and scripts for processing large amounts of audio data or single audio files.
+This is the most advanced version of BirdNET for acoustic analyses and we will keep this repository up-to-date with new models and improved interfaces to enable scientists with no CS background to run the analysis.
+
+Feel free to use BirdNET for your acoustic analyses and research.
+If you do, please cite as:
+
+```bibtex
+@article{kahl2021birdnet,
+  title={BirdNET: A deep learning solution for avian diversity monitoring},
+  author={Kahl, Stefan and Wood, Connor M and Eibl, Maximilian and Klinck, Holger},
+  journal={Ecological Informatics},
+  volume={61},
+  pages={101236},
+  year={2021},
+  publisher={Elsevier}
+}
+```
+
+## Documentation
+
+You can access documentation for this project [here](https://birdnet-team.github.io/BirdNET-Analyzer/).
+
+## Download
+
+You can download installers for Windows and macOS from the [releases page](https://github.com/birdnet-team/BirdNET-Analyzer/releases/latest).
+
+## About
+
+Developed by the [K. Lisa Yang Center for Conservation Bioacoustics](https://www.birds.cornell.edu/ccb/) at the [Cornell Lab of Ornithology](https://www.birds.cornell.edu/home) in collaboration with [Chemnitz University of Technology](https://www.tu-chemnitz.de/index.html.en).
+
+Go to https://birdnet.cornell.edu to learn more about the project.
+
+Want to use BirdNET to analyze a large dataset? Don't hesitate to contact us: ccb-birdnet@cornell.edu
+
+**Have a question, remark, or feature request? Please start a new issue thread to let us know. Feel free to submit a pull request.**
+
+## License
+
+- **Source Code**: The source code for this project is licensed under the [MIT License](https://opensource.org/licenses/MIT).
+- **Models**: The models used in this project are licensed under the [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0)](https://creativecommons.org/licenses/by-nc-sa/4.0/).
+
+Please ensure you review and adhere to the specific license terms provided with each model.
+
+*Please note that all educational and research purposes are considered non-commercial use and it is therefore freely permitted to use BirdNET models in any way.*
+
+## Funding
+
+This project is supported by Jake Holshuh (Cornell class of ´69) and The Arthur Vining Davis Foundations.
+Our work in the K. Lisa Yang Center for Conservation Bioacoustics is made possible by the generosity of K. Lisa Yang to advance innovative conservation technologies to inspire and inform the conservation of wildlife and habitats.
+
+The development of BirdNET is supported by the German Federal Ministry of Education and Research through the project “BirdNET+” (FKZ 01|S22072).
+The German Federal Ministry for the Environment, Nature Conservation and Nuclear Safety contributes through the “DeepBirdDetect” project (FKZ 67KI31040E).
+In addition, the Deutsche Bundesstiftung Umwelt supports BirdNET through the project “RangerSound” (project 39263/01).
+
+## Partners
+
+BirdNET is a joint effort of partners from academia and industry.
+Without these partnerships, this project would not have been possible.
+Thank you!
+
+![Logos of all partners](https://tuc.cloud/index.php/s/KSdWfX5CnSRpRgQ/download/box_logos.png)

birdnet_analyzer-2.0.0/README.md

@@ -0,0 +1,83 @@
+<div align="center">
+  <h1>BirdNET-Analyzer</h1>
+    <a href="https://birdnet-team.github.io/BirdNET-Analyzer/">
+        <img src="https://github.com/birdnet-team/BirdNET-Analyzer/blob/main/docs/_static/logo_birdnet_big.png?raw=true" width="300" alt="BirdNET-Logo" />
+    </a>
+</div>
+<br>
+<div align="center">
+
+![License](https://img.shields.io/github/license/birdnet-team/BirdNET-Analyzer)
+![OS](https://badgen.net/badge/OS/Linux%2C%20Windows%2C%20macOS/blue)
+[![Python 3.11](https://img.shields.io/badge/python-3.11-blue.svg)](https://www.python.org/downloads/release/python-3110/)
+![Species](https://badgen.net/badge/Species/6512/blue)
+![Downloads](https://www-user.tu-chemnitz.de/~johau/birdnet_total_downloads_badge.php)
+
+[![Docker](https://github.com/birdnet-team/BirdNET-Analyzer/actions/workflows/docker-build.yml/badge.svg)](https://github.com/birdnet-team/BirdNET-Analyzer/actions/workflows/docker-build.yml)
+[![Reddit](https://img.shields.io/badge/Reddit-FF4500?style=flat&logo=reddit&logoColor=white)](https://www.reddit.com/r/BirdNET_Analyzer/)
+![GitHub stars)](https://img.shields.io/github/stars/birdnet-team/BirdNET-Analyzer)
+[![GitHub release](https://img.shields.io/github/v/release/birdnet-team/BirdNET-Analyzer)](https://github.com/birdnet-team/BirdNET-Analyzer/releases/latest)
+
+</div>
+
+This repo contains BirdNET models and scripts for processing large amounts of audio data or single audio files.
+This is the most advanced version of BirdNET for acoustic analyses and we will keep this repository up-to-date with new models and improved interfaces to enable scientists with no CS background to run the analysis.
+
+Feel free to use BirdNET for your acoustic analyses and research.
+If you do, please cite as:
+
+```bibtex
+@article{kahl2021birdnet,
+  title={BirdNET: A deep learning solution for avian diversity monitoring},
+  author={Kahl, Stefan and Wood, Connor M and Eibl, Maximilian and Klinck, Holger},
+  journal={Ecological Informatics},
+  volume={61},
+  pages={101236},
+  year={2021},
+  publisher={Elsevier}
+}
+```
+
+## Documentation
+
+You can access documentation for this project [here](https://birdnet-team.github.io/BirdNET-Analyzer/).
+
+## Download
+
+You can download installers for Windows and macOS from the [releases page](https://github.com/birdnet-team/BirdNET-Analyzer/releases/latest).
+
+## About
+
+Developed by the [K. Lisa Yang Center for Conservation Bioacoustics](https://www.birds.cornell.edu/ccb/) at the [Cornell Lab of Ornithology](https://www.birds.cornell.edu/home) in collaboration with [Chemnitz University of Technology](https://www.tu-chemnitz.de/index.html.en).
+
+Go to https://birdnet.cornell.edu to learn more about the project.
+
+Want to use BirdNET to analyze a large dataset? Don't hesitate to contact us: ccb-birdnet@cornell.edu
+
+**Have a question, remark, or feature request? Please start a new issue thread to let us know. Feel free to submit a pull request.**
+
+## License
+
+- **Source Code**: The source code for this project is licensed under the [MIT License](https://opensource.org/licenses/MIT).
+- **Models**: The models used in this project are licensed under the [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0)](https://creativecommons.org/licenses/by-nc-sa/4.0/).
+
+Please ensure you review and adhere to the specific license terms provided with each model.
+
+*Please note that all educational and research purposes are considered non-commercial use and it is therefore freely permitted to use BirdNET models in any way.*
+
+## Funding
+
+This project is supported by Jake Holshuh (Cornell class of ´69) and The Arthur Vining Davis Foundations.
+Our work in the K. Lisa Yang Center for Conservation Bioacoustics is made possible by the generosity of K. Lisa Yang to advance innovative conservation technologies to inspire and inform the conservation of wildlife and habitats.
+
+The development of BirdNET is supported by the German Federal Ministry of Education and Research through the project “BirdNET+” (FKZ 01|S22072).
+The German Federal Ministry for the Environment, Nature Conservation and Nuclear Safety contributes through the “DeepBirdDetect” project (FKZ 67KI31040E).
+In addition, the Deutsche Bundesstiftung Umwelt supports BirdNET through the project “RangerSound” (project 39263/01).
+
+## Partners
+
+BirdNET is a joint effort of partners from academia and industry.
+Without these partnerships, this project would not have been possible.
+Thank you!
+
+![Logos of all partners](https://tuc.cloud/index.php/s/KSdWfX5CnSRpRgQ/download/box_logos.png)

birdnet_analyzer-2.0.0/birdnet_analyzer/__init__.py

@@ -0,0 +1,8 @@
+from birdnet_analyzer.analyze import analyze
+from birdnet_analyzer.embeddings import embeddings
+from birdnet_analyzer.train import train
+from birdnet_analyzer.search import search
+from birdnet_analyzer.segments import segments
+from birdnet_analyzer.species import species
+
+__all__ = ["analyze", "train", "embeddings", "search", "segments", "species"]

birdnet_analyzer-2.0.0/birdnet_analyzer/analyze/__init__.py

@@ -0,0 +1,5 @@
+from birdnet_analyzer.analyze.core import analyze
+
+__all__ = [
+    "analyze",
+]

birdnet_analyzer-2.0.0/birdnet_analyzer/analyze/__main__.py

@@ -0,0 +1,4 @@
+from birdnet_analyzer.analyze.cli import main
+
+
+main()

birdnet_analyzer-2.0.0/birdnet_analyzer/analyze/cli.py

@@ -0,0 +1,25 @@
+from birdnet_analyzer.utils import runtime_error_handler
+from birdnet_analyzer import analyze
+
+
+@runtime_error_handler
+def main():
+    import os
+    from multiprocessing import freeze_support
+
+    import birdnet_analyzer.cli as cli
+
+    # Freeze support for executable
+    freeze_support()
+
+    parser = cli.analyzer_parser()
+
+    args = parser.parse_args()
+
+    try:
+        if os.get_terminal_size().columns >= 64:
+            print(cli.ASCII_LOGO, flush=True)
+    except Exception:
+        pass
+
+    analyze(**vars(args))

birdnet_analyzer-2.0.0/birdnet_analyzer/analyze/core.py

@@ -0,0 +1,245 @@
+import os
+from typing import List, Literal
+
+
+def analyze(
+    input: str,
+    output: str | None = None,
+    *,
+    min_conf: float = 0.25,
+    classifier: str | None = None,
+    lat: float = -1,
+    lon: float = -1,
+    week: int = -1,
+    slist: str | None = None,
+    sensitivity: float = 1.0,
+    overlap: float = 0,
+    fmin: int = 0,
+    fmax: int = 15000,
+    audio_speed: float = 1.0,
+    batch_size: int = 1,
+    combine_results: bool = False,
+    rtype: Literal["table", "audacity", "kaleidoscope", "csv"]
+    | List[Literal["table", "audacity", "kaleidoscope", "csv"]] = "table",
+    skip_existing_results: bool = False,
+    sf_thresh: float = 0.03,
+    top_n: int | None = None,
+    merge_consecutive: int = 1,
+    threads: int = 8,
+    locale: str = "en",
+):
+    """
+    Analyzes audio files for bird species detection using the BirdNET-Analyzer.
+    Args:
+        input (str): Path to the input directory or file containing audio data.
+        output (str | None, optional): Path to the output directory for results. Defaults to None.
+        min_conf (float, optional): Minimum confidence threshold for detections. Defaults to 0.25.
+        classifier (str | None, optional): Path to a custom classifier file. Defaults to None.
+        lat (float, optional): Latitude for location-based filtering. Defaults to -1.
+        lon (float, optional): Longitude for location-based filtering. Defaults to -1.
+        week (int, optional): Week of the year for seasonal filtering. Defaults to -1.
+        slist (str | None, optional): Path to a species list file for filtering. Defaults to None.
+        sensitivity (float, optional): Sensitivity of the detection algorithm. Defaults to 1.0.
+        overlap (float, optional): Overlap between analysis windows in seconds. Defaults to 0.
+        fmin (int, optional): Minimum frequency for analysis in Hz. Defaults to 0.
+        fmax (int, optional): Maximum frequency for analysis in Hz. Defaults to 15000.
+        audio_speed (float, optional): Speed factor for audio playback during analysis. Defaults to 1.0.
+        batch_size (int, optional): Batch size for processing. Defaults to 1.
+        combine_results (bool, optional): Whether to combine results into a single file. Defaults to False.
+        rtype (Literal["table", "audacity", "kaleidoscope", "csv"] | List[Literal["table", "audacity", "kaleidoscope", "csv"]], optional):
+            Output format(s) for results. Defaults to "table".
+        skip_existing_results (bool, optional): Whether to skip analysis for files with existing results. Defaults to False.
+        sf_thresh (float, optional): Threshold for species filtering. Defaults to 0.03.
+        top_n (int | None, optional): Limit the number of top detections per file. Defaults to None.
+        merge_consecutive (int, optional): Merge consecutive detections within this time window in seconds. Defaults to 1.
+        threads (int, optional): Number of CPU threads to use for analysis. Defaults to 8.
+        locale (str, optional): Locale for species names and output. Defaults to "en".
+    Returns:
+        None
+    Raises:
+        ValueError: If input path is invalid or required parameters are missing.
+    Notes:
+        - The function ensures the BirdNET model is available before analysis.
+        - Results can be combined into a single file if `combine_results` is True.
+        - Analysis parameters are saved to a file in the output directory.
+    """
+    from multiprocessing import Pool
+
+    import birdnet_analyzer.config as cfg
+    from birdnet_analyzer.analyze.utils import analyze_file, save_analysis_params
+    from birdnet_analyzer.analyze.utils import combine_results as combine
+    from birdnet_analyzer.utils import ensure_model_exists
+
+    ensure_model_exists()
+
+    flist = _set_params(
+        input=input,
+        output=output,
+        min_conf=min_conf,
+        custom_classifier=classifier,
+        lat=lat,
+        lon=lon,
+        week=week,
+        slist=slist,
+        sensitivity=sensitivity,
+        locale=locale,
+        overlap=overlap,
+        fmin=fmin,
+        fmax=fmax,
+        audio_speed=audio_speed,
+        bs=batch_size,
+        combine_results=combine_results,
+        rtype=rtype,
+        sf_thresh=sf_thresh,
+        top_n=top_n,
+        merge_consecutive=merge_consecutive,
+        skip_existing_results=skip_existing_results,
+        threads=threads,
+        labels_file=cfg.LABELS_FILE,
+    )
+
+    print(f"Found {len(cfg.FILE_LIST)} files to analyze")
+
+    if not cfg.SPECIES_LIST:
+        print(f"Species list contains {len(cfg.LABELS)} species")
+    else:
+        print(f"Species list contains {len(cfg.SPECIES_LIST)} species")
+
+    result_files = []
+
+    # Analyze files
+    if cfg.CPU_THREADS < 2 or len(flist) < 2:
+        for entry in flist:
+            result_files.append(analyze_file(entry))
+    else:
+        with Pool(cfg.CPU_THREADS) as p:
+            # Map analyzeFile function to each entry in flist
+            results = p.map_async(analyze_file, flist)
+            # Wait for all tasks to complete
+            results.wait()
+            result_files = results.get()
+
+    # Combine results?
+    if cfg.COMBINE_RESULTS:
+        print(f"Combining results, writing to {cfg.OUTPUT_PATH}...", end="", flush=True)
+        combine(result_files)
+        print("done!", flush=True)
+
+    save_analysis_params(os.path.join(cfg.OUTPUT_PATH, cfg.ANALYSIS_PARAMS_FILENAME))
+
+
+def _set_params(
+    input,
+    output,
+    min_conf,
+    custom_classifier,
+    lat,
+    lon,
+    week,
+    slist,
+    sensitivity,
+    locale,
+    overlap,
+    fmin,
+    fmax,
+    audio_speed,
+    bs,
+    combine_results,
+    rtype,
+    skip_existing_results,
+    sf_thresh,
+    top_n,
+    merge_consecutive,
+    threads,
+    labels_file=None,
+):
+    import birdnet_analyzer.config as cfg
+    from birdnet_analyzer.analyze.utils import load_codes  # noqa: E402
+    from birdnet_analyzer.species.utils import get_species_list
+    from birdnet_analyzer.utils import collect_audio_files, read_lines
+
+    cfg.CODES = load_codes()
+    cfg.LABELS = read_lines(labels_file if labels_file else cfg.LABELS_FILE)
+    cfg.SKIP_EXISTING_RESULTS = skip_existing_results
+    cfg.LOCATION_FILTER_THRESHOLD = sf_thresh
+    cfg.TOP_N = top_n
+    cfg.MERGE_CONSECUTIVE = merge_consecutive
+    cfg.INPUT_PATH = input
+    cfg.MIN_CONFIDENCE = min_conf
+    cfg.SIGMOID_SENSITIVITY = sensitivity
+    cfg.SIG_OVERLAP = overlap
+    cfg.BANDPASS_FMIN = fmin
+    cfg.BANDPASS_FMAX = fmax
+    cfg.AUDIO_SPEED = audio_speed
+    cfg.RESULT_TYPES = rtype
+    cfg.COMBINE_RESULTS = combine_results
+    cfg.BATCH_SIZE = bs
+
+    if not output:
+        if os.path.isfile(cfg.INPUT_PATH):
+            cfg.OUTPUT_PATH = os.path.dirname(cfg.INPUT_PATH)
+        else:
+            cfg.OUTPUT_PATH = cfg.INPUT_PATH
+    else:
+        cfg.OUTPUT_PATH = output
+
+    if os.path.isdir(cfg.INPUT_PATH):
+        cfg.FILE_LIST = collect_audio_files(cfg.INPUT_PATH)
+    else:
+        cfg.FILE_LIST = [cfg.INPUT_PATH]
+
+    if os.path.isdir(cfg.INPUT_PATH):
+        cfg.CPU_THREADS = threads
+        cfg.TFLITE_THREADS = 1
+    else:
+        cfg.CPU_THREADS = 1
+        cfg.TFLITE_THREADS = threads
+
+    if custom_classifier is not None:
+        cfg.CUSTOM_CLASSIFIER = custom_classifier  # we treat this as absolute path, so no need to join with dirname
+
+        if custom_classifier.endswith(".tflite"):
+            cfg.LABELS_FILE = custom_classifier.replace(".tflite", "_Labels.txt")  # same for labels file
+
+            if not os.path.isfile(cfg.LABELS_FILE):
+                cfg.LABELS_FILE = custom_classifier.replace("Model_FP32.tflite", "Labels.txt")
+
+            cfg.LABELS = read_lines(cfg.LABELS_FILE)
+        else:
+            cfg.APPLY_SIGMOID = False
+            # our output format
+            cfg.LABELS_FILE = os.path.join(custom_classifier, "labels", "label_names.csv")
+
+            if not os.path.isfile(cfg.LABELS_FILE):
+                cfg.LABELS_FILE = os.path.join(custom_classifier, "assets", "label.csv")
+                cfg.LABELS = read_lines(cfg.LABELS_FILE)
+            else:
+                cfg.LABELS = [line.split(",")[1] for line in read_lines(cfg.LABELS_FILE)]
+    else:
+        cfg.LATITUDE, cfg.LONGITUDE, cfg.WEEK = lat, lon, week
+        cfg.CUSTOM_CLASSIFIER = None
+
+        if cfg.LATITUDE == -1 and cfg.LONGITUDE == -1:
+            if not slist:
+                cfg.SPECIES_LIST_FILE = None
+            else:
+                cfg.SPECIES_LIST_FILE = slist
+
+                if os.path.isdir(cfg.SPECIES_LIST_FILE):
+                    cfg.SPECIES_LIST_FILE = os.path.join(cfg.SPECIES_LIST_FILE, "species_list.txt")
+
+            cfg.SPECIES_LIST = read_lines(cfg.SPECIES_LIST_FILE)
+        else:
+            cfg.SPECIES_LIST_FILE = None
+            cfg.SPECIES_LIST = get_species_list(cfg.LATITUDE, cfg.LONGITUDE, cfg.WEEK, cfg.LOCATION_FILTER_THRESHOLD)
+
+    lfile = os.path.join(
+        cfg.TRANSLATED_LABELS_PATH, os.path.basename(cfg.LABELS_FILE).replace(".txt", "_{}.txt".format(locale))
+    )
+
+    if locale not in ["en"] and os.path.isfile(lfile):
+        cfg.TRANSLATED_LABELS = read_lines(lfile)
+    else:
+        cfg.TRANSLATED_LABELS = cfg.LABELS
+
+    return [(f, cfg.get_config()) for f in cfg.FILE_LIST]