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
47 Dec 29, 2022
6 Jan 04, 2023
6 Nov 28, 2022
9 Oct 24, 2021
4 Jul 26, 2022
1 Nov 23, 2021
3 Dec 06, 2022
23 Nov 21, 2022
1 Dec 02, 2022
34 Dec 07, 2022
1 Oct 10, 2021
1 Dec 21, 2021
1 Nov 09, 2021
1 Jan 05, 2022
9.4k Jan 07, 2023
1 Jan 07, 2022
2 Dec 18, 2021
1 Jan 08, 2022
11 Oct 11, 2022
43 Dec 17, 2022