{ "info": { "author": "Emilio Molina", "author_email": "emilio.mol.mar@gmail.com", "bugtrack_url": null, "classifiers": [], "description": "[![Build Status](https://travis-ci.org/EliosMolina/audio_degrader.svg?branch=master)](https://travis-ci.org/EliosMolina/audio_degrader)\n# audio_degrader\n\nLatest version: `1.2.3`\n\nAudio degradation toolbox in python, with a command-line tool. It is useful to apply controlled degradations to audio.\n\n\n## Installation\n\n`pip install audio_degrader`\n\nThe program depends on `sox`, `ffmpeg` and `rubberband`, so you might need to install them as well. Recommended `brew` in OSX and `apt-get` in linux (for rubberband, in linux use `rubberband-cli`).\n\n\n## Usage of python package\n```Python\nimport audio_degrader as ad\naudio_file = ad.AudioFile('input.wav', './tmp_dir')\nfor d in ad.ALL_DEGRADATIONS.values():\n print ad.DegradationUsageDocGenerator.get_degradation_help(d)\ndegradations = ad.ParametersParser.parse_degradations_args([\n 'normalize',\n 'gain,6',\n 'dr_compression,3',\n 'equalize,500,10,30'])\nfor d in degradations:\n audio_file.apply_degradation(d)\naudio_file.to_wav('output.wav')\naudio_file.delete_tmp_files()\n```\n\n## Usage of command-line tool\n\nThe script `audio_degrader` is installed along with the python package.\n\n```\n# e.g. mix with restaurant08.wav with snr=10db, then amplifies 6db, then compress dynamic range\n$ audio_degrader -i input.mp3 -d mix,https://github.com/hagenw/audio-degradation-toolbox/raw/master/AudioDegradationToolbox/degradationData/PubSounds/restaurant08.wav,10 gain,6 dr_compression,3 -o out.wav\n\n# for more details:\n$ audio_degrader --help\n```\n\nA small set of sounds and impulse responses are installed along with the script, which can be listed with:\n```\n$ audio_degrader -l\n\n# these relative paths can be used directly in the script too:\n$ audio_degrader -i input.mp3 -d mix,sounds/applause.wav,-3 gain,6 -o out.wav\n```\n\n\n## Applications\n* Evaluate Music Information Retrieval systems under different degrees of degradations\n* Prepare augmented data for training of machine learning systems\n\nIt is similar to the [Audio Degradation Toolbox in Matlab by Sebastian Ewert and Matthias Mauch][1] (for Matlab).\n\n\n## Some examples\n\n```\n# Mix input with a sound / noise (e.g. using installed resources)\n$ audio_degrader -i input.wav -d mix,sounds/applause.wav,-3 -o out.wav\n\n\n# Instead of paths, we can also use URLs\n$ audio_degrader -i input.wav -d mix,https://www.pacdv.com/sounds/ambience_sounds/airport-security-1.mp3,-3 -o out.wav\n\n\n# Microphone recording style\n$ audio_degrader -i input.wav -d gain,-15 mix,sounds/ambience-pub.wav,18 convolution,impulse_responses/ir_smartphone_mic_mono.wav,0.8 dr_compression,2 equalize,50,100,-6 normalize -o out.wav\n\n\n# Resample and normalize\n$ audio_degrader -i input.mp3 -d resample,8000 normalize -o out.wav\n\n\n# Convolution (again impulse responses can be resources, full paths or URLs)\n$ audio_degrader -i input.wav -d convolution,impulse_responses/ir_classroom_mono.wav,0.7 -o out.wav\n$ audio_degrader -i input.wav -d convolution,http://www.cksde.com/sounds/month_ir/FLANGERSPACE%20E001%20M2S.wav,0.7 -o out.wav\n```\n\n## Audio formats\n\n### Input\n`audio_degrader` relies on ffmpeg for audio reading, so it can read any format (even video).\n\n### Output\n`audio_degrader` output format is always wav stereo `pcm_f32le` (sample rate from original audio file).\n\nThis output wav file can be easily coverted into another format with ffmpeg, e.g.:\n```\n$ ffmpeg -i out.wav -b:a 320k out.mp3\n$ ffmpeg -i out.wav -ac 2 -ar 44100 -acodec pcm_s16le out_formatted.wav\n```\n\n\n[1]: https://code.soundsoftware.ac.uk/projects/audio-degradation-toolbox\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "https://github.com/EliosMolina/audio_degrader/archive/master.zip", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/EliosMolina/audio_degrader", "keywords": "audio,degradation,augmentation", "license": "", "maintainer": "", "maintainer_email": "", "name": "audio-degrader", "package_url": "https://pypi.org/project/audio-degrader/", "platform": "", "project_url": "https://pypi.org/project/audio-degrader/", "project_urls": { "Download": "https://github.com/EliosMolina/audio_degrader/archive/master.zip", "Homepage": "https://github.com/EliosMolina/audio_degrader" }, "release_url": "https://pypi.org/project/audio-degrader/1.2.3/", "requires_dist": [ "librosa (>=0.6.0)" ], "requires_python": "", "summary": "Tool to introduce controlled degradations to audio", "version": "1.2.3" }, "last_serial": 5185227, "releases": { "1.0.1": [ { "comment_text": "", "digests": { "md5": "1d003ba096a06456356505db29782d05", "sha256": "536df57946b28f7e8189fe4b9db5f73d3368bbcde733653e8b148dbb3af874e1" }, "downloads": -1, "filename": "audio_degrader-1.0.1-py2-none-any.whl", "has_sig": false, "md5_digest": "1d003ba096a06456356505db29782d05", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 19508904, "upload_time": "2018-05-06T14:38:36", "url": "https://files.pythonhosted.org/packages/b1/8f/c54beeb5716d9ba65a6baa65e93ca36142ecd0716d6df1cf245e4b2f0146/audio_degrader-1.0.1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e8758e70d2c192f1200f910a0a1a46b5", "sha256": "d85926ef364de9166e61bb873946cf1bf72653ebf695ccbbda941393c7242431" }, "downloads": -1, "filename": "audio_degrader-1.0.1.tar.gz", "has_sig": false, "md5_digest": "e8758e70d2c192f1200f910a0a1a46b5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17340, "upload_time": "2018-05-06T14:38:40", "url": "https://files.pythonhosted.org/packages/77/5a/147d5890d2f8f1191b6847a4a8dfddcc0527eeaba0c30a6e70c8b5eaab4b/audio_degrader-1.0.1.tar.gz" } ], "1.0.2": [ { "comment_text": "", "digests": { "md5": "9383aae3f5b191a3e729e79dae1f37cd", "sha256": "97322d1ffe2ca54dcdb0ec784a94eb1cf1777ee22287013e6473aadf0e7e5814" }, "downloads": -1, "filename": "audio_degrader-1.0.2-py2-none-any.whl", "has_sig": false, "md5_digest": "9383aae3f5b191a3e729e79dae1f37cd", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 19509299, "upload_time": "2018-05-06T21:29:20", "url": "https://files.pythonhosted.org/packages/47/66/39916b9d2bb9238891dddf6b7aff8d6d3dc60e8ab7f63c5dfb29a0ea9a9e/audio_degrader-1.0.2-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "25138c32e324f31535cb376389b3fb11", "sha256": "57c82623050274371ce72db1d1bc38fb586eb432ff3898f225ace05bb33a5a5f" }, "downloads": -1, "filename": "audio_degrader-1.0.2.tar.gz", "has_sig": false, "md5_digest": "25138c32e324f31535cb376389b3fb11", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17135, "upload_time": "2018-05-06T21:29:23", "url": "https://files.pythonhosted.org/packages/03/1e/f3775ca9a9c19fd6831b77349900331f36735b1450b679efc12b729c8a1d/audio_degrader-1.0.2.tar.gz" } ], "1.0.3": [ { "comment_text": "", "digests": { "md5": "6b63aa942998feeea3b8898ff9e70a1f", "sha256": "3954f17c930736d9415858c7281c4a2cfa4bfc6492abead3a3b859aa40d63548" }, "downloads": -1, "filename": "audio_degrader-1.0.3-py2-none-any.whl", "has_sig": false, "md5_digest": "6b63aa942998feeea3b8898ff9e70a1f", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 19509541, "upload_time": "2018-05-06T22:01:52", "url": "https://files.pythonhosted.org/packages/2a/d0/e407144606163964f1aae516bab1068a61f48b9c193322d8a5858758fe73/audio_degrader-1.0.3-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d2be5000a55bbd738d89ff28130387f8", "sha256": "a0013b7d8e62a96c006e2438f2e0276a11586dfb710939ed07525b29a2c53960" }, "downloads": -1, "filename": "audio_degrader-1.0.3.tar.gz", "has_sig": false, "md5_digest": "d2be5000a55bbd738d89ff28130387f8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17374, "upload_time": "2018-05-06T22:01:55", "url": "https://files.pythonhosted.org/packages/51/dc/daa4e15a5d168f2d963c1d2229ea0a7c56ef447958214ff50a6aa0539af9/audio_degrader-1.0.3.tar.gz" } ], "1.0.4": [ { "comment_text": "", "digests": { "md5": "83cc08f4eb9fa5652931155e2d510432", "sha256": "635c6a2f0e8412cb73d26fac51dedda6a7f4e253c516398bb53101ad34ca70c1" }, "downloads": -1, "filename": "audio_degrader-1.0.4-py2-none-any.whl", "has_sig": false, "md5_digest": "83cc08f4eb9fa5652931155e2d510432", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 19509553, "upload_time": "2018-05-06T22:16:22", "url": "https://files.pythonhosted.org/packages/e0/96/a7e8510387e60c88d115c6657dd995eb1226c1d39ef1f3c0c260b59cd12d/audio_degrader-1.0.4-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0e875dbd2a8152eba4a475f3e3a65086", "sha256": "d121a437b8db5337d7a11183f59c9f8b6210e09211d7669cd5d1c4e0f94c837c" }, "downloads": -1, "filename": "audio_degrader-1.0.4.tar.gz", "has_sig": false, "md5_digest": "0e875dbd2a8152eba4a475f3e3a65086", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17385, "upload_time": "2018-05-06T22:16:25", "url": "https://files.pythonhosted.org/packages/b3/1d/2c9bc6ce098f875db66f6b4a7d98d1ad36f947c04c39f55e0ceb995ca449/audio_degrader-1.0.4.tar.gz" } ], "1.0.5": [ { "comment_text": "", "digests": { "md5": "088acad95e95637bd8c8ead4ac4d18d0", "sha256": "27e91a5bd5bf753c9d94cbba366257c63fbb5006fc260d5d2aaa4c596a4d09aa" }, "downloads": -1, "filename": "audio_degrader-1.0.5-py2-none-any.whl", "has_sig": false, "md5_digest": "088acad95e95637bd8c8ead4ac4d18d0", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 19510329, "upload_time": "2018-05-07T16:01:28", "url": "https://files.pythonhosted.org/packages/c6/c1/8b051705e7797a9915f5c5aaa027e8163c20947b0d8b90ed0f2a497e20b2/audio_degrader-1.0.5-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1c0f66da95e5ec13f3900995a0304ab7", "sha256": "05dca71acc26507ff80cf7b97cc11609808b2d1ecba1aa5d2ff57bfbe541804e" }, "downloads": -1, "filename": "audio_degrader-1.0.5.tar.gz", "has_sig": false, "md5_digest": "1c0f66da95e5ec13f3900995a0304ab7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18180, "upload_time": "2018-05-07T16:01:31", "url": "https://files.pythonhosted.org/packages/5b/96/30f924c822554914278e83cc346c7461bcbc364d594c620f7308ffc64c17/audio_degrader-1.0.5.tar.gz" } ], "1.1": [ { "comment_text": "", "digests": { "md5": "c662017f43106c2d801a99e4aaf7fa10", "sha256": "f8d2db46aefccbd1d9ccd168f61e49fdcaed32b35c4cc5f1e8a7612ca8427d5e" }, "downloads": -1, "filename": "audio_degrader-1.1-py2-none-any.whl", "has_sig": false, "md5_digest": "c662017f43106c2d801a99e4aaf7fa10", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 19713589, "upload_time": "2018-08-26T09:56:30", "url": "https://files.pythonhosted.org/packages/3b/c7/8a347edbd0cd5ca5c6f7c2f91d8ea603f2eb3fde3eecb4f0d9050efbc357/audio_degrader-1.1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3566e9e9086be36146968020a48f79bb", "sha256": "0f95992e0fcaa434c4fedabaf4a301b6f2a2d34fb4dc8e51899e4dec5ef71b31" }, "downloads": -1, "filename": "audio_degrader-1.1.tar.gz", "has_sig": false, "md5_digest": "3566e9e9086be36146968020a48f79bb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21842, "upload_time": "2018-08-26T09:56:34", "url": "https://files.pythonhosted.org/packages/1f/f9/2e75a279131c2fc9ed60c0cba4d2d90a64651e1f353b8ebab9e2926a820d/audio_degrader-1.1.tar.gz" } ], "1.1.1": [ { "comment_text": "", "digests": { "md5": "54f0e2e7d0602c359f23adf508ff5803", "sha256": "86dd0504b4ff5d326382bfa084a3df0d83c3f194e605d063593de74d8bd05818" }, "downloads": -1, "filename": "audio_degrader-1.1.1-py2-none-any.whl", "has_sig": false, "md5_digest": "54f0e2e7d0602c359f23adf508ff5803", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 19766968, "upload_time": "2018-08-27T15:25:36", "url": "https://files.pythonhosted.org/packages/c0/81/9e7b87113b3b1295d6b99787741751dc62cba76ef74d27894e65f994bbd8/audio_degrader-1.1.1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "9c6618b0b277c2a7f874913c3f397133", "sha256": "51c75dd8caeda5e4eb774ed17a18a63a862c0709d734726e1a24ad8412cecd40" }, "downloads": -1, "filename": "audio_degrader-1.1.1.tar.gz", "has_sig": false, "md5_digest": "9c6618b0b277c2a7f874913c3f397133", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21797, "upload_time": "2018-08-27T15:25:39", "url": "https://files.pythonhosted.org/packages/f2/1a/28532421183278a0293dac5e098c89a60505bfffdfc7d15f2d2fa7d744d5/audio_degrader-1.1.1.tar.gz" } ], "1.2": [ { "comment_text": "", "digests": { "md5": "6c6aef6008c640338bed5441e796e2fa", "sha256": "73fc5b6e51919cb44414e050053960ea08dfff478b0b0589d7b4025e4a1c6c55" }, "downloads": -1, "filename": "audio_degrader-1.2-py2-none-any.whl", "has_sig": false, "md5_digest": "6c6aef6008c640338bed5441e796e2fa", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 19001985, "upload_time": "2019-04-07T02:16:05", "url": "https://files.pythonhosted.org/packages/33/b3/c602c919f1fdc750d1042de201932c69ad5db358a5752a436925403514f3/audio_degrader-1.2-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "baf50d87222823add585d4b2d21b051d", "sha256": "d0ce5abd1dce01174da000cd33efa7b5e0416248af40f79c10b6eb92eeb86a43" }, "downloads": -1, "filename": "audio_degrader-1.2.tar.gz", "has_sig": false, "md5_digest": "baf50d87222823add585d4b2d21b051d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22814, "upload_time": "2019-04-07T02:16:09", "url": "https://files.pythonhosted.org/packages/7c/af/38d61771b3730bfbd8ba6222cd355aede763ebbeab30e60193c14f11eb2c/audio_degrader-1.2.tar.gz" } ], "1.2.1": [ { "comment_text": "", "digests": { "md5": "cebd61792be7f005bcfdd42b057b384f", "sha256": "4ebd3dd53b9fc9a994e1078382596368a2d74ad00fcc6ec9137f7f12fb6c041d" }, "downloads": -1, "filename": "audio_degrader-1.2.1-py2-none-any.whl", "has_sig": false, "md5_digest": "cebd61792be7f005bcfdd42b057b384f", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 19001919, "upload_time": "2019-04-07T03:49:23", "url": "https://files.pythonhosted.org/packages/d1/fc/973a0cbe6f4290ece3c557c2baa0e1bcf7c9fcb13d0e091691bacbef282d/audio_degrader-1.2.1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "43cc20da6142b65511003a456cadd75d", "sha256": "d230b991fb80f6f186a51e5cc4c186d61be29bf262f159bf1a4d99933b85dff4" }, "downloads": -1, "filename": "audio_degrader-1.2.1.tar.gz", "has_sig": false, "md5_digest": "43cc20da6142b65511003a456cadd75d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23016, "upload_time": "2019-04-07T03:49:26", "url": "https://files.pythonhosted.org/packages/6e/db/2876bd18d6295071d771bdfdebc968225b01360c023184fc3b83e29015fa/audio_degrader-1.2.1.tar.gz" } ], "1.2.2": [ { "comment_text": "", "digests": { "md5": "6d90d736a1b6d787923cfcd3f726a954", "sha256": "d4f13b640808976b07d983e428e1a707a1fc83c986e51aa0e6dde196157a6ff5" }, "downloads": -1, "filename": "audio_degrader-1.2.2-py2-none-any.whl", "has_sig": false, "md5_digest": "6d90d736a1b6d787923cfcd3f726a954", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 19001984, "upload_time": "2019-04-07T11:01:12", "url": "https://files.pythonhosted.org/packages/53/2e/d068f7466b4bd00334577a293fb56d58ac4b8c8288c5e0670032528e7fa0/audio_degrader-1.2.2-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f147b869bbf60c5a3e2dbd030be0674c", "sha256": "b2a4107a131c3bd3bdec4ad7afa71912c62502089933874c2aa906f45ea51a9f" }, "downloads": -1, "filename": "audio_degrader-1.2.2.tar.gz", "has_sig": false, "md5_digest": "f147b869bbf60c5a3e2dbd030be0674c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22450, "upload_time": "2019-04-07T11:01:16", "url": "https://files.pythonhosted.org/packages/9a/8e/178601cab3d51b5bd9398001e1f5448d7f46ce5e81e29cc85b6decb121f3/audio_degrader-1.2.2.tar.gz" } ], "1.2.3": [ { "comment_text": "", "digests": { "md5": "1bfa9219cf9094226d49b5214883cfd1", "sha256": "8c1e1358c1d0bba585d159e469fcfa96729da3c05f8eecd2619eb7c68a9e775c" }, "downloads": -1, "filename": "audio_degrader-1.2.3-py2-none-any.whl", "has_sig": false, "md5_digest": "1bfa9219cf9094226d49b5214883cfd1", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 19003558, "upload_time": "2019-04-24T22:55:59", "url": "https://files.pythonhosted.org/packages/41/dc/ed544b854a9a441d7c1ecd0dbbf748cd638ca5e10f7bde8e7a785d6601b6/audio_degrader-1.2.3-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a07251b0b9b10a35fdbcd73d395f69a4", "sha256": "3a4487e38ca9dc7cd7b67330ef9a7924f7f58bfa54d8bc9aa42673fbd3a0ee5b" }, "downloads": -1, "filename": "audio_degrader-1.2.3.tar.gz", "has_sig": false, "md5_digest": "a07251b0b9b10a35fdbcd73d395f69a4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 24334, "upload_time": "2019-04-24T22:56:02", "url": "https://files.pythonhosted.org/packages/da/85/19bc7ebaf57033575c92647efbb95f17e5e4ed944b11620f2938c7079d94/audio_degrader-1.2.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "1bfa9219cf9094226d49b5214883cfd1", "sha256": "8c1e1358c1d0bba585d159e469fcfa96729da3c05f8eecd2619eb7c68a9e775c" }, "downloads": -1, "filename": "audio_degrader-1.2.3-py2-none-any.whl", "has_sig": false, "md5_digest": "1bfa9219cf9094226d49b5214883cfd1", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 19003558, "upload_time": "2019-04-24T22:55:59", "url": "https://files.pythonhosted.org/packages/41/dc/ed544b854a9a441d7c1ecd0dbbf748cd638ca5e10f7bde8e7a785d6601b6/audio_degrader-1.2.3-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a07251b0b9b10a35fdbcd73d395f69a4", "sha256": "3a4487e38ca9dc7cd7b67330ef9a7924f7f58bfa54d8bc9aa42673fbd3a0ee5b" }, "downloads": -1, "filename": "audio_degrader-1.2.3.tar.gz", "has_sig": false, "md5_digest": "a07251b0b9b10a35fdbcd73d395f69a4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 24334, "upload_time": "2019-04-24T22:56:02", "url": "https://files.pythonhosted.org/packages/da/85/19bc7ebaf57033575c92647efbb95f17e5e4ed944b11620f2938c7079d94/audio_degrader-1.2.3.tar.gz" } ] }