Metadata-Version: 2.1
Name: soundviewer
Version: 1.0.2
Summary: Python package for sound visualization
Author-email: emingenc <emingench@yandex.com>
Description-Content-Type: text/markdown
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Requires-Dist: librosa>=0.9.0
Requires-Dist: matplotlib>=3.5.1
Requires-Dist: audio-metadata>=0.11.1
Requires-Dist: opencv-python>=4.5.5.62
Project-URL: Home, https://github.com/emingenc/soundviewer

<!-- sound to image image to sound python package  -->

# Soundviewer

Python package for converting sound to image and image to sound.

for longer sounds try to split them into smaller parts.

![](https://c.tenor.com/5eU8wSWY8zkAAAAC/wow-cool.gif)


## Installation

```bash
pip3 install 'git+https://github.com/emingenc/soundviewer.git'

# Or, to install it from a local clone:
git clone +https://github.com/emingenc/soundviewer.git
pip3 install -e soundviewer
```

### Linux post-install

On a base linux install you may be missing `libsnd`.

On Ubuntu and Debian this can be fixed via:

```
sudo apt-get install libsndfile1-dev
```

## Getting Started

### Run from local clone

```bash
cd soundviewer
pip3 install -r requirements.txt


python3 -m soundviewer.sound2image --input sample_data/thermo.wav --show

or

python3 soundviewer/sound2image.py --input sample_data/thermo.wav --show

```

if you want to save without showing the image, remove `--show`

or with `--output` flag you can specify custom name and spesific path


image to sound

```bash
python3 -m soundviewer.image2sound --input sample_data/thermo.png --output sample_data/thermo.wav

or

python3 soundviewer/image2sound.py --input sample_data/thermo.png --output sample_data/thermo.wav
```

this will save thermo.wav to your working directory if --output is not specified

### use it on your python script

```python3
import soundviewer
sound_path = 'sample_data/thermo.wav'
soundviewer.souund_to_image(sound_path)
```
this will save thermo.jpg to your working directory

if you want you can specify the output path and image name `soundviewer.sound2image.save_image_from_sound(sound_path,output='./test.jpg')`

image to sound

```python3
import soundviewer
sound_path = 'sample_data/thermo.png'
soundviewer.image_to_sound(sound_path)
```

here is the output image for sample data thermo.wav

![sound to image](https://raw.githubusercontent.com/emingenc/soundviewer/master/sample_data/thermo.png)






wav source : https://people.math.sc.edu/Burkardt/data/wav/thermo.wav

