Skip to main content

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

Project description

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 history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

music21-10.5.0.tar.gz (16.8 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

music21-10.5.0-py3-none-any.whl (20.1 MB view details)

Uploaded Python 3

File details

Details for the file music21-10.5.0.tar.gz.

File metadata

  • Download URL: music21-10.5.0.tar.gz
  • Upload date:
  • Size: 16.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for music21-10.5.0.tar.gz
Algorithm Hash digest
SHA256 f72676fb953cb592bfb4e3bb246b0a234446f89088aa8a55ec9b5fcef2ce3db2
MD5 a549b301cd8c1c8a6b40693f38b90c0f
BLAKE2b-256 cdf41f95fda14554cf0e070c8b6bb375a7bc64c020016670766c44bc910a6a84

See more details on using hashes here.

File details

Details for the file music21-10.5.0-py3-none-any.whl.

File metadata

  • Download URL: music21-10.5.0-py3-none-any.whl
  • Upload date:
  • Size: 20.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for music21-10.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9924eff5fbf58490e67cbf3b78a58ba53040e77c281930d354af32a747e94606
MD5 b304fd3053f6d2abef43e2ec9efc371a
BLAKE2b-256 814c4f307e5ab6fbf59233813e58e07128a599c810dd974673449e132ce1432d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page