Uso da linha de comando

PLEASE NOTE: This page was copied from the equivalent page in the MuseScore 3 Handbook. If you find an option that no longer works in MuseScore 4, please report it on GitHub.

MSCORE(1) — Página de Manual de Comandos Gerais

NAME

mscore, MuseScore4 - MuseScore 4 sheet music editor

SYNOPSIS

Você pode iniciar o MuseScore pela linha de comando digitando

mscore [options] [filename …] (Mac and Linux/BSD/Unix)
musescore [options] [filename …] (Linux/BSD/Unix)
mscore4portable [options] [filename …] (Linux AppImage)
MuseScore4.exe [options] [filename …] (Windows)

[options] and [filename] are optional. For this to work the MuseScore executable must be in %PATH% (Windows) or $PATH (Mac and Linux). If it is not, see Revert to factory settings for detailed instructions on how and where to find and execute the MuseScore executable from the command line on the various supported platforms.

Segue uma sinopse mais detalhada:

DESCRIPTION

MuseScore é um software livre e de código aberto WYSIWYG, multiplataforma, multilíngue, de composição e notação musical, lançado sob a Licença Pública Geral GNU (GPLv3).

Executar mscore sem opções adicionais inicia o programa completo do MuseScore com interface gráfica e abre quaisquer arquivos especificados na linha de comando.

As opções são as seguintes:

-b | --bitrate bitrate
Define a taxa de bits de saída MP3 em kbit/s
-c | --config-folder pathname
Sobrescreve o diretório de configuração e de preferências
-D | --monitor-resolution DPI
Especifica a resolução do monitor (sobrescreve a detecção automática)
-d | --debug
Inicia o MuseScore no modo de depuração
-E | --install-extension extension file
Instala um arquivo de extensão; soundfonts são carregados por padrão a menos que -e também seja especificado
-e | --experimental
Enable experimental features
-F | --factory-settings
Use only the standard built-in presets (“factory settings”) and delete user preferences; compare with the -R option (see also Revert to factory settings)
-f | --force
Ignora avisos de corrupção da partitura e incompatibilidade de versão no “modo conversor”
-h | -? | --help
Exibe uma visão geral das instruções de invocação (não funciona no Windows)
-I | --dump-midi-in
Exibe toda a entrada MIDI no console
-i | --load-icons
Carrega ícones do sistema de arquivos; útil se quiser editar os ícones do MuseScore e pré-visualizar as alterações
-j | --job file.json
Processa uma tarefa de conversão (veja EXEMPLOS abaixo)
-L | --layout-debug
Inicia o MuseScore no modo de depuração de layout
-M | --midi-operations file
Especifica o arquivo de operações de importação MIDI (veja EXEMPLOS abaixo)
-m | --no-midi
Desativa a entrada MIDI
-n | --new-score
Inicia com o assistente Nova Partitura independentemente de estar habilitado ou desabilitado nas preferências do usuário
-O | --dump-midi-out
Exibe toda a saída MIDI no console
-o | --export-to file
Exporta o arquivo dado (ou atualmente aberto) para o arquivo de saída especificado. O tipo de arquivo depende da extensão do nome de arquivo fornecido. Esta opção muda para o “modo conversor” e evita a interface gráfica.
-P | --export-score-parts
Ao converter para PDF com a opção -o, anexa as páginas de cada parte ao arquivo PDF criado. Se a partitura não possuir partes, todas as partes padrão serão geradas temporariamente automaticamente.
-p | --plugin name
Executa o plugin nomeado
-R | --revert-settings
Use only the standard built-in presets ("factory settings") but do not delete user preferences; compare with the -F option
-r | --image-resolution DPI
Set image resolution for conversion to PNG files. Default: 300 DPI
-S | --style style
Carrega primeiro um arquivo de estilo; útil ao usar a opção -o
-s | --no-synthesizer
Desativa o sintetizador de software integrado
-T | --trim-image margin
Trim exported PNG and SVG images to remove whitespace surrounding the score. The specified margin, in pixels, will be retained (use 0 for a tightly cropped image). When exporting to SVG, this option only works with single-page scores.
-t | --test-mode
Define a bandeira de modo teste para todos os arquivos, inclui --template-mode
-v | --version
Exibe o nome e a versão do aplicativo sem iniciar a interface gráfica (não funciona no Windows)
-w | --no-webview
Desativa o componente de visualização web no Centro de Início
-x | --gui-scaling factor
Escala a exibição da partitura e outros elementos da interface pelo fator especificado; destinado ao uso com telas de alta resolução
--diff
Imprime um diff condicionado entre as partituras fornecidas
--long-version
Exibe o nome completo, versão e revisão git do aplicativo sem iniciar a interface gráfica (não funciona no Windows)
--no-fallback-font
Não use Bravura como fonte musical de fallback
--raw-diff
Imprime um diff bruto entre as partituras fornecidas
--run-test-script
Executa testes de script listados nos argumentos da linha de comando
--score-media
Exporta toda a mídia (exceto MP3) de uma partitura dada como um único documento JSON para a saída padrão
--highlight-config
Define o destaque para svg, gerado a partir de uma partitura dada
--score-meta
Exporta metadados da partitura para documento JSON e imprime na saída padrão
--score-parts
Gera dados de partes para a partitura dada e os salva em arquivos mscz separados
--score-parts-pdf
Gera dados de partes para a partitura dada e exporta como um único documento JSON para a saída padrão
--score-transpose
Transpõe a partitura dada e exporta os dados para um único arquivo JSON, imprimindo na saída padrão
--sound-profile sound-profile
Use com '-o .mp3' ou com '-j ', sobrescreve o perfil de som nas partitura(s) fornecida(s). Valores possíveis: "MuseScore Basic", "Muse Sounds"
--source-update
Atualiza a fonte na partitura dada
--template-mode
Salva arquivos no modo template (ex.: sem tamanhos de página)

