{"id":17182102,"url":"https://github.com/schoettl/nn2gs-plugin-musescore","last_synced_at":"2026-02-08T02:40:17.313Z","repository":{"id":65278814,"uuid":"353760329","full_name":"schoettl/nn2gs-plugin-musescore","owner":"schoettl","description":"Nn2GS - Griffschrift für Steirische Harmonika - Plugin für MuseScore","archived":false,"fork":false,"pushed_at":"2026-01-31T00:56:38.000Z","size":914,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-01-31T15:54:56.995Z","etag":null,"topics":["musescore","musescore-plugin","music","plugin"],"latest_commit_sha":null,"homepage":"","language":"QML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/schoettl.png","metadata":{"files":{"readme":"README.org","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-04-01T16:24:40.000Z","updated_at":"2026-01-31T00:56:41.000Z","dependencies_parsed_at":"2024-11-01T19:17:17.071Z","dependency_job_id":"fbc2ea74-5906-4756-9364-7918b3c2d3ee","html_url":"https://github.com/schoettl/nn2gs-plugin-musescore","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/schoettl/nn2gs-plugin-musescore","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schoettl%2Fnn2gs-plugin-musescore","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schoettl%2Fnn2gs-plugin-musescore/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schoettl%2Fnn2gs-plugin-musescore/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schoettl%2Fnn2gs-plugin-musescore/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/schoettl","download_url":"https://codeload.github.com/schoettl/nn2gs-plugin-musescore/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schoettl%2Fnn2gs-plugin-musescore/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29218123,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-08T02:25:35.815Z","status":"ssl_error","status_checked_at":"2026-02-08T02:24:27.970Z","response_time":57,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["musescore","musescore-plugin","music","plugin"],"created_at":"2024-10-15T00:36:00.675Z","updated_at":"2026-02-08T02:40:17.305Z","avatar_url":"https://github.com/schoettl.png","language":"QML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n* MuseScore Plugin\n\n- [[https://musescore.org/en/project/nn2gs-normalnoten-zu-griffschrift-fur-steirische-harmonika][Plugin page at musescore.org]]\n- [[https://musescore.org/en/node/315330][Plugin discussion thread on musescore.org]]\n\nNn2GS („Normalnototation zu Griffschrift“) ist ein Computerprogramm zum\nÜbersetzen zwischen Normalnoten und Griffschrift für Steirische\nHarmonika, Club Harmonika, Schwyzer-Orgel und ähnliche Instrumente.\n\n/Nn2GS is a software to convert between normal music notation and\nGriffschrift for Steirische Harmonika (a diatonic button accordion), and\nsimilar instruments./\n\nDie Webseite https://griffschrift-notation.de/ zeigt die\nDiskant-Tastenanordnungen, für die Griffschrift erzeugt werden kann. Auf\nAnfrage können auch weitere Tastenanordnungen hinzugefügt werden.\n\nDemo-Videos gibt es [[https://www.youtube.com/@jakob.schoettl][hier bei YouTube]].\n\n*Features:*\n\n- *Übersetzen in beide Richtungen*\n- „Durchschalten“ der *alternativen Griffweisen*.\n- Übersetzte *Griffschrift ist abspielbar* in MuseScore.\n  [Aktuell nicht mehr in MuseScore 4.]\n- In Griffschrift werden die *Notenköpfe automatisch auf die richtige\n  Seite* des Notenhalses sortiert (optional).\n- In Griffschrift werden Zusatztasten zusätzlich durch spezielle\n  Notenköpfe gekennzeichnet.\n- Verschiedene Griffschrift-Varianten (=Schriftarten), z.B. Kreuz vor\n  Notenkopf oder Notenkopf in Kreuzform.\n- Zug-Passagen werden wahlweise blau gefärbt, damit man sich auskennt.\n- Die Färbung kann auch wieder rückgängig gemacht werden durch abwählen\n  des Häckchens.\n- Tonart automatisch auswählen durch Klick auf /Aktuelle Dur-Tonart/.\n- Tastaturschema mit aktuell markiertem Akkord anzeigen (im Browser).\n- Kann komplett mit Tastenkürzeln bedient werden.\n- Bassbezifferung zu ausnotierten Basslinien hinzufügen (z.B. bei\n  Chorälen).\n- Unterstützung für verschiedene Basssystemen und Schemas für die\n  Bassbenennung (A-H vs. A, A’, …).\n\n*Geplante Erweiterungen:*\n\n- Druckbalken automatisch einfügen (ist leider nicht so einfach).\n- Existierende Griffschrift abspielbar machen.\n- Bassbegleitung halbautomatisch einfügen.\n\n[[screenshot.png]]\n\n*Installation:*\n\n1. Plugin als Zip-Datei herunterladen:\n   - nn2gs-v1.7.zip für MuseScore Studio 4.4\n   - nn2gs-v1.6.zip für MuseScore 4.0 bis 4.3\n   - nn2gs-v1.5.1-ms36.zip für MuseScore 3.6\n2. QML-Datei extrahieren und in den Ordner =Dokumente / MuseScore4 / Plugins= ablegen\n3. MuseScore starten, /Plug-Ins → Plug-Ins verwalten…/, dort Nn2GS aktivieren\n4. Partitur öffnen oder erstellen\n5. Plugin starten: /Plug-Ins → Griffschrift (Nn2GS)/\n\nKosten: Aktuell kostenlos, irgendwann später wohl wenige Euro pro\numgewandeltes Stück.\n\nKontakt: Jakob Schöttl, jschoett@gmail.com\n\n* Compatibilty with MuseScore versions\n:PROPERTIES:\n:ID: compatibility\n:END:\n\nGetestet wurde das Plugin mit:\n\n| MuseScore | Plugin Nn2GS | Betriebsystem | Qt      | Datum           |\n|-----------+--------------+---------------+---------+-----------------|\n|     4.6.5 | v1.7.1       | Linux         | 6.10.1  | [2026-01-31 Sa] |\n|     4.6.5 | v1.7         | Windows 11    | 6.9.2   | [2026-01-18 So] |\n|     4.6.0 | v1.7         | Linux         | 6.9.1   | [2025-08-04 Mo] |\n|     4.5.2 | v1.7         | Linux         | 6.9.0   | [2025-08-04 Mo] |\n|     4.4.4 | v1.7         | Linux         | 6.8.1   | [2025-01-11 Sa] |\n|     4.4.3 | v1.7         | macOS 11.7.10 | -       | [2024-11-01 Fr] |\n|     4.4.3 | v1.7         | Windows 10    | -       | [2024-11-02 Sa] |\n|     4.4.3 | v1.7         | Windows 11    | 6.2.9   | [2024-11-01 Fr] |\n|     4.4.2 | v1.7         | Windows 11    | -       | [2024-11-01 Fr] |\n|     4.4.2 | v1.7         | Linux         | 6.7.2   |                 |\n|     4.4.2 | v1.7         | Linux         | 6.8.0   | [2024-11-01 Fr] |\n|     4.2.1 | v1.6         | Linux         | 5.15.12 |                 |\n|     4.1.1 | v1.6         | Windows 11    | -       |                 |\n|     4.1.1 | v1.6         | Windows 7     | 5.15.2  |                 |\n|     4.1.1 | v1.6         | Linux         | -       |                 |\n|     4.1.1 | v1.6         | macOS         | -       |                 |\n|     4.0.2 | v1.6         | Linux         | -       |                 |\n|     4.0.2 | v1.6         | macOS         | -       |                 |\n|     3.6.2 | v1.5.1       | Windows 10    | 5.9.9   | [2025-01-11 Sa] |\n|     3.6.2 | v1.5.1       | Linux         | -       |                 |\n|     3.6.2 | v1.5.1       | macOS         | -       |                 |\n\n* Downloads\n\nDie Plugin QML-Datei für MuseScore wird per Skript generiert.\nSie kann hier heruntergeladen werden:\n\nhttps://musescore.org/en/project/nn2gs-normalnoten-zu-griffschrift-fur-steirische-harmonika\n\n* Development\n\nMS 4 cannot use this project's directory as plugin directory.\nWe need to copy or symlink the QML file to MuseScore's plugin directory.\n\n: nix-shell\n: . BUILD_CONFIG\n: watchexec 'make devbuild \u0026\u0026 cp nn2gs.qml ~/Documents/MuseScore4/Plugins/nn2gs-dev.qml'\n: watchexec 'make build \u0026\u0026 cp nn2gs.qml \"nn2gs-v$VERSION.qml\" ~/Documents/MuseScore4/Plugins/'\n\nSymlinks also work (confirmed with MS 4.6):\n\n: ln -s /path/to/nn2gs-plugin-musescore/nn2gs.qml ~/Documents/MuseScore4/Plugins/\n\n*Note:* You must restart MuseScore for every change you make to the plugin code!\n\nStart MuseScore with debug mode and a sample file:\n\n: mscore -d ~/projects/nn2gs-plugin-musescore/beispiele/Echt_Boarischer_Klang_1.mscz\n\nDebug mode is important to show output of =console.debug('logs')=.\n\nIf MuseScore screen resolution is not correct, you can pass =-D 100=.\nThis was probably only a X11/XMonad problem.\n\nBefore publishing a new version, call =make=. Only publish it if a tests are green!\n\n** Older MuseScore versions\n\nTo work on the plugin for older MuseScore versions, you need to\ncheckout the respecting commit. See =BUILD_CONFIG= for version bumps\nand the branch =musescore36= for plugin version 1.5.1 for MS 3.6.\n\n* Contributing\n\nUm zu diesem Plugin beizutragen und mitzuentwickeln können gerne\nGitHub Issues und PRs erstellt werden.\n\nMeine Entwicklungsumgebung ist Linux und folgende Programme müssen\ninstalliert sein:\n\n- GNU Make, um die QML-Plugin-Datei zu erzeugen\n- closure-compiler, um die ES6 JavaScript-Dateien in einfaches JS zu übersetzen\n- GNU awk/sed/bash, ebenfalls für den Build-Prozess der QML-Datei\n\nWer den [[https://nixos.org/download.html#download-nix][Nix package manager]] installiert hat kann mit folgenden Befehlen\nalle Abhängigkeiten installieren:\n\n: git clone git@github.com:schoettl/nn2gs-plugin-musescore.git\n: cd nn2gs-plugin-musescore\n: nix-shell\n\nFolgender Befehl erzeugt die Datei =nn2gs-vXXX.qml=, die in MuseScore 3.6\nim Plugin-Editor (=Strg+Shift+P=) geöffnet und gestartet werden kann.\n\n: make build\n\nMit diesem Befehl (mithilfe eines \"File Watchers\") wird die QML-Datei\nbei jeder Änderung von Quell-Dateien automatisch übersetzt:\n\n: watchexec make build\n\nDieser Befehl ist nur für mich, da hiermit die URL der\nÜbersetzungs-API auf =localhost= geändert wird:\n\n: make devbuild\n\n* Documentation sources\n\n- https://musescore.org/de/handbook/developers-handbook/plugin-development\n- More description of important score elements and their properties:\n  https://musescore.org/en/handbook/developers-handbook/plugins-3x\n- Doxygen technical doc on QML classes, properties, methods:\n  https://musescore.github.io/MuseScore_PluginAPI_Docs/plugins/html/\n\n* Implementation details\n\n** Hinzufügen der Balken für Druck?\n\n=newElement(type)= where type is one of [[https://musescore.github.io/MuseScore_PluginAPI_Docs/plugins/html/class_ms_1_1_plugin_a_p_i_1_1_plugin_a_p_i.html#a5fcfe46c56901e9f3998a72a458e66dc][these]].\n\nI guess =Spanner= would be the right one but it's\n[[https://musescore.org/en/node/118231][not yet implemented]]\nas plugin API.\n\n** Umwandlung von Normalnotation zu Griffschrift\n\nDies ist die komplizierte Richtung, weil\n\n- es meist mehrere Tasten gibt, die ein und denselben Ton erzeugen.\n- es Töne gibt, die auf dem Instrument gar nicht gespielt werden\n  können (z.B. bestimmte Halbtöne bei einer Harmonika ohne Zusatztöne).\n\nEs gibt also pro Akkord meistens verschiedene Griffweisen/Alternativen.\nAußerdem unterscheidet man natürlich zwischen dem Spielen auf Zug und Druck.\n\n** Umwandlung von Basslinien (ausgeschriebene Bassstimme) in Tastennamen\n\nDie Tastennamen werden dann als „Liedtext“ unter die Noten geschrieben.\nSo funktioniert es:\n\nAnhand der Stimmung und des Basssystems wird das konkrete Basssystem\nfür die Stimmung berechnet.\n\n1. Anhand dieses Mappings von Ton zu Taste (auf Druck und Zug) wird dann\n   für jeden Ton der Basslinie die Basstaste berechnet.\n2. Anhand des Basstasten-Benennungsschemas wird aus der Basstaste dann\n   der Name des zu drückenden Knopfes berechnet.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschoettl%2Fnn2gs-plugin-musescore","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fschoettl%2Fnn2gs-plugin-musescore","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschoettl%2Fnn2gs-plugin-musescore/lists"}