Utilisation de la ligne de commande

Mis à jour il y a 1 semaine

    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 4, 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 4, il faut la supprimer de cette page.

    Nom

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

    Résumé

    Vous
    Vous pouvez lancer MuseScore à 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 :

    mscore [-deFfhIiLmnOPRstvw]
    [-a | --use-audio driver]
    [-b | --bitrate bitrate]
    [-c | --config-folder pathname]
    [-D | --monitor-resolution DPI]
    [-d | --debug]
    [-E | --install-extension extension file]
    [-e | --experimental]
    [-F | --factory-settings]
    [-f | --force]
    [-h | -? | --help]
    [-I | --dump-midi-in]
    [-i | --load-icons]
    [-j | --job file.json]
    [-L | --layout-debug]
    [-M | --midi-operations file]
    [-m | --no-midi]
    [-n | --new-score]
    [-O | --dump-midi-out]
    [-o | --export-to file]
    [-P | --export-score-parts]
    [-p | --plugin name]
    [-R | --revert-settings]
    [-r | --image-resolution DPI]
    [-S | --style style]
    [-s | --no-synthesizer]
    [-T | --trim-image margin]
    [-t | --test-mode]
    [-v | --version]
    [-w | --no-webview]
    [-x | --gui-scaling factor]
    [--diff]
    [--long-version]
    [--no-fallback-font]
    [--raw-diff]
    [--run-test-script]
    [--score-media]
    [--score-meta]
    [--highlight-config]
    [--score-parts]
    [--score-parts-pdf]
    [--score-transpose]
    [--source-update]
    [--template-mode]
    [file ...]

    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 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 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 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 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 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 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 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 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 ne distingue pas /etc/papersize.

    • Potentiellement quelques autres ; voir l’outil de suivi des problèmes (cf. Voir aussi).