PicTone is a simple, fun Python CLI tool that converts images into vectorscope audios. It supports tweaking multiple parameters and sampling sequences of images.

To install PicTone, use pip:

pip install pictone

You'll need Python 3.6 or higher.

PicTone is a command-line tool that converts the images into WAV files using a sampler with edge detection. You can tweak its parameters and the way the images are passed to it.

The basic command structure for using PicTone is as follows:

pictone -i input_path -o output_path [options]

Input can be either an image or a folder with an ordered sequence of them.

In addition to the required input and output paths, there are some optional arguments to shape the result:

• -r --rate: Sample rate for the output audio. Default is 44100 Hz.
• -d --depth: Bit depth for audio samples. Can be 8, 16, or 24. Default is 16.
• -s --samples: Number of samples the inputs should be forced to last. By default, they'll last the minimum. This is useful if you are converting a sequence (e.g. Forcing to 735 with a rate of 44100 would achieve a ~60 fps visualization).
• -a --aspect: Boolean value to decide whether to preserve the input aspect ratio. Defaults to True.

If you want to experiment, the sampler can be instantiated and configured by yourself. Although it just outputs a single input raw data:

import cv2
from pictone.sampler import EdgeSampler

image = cv2.imread("image.png", 0)
image_edges = cv2.Canny(image, 100, 200)

edge_threshold = 0
byte_depth = 2

sampler = EdgeSampler(edge_threshold, byte_depth) # Basic params

sampled_data = sampler.sample_frames(image_edges)