{ "info": { "author": "Nazariy Tivirikin", "author_email": "n.tivirikin@gmail.com", "bugtrack_url": null, "classifiers": [], "description": "# xeno-canto API Wrapper\nxeno-canto-py is an API wrapper designed to help users easily download xeno-canto.org recordings and associated information.\n\nOriginally created to aid in data collection and filtering for the training of machine learning models.\n## Installation\nNavigate to your desired file location in a terminal and then clone the repository with the following command:\n```bash\ngit clone https://github.com/ntivirikin/xeno-canto-py\n```\nThe only file required for operation is the ```xenocanto.py``` file, so feel free to remove the others or move ```xenocanto.py``` to another working directory.\n\nYou may also use the package manager [pip](https://pip.pypa.io/en/stable/) to install xeno-canto-py to include in your Python projects.\n\n```bash\npip install xeno-canto\n```\nThen import the module:\n```python\nimport xenocanto\n```\nOr use it straight from the command line:\n```bash\nxeno-canto -dl Bearded Bellbird\n```\n## Usage\nCommands through the terminal are given in the following format:\n```\n-m \t[filters]\tMetadata generation\n\n-dl \t[filters] \tDownload recordings\n\n-d \t[filters]\tDelete recordings\n\n-p \t[num] \t\tPurge folders containing num or fewer recordings\n\n-g \t[path] \t\tGenerate metadata for provided library path (defaults to 'dataset/audio/')\n```\n```filters``` are given in tag:value form in accordance with the API search guidelines. For help in building search terms, consult the [xeno-canto API guide](https://www.xeno-canto.org/article/153). The only exception is when providing English bird names as an argument to the ```-d``` command, which must be preceded with ```en:``` and have all spaces be replaced with underscores.\n\nExamples of command usage are given below:\n```bash\n# Retrieving metadata\nxeno-canto -m Bearded Bellbird q:A\n\n# Downloading recordings\nxeno-canto -dl Bearded Bellbird cnt:Brazil\n\n# Delete recordings with ANY of specified criteria from\n# library\nxeno-canto -d q:D cnt:Brazil\n\n# Purge folders with less than 10 recordings\nxeno-canto -p 10\n\n# Generate metadata for all recordings in the path\n# (defaults to 'dataset/audio/')\nxeno-canto -g\n```\n## Contributing\nAll pull requests are welcome! If any issues are found, please do not hesitate to bring them to my attention.\n## Acknowledgements\nThank you to the team at xeno-canto.org and all its contributors for putting together such an amazing database.\n## License\n[MIT](https://choosealicense.com/licenses/mit/)\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/ntivirikin/xeno-canto-py", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "xeno-canto", "package_url": "https://pypi.org/project/xeno-canto/", "platform": "", "project_url": "https://pypi.org/project/xeno-canto/", "project_urls": { "Homepage": "https://github.com/ntivirikin/xeno-canto-py" }, "release_url": "https://pypi.org/project/xeno-canto/2.0.2/", "requires_dist": null, "requires_python": "", "summary": "xeno-canto.org API Wrapper", "version": "2.0.2", "yanked": false, "yanked_reason": null }, "last_serial": 11838783, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "5a38d6d2da7384cb7ef19022d7079c93", "sha256": "6168b876d3cf06c0d36376e69994bd3c428845ddef94f07e04b027ed65283099" }, "downloads": -1, "filename": "xeno_canto-1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "5a38d6d2da7384cb7ef19022d7079c93", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 4321, "upload_time": "2019-03-13T02:41:58", "upload_time_iso_8601": "2019-03-13T02:41:58.156375Z", "url": "https://files.pythonhosted.org/packages/e9/6d/41223882dbdf1516fc87aa3e718cea44e0ad3d202075ff3a6ee877031aac/xeno_canto-1.0.0-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "1a87814e3ff485f9c3e64cce4957d7f2", "sha256": "d6b179281bac5f2905a424d33f38ac791f193960a5805d04aa99c4a849d3072b" }, "downloads": -1, "filename": "xeno-canto-1.0.0.tar.gz", "has_sig": false, "md5_digest": "1a87814e3ff485f9c3e64cce4957d7f2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4518, "upload_time": "2019-03-13T02:42:00", "upload_time_iso_8601": "2019-03-13T02:42:00.026740Z", "url": "https://files.pythonhosted.org/packages/c1/b2/6f2244b696105492a5f0dff4d479870e0f97a1159e44803c976dbca8bf6c/xeno-canto-1.0.0.tar.gz", "yanked": false, "yanked_reason": null } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "e7182d32552410e0a456438743bbf77f", "sha256": "121ee9a0399bac2a4b603df7e7ce4ca18fafb9a35958c4d06792a8b1fd55cc1a" }, "downloads": -1, "filename": "xeno_canto-1.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "e7182d32552410e0a456438743bbf77f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 4387, "upload_time": "2019-03-14T03:09:21", "upload_time_iso_8601": "2019-03-14T03:09:21.434916Z", "url": "https://files.pythonhosted.org/packages/f1/b4/4dedce03fc8bf5629dc0dcde699711baa0051019db8ed3339899784b0bf0/xeno_canto-1.0.1-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "ac67683ae1219310e7a7bc65d7232ecc", "sha256": "eceab131d443908d4d1c7d077b95e6433c05a3c282a6c0da2e0f0b3ea8f206fa" }, "downloads": -1, "filename": "xeno-canto-1.0.1.tar.gz", "has_sig": false, "md5_digest": "ac67683ae1219310e7a7bc65d7232ecc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4620, "upload_time": "2019-03-14T03:09:22", "upload_time_iso_8601": "2019-03-14T03:09:22.825906Z", "url": "https://files.pythonhosted.org/packages/0d/56/a8d4574867227d09eb6bbdfb6bfd3dd85f43da377258b7ccd18b9fdbe636/xeno-canto-1.0.1.tar.gz", "yanked": false, "yanked_reason": null } ], "1.0.2": [ { "comment_text": "", "digests": { "md5": "77a491cd91f0e58481942dd3983e2969", "sha256": "78c2473e2d548246f145071503a16128cc477d4445fd979c7f696f19b622f762" }, "downloads": -1, "filename": "xeno_canto-1.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "77a491cd91f0e58481942dd3983e2969", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 4389, "upload_time": "2019-03-19T00:13:22", "upload_time_iso_8601": "2019-03-19T00:13:22.162587Z", "url": "https://files.pythonhosted.org/packages/55/35/7d504f2d5a0ac04d8599a5c369c6690f152825b23507c2c2e60ba2052894/xeno_canto-1.0.2-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "48288187a8ceef16242969cb3568fe89", "sha256": "bd878d677aed08737dc5281e275fc764888987a1c65f7dfd66c2b7f80e6ffba5" }, "downloads": -1, "filename": "xeno-canto-1.0.2.tar.gz", "has_sig": false, "md5_digest": "48288187a8ceef16242969cb3568fe89", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4620, "upload_time": "2019-03-19T00:13:23", "upload_time_iso_8601": "2019-03-19T00:13:23.660802Z", "url": "https://files.pythonhosted.org/packages/e7/95/af714db6a5a5282326e78a788395f26edd698f394669b5befc016c6b7738/xeno-canto-1.0.2.tar.gz", "yanked": false, "yanked_reason": null } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "2cf602d04937e0e1b4826c20976ceee3", "sha256": "0da8858b90b69e8f672198a11ee87fcacf9291a1b3fa68bab9d14f9569be8fac" }, "downloads": -1, "filename": "xeno-canto-1.1.0.tar.gz", "has_sig": false, "md5_digest": "2cf602d04937e0e1b4826c20976ceee3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5409, "upload_time": "2019-05-02T00:28:47", "upload_time_iso_8601": "2019-05-02T00:28:47.428066Z", "url": "https://files.pythonhosted.org/packages/43/77/4086fd9564ade52d90db5cc752e3511962a20e068934afe726a9ba716363/xeno-canto-1.1.0.tar.gz", "yanked": false, "yanked_reason": null } ], "2.0": [ { "comment_text": "", "digests": { "md5": "ff13b8368a2eb843076cd527ca0e71b9", "sha256": "02432aaa4da390c9af2152af464c406e69d03c93786257fba1a78117451342cb" }, "downloads": -1, "filename": "xeno-canto-2.0.tar.gz", "has_sig": false, "md5_digest": "ff13b8368a2eb843076cd527ca0e71b9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5819, "upload_time": "2019-10-22T22:04:40", "upload_time_iso_8601": "2019-10-22T22:04:40.655379Z", "url": "https://files.pythonhosted.org/packages/24/76/f2a477d792b97914c918a4d73059c71fd1fd11ac25be3788370f74e85c82/xeno-canto-2.0.tar.gz", "yanked": false, "yanked_reason": null } ], "2.0.1": [ { "comment_text": "", "digests": { "md5": "61231db71669443ec7a9d8f310722705", "sha256": "7f7080c9b93e7c893a7e7e713a86a9bee9c55c137447278d13b01a958ff1f123" }, "downloads": -1, "filename": "xeno-canto-2.0.1.tar.gz", "has_sig": false, "md5_digest": "61231db71669443ec7a9d8f310722705", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6175, "upload_time": "2020-03-15T19:20:24", "upload_time_iso_8601": "2020-03-15T19:20:24.820657Z", "url": "https://files.pythonhosted.org/packages/81/54/5805b0171185758977f82b546db14498f67c3af970ba4899557bc48b7ae4/xeno-canto-2.0.1.tar.gz", "yanked": false, "yanked_reason": null } ], "2.0.2": [ { "comment_text": "", "digests": { "md5": "13c124abae0c70452c887947774f0052", "sha256": "2cc234e4e2c583e916f8a9078bd1a8b0fcde6e23b21b7da95976697372b632b2" }, "downloads": -1, "filename": "xeno_canto-2.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "13c124abae0c70452c887947774f0052", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6511, "upload_time": "2021-10-26T19:11:15", "upload_time_iso_8601": "2021-10-26T19:11:15.132885Z", "url": "https://files.pythonhosted.org/packages/c0/1d/a07135879909d07991ac78881499e3730cd4695d2f9e549badaea129fdfd/xeno_canto-2.0.2-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "8a6e324d9b78f95784d751220e66c803", "sha256": "b312e4d7fcdff9b10700eea805bca05e039304e8ee1ce0790647f6fa404cbcc8" }, "downloads": -1, "filename": "xeno-canto-2.0.2.tar.gz", "has_sig": false, "md5_digest": "8a6e324d9b78f95784d751220e66c803", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7283, "upload_time": "2021-10-26T19:11:17", "upload_time_iso_8601": "2021-10-26T19:11:17.808885Z", "url": "https://files.pythonhosted.org/packages/53/3e/dc36f99ffbf39a8c4d71cd82fe1ab02ea7dba2042f1e1daf8a504be3b5aa/xeno-canto-2.0.2.tar.gz", "yanked": false, "yanked_reason": null } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "13c124abae0c70452c887947774f0052", "sha256": "2cc234e4e2c583e916f8a9078bd1a8b0fcde6e23b21b7da95976697372b632b2" }, "downloads": -1, "filename": "xeno_canto-2.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "13c124abae0c70452c887947774f0052", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6511, "upload_time": "2021-10-26T19:11:15", "upload_time_iso_8601": "2021-10-26T19:11:15.132885Z", "url": "https://files.pythonhosted.org/packages/c0/1d/a07135879909d07991ac78881499e3730cd4695d2f9e549badaea129fdfd/xeno_canto-2.0.2-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "8a6e324d9b78f95784d751220e66c803", "sha256": "b312e4d7fcdff9b10700eea805bca05e039304e8ee1ce0790647f6fa404cbcc8" }, "downloads": -1, "filename": "xeno-canto-2.0.2.tar.gz", "has_sig": false, "md5_digest": "8a6e324d9b78f95784d751220e66c803", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7283, "upload_time": "2021-10-26T19:11:17", "upload_time_iso_8601": "2021-10-26T19:11:17.808885Z", "url": "https://files.pythonhosted.org/packages/53/3e/dc36f99ffbf39a8c4d71cd82fe1ab02ea7dba2042f1e1daf8a504be3b5aa/xeno-canto-2.0.2.tar.gz", "yanked": false, "yanked_reason": null } ], "vulnerabilities": [] }