Metadata-Version: 2.1
Name: audiosample
Version: 2.1.5
Summary: AudioSample is an optimized numpy-like audio manipulation library, created for researchers, used by developers.
Home-page: https://deepdub.ai
Author: Nir Krakowski
Author-email: nir@deepdub.ai
License: MIT
Project-URL: Source, https://github.com/deepdub-ai/audiosample
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: numpy<=1.23.5
Provides-Extra: jupyter
Requires-Dist: jupyter; extra == "jupyter"
Requires-Dist: IPython; extra == "jupyter"
Requires-Dist: librosa; extra == "jupyter"
Requires-Dist: matplotlib; extra == "jupyter"
Provides-Extra: torch
Requires-Dist: torch>=1.5; extra == "torch"
Provides-Extra: noui
Requires-Dist: torch>=1.5; extra == "noui"
Requires-Dist: av; extra == "noui"
Provides-Extra: av
Requires-Dist: av; extra == "av"
Provides-Extra: play
Requires-Dist: pyaudio; extra == "play"
Provides-Extra: all
Requires-Dist: jupyter; extra == "all"
Requires-Dist: IPython; extra == "all"
Requires-Dist: librosa; extra == "all"
Requires-Dist: matplotlib; extra == "all"
Requires-Dist: pyaudio; extra == "all"
Requires-Dist: torch>=1.5; extra == "all"
Requires-Dist: av; extra == "all"
Provides-Extra: tests
Requires-Dist: pytest; extra == "tests"
Requires-Dist: jupyter; extra == "tests"
Requires-Dist: IPython; extra == "tests"
Requires-Dist: librosa; extra == "tests"
Requires-Dist: matplotlib; extra == "tests"
Requires-Dist: scipy; extra == "tests"
Requires-Dist: pyaudio; extra == "tests"
Requires-Dist: torch>=1.5; extra == "tests"
Requires-Dist: av; extra == "tests"

# audiosample

Here's a revised README.md that includes information about Deepdub:

---

# AudioSample
AudioSample is an optimized numpy-like audio manipulation library, created for researchers, used by developers.

It is an advanced audio manipulation library designed to provide researchers and developers with efficient, numpy-like tools for audio processing. It supports complex audio operations with ease and offers a familiar syntax for those accustomed to numpy.

## Features

- **Seamless Audio Operations:** Perform a wide range of audio manipulations, including mixing, filtering, and transformations.
- **Integration with Numpy:** Leverage numpy's syntax and capabilities for intuitive audio handling.
- **Integration with Torch:** Export audio directly to and from torch tensors.
- **High Performance:** Optimized for speed and efficiency, suitable for research and production environments. Most actions are lazy, so no operation done until absolutely necessary.
- **Extensive I/O Support:** Easily read from and write to various audio formats. Utilizes PyAv - to support multiple ranges.

## Installation

To install AudioSample, use pip:

to install all prerequisites:
```bash
pip install audiosample[all] 
#Possible extras are:

[av] - only av
[torch] - add torch
[tests] - include everything for tests.
[noui] - install without jupyter support.
[play] - bare, with ability to play audio in console. (uses pyaudio)
```



## Usage

Here's a quick example of how to load, process, and save audio using AudioSample:

```python
import audiosample as ap
import numpy as np

# Create a 1 second audio sample with 44100 samples per second and 2 channels
au = ap.AudioSample.from_numpy(np.random.rand(2, 48000), rate=48000)
beep = ap.AudioSample().beep(1).to_stereo()
out = au.gain(-12) * beep
out.write("beep_with_overlayed_noise.mp3")
out = au.gain(-10) + au.silence(1) + beep
out.write("noise_then_silence_then_beep.mp3")

```

### Additional Operations

- **FFT Analysis:** Perform fast Fourier transforms to analyze frequency components.
- **Normalization:** Easily normalize audio levels.
- **Mixing:** Easily mix multiple audio sources together. Using * sign
- **Concat** Easily concat audio sources. Using + sign
- **Playback:** Play audio directly in Jupyter notebooks or from the command line.
## Documentation

For detailed instructions and API references, type help(AudioSample)

## Examples

Explore the [examples notebook](examples.ipynb) to see practical applications of AudioSample in action.

## Contributing

Contributions are welcome! Please follow the [contributing guidelines](CONTRIBUTING.md) to submit changes.

## About Deepdub

AudioSample is developed by [Deepdub](https://deepdub.ai), a company specializing in AI-driven audio solutions. Deepdub focuses on enhancing media experiences through cutting-edge technology, enabling content creators to reach global audiences with high-quality, localized audio.

## Support

If you have questions or need help, please open an issue on GitHub.
