# Uso da linha de comando

***PLEASE NOTE:** This page was copied from the* [*equivalent page*](https://musescore.org/en/handbook/3/command-line-options) *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](https://handbook.musescore.org/pt_br/support/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:

**mscore** \[**-deFfhIiLmnOPRstvw**]\
\[**-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**]\
\[**--sound-profile**]\
\[**--source-update**]\
\[**--template-mode**]\
\[*file ...*]

### 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](https://handbook.musescore.org/pt_br/support/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*](#examples) 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*](#examples) 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](http://doc.qt.io/qt-5/qguiapplication.html#supported-command-line-options).

### 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 salv*individualmente*, 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`](https://musescore.org/sites/musescore.org/files/midi_import_options_0.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.

### SEE ALSO

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

* <https://handbook.musescore.org/>

  Online Handbook, full user manual
* <https://musescore.org/forum>

  Support Forum
* [Revert to factory settings](https://handbook.musescore.org/pt_br/support/revert-to-factory-settings) (troubleshooting)
* [https://github.com/musescore/MuseScore/issues](https://handbook.musescore.org/pt_br/support/revert-to-factory-settings)

  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](https://musescore.org/forum) instead.
* [http://doc.qt.io/qt-5/qguiapplication.html#supported-command-line-optio…](http://doc.qt.io/qt-5/qguiapplication.html#supported-command-line-options)

  Documentation of automatic Qt command line options

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