Scripts for working with the xeno-canto sound archive. https://spacecruft.org/deepcrayon/xeno-crufto
Go to file
Jeff Moe 14f8603383 Add Dependencies 2023-09-27 12:13:03 -06:00
.gitignore Ignore temporary files 2023-09-27 11:15:20 -06:00
LICENSE-APACHE Apache 2.0 2023-09-27 11:15:09 -06:00
LICENSE-CC CC by SA 4.0 2023-09-27 11:15:02 -06:00
README.md Add Dependencies 2023-09-27 12:13:03 -06:00
requirements-dev.txt Formatting, python deps stub 2023-09-27 11:49:05 -06:00
requirements.txt Add Dependencies 2023-09-27 12:13:03 -06:00
xeno-crufto xeno-crufto script stub 2023-09-27 12:12:44 -06:00

README.md

xeno-crufto

Scripts for working with the xeno-canto sound archive.

https://spacecruft.org/deepcrayon/xeno-crufto

Install

Install thusly.

Using Debian Stable (12/Bookworm).

Install thine dependencies:

sudo apt update
sudo apt install git python3-pip python3-virtualenv

Clone repo:

git clone https://spacecruft.org/deepcrayon/xeno-crufto
cd xeno-crufto/

Set up Python to taste, such as:

virtualenv env
source env/bin/activate
pip install --upgrade pip setuptools wheel

Install Python dependencies.

pip install -r requirements.txt

Using jq isn'ta requirement, but it is handy to have:

sudo apt install jq

Usage

Development

To "develop", install the requirements:

pip install -r requirements-dev.txt

Then run black on the Python files for nice formatting:

black xeno-crufto*

Upstream

The main upstream project.

Other xeno-canto projects

The following projects are noted for further research. They all have libre licenses, are somewhat recently updated, and are in Python. Many xeno-canto software projects on Github have no licenses.

Unsupervised classification to improve the quality of a bird song. recording dataset.

XenoPy: Python wrapper for Xeno-canto API 2.0. Supports multiprocessing.

easybird: Python toolkit for Bird Activity Detection (BAD).

train bird song recognition with a xeno canto database.

A Python wrapper for the Xeno Canto API.

Python wrapper for the xeno-canto.org API to aid in downloading and managing recordings.

This python script automated downloading audio recordings of different bird calls.

A tool for getting xeno-canto bird calls and transforming them for use in TensorFlow.

Status

Alpha, initial development.

Disclaimer

I'm not a programmer and I know less about birds.

Copyright

Unofficial project, not related to xeno-canto.

Upstream sources under their respective copyrights.

License

Dual licensed under the Creative Commons Attribution-ShareAlike 4.0 International and the Apache 2.0 license. The content may be used under either license.

Copyright © 2023, Jeff Moe.