Skip to main content

music21

music21 -- A Toolkit for Computer-Aided Musical Analysis and Computational Musicology

Copyright © 2006-2026 Michael Scott Asato Cuthbert

Released under the BSD (3-clause) license. See LICENSE and below.

For more information, visit: https://www.music21.org/music21docs/

To try it out, visit: https://tinyurl.com/m21colab (run all to set up an environment for the latest release)

And to install, see: https://www.music21.org/music21docs/usersGuide/usersGuide_01_installing.html

Music21 runs on Python 3.11+. (Use music21 version 4 on Python 2 or Py3.4, v5 on Py3.5, v6 on Py3.6, v7 on Py3.7, v8 on Py3.8/Py3.9, and v9 on Py3.10)

Build Status Coverage Status

Documentation

User's Guide

Module Documentation

Mailing list

See: https://groups.google.com/forum/#!forum/music21list

Contributing Guide

Contributing Guide

Community Code of Conduct

Music21 encourages contributions, discussions, and usage from all people interested in music and computers. This encouragement extends to all people regardless of (among other aspects) gender, race, sexual orientation, disability, religion, appearance, veteran status, gender identity, socioeconomic status, or nationality.

Members of the community will strive to be friendly, patient, and welcoming, especially of viewpoints and experiences different from our own. We reject harassment and contributions (in mail, comments, or code) that belittle individuals or groups of people.

We ask all members of the community to be mindful particularly about assumptions of the gender of users (including using correct pronouns in comments and code). We recognize that members sometimes make mistakes and will, in general, accept sincere regrets for such cases. Blatant or repeated violations of the code will result in the removal of the contributor’s participation in the community.

The maintainers of music21 and associated sites will commit themselves to enforcing this code of conduct. Users who notice violations, including instances of abuse, harassment, or otherwise unacceptable behavior are requested to contact michael.asato.cuthbert@gmail.com. Maintainers will respect confidentiality with regard to reports.

Acknowledgements

The early development of music21 was supported by the generosity of the Seaver Institute and the National Endowment for the Humanities, along with MIT's Music and Theater Arts Section and the School of Humanities, Arts, and Social Sciences.

License Coverage and Other/Prior Licenses

Music21 is Open-Source Software released under the BSD (3-clause) license. Essentially, it's free and you can do with it what you'd like as long as you keep the LICENSE file and copyright statement.

The license applies to all code files that are new to music21 along with documentation. Externally provided software (including the MIT-licensed Lilypond/MusicXML test Suite) may have other licenses. The encoded musical scores in the corpus have their own copyrights and licenses. They underlying music is believed to be in the public domain in the US, EU, and Canada (and most of the world) and the encodings are also either public domain or used by permission. For those needing a strict BSD-license of all parts of the music21 system, a no-corpus version of music21 is available also on GitHub or from the FreeBSD repo.

(For historical reasons, music21 before v2 can also be used under the LGPL license. Between v1 and 2, all prior contributors were contacted (it was a handful back then) and all agreed to relicense their contributions under the BSD license).

These detailed explanations of the license were moved to this README.md file in 2026 (v10) and out of LICENSE, music21/LICENSE and music21/license.txt in order to make the music21 license more parsable by tooling. The move was not meant to imply any change in the license or your rights or obligations under it.

Release files for music21 10.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for music21 10.5.0
File Size Uploaded
music21-10.5.0.tar.gz 16.8 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for music21 10.5.0
File Interpreter ABI Platform
music21-10.5.0-py3-none-any.whl Python 3 none any Details

Total release size: 36.9 MB

Release files / music21-10.5.0.tar.gz

Download URL music21-10.5.0.tar.gz
Size 16.8 MB
Tags Source
SHA-256 checksum
How to use checksums
f72676fb953cb592bfb4e3bb246b0a234446f89088aa8a55ec9b5fcef2ce3db2
BLAKE2b-256 checksum
How to use checksums
cdf41f95fda14554cf0e070c8b6bb375a7bc64c020016670766c44bc910a6a84
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release files / music21-10.5.0-py3-none-any.whl

Download URL music21-10.5.0-py3-none-any.whl
Size 20.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
9924eff5fbf58490e67cbf3b78a58ba53040e77c281930d354af32a747e94606
BLAKE2b-256 checksum
How to use checksums
814c4f307e5ab6fbf59233813e58e07128a599c810dd974673449e132ce1432d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release history Release notifications | RSS feed

This release

10.5.0 This release

2 release files

10.3.0

2 release files

10.1.0

2 release files

9.9.2

2 release files

9.9.1

2 release files

9.9.0

2 release files

9.7.1

2 release files

9.7.0

2 release files

9.5.0

2 release files

9.3.0

2 release files

9.1.0

2 release files

8.3.0

2 release files

8.1.0

2 release files

7.3.3

2 release files

7.3.1

2 release files

7.3.0

1 release file

7.1.0

1 release file

6.7.1

1 release file

6.7.0

1 release file

6.5.0

1 release file

6.3.0

1 release file

6.1.0

1 release file

5.7.2

1 release file

5.7.1

1 release file

5.7.0

1 release file

5.5.0

1 release file

5.3.0

1 release file

5.1.0

1 release file

4.1.0

1 release file

3.1.0

1 release file

2.2.1

1 release file

2.1.2

1 release file

2.1.0

1 release file

2.0.11

1 release file

2.0.10

1 release file

2.0.8

2.0.5

1 release file

2.0.0

1 release file

1.9.3

1 release file

1.8.1

1.8.0

1.7.0

1.6.0

1.5.0

1.4.0

1.3.0

1.0.0

1 release file

0.6.2.b2

0.6.1.b1

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page