Librosa 1.0

This release is intended to stabilize the API from the long-running 0.x series.

A full changelog is available at https://librosa.org/doc//dev/changelog.html

A blog post on the 1.0 release gives a high level overview of the changes.

What's Changed

• fix: correct typo in core/convert.py line:1658 by @afadel151 in #1932
• Test overhaul by @bmcfee in #1925
• Peak picking by dynamic programming by @bmcfee in #1927
• Trying a new environment cache setup in CI by @bmcfee in #1936
• Variable-rate and non-iterative phase vocoding by @bmcfee in #1931
• Include scipy-stubs in the test dependencies - v1.0.0 rebase by @jorenham in #1946
• vscale option to specshow by @bmcfee in #1938
• Remove default quantization for note_to_hz by @bmcfee in #1947
• Freq convert nan by @bmcfee in #1948
• Colorbar helpers by @bmcfee in #1952
• Two-slope norm for inferred diverging colormap by @bmcfee in #1954
• Warn on perceptual weighting underflow by @bmcfee in #1955
• Warping path to step grid by @bmcfee in #1958
• Fix subsegment example by @bmcfee in #1959
• SPEC07 compliant rng parameters by @bmcfee in #1960
• Upload doc build preview artifacts by @bmcfee in #1962
• Expire deprecations for 1.0 release by @bmcfee in #1963
• Signal mixing helpers by @bmcfee in #1964
• oct3 display modes by @bmcfee in #1967
• Inverted waveshow by @bmcfee in #1971
• Wavebars by @bmcfee in #1973
• Refine .gitignore for improved accuracy and coverage by @MLsound in #1969
• Fixing figures clumped up at the end of page by @haydnllh in #1979
• Fix types in beat tracking code by @emilazy in #1977
• Fix #1970: Prevent AdaptiveWaveplot adaptor from being garbage collected by @Daniel-Haas-B in #1992
• Add Metrogram Transform by @danferns in #1986
• Update type annotations by @bmcfee in #1980
• Migrate from SciPy spmatrix to sparray by @Daniel-Haas-B in #1994
• Python 3.14 support by @bmcfee in #1999
• feat: implement hybrid_tempogram (#1991) by @Gopesh111 in #2004
• Document specshow frequency axis scaling by @cookesan in #2006
• Surface contributing guide in docs site, link build instructions by @petrakuhnle in #2009
• Multiplot by @bmcfee in #2012
• Spec0 2026.06 by @bmcfee in #2018
• display.wavef0 (was: melodyplot) by @bmcfee in #1976
• Yet another Viterbi acceleration PR by @bmcfee in #2007
• Updates for mypy 2.1 by @bmcfee in #2025
• Fix tonnetz display label ordering by @bmcfee in #2026
• Modern linting by @bmcfee in #2027
• Dynamic vectorize by @bmcfee in #2028
• Even faster import by @bmcfee in #2029
• Negative offset load by @bmcfee in #2030
• Loadx by @bmcfee in #2031
• more helpful failure mode in loadx by @bmcfee in #2032
• Modernize types in librosa._typing by @jorenham in #2035
• modernizing type annotations for the future by @bmcfee in #2036
• more type annotation modernization by @bmcfee in #2038
• Fill in missing type annotations by @jorenham in #2037
• Display Highlighter by @bmcfee in #2034
• cmap_cyclic= in specshow by @bmcfee in #2041
• avoid turning scalars into 0-d arrays in core.{convert,spectrum} and util.utils by @jorenham in #2039
• Waveplot styling by @bmcfee in #2044
• improved dtype_r2c and dtype_c2r typing in util.utils by @jorenham in #2043
• Doc check modernizing by @bmcfee in #2047
• Contributing and agents update by @bmcfee in #2017
• reformat **/__init__.pyi re-exports by @jorenham in #2049
• Include str dtype in ndarray return type annotations by @jorenham in #2050
• Multichannel db by @bmcfee in #2051
• Fix decorator callable types in librosa.util.decorators by @jorenham in #2053
• Improve ndarray return types by @jorenham in #2052
• Support matplotlib 3.11 in tests by @bmcfee in #2054
• Stream resampling by @bmcfee in #2055
• massive simplification of legend_for_axes, fixes #2057 by @bmcfee in #2059
• Refactor frequency formatters by @bmcfee in #2060
• Updating actions by @bmcfee in #2065
• Standardize n_fft parameter docstrings by @brookcs3 in #2068
• Precise dtype type annotations in librosa.beat by @jorenham in #2069
• Infer n_bins automatically in cqt/vqt by @bmcfee in #2066
• Add out= parameter to to_mono for in-place downmixing by @ejwong24 in #2058
• Fix RQA single-axis inputs by @suhashollakc in #2063
• BoundedNorm for specshow on boolean data by @bmcfee in #2072
• Skip redundant np.abs copy in piptrack for non-negative real input by @imrulhuda in #2080
• Tutorial restructure and general documentation overhaul by @bmcfee in #1968
• 1.0.0rc0 release by @bmcfee in #2082
• revising nnls initialization by @bmcfee in #2085
• Validate audio input in feature.rms (closes #2086) by @Kayvan-Zahiri in #2087
• 1.0 final by @bmcfee in #2084

New Contributors

• @afadel151 made their first contribution in #1932
• @jorenham made their first contribution in #1946
• @MLsound made their first contribution in #1969
• @haydnllh made their first contribution in #1979
• @emilazy made their first contribution in #1977
• @Daniel-Haas-B made their first contribution in #1992
• @danferns made their first contribution in #1986
• @Gopesh111 made their first contribution in #2004
• @cookesan made their first contribution in #2006
• @petrakuhnle made their first contribution in #2009
• @brookcs3 made their first contribution in #2068
• @ejwong24 made their first contribution in #2058
• @suhashollakc made their first contribution in #2063
• @imrulhuda made their first contribution in #2080
• @Kayvan-Zahiri made their first contribution in #2087

Full Changelog: 0.11.0...1.0.0