MSCORE(1) — Page du manuel des commandes générales
mscore, MuseScore3 — MuseScore 3 éditeur de partition de musique
Vous pouvez lancer MuseScore à partir d'une ligne de commande en tapant :
[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 ...]
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 :
Utilise un pilote audio : parmi jack, alsa, portaudio, pulse
Affiche le débit binaire de sortie MP3 en kbit/s
Outrepasse le répertoire de configuration et de paramètres
Spécifie la résolution du moniteur (outrepasse la détection automatique)
Démarre MuseScore en mode débogage
Installe un fichier d’extension ; les soundfonts sont chargés par défaut sauf si -e est également spécifié
Active les fonctionnalités expérimentales, telles que les calques
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)
Ignore les avertissements de corruption de partition et de non-concordance de version en « mode convertisseur »
Affiche la présentation des instructions d'appel (ne fonctionne pas sous Windows)
Affiche toutes les entrées MIDI dans la console
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
Traite une tâche de conversion (voir EXEMPLES plus bas)
Démarre MuseScore en mode débogage de la mise en page
Spécifie le fichier des opérations d'import MIDI (voir EXEMPLES plus bas)
Désactive l'entrée MIDI
Force le démarrage avec l'Assistant Nouvelle Partition, qu’il soit activé ou désactivé dans les préférences de l’utilisateur
Affiche toutes les sorties MIDI dans la console
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.
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.
Exécute le plugin spécifié
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
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)
Charge un fichier de style en premier ; pratique pour utiliser avec l'option -o
Désactive le synthétiseur logiciel intégré
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.
Active le mode test pour tous les fichiers
Affiche le nom et la version de l’application sans démarrer l’interface utilisateur graphique (ne fonctionne pas sous Windows)
Désactive le composant Web View dans le Centre de démarrage
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
Imprime les différences conditionnées entre les partitions données
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)
N’utilise pas Bravura comme police musicale de repli
Imprime les différences brutes entre les partitions données
Lance les tests de script listés dans les arguments de la ligne de commande
Exporte tous les médias (sauf MP3) pour une partition donnée en tant que document JSON unique vers stdout (sortie standard)
Génère un MP3 pour une partition donnée et l'exporte en tant que document JSON unique vers stdout (sortie standard)
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)
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.
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
metajson
mid
fichier MIDI standard
midi
mlog
mp3
mpos
mscx
mscz
musicxml
mxl
ogg
pdf
png
spos
svg
wav
xml
Voir plus bas pour un exemple.
SKIP_LIBJACK
XDG_CONFIG_HOME
~/.config
if unset.XDG_DATA_HOME
~/.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.
/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.
mscore -o 'My Score.pdf' 'My Score.mscz'
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).
The attached midi_import_options.xml
is a sample MIDI import operations file for the -M option.
The mscore utility exits 0 on success, and >0 if an error occurs.
fluidsynth(1), midicsv(1), timidity(1), qtoptions(7)
Online Handbook, full user manual
Support Forum
Reverting to factory settings (troubleshooting)
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.
Documentation of automatic Qt command line options
MuseScore attempts to implement the following standards:
MuseScore was split off the MusE sequencer in 2002 and has since become the foremost Open Source notation software.
MuseScore is developed by Werner Schweer and others.
This manual page was written by mirabilos <tg@debian.org>.
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.
MuseScore does not honour /etc/papersize.
Probably some more; check the project’s bug tracker (cf. SEE ALSO).
MuseScore — December 18, 2018