Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/AlbertSuarez/weird-converter
🔀 Strange combinations converter like Audio <-> Image
https://github.com/AlbertSuarez/weird-converter
audio-to-image converter image-to-audio pypi pypi-package python strange weird
Last synced: 17 days ago
JSON representation
🔀 Strange combinations converter like Audio <-> Image
- Host: GitHub
- URL: https://github.com/AlbertSuarez/weird-converter
- Owner: AlbertSuarez
- License: apache-2.0
- Created: 2020-05-23T15:29:11.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-10-03T23:44:35.000Z (about 1 year ago)
- Last Synced: 2024-09-18T14:31:45.720Z (about 2 months ago)
- Topics: audio-to-image, converter, image-to-audio, pypi, pypi-package, python, strange, weird
- Language: Python
- Homepage: https://pypi.org/project/weird-converter
- Size: 21.4 MB
- Stars: 18
- Watchers: 3
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Weird converter
[](https://pypi.org/project/weird-converter/)
[](https://pepy.tech/project/weird-converter)
[](https://pepy.tech/project/weird-converter/month)
[](https://pepy.tech/project/weird-converter/week)
[](http://hits.dwyl.io/AlbertSuarez/weird-converter)
[](https://codecov.io/gh/AlbertSuarez/weird-converter)
[](https://GitHub.com/AlbertSuarez/weird-converter/stargazers/)
[](https://GitHub.com/AlbertSuarez/weird-converter/network/)
[](https://GitHub.com/AlbertSuarez/weird-converter/graphs/contributors/)
🔀 Strange combinations converter like from Audio to Image and Image to Audio
## Installation
Install client via pip. Ideally, `weird-converter` is well supported for Python >= 3.7.
```bash
pip3 install weird-converter
```
## Usage
Just run it like this:
```python
weird_converter.audio_to_image('audio.wav') # It only supports wav files, for now.
weird_converter.image_to_audio('image.jpg')
```
## Future development
* 🎶 Support other input audio types.
* 📹 Implement audio to video conversion (and the same other way around).
* ⭐️ Implement custom transformations for getting different results.
## Motivation
I know this tool is kind of strange and probably not very useful. However, I wanted to play with numpy and try to understand in a deeper way the amount of stuff that this library can do. That's why I ended up doing this project where I see a lot of progression with different future tweakments (as it is specified above).
## Results
### Audio to image
Image generation comes from a normalization of the audio values. The image will have higher dimensions as more information the audio has, like audio length or channels available.
From this [fanfare audio](https://raw.githubusercontent.com/AlbertSuarez/weird-converter/master/examples/from_audio/fanfare.wav) to this image:
Or from this [empty audio](https://raw.githubusercontent.com/AlbertSuarez/weird-converter/master/examples/from_audio/silent.wav), representing a silence, to this image:
### Image to Audio
Audio generation comes from a normalization to a 44,100 samples per second audio. The output length will be higher depending on the dimensions of the input image. As you could check, the results look very similar to an helicopter sound but it differs depending on the given image.
To this [audio](https://raw.githubusercontent.com/AlbertSuarez/weird-converter/master/examples/from_image/church.wav), where it's clear when the audio is playing the black background and the building pixels.
To this near empty [audio](https://raw.githubusercontent.com/AlbertSuarez/weird-converter/master/examples/from_image/black.wav) and very uniform.
## Development
### Recommendations
Usage of [virtualenv](https://realpython.com/blog/python/python-virtual-environments-a-primer/) is recommended for package library / runtime isolation.
### Installation
1. Setup virtual environment
2. Install dependencies
```bash
pip3 install -r requirements.lock
```
3. Install locally
```bash
pip3 install .
```
## Contributing
Suggestions, improvements, and enhancements are always welcome! If you have any issues, please do raise one in the Issues section. If you have an improvement, do file an issue to discuss the suggestion before creating a PR.
All ideas – no matter how outrageous – welcome!
## Authors
- [Albert Suàrez](https://github.com/AlbertSuarez)
## License
Apache-2.0 © weird-converter