Utilisation de la ligne de commande

Mis à jour il y a 3 semaines

Remarque : cette page a été copiée à partir de la page équivalente du manuel de MuseScore 3. Si vous trouvez une option qui ne fonctionne pas avec MuseScore Studio, merci de la signaler sur GitHub et d’ajouter une note relative à cette option dans cette page. Si l’option a été volontairement supprimée de MuseScore Studio, il faut la supprimer de cette page.

Nom

mscore, MuseScore4 , MuseScore Studio — Éditeur de partition de musique MuseScore Studio

Résumé

Vous pouvez lancer MuseScore Studio à partir de la ligne/invite de commande en tapant :
* mscore [options] [nom de fichier …] (Mac and Linux/BSD/Unix)
* musescore [options] [nom de fichier …] (Linux/BSD/Unix)
* mscore4portable [options] [nom de fichier …] (Linux AppImage)
* MuseScore4.exe [options] [nom de fichier …] (Windows)

[options] et [nom de fichier] sont optionnels. Pour que cela fonctionne le fichier exécutable de MuseScore doit être dans la variable d’environnement %PATH% (Windows) ou $PATH (Mac and Linux). Si ce n’est pas le cas, voir Restaurer les paramètres par défaut pour avec des instructions détaillées sur comment et où trouver et exécuter le fichier exécutable de MuseScore depuis la ligne de commande dans les différentes plateformes supportées.

Voici un résumé plus détaillé des options disponibles :

Description

MuseScore est un logiciel libre et open source de notation musicale multilingue et multiplateforme WYSIWYG (ce que vous voyez est ce que vous obtenez), publié sous la licence publique générale GNU (GPLv3).

Exécuter mscore sans option supplémentaire lance le programme MuseScore Studio en version graphique complète et ouvre tous les fichiers spécifiés dans la ligne de commande.

Les options sont les suivantes :

