Metadata-Version: 2.1
Name: sinethesizer
Version: 0.2.10
Summary: A digital additive synthesizer that provides a flexible way to create new virtual instruments with their own timbres.
Home-page: https://github.com/Nikolay-Lysenko/sinethesizer
Author: Nikolay Lysenko
Author-email: nikolay-lysenco@yandex.ru
License: MIT
Description: [![Build Status](https://travis-ci.org/Nikolay-Lysenko/sinethesizer.svg?branch=master)](https://travis-ci.org/Nikolay-Lysenko/sinethesizer)
        [![codecov](https://codecov.io/gh/Nikolay-Lysenko/sinethesizer/branch/master/graph/badge.svg)](https://codecov.io/gh/Nikolay-Lysenko/sinethesizer)
        [![Maintainability](https://api.codeclimate.com/v1/badges/a43618b5f9454d01186c/maintainability)](https://codeclimate.com/github/Nikolay-Lysenko/sinethesizer/maintainability)
        [![PyPI version](https://badge.fury.io/py/sinethesizer.svg)](https://badge.fury.io/py/sinethesizer)
        
        # [Sine]thesizer
        
        ## Overview
        
        It is a digital additive synthesizer that provides a flexible way to create new virtual instruments with their own timbres.
        
        The list of implemented and planned features is as follows:
        - [x] Balance between freedom for user and simplicity of input formats
        - [x] Stereo sound
        - [x] Sound effects (e.g., vibrato, overdrive, phaser, etc)
        - [x] Custom amplitude envelopes
        - [ ] Noises and drums
        - [ ] Rich collection of presets
        
        ## Installation
        
        To install a stable version, run:
        ```
        pip install sinethesizer
        ```
        
        ## Usage
        
        This synthesizer converts MIDI files and special text files to WAV files with resulting audio tracks.
        
        For a MIDI file, it can be done with the following command:
        ```bash
        python -m sinethesizer \
            -i path/to/track.midi \
            -p path/to/presets.yml \
            -m path/to/mapping.yml \
            -o path/to/output.wav
        ```
        
        However, MIDI files do not carry information about source location and sound effects. Here, TSV (Tab-Separated Values) files of special schema can be used as a more self-contained alternative to MIDI. To process such file, run:
        ```bash
        python -m sinethesizer \
            -i path/to/track.tsv \
            -p path/to/presets.yml \
            -o path/to/output.wav
        ```
        
        Below table provides links to detailed information about input files that are required from a user.
        
        Option | Description | Example
        :----: | :---------: | :-----:
        -i path/to/track.tsv | [Track definition](https://github.com/Nikolay-Lysenko/sinethesizer/blob/master/docs/track_definition.md) | [Scale](https://github.com/Nikolay-Lysenko/sinethesizer/blob/master/docs/examples/scale.tsv)
        -p path/to/presets.yml | [Timbres definition](https://github.com/Nikolay-Lysenko/sinethesizer/blob/master/docs/timbres_creation.md) | [Demo timbres](https://github.com/Nikolay-Lysenko/sinethesizer/blob/master/presets/demo.yml)
        -m path/to/mapping.yml | Mapping from MIDI instrument IDs to timbres | [Demo mapping](https://github.com/Nikolay-Lysenko/sinethesizer/blob/master/docs/examples/mapping.yml)
        
        If something is still unclear, you can read the source code — it is structured and has built-in documentation. Also your questions are welcome.
        
Keywords: synthesizer analog_synthesizer additive_synthesis music timbre
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Artistic Software
Classifier: Topic :: Multimedia :: Sound/Audio :: Sound Synthesis
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.6
Description-Content-Type: text/markdown
