[Sine]thesizer
Overview
It is a digital synthesizer that is based on some design principles:
- Control via text files facilitates automation and boosts reproducibility, so GUI is absent.
- Although low-level and OS-specific dependencies improve performance, they reduce reliability, portability, and transparency, so they are avoided here. This standalone synth depends only on Python and some its packages.
- Since performance is not a merit of this synth, it is better to trade off speedups for sound quality. In particular, wavetables are not used at all and full waves are generated. Also, noise is generated from scratch every time it is needed.
The list of implemented and planned features is as follows:
- Balance between freedom for user and simplicity of input formats
- Support of additive synthesis, subtractive synthesis, and AM/PM synthesis
- Sound effects (e.g., phaser, overdrive, reverb, etc)
- Custom 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:
python -m sinethesizer \
-i path/to/track.midi \
-p path/to/presets.yml \ # Or -p path/to/dir_with_presets
-m path/to/midi_config.yml \
-o path/to/output.wav
However, MIDI files are binary and, therefore, quite opaque. Also, integration between them and this synth is not complete: for example, control changes are ignored and event-level effects can not be applied. Here, TSV (Tab-Separated Values) files of special schema can be used as a native and more transparent alternative to MIDI. To process such a file, run:
python -m sinethesizer \
-i path/to/track.tsv \
-p path/to/presets.yml \ # Or -p path/to/dir_with_presets
-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 | Scale |
| -p path/to/presets.yml | Instruments definition | Demo instruments |
| -m path/to/midi_config.yml | Settings of MIDI file interpretation | Demo MIDI config |
If something is still unclear, you can read the source code — it is structured and has built-in documentation. Also, your questions are welcome.
See also
To turn Jupyter notebook into a simple DAW, PyMixer can be used. It is a Python library having good integration with [Sine]thesizer. Together they form a small ecosystem of audio tools which are oriented to text-based control.
Metadata
Release files for sinethesizer 0.6.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| sinethesizer-0.6.2.tar.gz | 57.4 kB | Without provenance | Details for sinethesizer-0.6.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| sinethesizer-0.6.2-py3-none-any.whl | Python 3 | none | any | Details for sinethesizer-0.6.2-py3-none-any.whl |
Total release size: 108.6 kB
Release files / sinethesizer-0.6.2.tar.gz
| Download URL | sinethesizer-0.6.2.tar.gz |
|---|---|
| Size | 57.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fb279589c20ba3825b96793b32f63c6786538d322926a0d4e159be382677cf39
|
|
BLAKE2b-256 checksum How to use checksums |
e66ba5fb6f9188e414c90022f3d51fbdacc053ac17959d6b4a47817f771a26da
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.10.12
|
Release files / sinethesizer-0.6.2-py3-none-any.whl
| Download URL | sinethesizer-0.6.2-py3-none-any.whl |
|---|---|
| Size | 51.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cd515740d553888fef034f19aba58483ab4c253ce6eb3792093dcb9e500d4444
|
|
BLAKE2b-256 checksum How to use checksums |
16102588d3b319bc00e523f0311c9edb4887b91ca05dfc3fe5a34a9d34e7d3b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.10.12
|
Security for sinethesizer 0.6.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.