# Audio DeSilencer
Audio DeSilencer is a powerful Python package for audio processing that empowers you to detect and remove silence in audio recordings. Additionally, it provides functionality to facilitate video silence removal using the generated text files.
## Features
- **Silence Detection**: Identify and segment silent parts of audio based on custom-defined silence thresholds and minimum silence duration.
- **Silence Removal**: Effortlessly remove detected silence segments to enhance audio quality and eliminate unnecessary gaps.
- **Text File Generation**: Create text files containing the timeline data of silent and non-silent parts, facilitating further processing for video silence removal or in-depth analysis.
- **Command-Line Interface**: Seamlessly integrate Audio DeSilencer into your audio and video processing pipelines with an intuitive command-line interface.
## Installation
### Installation via pip
To install Audio DeSilencer using pip, simply run:
```bash
pip install audio-desilencer
```
Now, you can run Audio DeSilencer from the command line:
```bash
audio-desilencer input_audio.mp3 --output_folder output_directory --min_silence_len 100 --threshold -30
```
### Manual Installation
If you prefer not to use pip, you can manually install Audio DeSilencer by following these steps:
1. Clone the Audio DeSilencer repository:
```bash
git clone https://github.com/BTawaifi/Audio-DeSilencer.git
```
2. Navigate to the project directory:
```bash
cd Audio-DeSilencer
```
3. Install the required dependencies:
```bash
pip install -r requirements.txt
```
4. Now, you can run Audio DeSilencer from the command line:
```bash
python audio-desilencer.py input_audio.mp3 --output_folder output_directory --min_silence_len 100 --threshold -30
```
### Command-Line Arguments
- `input_audio.mp3`: The path to the input audio file.
- `--output_folder`: (Optional) The folder where the output files and timeline data will be saved (default is "output").
- `--min_silence_len`: (Optional) The minimum duration of silence (in milliseconds) to be considered as a separate silent part (default is 100 ms).
- `--threshold`: (Optional) The silence threshold in dBFS (decibels relative to full scale) used to distinguish between silent and non-silent parts (default is -30 dBFS).
### Output
Audio DeSilencer will generate the following output:
- `interview_silent.mp3`: Audio file with silence segments removed.
- `interview_non_silent.mp3`: Audio file containing only the non-silent parts.
- `silent_parts.txt`: Timeline data of silent parts.
- `non_silent_parts.txt`: Timeline data of non-silent parts.
## Usage Example
Here's a usage example to get you started:
```bash
python audio-desilencer.py input_audio.mp3 --output_folder output_directory --min_silence_len 100 --threshold -30
```
Or if you have it installed using pip
```bash
audio-desilencer input_audio.mp3 --output_folder output_directory --min_silence_len 100 --threshold -30
```
## Contributing
Contributions to Audio DeSilencer are highly encouraged! Whether you'd like to report issues or submit pull requests to enhance the tool, your contributions are invaluable. Please refer to the [CONTRIBUTING](CONTRIBUTING.md) guide for details on how to contribute.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/BTawaifi/Audio-DeSilencer",
"name": "Audio-DeSilencer",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "audio,processing,silence removal,pause removal",
"author": "Boutros Tawaifi",
"author_email": "boutrous.m.tawaifi@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/08/04/cb689ee7361d61f1ef9f8bb29c15338cf06e68d86dc2b13edab045c1decc/Audio-DeSilencer-1.0.2.tar.gz",
"platform": null,
"description": "# Audio DeSilencer\r\n\r\nAudio DeSilencer is a powerful Python package for audio processing that empowers you to detect and remove silence in audio recordings. Additionally, it provides functionality to facilitate video silence removal using the generated text files.\r\n\r\n## Features\r\n\r\n- **Silence Detection**: Identify and segment silent parts of audio based on custom-defined silence thresholds and minimum silence duration.\r\n\r\n- **Silence Removal**: Effortlessly remove detected silence segments to enhance audio quality and eliminate unnecessary gaps.\r\n\r\n- **Text File Generation**: Create text files containing the timeline data of silent and non-silent parts, facilitating further processing for video silence removal or in-depth analysis.\r\n\r\n- **Command-Line Interface**: Seamlessly integrate Audio DeSilencer into your audio and video processing pipelines with an intuitive command-line interface.\r\n\r\n## Installation\r\n\r\n### Installation via pip\r\n\r\nTo install Audio DeSilencer using pip, simply run:\r\n\r\n```bash\r\npip install audio-desilencer\r\n```\r\n\r\nNow, you can run Audio DeSilencer from the command line:\r\n\r\n ```bash\r\n audio-desilencer input_audio.mp3 --output_folder output_directory --min_silence_len 100 --threshold -30\r\n ```\r\n\r\n### Manual Installation\r\n\r\nIf you prefer not to use pip, you can manually install Audio DeSilencer by following these steps:\r\n\r\n1. Clone the Audio DeSilencer repository:\r\n\r\n ```bash\r\n git clone https://github.com/BTawaifi/Audio-DeSilencer.git\r\n ```\r\n\r\n2. Navigate to the project directory:\r\n\r\n ```bash\r\n cd Audio-DeSilencer\r\n ```\r\n\r\n3. Install the required dependencies:\r\n\r\n ```bash\r\n pip install -r requirements.txt\r\n ```\r\n\r\n4. Now, you can run Audio DeSilencer from the command line:\r\n\r\n ```bash\r\n python audio-desilencer.py input_audio.mp3 --output_folder output_directory --min_silence_len 100 --threshold -30\r\n ```\r\n\r\n### Command-Line Arguments\r\n\r\n- `input_audio.mp3`: The path to the input audio file.\r\n- `--output_folder`: (Optional) The folder where the output files and timeline data will be saved (default is \"output\").\r\n- `--min_silence_len`: (Optional) The minimum duration of silence (in milliseconds) to be considered as a separate silent part (default is 100 ms).\r\n- `--threshold`: (Optional) The silence threshold in dBFS (decibels relative to full scale) used to distinguish between silent and non-silent parts (default is -30 dBFS).\r\n\r\n### Output\r\n\r\nAudio DeSilencer will generate the following output:\r\n\r\n- `interview_silent.mp3`: Audio file with silence segments removed.\r\n- `interview_non_silent.mp3`: Audio file containing only the non-silent parts.\r\n- `silent_parts.txt`: Timeline data of silent parts.\r\n- `non_silent_parts.txt`: Timeline data of non-silent parts.\r\n\r\n## Usage Example\r\n\r\nHere's a usage example to get you started:\r\n\r\n```bash\r\npython audio-desilencer.py input_audio.mp3 --output_folder output_directory --min_silence_len 100 --threshold -30\r\n```\r\n\r\nOr if you have it installed using pip\r\n\r\n```bash\r\naudio-desilencer input_audio.mp3 --output_folder output_directory --min_silence_len 100 --threshold -30\r\n```\r\n\r\n## Contributing\r\n\r\nContributions to Audio DeSilencer are highly encouraged! Whether you'd like to report issues or submit pull requests to enhance the tool, your contributions are invaluable. Please refer to the [CONTRIBUTING](CONTRIBUTING.md) guide for details on how to contribute.\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "An audio processing tool for detecting and removing silence in audio recordings.",
"version": "1.0.2",
"project_urls": {
"Homepage": "https://github.com/BTawaifi/Audio-DeSilencer"
},
"split_keywords": [
"audio",
"processing",
"silence removal",
"pause removal"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "81122e4f362eeb0155b14b32cac7500794fd80afc6d57a70db97aa089b079908",
"md5": "fd91fd5bee58dae056bf561fb7026e58",
"sha256": "a50181c3a00a553520a0005a2e74552aecf2265d0b73d2099c06f7b43773de9a"
},
"downloads": -1,
"filename": "Audio_DeSilencer-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fd91fd5bee58dae056bf561fb7026e58",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 5103,
"upload_time": "2023-09-19T11:50:20",
"upload_time_iso_8601": "2023-09-19T11:50:20.495263Z",
"url": "https://files.pythonhosted.org/packages/81/12/2e4f362eeb0155b14b32cac7500794fd80afc6d57a70db97aa089b079908/Audio_DeSilencer-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0804cb689ee7361d61f1ef9f8bb29c15338cf06e68d86dc2b13edab045c1decc",
"md5": "6878886f3ba0f99070a08892bb05ea1f",
"sha256": "059eb166d2c35ef3adb00a54b8422d8304165242ad541a60c7d9eb5b1d8b2a3b"
},
"downloads": -1,
"filename": "Audio-DeSilencer-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "6878886f3ba0f99070a08892bb05ea1f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 4458,
"upload_time": "2023-09-19T11:50:22",
"upload_time_iso_8601": "2023-09-19T11:50:22.731005Z",
"url": "https://files.pythonhosted.org/packages/08/04/cb689ee7361d61f1ef9f8bb29c15338cf06e68d86dc2b13edab045c1decc/Audio-DeSilencer-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-19 11:50:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "BTawaifi",
"github_project": "Audio-DeSilencer",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "audio-desilencer"
}
JSON
