birdData
BirdData is a python wrapper for Xeno-canto API 2.0. Enables user to download bird data with one command line. BirdData supports multithreading download.
Environment
Download repo to local:
git clone [email protected]:realzza/birdData.git
Set up environment:
pip install -r requirement.txt
Usage
Single-thread
Download audio data for one bird species. Use scientific name starting with lowercase. e.g, cettia cetti.
python download.py --name "cettia cetti"
Download audio data for a file of species names. Format requirement: names divided by "\n"
python download.py --name name_file
General Usage:
usage: download.py [-h] --name NAME
download bird audios
optional arguments:
-h, --help show this help message and exit
--name NAME [1] name of one bird species; [2] file of bird species spaced
by '\n'
Multi-thread
Speed up downloading using multiple threads.
python download-mult.py --name "cettia cetti" --process-ratio 0.6
Download multiple birds in a file, format requirement: names divided by "\n"
python download-mult.py --name name_file --process-ratio 0.6
General Usage:
usage: download-mult.py [-h] --name NAME [--process-ratio PROCESS_RATIO]
download bird audios
optional arguments:
-h, --help show this help message and exit
--name NAME [1] name of one bird species; [2] file of bird species
spaced by '\n'
--process-ratio PROCESS_RATIO
float[0~1], define cpu utilities in downloading audios
[default: 0.8]
To-do
- [12.29] multiprocess download
- define sample rate prior to download
Contact
Feel free to file an issue had you encountered any problems. Have fun!
3k Dec 29, 2022
12 Jun 23, 2022
904 Jan 2, 2023
16 Mar 29, 2022
1 Nov 19, 2022
2 May 11, 2022
159 Dec 26, 2022
6 Mar 27, 2022
28 Oct 10, 2022
21 Jan 14, 2022
1 Oct 30, 2021
2 Oct 21, 2022
8 Dec 13, 2022
38 Dec 03, 2022
16 Nov 09, 2022
8 Nov 30, 2022
3 Sep 23, 2022
1.4k Jan 03, 2023
72 Dec 21, 2022
1 Nov 18, 2021
9 Nov 16, 2022
3 Feb 21, 2022
5 Dec 01, 2021
2 Oct 29, 2022
8 Oct 06, 2022
1 Nov 09, 2021
7 Nov 18, 2022
3 Mar 02, 2022
17 Dec 06, 2022