Skip to content

About

A MusicXML to Numbered Notation renderer with layout logic built from scratch.

Topics

Resources

Stars

3 stars

Watchers

1 watching

Forks

Latest commit

 

History

463 Commits

Folders and files

Repository files navigation

🎼 Kidung Jemaat Digital — Numbered Notation Engine

A MusicXML → Numbered Notation renderer with layout logic built from scratch.

This project aims to digitize and render Kidung Jemaat hymns into numbered notation (not angka) based on the Indonesian Yamuger (yayasan musik gereja), following the visual style of the official publication as closely as possible.

The goal is to create a searchable, accessible, and accurate digital version of Kidung Jemaat, starting from MusicXML sources and manually curated metadata. The engine outputs SVG-based notation modeled after the original KJ print style.

🏁 Getting started

  • Clone the repository
  • Checkout releases tab
  • Download these two files:
    • kidung-jemaat.db : the metadata of the music that cannot be stored in the musicxml
    • musicxml.zip : musicxml files that needed for the app to run
  • Place them somewhere in the drive
  • Adjust config in the files/etc/numbered-mutation-xml/config.ini
  • run the app from cmd/rest/app.go
  • open browser and open http//localhost:[port]/kidung-jemaat/render/1 (currently from 1 to 478c)

💡 Alternatively you can download the goldenfiles.zip to see the final render looks like.

Features

🔹 Full SVG

🔹 Numbered and Classical notation

🔹 Syllable counting (can map other verse with the music)

🔹 Search with full Indonesian stemming support

🔧 Features in Progress

🔹GUI

🔹Follow Along with music

📌 Next Features on the Roadmap

🎵 4-part SATB Support

  • Soprano / Alto / Tenor / Bass layering
  • Multi-staff layout
  • Proper vertical alignment


🖼 Screenshot

** Numbered Only

Alt Text Alt Text
Alt Text Alt Text

** With Notation

Alt Text Alt Text
Alt Text Alt Text

** Syllable counting and music matching (Beta)

Non Focus mode Focus mode
Alt Text Alt Text

🧠 Why This Project Exists

I started digitizing Kidung Jemaat for personal use, to create a digital hymnal with clean notation and better searchability. Along the way, it grew into a more general exploration of:

  • music engraving algorithms
  • layout engines
  • type-setting rules for classical hymnbooks
  • MusicXML parsing
  • text-notation alignment

🤓 References (sites that I used for content and references music theory)

About

A MusicXML to Numbered Notation renderer with layout logic built from scratch.

Topics

Resources

Stars

3 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages