{"id":13412041,"url":"https://github.com/AlbertSuarez/weird-converter","last_synced_at":"2025-03-14T17:31:40.934Z","repository":{"id":40945688,"uuid":"266364600","full_name":"AlbertSuarez/weird-converter","owner":"AlbertSuarez","description":"🔀 Strange combinations converter like Audio \u003c-\u003e Image","archived":false,"fork":false,"pushed_at":"2023-10-03T23:44:35.000Z","size":22430,"stargazers_count":18,"open_issues_count":3,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-09-18T14:31:45.720Z","etag":null,"topics":["audio-to-image","converter","image-to-audio","pypi","pypi-package","python","strange","weird"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/weird-converter","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlbertSuarez.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-23T15:29:11.000Z","updated_at":"2024-07-03T15:47:21.000Z","dependencies_parsed_at":"2024-10-26T15:40:03.216Z","dependency_job_id":null,"html_url":"https://github.com/AlbertSuarez/weird-converter","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlbertSuarez%2Fweird-converter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlbertSuarez%2Fweird-converter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlbertSuarez%2Fweird-converter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlbertSuarez%2Fweird-converter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlbertSuarez","download_url":"https://codeload.github.com/AlbertSuarez/weird-converter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243618773,"owners_count":20320289,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio-to-image","converter","image-to-audio","pypi","pypi-package","python","strange","weird"],"created_at":"2024-07-30T20:01:20.402Z","updated_at":"2025-03-14T17:31:35.926Z","avatar_url":"https://github.com/AlbertSuarez.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Weird converter\n\n[![PyPI version](https://badge.fury.io/py/weird-converter.svg)](https://pypi.org/project/weird-converter/)\n[![Downloads](https://pepy.tech/badge/weird-converter)](https://pepy.tech/project/weird-converter)\n[![Downloads](https://pepy.tech/badge/weird-converter/month)](https://pepy.tech/project/weird-converter/month)\n[![Downloads](https://pepy.tech/badge/weird-converter/week)](https://pepy.tech/project/weird-converter/week)\n\u003cbr\u003e\n[![HitCount](http://hits.dwyl.io/AlbertSuarez/weird-converter.svg)](http://hits.dwyl.io/AlbertSuarez/weird-converter)\n![Python package](https://github.com/AlbertSuarez/weird-converter/workflows/Python%20package/badge.svg)\n[![codecov](https://codecov.io/gh/AlbertSuarez/weird-converter/branch/master/graph/badge.svg)](https://codecov.io/gh/AlbertSuarez/weird-converter)\n[![GitHub stars](https://img.shields.io/github/stars/AlbertSuarez/weird-converter.svg)](https://GitHub.com/AlbertSuarez/weird-converter/stargazers/)\n[![GitHub forks](https://img.shields.io/github/forks/AlbertSuarez/weird-converter.svg)](https://GitHub.com/AlbertSuarez/weird-converter/network/)\n[![GitHub contributors](https://img.shields.io/github/contributors/AlbertSuarez/weird-converter.svg)](https://GitHub.com/AlbertSuarez/weird-converter/graphs/contributors/)\n\n🔀 Strange combinations converter like from Audio to Image and Image to Audio\n\n## Installation\n\nInstall client via pip. Ideally, `weird-converter` is well supported for Python \u003e= 3.7.\n\n```bash\npip3 install weird-converter\n```\n\n## Usage\n\nJust run it like this:\n\n```python\nweird_converter.audio_to_image('audio.wav')  # It only supports wav files, for now.\nweird_converter.image_to_audio('image.jpg')\n```\n\n## Future development\n\n* 🎶 Support other input audio types.\n* 📹 Implement audio to video conversion (and the same other way around).\n* ⭐️ Implement custom transformations for getting different results.\n\n## Motivation\n\nI 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).\n\n## Results\n\n### Audio to image\n\nImage 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.\n\nFrom this [fanfare audio](https://raw.githubusercontent.com/AlbertSuarez/weird-converter/master/examples/from_audio/fanfare.wav) to this image:\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"Fanfare image\" src=\"https://raw.githubusercontent.com/AlbertSuarez/weird-converter/master/examples/from_audio/fanfare.jpg\" width=\"30%\"/\u003e\n\u003c/p\u003e\n\nOr from this [empty audio](https://raw.githubusercontent.com/AlbertSuarez/weird-converter/master/examples/from_audio/silent.wav), representing a silence, to this image:\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"Silent image\" src=\"https://raw.githubusercontent.com/AlbertSuarez/weird-converter/master/examples/from_audio/silent.jpg\" width=\"30%\"/\u003e\n\u003c/p\u003e\n\n### Image to Audio\n\nAudio 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.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"Church image\" src=\"https://raw.githubusercontent.com/AlbertSuarez/weird-converter/master/examples/from_image/church.jpg\" width=\"30%\"/\u003e\n\u003c/p\u003e\n\nTo 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.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"Black image\" src=\"https://raw.githubusercontent.com/AlbertSuarez/weird-converter/master/examples/from_image/black.jpg\" width=\"30%\"/\u003e\n\u003c/p\u003e\n\nTo this near empty [audio](https://raw.githubusercontent.com/AlbertSuarez/weird-converter/master/examples/from_image/black.wav) and very uniform.\n\n## Development\n\n### Recommendations\n\nUsage of [virtualenv](https://realpython.com/blog/python/python-virtual-environments-a-primer/) is recommended for package library / runtime isolation.\n\n### Installation\n\n1. Setup virtual environment\n\n2. Install dependencies\n\n  ```bash\n  pip3 install -r requirements.lock\n  ```\n\n3. Install locally\n\n  ```bash\n  pip3 install .\n  ```\n\n## Contributing\n\nSuggestions, 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.\n\nAll ideas – no matter how outrageous – welcome!\n\n## Authors\n\n- [Albert Suàrez](https://github.com/AlbertSuarez)\n\n## License\n\nApache-2.0 © weird-converter\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlbertSuarez%2Fweird-converter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAlbertSuarez%2Fweird-converter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlbertSuarez%2Fweird-converter/lists"}