# 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](/pt_br/support/revert-to-factory-settings.md) 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](/pt_br/support/revert-to-factory-settings.md))
* **-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](/pt_br/support/revert-to-factory-settings.md) (troubleshooting)
* [https://github.com/musescore/MuseScore/issues](/pt_br/support/revert-to-factory-settings.md)

  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)).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://handbook.musescore.org/pt_br/appendix/command-line-usage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.