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
170 Dec 20, 2022
4.4k Jan 09, 2023
1 Mar 01, 2022
455 Jan 08, 2023
12 Oct 24, 2017
8 May 15, 2022
2.3k Dec 30, 2022
2 Oct 10, 2021
1 Feb 14, 2022
1.4k Dec 24, 2022
2 Oct 23, 2022
1 Mar 21, 2022
31 Aug 31, 2022
9 Jul 19, 2022
15 Dec 09, 2022
3 Dec 28, 2022
6 Apr 06, 2022
2 Nov 17, 2021
5 Oct 25, 2022
5 Jun 06, 2022