Metadata-Version: 2.4
Name: radiant-voices
Version: 2.0.1.2.1.4.0
Summary: Create, read, modify, and write SunVox files.
Author-email: Matthew Scott <matt@11craft.com>
License-File: AUTHORS.rst
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: attrs>=25.1.0
Requires-Dist: logutils>=0.3.5
Requires-Dist: networkx>=3.4.2
Requires-Dist: python-slugify>=8.0.4
Provides-Extra: docs
Requires-Dist: plantweb>=1.2.1; extra == 'docs'
Requires-Dist: sphinx-rtd-theme>=3.0.2; extra == 'docs'
Requires-Dist: sphinx>=8.2.1; extra == 'docs'
Provides-Extra: tools
Requires-Dist: hexdump>=3.3; extra == 'tools'
Requires-Dist: numpy>=2.2.3; extra == 'tools'
Requires-Dist: rich>=13.9.4; extra == 'tools'
Requires-Dist: scipy>=1.15.2; extra == 'tools'
Requires-Dist: sunvox-dll-python>=0.3.6.2.1.2.1; extra == 'tools'
Requires-Dist: tqdm>=4.67.1; extra == 'tools'
Description-Content-Type: text/x-rst

Overview of Radiant Voices
==========================

Part of the Metrasynth_ project.

.. _Metrasynth: https://metrasynth.github.io/

Radiant Voices provides tools and an object model to
**create, read, modify, and write SunVox files**.
This includes project files ending in ``.sunvox``,
and module/synth files ending in ``.sunsynth``.


SunVox data structures and APIs
-------------------------------

Radiant Voices strives toward 100% coverage of
all data structures used by SunVox files,
exposing APIs for creating and manipulating those structures.

Using these APIs, you can do things not possible
with the standard SunVox interface or the SunVox DLL, such as:

- `algorithmic composition`_
- parametric synth/module design
- structure and complexity analysis
- automatic `graph layout`_ of modules
- and more...

Our collective imagination is the limit!

..  _algorithmic composition:
    https://en.wikipedia.org/wiki/Algorithmic_composition

..  _graph layout:
    https://en.wikipedia.org/wiki/Graph_drawing


Supported programming languages
-------------------------------

Supported languages currently include:

- Python 3.11+

While Radiant Voices currently only targets Python,
the project is structured to be able to handle multiple programming languages.

This is accomplished by combining a structured file format specification
with a custom code generation framework.


Interaction with the SunVox DLL
-------------------------------

By combining Radiant Voices with sunvox-dll-python_ for Python
(or the SunVox library wrapper for your language),
one can also create alternative editing and performance tools
to use alongside, or instead of, the official SunVox app.

The two packages work together to provide convenient high-level
APIs for loading project and module objects directly into
playback slots managed by the SunVox DLL.

Some possibilities might include:

- alternative project editors
- generative_ sound design using `genetic algorithms`_
- network-enabled performance tools

What can *you* come up with?

..  _sunvox-dll-python:
    https://sunvox-dll-python.readthedocs.io/

..  _generative:
    https://en.wikipedia.org/wiki/Generative_Design

..  _genetic algorithms:
    https://en.wikipedia.org/wiki/Genetic_algorithm


SunVox file format documentation
--------------------------------

Radiant Voices intends to serve as a *de facto* source of documentation
about the format, as there is currently `no official documentation for the
SunVox file format <http://www.warmplace.ru/forum/viewtopic.php?t=1943#p5562>`__.

The interpretation of SunVox file formats is based on a mix of "clean room"
style inspection of what SunVox writes to disk when a file is edited
a specific way, the `most recent BSD-licensed source code
for the SunVox audio engine <https://github.com/warmplace/sunvox_sources>`__,
and consultation with NightRadio (the author of SunVox).

Documentation is provided in the form of prose in the English language,
as well as a specification defined in YAML format.


Requirements
------------

- Python 3.11+

- OS and platform supported by `sunvox-dll-python`_, if working with
  the native SunVox DLL.


About SunVox
------------

From the `SunVox home page`_:

    SunVox is a small, fast and powerful modular synthesizer with pattern-based sequencer (tracker).
    It is a tool for those people who like to compose music wherever they are, whenever they wish.
    On any device. SunVox is available for Windows, OS X, Linux, Maemo, Meego, Raspberry Pi,
    Windows Mobile (WindowsCE), PalmOS, iOS and Android.

.. _SunVox home page: http://www.warmplace.ru/soft/sunvox/
