{"id":15109011,"url":"https://github.com/audiveris/audiveris","last_synced_at":"2025-04-11T23:55:17.409Z","repository":{"id":37686498,"uuid":"67609286","full_name":"Audiveris/audiveris","owner":"Audiveris","description":"Latest generation of Audiveris OMR engine","archived":false,"fork":false,"pushed_at":"2025-04-09T14:12:54.000Z","size":332299,"stargazers_count":1854,"open_issues_count":158,"forks_count":271,"subscribers_count":71,"default_branch":"master","last_synced_at":"2025-04-11T23:54:50.457Z","etag":null,"topics":["java","open-source","optical-music-recognition"],"latest_commit_sha":null,"homepage":"https://audiveris.github.io/audiveris","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Audiveris.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-09-07T13:31:03.000Z","updated_at":"2025-04-11T03:50:33.000Z","dependencies_parsed_at":"2024-01-14T15:25:03.745Z","dependency_job_id":"9f4e55b4-b7a5-40e7-887f-144927ad543a","html_url":"https://github.com/Audiveris/audiveris","commit_stats":{"total_commits":5119,"total_committers":25,"mean_commits":204.76,"dds":"0.045907403789802737","last_synced_commit":"76f27b10b5e84435a618863c738d5537ce8bc1e2"},"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Audiveris%2Faudiveris","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Audiveris%2Faudiveris/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Audiveris%2Faudiveris/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Audiveris%2Faudiveris/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Audiveris","download_url":"https://codeload.github.com/Audiveris/audiveris/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248497812,"owners_count":21113984,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","open-source","optical-music-recognition"],"created_at":"2024-09-25T23:00:31.346Z","updated_at":"2025-04-11T23:55:17.391Z","avatar_url":"https://github.com/Audiveris.png","language":"Java","readme":"![](https://github.com/Audiveris/docs/blob/master/images/SplashLogo.png)\nLogo crafted by [Katka](https://www.facebook.com/katkastreetart/)\n\n# Audiveris - Open-source Optical Music Recognition\n\nThe goal of an OMR application is to allow the end-user to transcribe a score image into\nits symbolic counterpart.\nThis opens the door to its further use by many kinds of digital processing such as\nplayback, music edition, searching, republishing, etc.\n\nThe Audiveris application is built around the tight integration of two main components:\nan OMR engine and an OMR editor.\n- The OMR engine combines many techniques, depending on the type of entities to be recognized\n-- *ad-hoc* methods for lines, image morphological closing for beams, external OCR for texts,\ntemplate matching for heads, neural network for all other fixed-size shapes.   \nSignificant progresses have been made, especially regarding poor-quality scores,\nbut experience tells us that a 100% recognition ratio is simply out of reach in many cases.\n- The OMR editor thus comes into play to overcome engine weaknesses in convenient ways.\nThe user can preselect processing switches to adapt the OMR engine before launching the\ntranscription of the current score.\nThen the remaining mistakes can generally be quickly fixed\nvia the manual editing of a few music symbols.\n\n## Key characteristics\n\n* Good recognition efficiency on real-world quality scores (as those seen on the [IMSLP][imslp] site)\n* Effective support for large scores (with up to hundreds of pages)\n* Convenient user-oriented interface to detect and correct most OMR errors\n* Available on Windows, Linux and macOS\n* Open source\n\nThe core of engine music information (OMR data) is fully documented and made publicly available,\neither directly via XML-based `.omr` project files or via the Java API of this software.   \nAudiveris comes with an integrated exporter to write (a subset of) this OMR data into\n[MusicXML][musicxml] 4.0 format.\nIn the future, other exporters are expected to build upon OMR data to support other target formats.\n\n## Stable releases\n\nOn a rather regular basis, typically every 6 to 12 months, a new release is made available\non the dedicated [Audiveris Releases][releases] page.\n\nThe goal of a release is to provide significant improvements, well tested and integrated,\nresulting in a software as easy as possible to install and use.\n\nSince the release 5.5, an installer is provided for each of the main OSes\n(**Windows**, **Linux** and **macOS**) and comes with a pre-installed Java Runtime Environment (JRE).\nYou can download any installer file from the **Assets** section, at the end of the chosen release:\n\n| OS name | Installer file extension |\n| :---    | :---   |\n| Windows | `.msi` |\n| Linux   | `.deb` |\n| macOS   | `.dmg` |\n\nAdditionally for **Linux**, a _flatpak_ package, also with a suitable JRE included,\ncan be installed from the [Flathub] site.\n\nSee installers details in the handbook [installation] section.\n\n## Development versions\n\nThe Audiveris project is developed on GitHub, the site you are reading.  \nAny one can clone, build and run this software. \nThe needed tools are `git`, `gradle` and a Java Development Kit (`jdk`),\nas described in the handbook [sources section][sources].\n\nThere are two main branches in the Audiveris project:\n- the `master` branch is the GitHub default branch;\nwe use it for releases, and only for them;  \nTo build from this branch, you will need a `jdk` for Java version **21** or higher.\n- the `development` branch is the one where all developments continuously take place;\nPeriodically, when a release is to be made, we merge the development branch into the master branch;  \nAs of this writing, the source code on development branch requires a `jdk` for Java version **21**.\n\nSee details in the [Wiki article][workflow] dedicated to the chosen development workflow.\n\n## Further Information\n\nUsers and developers are advised to read the Audiveris [User Handbook][handbook],\nand the more general [Wiki][audiveris-wiki] set of articles.\n\n[audiveris-wiki]: https://github.com/Audiveris/audiveris/wiki\n[Flathub]:        https://flathub.org/apps/org.audiveris.audiveris\n[handbook]:       https://audiveris.github.io/audiveris/\n[imslp]:          https://imslp.org/\n[installation]:   https://audiveris.github.io/audiveris/_pages/tutorials/install/binaries/\n[musicxml]:       http://www.musicxml.com/\n[releases]:       https://github.com/Audiveris/audiveris/releases\n[sources]:        https://audiveris.github.io/audiveris/_pages/tutorials/install/sources/\n[workflow]:       https://github.com/Audiveris/audiveris/wiki/Git-Workflow\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faudiveris%2Faudiveris","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faudiveris%2Faudiveris","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faudiveris%2Faudiveris/lists"}