Repository files navigation

Outil pour travailler sur les fichiers gabc.

English Documentation.

Legabc est le langage utilisé par le logicielGregorio.Vous en trouverez la descriptionici.

Ce script est dérivé degabc2mid ;l'optique du projet s'étant élargie, gabc2mid restera tel qu'il est à présent(sauf correction de bug), et les développements auront lieu ici.Gabctk parcourt le codegabc, en extrait ce qui concerne la mélodie,et produit celle-ci sous la forme d'un fichier midi et/ou lilypond, abc,musicxml.Il peut aussi extraire le texte dans un fichier texte.La syntaxe est la suivante :

gabctk.py -i </chemin/vers/le/fichier/source.gabc> \         [-n titre] \         [-o </chemin/vers/le/fichier/destination.mid>] \         [-l </chemin/vers/le/fichier/destination.ly>] \         [-c </chemin/vers/le/fichier/destination.abc>] \         [-x </chemin/vers/le/fichier/destination.xml>] \         [-b </chemin/vers/le/fichier/destination.tab>] \         [-e </chemin/vers/le/fichier/destination.txt>] \         [-m </chemin/vers/le/fichier/destination.mus>] \         [-t tempo] \         [-d transposition] \         [-a alerte] \         [-v verbosité]

Toutes les options entre crochets sont facultatives.gabc -h affiche une aide sommaire.

Si, à la place d'un nom de fichier, vous voulez utiliser l'entrée ou la sortiestandard, spécifiez-. Par exemple, pour écouter un gabc grâce àtimidity :

gabctk.py -i <fichier/source.gabc> -o - | timidity -

Ou encore, pour extraire le texte du gabc et l'afficher :

gabctk.py -i <fichier/source.gabc> -e -

Le tempo est exprimé en temps premiers par minute :sa valeur par défaut est 165.

La transposition est exprimée en demi-tons. En son absence, gabctk transposeraautomatiquement le chant sur une tessiture facile à chanter. Pour les formatsabc et musicxml, la gestion de la transposition est laissée à abc et auxdifférents logiciels compatibles avec ces formats. Les notes resteront doncgraphiquement en place, mais la mélodie sera jouée à la hauteur indiquée parce paramètre.

Si des alertes sont définies, gabctk renverra un message chaque foisqu'il détecte la chaîne de caractères dans le texte du chant.Par exemple,gabctk.py -i \<Fichier.gabc\> -a j -a eumdem renverra un messagesi le texte contient desj ou le moteumdem.

Il est encore possible de convertir plusieurs fichiers à la fois. En ce cas,il faut donner en paramètre à-o,-l,-c,-x ou-b un dossieret non un fichier individuel. Par exemple, pour convertir en midi tousles gabc du répertoire courant :

gabctk.py -i *.gabc -o .

Il est possible de récupérer dansReleasesou de créer soi-même un exécutable contenant tout ce qui est nécessaire pour utilisergabctk, aussi bien sous Linux que sous MacOS ou encore Windows (grâce àcosmopolitan). Étant admis que le programmezip est accessible à l’interpréteur de commandes,make com devrait générergabctk.com, utilisable comme décrit ci-dessus (en remplaçantgabctk.pypargabctk.com).