https://github.com/otsob/wmn4j
Java library for handling western music notation with a focus on computational music analysis.
https://github.com/otsob/wmn4j
computational-musicology music music-notation musicology
Last synced: 5 months ago
JSON representation
Java library for handling western music notation with a focus on computational music analysis.
- Host: GitHub
- URL: https://github.com/otsob/wmn4j
- Owner: otsob
- License: other
- Created: 2016-10-14T20:10:18.000Z (over 9 years ago)
- Default Branch: development
- Last Pushed: 2025-10-22T16:01:14.000Z (8 months ago)
- Last Synced: 2025-10-22T18:07:03.436Z (8 months ago)
- Topics: computational-musicology, music, music-notation, musicology
- Language: Java
- Homepage:
- Size: 7.47 MB
- Stars: 15
- Watchers: 3
- Forks: 3
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Western Music Notation for Java (wmn4j)
[](https://opensource.org/licenses/MIT)
[](https://central.sonatype.com/artifact/org.wmn4j/wmn4j)
wmn4j is a Java library for handling western music notation. The main purpose of wmn4j is to enable easy and efficient
analysis of scores and wmn4j is intended to also provide functionality for algorithmic composition by generating scores.
## The structure of wmn4j
The structure of scores in wmn4j is described in a separate [document](./doc/structure.md).
The [API Documentation](https://otsob.github.io/wmn4j) provides the Javadoc for the latest release of wmn4j. There are a
few architectural design principles in wmn4j:
* All notation classes are immutable
* Builder classes are used for creating objects
* Scores can be read using different types of iterators
See the [examples](./doc/examples) directory for simple examples of how to use wmn4j.
### Building wmn4j
wmn4j is developed and built with OpenJDK 17. wmn4j uses Gradle and can be built by running Gradle build. With the
current configuration the build consists of compilation, unit tests, and static analysis. It is recommended to delegate
the building of the project to Gradle using the provided Gradle wrapper in the IDE to ensure all dependencies etc. are
handled correctly. To build locally, run
```
./gradlew build
```
## Contributing
Contributions to wmn4j are very welcome. If you are interested, feel free to message me (otsob) through Github.
Contributing to wmn4j happens throught pull requests. For commits we try to follow basic practices (for example, see the
ones by [Painsi](https://gist.github.com/robertpainsi/b632364184e70900af4ab688decf6f53)
or [Beams](https://chris.beams.io/posts/git-commit/)).
As wmn4j is a library, the testing happens through unit tests and it is preferred that changes come accompanied by
corresponding unit tests.
The coding style of wmn4j is not very strict, but there are some [basic guidelines](CODING_CONVENTIONS.md).
Contributing to this project is supposed to be enjoyable, so behaving nicely and respectfully is appreciated. For a
general guideline on code-of-conduct we follow the one outlined
by [Contributor Covenant](https://www.contributor-covenant.org/version/1/4/code-of-conduct).
For pull requests target the `development` branch. The `main` branch is reserved for releases.
If you find a bug in wmn4j or want to propose a feature,
please [open an issue](https://github.com/otsob/wmn4j/issues/new/choose)
with the corresponding template.
## Built With
* [Gradle](https://gradle.org)
* [Apache Commons Math](https://commons.apache.org/proper/commons-math/)
* [SLF4J](http://www.slf4j.org). When using wmn4j, you
need [to bind to a compatible logger](https://www.slf4j.org/manual.html#swapping) implementation.
## Versioning
Wmn4j is still in the alpha phase. The released versions of wmn4j are available
on [Maven central](https://central.sonatype.com/artifact/org.wmn4j/wmn4j).
## Authors
* **Otso Björklund** - [otsob](https://github.com/otsob)
* **Matias Wargelin**
See also the list of [contributors](https://github.com/otsob/wmn4j/graphs/contributors) who participated in this
project.
## License
This project is licensed under the MIT License - see the [LICENSE.txt](LICENSE.txt) file for details
## Citation
If you use wmn4j for research, or need a reference to cite for other reasons, please use:
```
@inproceedings{wmn4j2022,
author = {Björklund, Otso},
title = {{Western Music Notation for Java: A library for music notation on the JVM}},
booktitle={Extended Abstracts for the Late-Breaking Demo Session of the 23rd International Society for Music Information Retrieval Conference},
year = {2022},
}
```