Note: Image discovery and retrieval is defunct since Chromatik, the web service behind this function, went defunct itself.
Similarly request a Google API access key and provide it to Kaleidoscope.
Prepare a configuration for Kaleidoscope.
Some libraries need to be set up, but I'm not going into that now.
Run KaleidoscopeApp as stand-alone Java application or use the included run IntelliJ configuration.
Click the recorder button in the controls window or press I to start recording from the default microphone line; click the recorder button again or press O to stop. The speech in the recorded section is transcribed, the resulting text synesthetised and the synesthetiation result used to search for images with Chromatik.
If you're unwilling or unable to speak to Kaleidoscope through a microphone, use the two text fields below the recorder button in the controls window. The upper one is for a message to synesthetise, the lower one for search terms for Chromatik's image search. You can run perform a synesthetiation and image search by having the upper text field in focus and pressing ENTER/RETURN.
F11 (Windows/Linux) or ⌘+F (macOS) toggles full screen display of Kaleidoscope.
The most convenient way to configure Kaleidoscope is through the integrated configuration editor:
Click on the Configuration window tool button at the bottom of the controls window.
Double-click the cells in the right column of the configuration table to edit their value. Most importantly, add the required API keys (see below).
Below is a description of some the most important options. All parameters except API keys are optional and have sensible defaults.
Flickr > access key and Transcription service > API access key
API access keys for Flickr and Google respectively. If the key is comprised of multiple parts, separate them with a colon (
If the value to of these parameters start with
@, the remainder is interpreted as the path to a resource file containing the key, where multiple parts are separated by newline characters.
The special parameter value
!MOCKresults in a mock implementation of the service connectors, that doesn't use the actual service, but returns a valid, pre-recorded result. For Google's speech-to-text service the mock mode can only be set through the key
com.google.developer.api.keyin the properties file
Note: The above example does not contain a working key, just a randomly generated look-alike.