Options de la ligne de commande

Mis à jour il y a 1 an
This page shows old instructions for MuseScore 3.
For MuseScore 4 users, see Options de la ligne de commande.

    MSCORE(1) — Page du manuel des commandes générales

    NOM

    mscore, MuseScore3 — MuseScore 3 éditeur de partition de musique

    RÉSUMÉ

    Vous pouvez lancer MuseScore à partir d'une ligne de commande en tapant :

    • mscore [options] [filename …] (Mac et Linux/BSD/Unix)
    • musescore [options] [filename …] (Linux/BSD/Unix)
    • MuseScore3.exe [options] [filename …] (Windows)

    [options] et [filename] sont optionnels. Pour que cela fonctionne MuseScore.exe doit être dans le %PATH% (Windows) resp. $PATH (Mac and Linux). Si tel n'est pas le cas, voir Restaurer les paramètres par défaut pour des instructions détaillées sur comment et où trouver et exécuter l'exécutable MuseScore à partir d'une ligne de commande sur les divers plateformes supportées.

    Voici un résumé plus détaillé :

    mscore [-deFfhIiLmnOPRstvw]
    [-a | --use-audio pilote]
    [-b | --bitrate débit_binaire]
    [-c | --config-folder chemin_d'accès]
    [-D | --monitor-resolution DPI]
    [-E | --install-extension fichier_d’extension]
    [-j | --job fichier.json]
    [-M | --midi-operations nom_fichier]
    [-o | --export-to nom_fichier]
    [-p | --plugin nom]
    [-r | --image-resolution DPI]
    [-S | --style style]
    [-T | --trim-image marge]
    [-x | --gui-scaling facteyr]
    [--debug]
    [--diff]
    [--dump-midi-in]
    [--dump-midi-out]
    [--experimental]
    [--export-score-parts]
    [--factory-settings]
    [--force]
    [--help]
    [--layout-debug]
    [--load-icons]
    [--long-version]
    [--new-score]
    [--no-fallback-font]
    [--no-midi]
    [--no-synthesizer]
    [--no-webview]
    [--raw-diff]
    [--revert-settings]
    [--run-test-script]
    [--score-media]
    [--score-mp3]
    [--score-parts-pdf]
    [--template-mode]
    [--test-mode]
    [--version]
    [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 license publique générale GNU (GPLv2).

    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 pilote audio : parmi jack, alsa, portaudio, pulse

    -b | --bitrate débit_binaire

    Affiche 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és par défaut sauf si -e est également spécifié

    -e | --experimental

    Active les fonctionnalités expérimentales, telles que les 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 ; comparez 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 la 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 actuellement ouvert) vers la sortie spécifiée 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 vous convertissez 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 générées temporairement automatiquement.

    -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 ; comparez 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 margin

    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é (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

    -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 factor

    Redimensionne l'affichage de la partition et d'autres éléments de l'interface graphique par 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 de script 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)

    --score-mp3

    Génère un MP3 pour une partition donnée et l'exporte en tant que document JSON unique vers stdout (sortie standard)

    --score-parts-pdf

    Génère des données sur les parties pour la partition donnée et les exporte en un seul document JSON vers stdout (sortie standard)

    --template-mode

    Enregistre les fichiers en mode modèle (e.g. sans format de page)

    MuseScore prend également en charge les options de ligne de commande automatique Qt.

    Conversion par lots 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 la spécification suivante :

    • 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 de plugin par utilisateur 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é)
      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 les 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 (imprimé)
      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
    Set this (the value does not matter) to skip initialisation of the JACK Audio Connection Kit library, in case it causes trouble.
    XDG_CONFIG_HOME
    User configuration location; defaults to ~/.config if unset.
    XDG_DATA_HOME
    User data location; defaults to ~/.local/share if unset.

    Note that MuseScore also supports the normal Qt environment variables such as QT_QPA_GENERIC_PLUGINS, QT_QPA_PLATFORM, QT_QPA_PLATFORMTHEME, QT_QPA_PLATFORM_PLUGIN_PATH, QT_STYLE_OVERRIDE, DISPLAY, etc.

    FILES

    /usr/share/mscore-3.0/ contains the application support data (demos, instruments, localisation, system-wide plugins, soundfonts, styles, chords, templates and wallpapers). In the Debian packages, system-wide soundfonts are installed into /usr/share/sounds/sf2/, /usr/share/sounds/sf3/ or /usr/share/sounds/sfz/, respectively, instead.

    The per-user data (extensions, plugins, soundfonts, styles, templates) and files (images, scores) are normally installed into subdirectories under ~/MuseScore3/ but may be changed in the configuration. Note that snapshot, alpha and beta versions use MuseScore3Development instead of MuseScore3 in all of these paths.

    $XDG_CONFIG_HOME/MuseScore/MuseScore3.ini contains the user preferences, list of recently used files and their locations, window sizes and positions, etc. See above for development version paths.

    $XDG_DATA_HOME/data/MuseScore/MuseScore3/ contains updated localisation files downloaded from within the program, plugin information, cached scores, credentials for the musescore.com community site, session information, synthesiser settings, custom key and time signatures and shortcuts. See above for development version paths.

    EXAMPLES

    Convert a score to PDF from the command line

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

    Run a batch job converting multiple documents

    mscore -j job.json
    

    This requires the file job.json in the current working directory to have content similar to the following:

    [
      {
        "in": "Reunion.mscz",
        "out": "Reunion-coloured.pdf",
        "plugin": "colornotes.qml"
      },
      {
        "in": "Reunion.mscz",
        "out": [
          "Reunion.pdf",
          [ "Reunion (part for ", ").pdf" ],
          "Reunion.musicxml",
          "Reunion.mid"
        ]
      },
      {
        "in": "Piece with excerpts.mscz",
        "out": [
          "Piece with excerpts (Partitura).pdf",
          [ "Piece with excerpts (part for ", ").pdf" ],
          "Piece with excerpts.mid"
        ]
      }
    ]
    

    The last part of the job would, for example, cause files like “Piece with excerpts (part for Violin).pdf” to be generated alongside the conductor’s partitura and a MIDI file with the full orchestra sound, whereas the equivalent part of the Reunion conversion will be silently ignored (because the Reunion piece (a MuseScore demo) has no excerpts defined).

    MIDI import operations

    The attached midi_import_options.xml is a sample MIDI import operations file for the -M option.

    DIAGNOSTIQUES

    The mscore utility exits 0 on success, and >0 if an error occurs.

    Voir aussi

    fluidsynth(1), midicsv(1), timidity(1), qtoptions(7)

    https://musescore.org/handbook

    Online Handbook, full user manual

    https://musescore.org/forum

    Support Forum

    https://musescore.org/en/node/278582

    Reverting to factory settings (troubleshooting)

    https://musescore.org/project/issues

    Project Issue Tracker — Please check first to if the bug you’re encountering has already been reported. If you just need help with something, then please use the support forum instead.

    http://doc.qt.io/qt-5/qguiapplication.html#supported-command-line-optio…

    Documentation of automatic Qt command line options

    STANDARDS

    MuseScore attempts to implement the following standards:

    • MusicXML 3.1 (score interchange format)
    • SF2 (SoundFont 2.01)
    • SF3 (SoundFont with OGG Vorbis-compressed samples)
    • SFZ (Sforzato soundfont)
    • SMuFL (Standard Music Font Layout 1.20)

    HISTORY

    MuseScore was split off the MusE sequencer in 2002 and has since become the foremost Open Source notation software.

    AUTEURS

    MuseScore is developed by Werner Schweer and others.

    This manual page was written by mirabilos <tg@debian.org>.

    CAVEATS

    The automatic Qt command line options are removed from the argument vector before the application has a chance at option processing; this means that an invocation like mscore -S -reverse has no chance at working because the -reverse is removed by Qt first.

    BUGS

    • MuseScore does not honour /etc/papersize.

    • Probably some more; check the project’s bug tracker (cf. SEE ALSO).

    MuseScore — December 18, 2018

    Do you still have an unanswered question? Please log in first to post your question.