Metadata-Version: 2.1
Name: AudioFusion
Version: 0.1.2
Summary: Enhance your music experience – effortlessly add immersive 8D, slowed, and reverb effects to any song.
Home-page: https://github.com/MineisZarox/AudioFusion
Author: Zarox
Author-email: mineiszarox@gmail.com
License: MIT
Project-URL: Bug Tracker, https://github.com/MineisZarox/AudioFusion
Keywords: music,reverb,slowed,8d,editor,python
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
License-File: License
Requires-Dist: pydub
Requires-Dist: SoundFile
Requires-Dist: pedalboard

<div align="center">
<h1>AudioFusion</h1>
Python music editor
</div>

<i>A package that allows to edit your music file however you want with effects like slowed reverb and 8d.</i>

<h2>Installation:</h2>

```bash
>>> python3 -m pip install AudioFusion
```

<h2>Usage:</h2>

```python
>>> from AudioFusion import Fusion
>>> # from AudioFusion.async import Fusion

>>> # Load your music file
>>> music = Fusion.loadSound("/path/to/your/music.mp3")

>>> # Add effects
>>> music = Fusion.effect8D(music)
>>> music = Fusion.effectSlowed(music)
>>> music = Fusion.effectReverb(music)

>>> # Save your edited music file
>>> Fusion.saveSound(music, "finalMusic")


```
More effects and method will be added soon
PR in [github repository](https://github.com/MineisZarox/AudioFusion) beta branch are always welcome.

For more immersive usage and possibilities check out [pydub](https://github.com/jiaaro/pydub)
Working Web application based on this library - [AudioFuser](https://huggingface.co/spaces/zarox/AudioFusion)

## Todo

- Acapella Extractor
- Karoke Maker
- Bass Booster
- Volume Booster


<h2>Advanced Usage:</h2>

```python
>>> from AudioFusion import Fusion


>>> # Load your music file
>>> music = Fusion.loadSound("/path/to/your/music.mp3")

>>> # Add effects
>>> music = Fusion.effect8D(
        music,
        panBoundary = 100,  # Perctange of dist from center that audio source can go
        jumpPercentage = 5,  # Percentage of dist b/w L-R to jump at a time
        timeLtoR = 10000,  # Time taken for audio source to move from left to right in ms
        volumeMultiplier = 6  # Max volume DB increase at edges
)

>>> music = Fusion.effectSlowed(music, speedMultiplier: float = 0.92 ): # Slowdown audio, 1.0 means original speed, 0.5 half speed etc

>>> music = Fusion.effectReverb(
        music,
        roomSize = 0.8, 
        damping = 1,
        width = 0.5,
        wetLevel = 0.3,
        dryLevel = 0.8,
        tempFile = "tempWavFileForReverb"
    )

>>> # Save your edited music file
>>> Fusion.saveSound(music, "finalMusic")

```


## Credits

- Special thanks to [Jiaaro](https://github.com/jiaaro) for pydub. AudioFusion is mainly wrapped around pydub
