# MTG/sms-tools

Sound analysis/synthesis tools for music applications

Repository: https://github.com/MTG/sms-tools
Canonical: https://ross.abutalabs.com/products/sms-tools
Homepage: https://www.upf.edu/web/mtg/sms-tools
Language: Python
License: AGPL-3.0
License Family: copyleft
Topics: jupyter-notebook, sound-analysis, python, sound-synthesis, teaching-materials
Last push: 2026-03-19T15:59:07+00:00

## Health v2 (maintenance only)
Score: 68/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 73, release rhythm 43, longevity 100
- inputs: {"age_days": 4786, "days_push": 167, "days_rel": 167, "gap_med": 253, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1794, forks 764 (observed 2026-08-28T04:05:37.280018+00:00)

## What it is
sms-tools is a Python library of sound analysis and synthesis models for music applications, including DFT, STFT, sinusoidal, harmonic, and stochastic modeling. It ships with Cython-accelerated core routines and companion Jupyter notebook teaching materials.

## Use cases
- analyze and synthesize audio signals in Python
- extract sinusoidal and harmonic components from music recordings
- learn spectral audio processing through Jupyter notebooks
- implement STFT-based sound transformations
- separate harmonic and stochastic parts of a sound
- teach or study digital signal processing for music

## When to choose
- you need spectral analysis/synthesis models like sinusoidal, harmonic, or stochastic modeling in Python
- you are teaching or learning audio DSP with hands-on notebooks
- you want a pip-installable, cross-platform audio modeling library with optional Cython speedups

## When to avoid
- you need real-time audio processing or streaming
- you want a GUI-based audio editor rather than a programmatic library
- you need general-purpose machine learning on audio rather than classical spectral models

## Facets
- artifact type: library
- maturity: active
- function: audio-processing, machine-learning, data-visualization
- domain: audio, education
- platform: python, windows, cross-platform
- tags: sound-analysis, sound-synthesis, spectral-modeling, stft, sinusoidal-model, harmonic-model, jupyter-notebooks, teaching-materials, cython-acceleration, dsp, audio, signal-processing, linux, macos

## Member repositories
- MTG/sms-tools (main) score 68

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:37.280018+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:22:52.671790+00:00, confidence not recorded.
  - readme: https://github.com/MTG/sms-tools (fetched 2026-08-28T04:05:37.280018+00:00, sha d2400510afbf)
  - registry_pypi: https://pypi.org/pypi/sms-tools/json (fetched 2026-08-29T11:01:42.254107+00:00, sha 6281b6f202b7)
- Data as of 2026-08-30T08:39:29.467469+00:00.