-a | --use-audio pilote: Utilise un fichier driver audio parmi : jack, alsa, portaudio, pulse
-b | --bitrate débit_binaire: Règle le débit binaire de sortie MP3 en kbit/s
-c | --config-folder chemin_d'accès: Outrepasse le répertoire de configuration et de paramètres
-D | --monitor-resolution DPI: Spécifie la résolution du moniteur (outrepasse la détection automatique)
-d | --debug: Démarre MuseScore Studio en mode débogage
-E | --install-extension fichier_d’extension: Installe un fichier d’extension ; les soundfonts sont chargées par défaut sauf si -e est également spécifié
-e | --experimental: Active les fonctionnalités expérimentales, telles que calques
-F | --factory-settings: Utilise uniquement les préréglages intégrés standard (“réglages d'usine”) et supprime les préférences utilisateur ; à comparer avec l’option -R (Voir aussi Restaurer les paramètres par défaut)
-f | --force: Ignore les avertissements de corruption de partition et de non-concordance de version en "mode convertisseur"
-h | -? | --help: Affiche la présentation des instructions d'appel (ne fonctionne pas sous Windows)
-I | --dump-midi-in: Affiche toutes les entrées MIDI dans la console
-i | --load-icons: Charge les icônes depuis le système de fichier ; utile si vous souhaitez modifier les icônes de MuseScore Studio et prévisualiser les changements
-j | --job fichier.json: Traite une tâche de conversion (voir Exemples plus bas)
-L | --layout-debug: Démarre MuseScore Studio en mode débogage de mise en page
-M | --midi-operations nom_fichier: Spécifie le fichier des opérations d'import MIDI (voir Exemples plus bas)
-m | --no-midi: Désactive l'entrée MIDI
-n | --new-score: Force le démarrage avec l'Assistant Nouvelle Partition, qu’il soit activé ou désactivé dans les préférences de l’utilisateur
-O | --dump-midi-out: Affiche toutes les sorties MIDI dans la console
-o | --export-to nom_fichier: Exporte le fichier donné (ou en cours) vers le fichier spécifié nom_fichier. Le type de fichier dépend de l’extension du nom de fichier donné. Cette option passe en mode convertisseur et évite l’interface utilisateur graphique.
-P | --export-score-parts: Lorsque qu’on convertit en format PDF avec l’option -o, ajoute les pages de chaque partie au fichier PDF créé. Si la partition n’a pas de partie, toutes les parties par défaut seront automatiquement générées de façon temporaire.
-p | --plugin nom: Exécute le plugin spécifié
-R | --revert-settings: Utilise seulement les préréglages standards ("réglages d'usine") mais ne supprime pas les préférences utilisateur ; à comparer avec l'option-F.
-r | --image-resolution DPI: Définit la résolution d'affichage pour la sortie vers les fichiers PNG. Par défaut : 300 DPI ( la valeur de « Résolution » du groupe d’options PNG dans l' Onglet ‘Export’ des préférences)
-S | --style style: Charge un fichier de style en premier ; pratique pour utiliser avec l'option -o
-s | --no-synthesizer: Désactive le synthétiseur logiciel intégré
-T | --trim-image marge: Recadre les images PNG et SVG exportées pour enlever les pourtours blancs de la partition. La marge, spécifiée en pixels, sera conservée (utilisez 0 pour une image totalement rognée. Lors de l’exportation vers SVG, cette option ne fonctionne qu’avec des partitions d’une seule page.
-t | --test-mode: Active le mode test pour tous les fichiers, y compris --template-mode.
-v | --version: Affiche le nom et la version de l’application sans démarrer l’interface utilisateur graphique (ne fonctionne pas sous Windows).
-w | --no-webview: Désactive le composant Web View dans le Centre de démarrage.
-x | --gui-scaling facteur: Redimensionne l'affichage de la partition et d'autres éléments de l'interface graphique selon le facteur spécifié ; destiné à être utilisé avec des écrans haute résolution.
--diff: Imprime les différences conditionnées entre les partitions données
--long-version: Affiche le nom complet, la version et la révision git de l’application sans démarrer l’interface utilisateur graphique (ne fonctionne pas sous Windows).
--no-fallback-font: N’utilise pas Bravura comme police musicale de repli
--raw-diff: Imprime les différences brutes entre les partitions données
--run-test-script: Lance les tests des scripts listés dans les arguments de la ligne de commande
--score-media: Exporte tous les médias (sauf MP3) pour une partition donnée en tant que document JSON unique vers stdout (sortie standard)
--highlight-config: Règle le surlignage au svg généré à partir d’une partition donnée
--score-meta: Exporte les métadonnées de la partition dans un document JSON document et l’imprime vers stdout (sortie standard)
--score-parts: Génère les données des parties de la partition donnée et les enregistre en fichiers mscz séparés.
--score-parts-pdf: Génère les données des parties de la partition donnée et les exporte en un document JSON unique vers stdout (sortie standard).
--score-transpose: Transpose la partition donnée et exporte les données vers un fichier JSON unique et l’imprime vers stdout (sortie standard).
--source-update: Met à jour la source dans la partition donnée
--template-mode: Enregistre les fichiers en mode modèle (par exemple : sans format de page)

MuseScore Studio supporte aussi les options de ligne de commande Qt.

Conversion par lot au format JSON

L’argument de l’option -j doit être le chemin d’accès d’un fichier composé d’un document JSON valide respectant les spécifications suivantes :

L’élément de niveau supérieur doit être un JSONArray, qui peut être vide.
Chaque élément du tableau doit être un JSONObject avec les clés suivantes :
- in : la valeur est le nom du fichier d’entrée (partition à convertir), en tant que JSONString.
- plugin : la valeur est le nom de fichier d’un plugin (avec l’extension .qml), qui sera lu à partir du chemin global ou du chemin utilisateur de plugin et exécuté avant que la sortie de conversion ne se produise, en tant que JSONString. Facultatif, mais au moins un des plugins et out doit être donné.
- out : la valeur est la cible de sortie de la conversion, telle que définie ci-dessous. Facultatif, mais au moins un des plugins et out doit être donné.
La cible de sortie de conversion peut être un nom de fichier (avec l'extension, qui a décidé du format à convertir), en tant que JSONString.
La cible de sortie de conversion peut être un JSONArray de noms de fichiers comme elle peut être un JSONString, comme ci-dessus, ce qui fera que la partition sera écrite dans plusieurs fichiers de sortie (dans plusieurs formats de sortie) séquentiellement, sans être fermée, rouverte et re-traitée entre les deux.
Si la cible de sortie de conversion est un JSONArray, un ou plusieurs de ses éléments peuvent également être, chacun, un JSONArray de deux JSONStrings (appelés première et deuxième moitié dans la description suivante). Il en résultera une extraction des parties : pour chacune de ces deux lignes, toutes les parties existantes de la partition seront sauvegardées individuellement, les noms de fichiers étant composés en concaténant la première moitié, le nom (titre) de la partie, et la deuxième moitié. La chaîne résultante doit être un nom de fichier valide (avec extension, déterminant le format de sortie). Si une partition n’a pas de parties (extraits) définies, elle sera silencieusement ignorée sans erreur.
Les extensions de fichiers valides pour la sortie sont :

flac

Free Lossless Audio Codec (audio compressé sans perte)

metajson

diverses métadonnées de notation (JSON)

mid

fichier MIDI standard

midi

fichier MIDI standard

mlog

fichier journal de l'audit interne d'intégrité (JSON)

mp3

MPEG Layer III (audio compressé avec perte)

mpos

mesure des positions (XML)

mscx

fichier MuseScore non compressé

mscz

fichier MuseScore compressé

musicxml

fichier MusicXML non compressé

mxl

fichier MusicXML compressé

ogg

OGG Vorbis (audio compressé avec perte)

pdf

portable document file (impression)

png

portable network graphics (image) — les fichiers individuels, un par page de la partition, avec un trait d’union suivi du numéro de page placé avant l’extension de fichier, seront générés.

spos

segment positions (XML)

svg

scalable vector graphics (image)

wav

RIFF Waveform (audio non compressé)

xml

fichier MusicXML non compressé

Voir plus bas pour un exemple.

Environnement

SKIP_LIBJACK: Paramétrez cela (la valeur n’a pas d’importance) pour sauter l’initialisation de la bibliothèque du kit de connexion Jack audio, dans le cas où il pose des problèmes.
XDG_CONFIG_HOME: Localisation de la configuration utilisateur ; défini par défaut à ~/.config si elle n’est pas paramétrée.
XDG_DATA_HOME: Localisation des données utilisateur ; défini par défaut à ~/.local/share si elle n’est pas paramétrée.

Notez que MuseScore Studio supporte aussi les variables de l’environnement Qt normal telles que QT_QPA_GENERIC_PLUGINS, QT_QPA_PLATFORM, QT_QPA_PLATFORMTHEME, QT_QPA_PLATFORM_PLUGIN_PATH, QT_STYLE_OVERRIDE, DISPLAY, etc.

Fichiers

/usr/share/mscore-4.0/ contient les données support de l’application (démos, instruments, localisation, plugins système, soundfonts, styles, accords, modèles et papiers peints). A la place, dans la distribution Debian, les soundfonts systèmes sont respectivement installés dans /usr/share/sounds/sf2/, /usr/share/sounds/sf3/ ou /usr/share/sounds/sfz/.

Les données (extensions, plugins, soundfonts, styles, modèle) et fichiers (images, scores) de l’utilisateur sont normalement installés dans des sous-répertoires sous ~/MuseScore4/ mais elles peuvent être modifiées dans la configuration. Notez que les versions snapshot, alpha et beta utilisent MuseScore4Development à la place de MuseScore4 pour tous ces chemins.

$XDG_CONFIG_HOME/MuseScore/MuseScore4.ini contient les préférences utilisateur, la liste des fichiers récemment ouverts ainsi que leur localisation, la position et la taille des fenêtres, etc. Voir ci-dessus pour les chemins des versions de développement.

$XDG_DATA_HOME/data/MuseScore/MuseScore4/ contient la localisation mise à jour des fichiers téléchargés depuis le programme, les informations de plugins, les partitions en cache, les certificats pour le site communautaire musescore.com, les informations de sessions, les paramètres de synthétiseur ; les clefs, indications de mesure et raccourcis personnalisés. Voir ci-dessus pour les chemins des versions de développement.

Exemples

Convertir une partition en pdf à partir de la ligne de commande

mscore -o 'My Score.pdf' 'My Score.mscz'

Exécuter un lot de commande pour convertir plusieurs documents

mscore -j job.json

Cela nécessite de s’assurer qu’un fichier job.json existe dans le répertoire courant avec un contenu similaire au suivant :

[
    {
        "in": "MyScore1.mscz",
        "out": "MyScore1.pdf"
    },
    {
        "in": "MyScore2.mscz",
        "plugin": "colornotes.qml",
        "out": [
            "MyScore2-notecolors.pdf",
            "MyScore2-notecolors.svg"
        ]
    },
    {
        "in": "MyScore3.mscz",
        "out": [
            "MyScore3.pdf",
            "MyScore3.musicxml",
            "MyScore3.mid",
            [
                "MyScore3 (",
                " part).pdf"
            ]
        ]
    }
]

Si MyScore3.mscz contient des extraits (parties instrumentales), la syntaxe ci-dessus devrait entraîner la production de fichiers comme “MyScore3 (partie violon).pdf” à côté du PDF et des fichiers MusicXML du conducteur, aussi bien qu’un fichier MIDI avec l’orchestration complète. Si MyScore3.mscz ne comporte pas d’extraits définis, seuls les fichiers PDF, MusicXML, et MIDI du conducteur seront générés, alors que la requête pour les parties PDF est ignorée de façon silencieuse.

Opération d’importation MIDI

Le fichier midi_import_options.xml est un exemple de fichier d’opération d’importation pour l’option -M.

Diagnostics

L’utilitaire mscore renvoie 0 en cas de succès et >0 si une erreur survient.

Voir aussi

https://musescore.org/handbook: Manuel en ligne
https://musescore.org/forum: Forum de support
https://musescore.org/en/node/278582: Restaurer les paramètres par défaut (en cas d’anomalies)
https://github.com/musescore/MuseScore/issues: Outil de suivi des problèmes — vérifier d’abord si le bug que vous rencontrez a déjà été signalé. Si vous avez juste besoin d’une aide pour réaliser quelque chose, merci d’utiliser plutôt le forum.
http://doc.qt.io/qt-5/qguiapplication.html#supported-command-line-optio…: Documentation sur les options de ligne de commande automatiques Qt

Standards

MuseScore Studio a pour objet d’implémenter les standards suivants :

MusicXML 3.1 (format d’échange de partitions)
SF2 (SoundFont 2.01)
SF3 (SoundFont avec échantillons compressés OGG Vorbis)
SFZ (soundfont Sforzato)
SMuFL (police de mise en page de musique standard 1.20)

Historique

MuseScore s’est séparé du séquenceur MusE en 2002 et est devenu depuis le principal programme open source de notation musicale.

Auteurs

MuseScore Studio est développé par MuseScore BVBA et autres.

Ce manuel a été écrit par mirabilos <tg@debian.org>.

Avertissements

Les options de ligne de commande Qt automatiques sont retirés du vecteur d’argument avant que l’application ait la possibilité de traiter les options ; cela signifie qu’une invocation comme mscore -S -reverse ne peut pas fonctionner car -reverse est d’abord retiré par Qt.

Bugs

MuseScore Studio ne distingue pas /etc/papersize.
Potentiellement quelques autres ; voir l’outil de suivi des problèmes (cf. Voir aussi).