PianoFingering.jl is an automatic fingering generator for piano scores, written in the Julia language.

THIS PACKAGE ONLY TESTED ON LINUX.

Prompt: You can copy all following commands start with ❯

Install Python (>3.10) and Julia (>1.8).

Make sure:

❯ python -V
Python 3.10.10
❯ julia -v
julia version 1.8.0

Install music21:

❯ pip3 install –upgrade music21

Clone this project to your computer and change directory to PianoFingering.jl folder, then:

❯ julia
❯ using Pkg
❯ Pkg.activate(".")
❯ Pkg.instantiate()

Now you have installed all the dependency. Close your terminal.

1. Put your .musicxml file to musicxml folder, suppose we have an example.musicxml file right now.

2. Change directory to PianoFingering.jl folder:

❯ julia -t auto
❯ using Pkg
❯ Pkg.activate(".")
❯ using PianoFingering
❯ fingering("example")

Wait for the program to complete, annotated piano score example_output.musicxml will be stored in output folder, this may take a few minutes.

If you encounter error, or musicxml file can't fingering correctly. Please open a issue and upload your musicxml file.