Options de la ligne de commande

Mis à jour il y a 2 ans

Cette page affiche d'anciennes instructions pour MuseScore 3.
Pour les utilisateurs de MuseScore 4 Veuillez consulter 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