https://github.com/dheerajshenoy/visound
Python program to convert images to sounds
https://github.com/dheerajshenoy/visound
Last synced: 6 months ago
JSON representation
Python program to convert images to sounds
- Host: GitHub
- URL: https://github.com/dheerajshenoy/visound
- Owner: dheerajshenoy
- License: agpl-3.0
- Created: 2025-05-06T15:58:41.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-05-07T15:26:12.000Z (6 months ago)
- Last Synced: 2025-05-07T15:27:43.597Z (6 months ago)
- Language: Python
- Size: 309 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ViSound
Library to convert images to sounds.
Refer to the wiki [here](https://github.com/dheerajshenoy/ViSound/blob/main/WIKI.md)
## Introduction
This is just a standalone library for use in other programs that can make use of `ViSound` capabilities. On it's own `ViSound` doesn't do anything. You have to use it in some way to get the output and play the audio yourself.
## Installation
ViSound can be installed using pip:
```
pip install visound
```
## Features
* Sonify images in a number of different ways
* Output the audio to a file or stdout
* Apply effects
## Traversal Modes
You can traverse the given input images in different ways to get different audio output. The following modes are currently supported.
* Left To Right
* Right to Left
* Top to Bottom
* Bottom to Top
* Circle Inward
* Circle Outward
## Usage
`visound --play --verbose`
## Dependencies
* numpy
* opencv-python
* sounddevice
* soundfile
# TODO
- [X] Traversal
- [X] Left to Right
- [X] Right to left
- [X] Top to bottom
- [X] Bottom to top
- [X] Circular inward
- [X] Circular outward
- [X] Apply effects to the output audio
- [ ] Allow for custom pixel to frequency mapping
- [X] CLI client
- [ ] Machine learning to apply effects and custom image traversal