MuseScore também suporta as opções automáticas de linha de comando do Qt.

Batch conversion job JSON format

O argumento para a opção -j deve ser o caminho de um arquivo contendo um documento JSON válido que siga a especificação a seguir:

O elemento de nível superior deve ser um JSONArray, que pode estar vazio.
Cada elemento do array deve ser um JSONObject com as seguintes chaves:
- in: Value is the name of the input file (score to convert), as JSONString.
- plugin: Value is the filename of a plugin (with the .qml extension), which will be read from either the global or per-user plugin path and executed before the conversion output happens, as JSONString. Optional, but at least one of plugin and out must be given.
- out: Value is the conversion output target, as defined below. Optional, but at least one of plugin and out must be given.
O destino de saída da conversão pode ser um nome de arquivo (com extensão, que determina o formato de conversão), como JSONString.
O destino de saída da conversão pode ser um JSONArray de nomes de arquivos como JSONString, como acima, o que fará com que a partitura seja gravada em vários arquivos de saída (em vários formatos) sequencialmente, sem ser fechada, reaberta e reprocessada entre eles.
Se o destino de saída da conversão for um JSONArray, um ou mais de seus elementos podem ser, cada um, um JSONArray de duas JSONStrings (chamadas primeira e segunda metade na descrição a seguir). Isso provocará a extração de partes: para cada par, todas as partes existentes da partitura serão salvindividualmente, com nomes de arquivos compostos concatenando a primeira metade, o nome (título) da parte e a segunda metade. A string resultante deve ser um nome de arquivo válido (com extensão, determinando o formato de saída). Se uma partitura não tiver partes (trechos) definidas, isso será ignorado silenciosamente sem erro.
Extensões de arquivo válidas para saída são:
- flac
  Free Lossless Audio Codec (áudio comprimido)
- metajson
  vários metadados de partitura (JSON)
- mid
  arquivo MIDI padrão
- midi
  arquivo MIDI padrão
- mlog
  registro interno de verificação de sanidade de arquivo (JSON)
- mp3
  MPEG Layer III (áudio comprimido com perda)
- mpos
  posições de compassos (XML)
- mscx
  arquivo MuseScore não comprimido
- mscz
  arquivo MuseScore comprimido
- musicxml
  arquivo MusicXML não comprimido
- mxl
  arquivo MusicXML comprimido
- ogg
  OGG Vorbis (áudio comprimido com perda)
- pdf
  arquivo de documento portátil (impressão)
- png
  gráficos de rede portátil (imagem) — Arquivos individuais, um por página da partitura, com um hífen seguido do número da página antes da extensão do arquivo, serão gerados.
- spos
  posições de segmento (XML)
- svg
  gráficos vetoriais escaláveis (imagem)
- wav
  RIFF Waveform (áudio não comprimido)
- xml
  arquivo MusicXML não comprimido

Veja abaixo um exemplo.

ENVIRONMENT

SKIP_LIBJACK
Defina isso (o valor não importa) para pular a inicialização da biblioteca JACK Audio Connection Kit, caso cause problemas.
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-4.0/ contains the application support data (demos, instruments, localization, 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 ~/MuseScore4/ but may be changed in the configuration. Note that snapshot, alpha and beta versions use MuseScore4Development instead of MuseScore4 in all of these paths.

$XDG_CONFIG_HOME/MuseScore/MuseScore4.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/MuseScore4/ contains updated localization files downloaded from within the program, plugin information, cached scores, credentials for the musescore.com community site, session information, synthesizer 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 assumes a file job.json exists in the current working directory with content similar to the following:

[
    {
        "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"
            ]
        ]
    }
]

If MyScore3.mscz contains excerpts (instrumental parts) then the syntax above would cause files like “MyScore3 (Violin part).pdf” to be generated alongside the conductor’s PDF and MusicXML files, as well as a MIDI file with the full orchestral sound. If MyScore3.mscz has no excerpts defined then only the conductor’s PDF, MusicXML, and orchestral MIDI files will be generated, while the request for part PDFs is silently ignored.

MIDI import operations

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

DIAGNOSTICS

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

STANDARDS

MuseScore tenta implementar os seguintes padrões:

MusicXML 4.0 (score interchange format)
SF2 (SoundFont 2.01)
SF3 (SoundFont com amostras comprimidas em OGG Vorbis)
SFZ (SoundFont Sforzato)
SMuFL (Standard Music Font Layout 1.4)

HISTORY

MuseScore foi separado do sequenciador MusE em 2002 e desde então se tornou o principal software de notação Open Source.

AUTHORS

MuseScore is developed by MuseScore Limited and others.

This manual page was originally written by mirabilos <[email protected]>.

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 Studio não reconhece /etc/papersize.
Check the project’s bug tracker (cf. SEE ALSO).

AnteriorSolução de problemas PróximoTodos os atalhos de teclado

Atualizado há 1 mês

Isto foi útil?