Metadata-Version: 2.4
Name: tuney
Version: 0.3.38
Summary: 🎶 Turn text into music (#noAI) 🎶
License-File: LICENSE
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.12
Requires-Dist: chardet>=7.4.3
Requires-Dist: mido>=1.3.3
Requires-Dist: numpy>=2.4.1
Requires-Dist: pydantic>=2.13.3
Requires-Dist: pynput>=1.8.1
Requires-Dist: pyside6>=6.11.1
Requires-Dist: python-rtmidi>=1.5.8
Requires-Dist: pyttsx3>=2.99
Requires-Dist: sounddevice>=0.5.3
Requires-Dist: soundfile>=0.13.1
Requires-Dist: tomlkit>=0.15.0
Requires-Dist: tyro>=1.0.13
Description-Content-Type: text/markdown

# 🎵 tuney 🎵: text to music

## What is it?

`tuney` runs as either a desktop program which is an instrument that turns your typing
into notes, or as a CLI that turns text into music.

## Why is this different from [Brand X text-to-music program]?

It's intended as an instrument for musicians and poets, not a toy.

While it warms up in a very regular piano mode, you have a large number of details to
tweak.

If you are interested in microtonal scales, which means scales that are not on the
standard Western scale, you can tune it to any scale you like: EDO and n-tet Just
Intonation is built-in, and you don't have to have any idea what these are to have some
fun with them, or you can take an existing tuning and change a few notes, or create an
entirely new tuning yourself.

There's a little looper and an audio recorder. You can run it in offline mode to turn a
large amount of text into music quite fast.

## Is this some AI thing?

No. All the scales, oscillators, synths, mappings, tunings, music theory and such were
conceived of and written by a human, and there's an actual algorithm you can examine
and change if you like.

The later portions of the code were written with the aid of AI coding models, carefully
reviewed by a human.

## Testing release builds

See [tester instructions](doc/tester-instructions.md) for downloading and running the
Windows, macOS and Linux release builds.
