# Komentorivin käyttö

***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) — Yleisten komentojen ohjekirjasivu

### NAME

**mscore**, **MuseScore4**  -  MuseScore 4 sheet music editor

### SYNOPSIS

MuseScore voidaan käynnistää komentoriviltä kirjoittamalla

* `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/fi/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.

Tarkempi yleiskatsaus on seuraava:

**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** on vapaa ja avoimen lähdekoodin monikielinen monialustaohjelma musiikin säveltämiseen ja nuotinkirjoitukseen. Ohjelma on julkaistu GNU General Public License (GPLv3) -lisenssillä, ja se perustuu WYSIWYG-periaatteeseen (eli muokkausnäkymä vastaa lopullista tulostetta).

Ohjelman **mscore** käynnistäminen ilman lisävalintoja avaa MuseScoren graafisen käyttöliittymän kokonaisuudessaan ja lataa kaikki komentorivillä määritetyt tiedostot.

Valinnat ovat seuraavat:

* **-b** | **--bitrate** *bittinopeus*

  Määritä MP3-ulostulon bittinopeus yksikössä kbit/s
* **-c** | **--config-folder** *polku*

  Ohita asetuskansio ja asetusten polku
* **-D** | **--monitor-resolution** *DPI*

  Määritä näytön tarkkuus (ohita automaattinen tunnistus)
* **-d** | **--debug**

  Käynnistä MuseScore vianetsintätilassa
* **-E** | **--install-extension** *laajennustiedosto*

  Asenna laajennustiedosto; soundfont-tiedostot ladataan oletusarvoisesti, ellei myös valintaa **-e** ole määritetty
* **-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/fi/support/revert-to-factory-settings))
* **-f** | **--force**

  Ohita partituurin vioittumista ja versioiden yhteensopimattomuutta koskevat varoitukset muunnostilassa ”converter mode”
* **-h** | **-?** | **--help**

  Näytä yleiskuvaus kutsumisohjeista (ei toimi Windowsissa)
* **-I** | **--dump-midi-in**

  Näytä kaikki MIDI-tulot konsolissa
* **-i** | **--load-icons**

  Lataa kuvakkeet tiedostojärjestelmästä; hyödyllinen, jos haluat muokata MuseScore-kuvakkeita ja esikatsella muutoksia
* **-j** | **--job** *file.json*

  Suorita muunnosajo (katso [*ESIMERKIT*](#examples) alta)
* **-L** | **--layout-debug**

  Käynnistä MuseScore asettelun virheenkorjaustilassa
* **-M** | **--midi-operations** *tiedosto*

  Määritä MIDI-tuonnin toimintoja ohjaava tiedosto (katso [*ESIMERKIT*](#examples) alta)
* **-m** | **--no-midi**

  Poista MIDI-tulo käytöstä
* **-n** | **--new-score**

  Käynnistä uuden partituurin ohjattu luominen riippumatta siitä, onko se otettu käyttöön tai poistettu käytöstä käyttäjän asetuksissa
* **-O** | **--dump-midi-out**

  Näytä kaikki MIDI-lähdöt konsolissa
* **-o** | **--export-to** *tiedosto*

  Vie annettu (tai parhaillaan avoinna oleva) *tiedosto* määritettyyn kohdetiedostoon. Tiedostotyyppi määräytyy annetun tiedostopäätteen perusteella. Tämä valinta siirtää ohjelman "muunnostilaan" ja ohittaa graafisen käyttöliittymän.
* **-P** | **--export-score-parts**

  Kun viet partituurin PDF-muotoon **-o**-valinnalla, liitä kunkin steman sivut luodun PDF-tiedoston jatkoksi. Jos partituurissa ei ole stemmoja, kaikki oletusstemmat luodaan tilapäisesti automaattisesti.
* **-p** | **--plugin** *nimi*

  Suorita nimetty lisäosa
* **-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** *tyyli*

  Lataa tyylitiedosto ensin; hyödyllinen käytettäväksi **-o**-valinnan kanssa
* **-s** | **--no-synthesizer**

  Poista sisäänrakennettu ohjelmistosyntetisaattori käytöstä
* **-T** | **--trim-image** *marginaali*

  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**

  Aseta testitilan lippu kaikille tiedostoille, sisältää **--template-mode**-valinnan
* **-v** | **--version**

  Näytä sovelluksen nimi ja versio käynnistämättä graafista käyttöliittymää (ei toimi Windowsissa)
* **-w** | **--no-webview**

  Poista verkkonäkymäkomponentti käytöstä Käynnistä-keskuksessa
* **-x** | **--gui-scaling** *kerroin*

  Skaalaa partituurinäkymä ja muut käyttöliittymän osat määritetyllä *kertoimella*; tarkoitettu käytettäväksi korkean resoluution näyttöjen kanssa.
* **--diff**

  Tulosta vertailu annettujen partituurien välillä
* **--long-version**

  Näytä sovelluksen koko nimi, versio ja Git-revisio käynnistämättä graafista käyttöliittymää (ei toimi Windowsissa)
* **--no-fallback-font**

  Älä käytä Bravuraa varamusiikkifonttina
* **--raw-diff**

  Tulosta raakavertailu annettujen partituurien välillä
* **--run-test-script**

  Suorita komentoriviargumenteissa luetellut skriptitestit
* **--score-media**

  Vie kaikki annetun partituurin mediatiedostot (paitsi MP3) yhtenä JSON-dokumenttina vakiotulostukseen
* **--highlight-config**

  Määritä korostus annetusta partituurista luotuun SVG-tiedostoon
* **--score-meta**

  Vie partituurin metatiedot JSON-dokumenttina ja tulosta se vakiotulostukseen
* **--score-parts**

  Luo stemmatiedot annetusta partituurista ja tallenna ne erillisiin mscz-tiedostoihin
* **--score-parts-pdf**

  Luo stemmatiedot annetusta partituurista ja vie ne yhtenä JSON-dokumenttina vakiotulostukseen
* **--score-transpose**

  Transponoi annettu partituuri ja vie tiedot yhtenä JSON-tiedostona vakiotulostukseen
* **--sound-profile** *ääniprofiili*

  Käytä valinnan '-o .mp3' tai '-j' kanssa ohittaaksesi annettujen partituurien ääniprofiilit.\
  Mahdolliset arvot: "MuseScore Basic", "Muse Sounds"
* **--source-update**

  Päivitä lähde annetussa partituurissa
* **--template-mode**

  Tallenna tiedostot mallipohjatilassa (esim. ilman sivukokoja)

MuseScore tukee myös [automaattisia Qt-komentorivivalintoja](http://doc.qt.io/qt-5/qguiapplication.html#supported-command-line-options).

### Batch conversion job JSON format

Valinnan **-j** argumenttina on oltava sellaisen tiedoston polku, joka sisältää seuraavan määrittelyn mukaisen kelvollisen JSON-dokumentin:

* Ylimmän tason elementin on oltava JSONArray, joka voi olla tyhjä.
* Jokaisen taulukon elementin on oltava JSONObject, joka sisältää seuraavat avaimet:
  * `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.
* Muunnostuloksen kohde voi olla tiedostonimi (varustettuna tiedostopäätteellä, joka määrittää muunnettavan muodon) JSONString-muodossa.
* Muunnostuloksen kohde voi olla tiedostonimien muodostama JSONArray (JSONString-arvoina, kuten edellä), jolloin partituuri kirjoitetaan useisiin tulostiedostoihin (useissa eri tiedostomuodoissa) peräkkäin ilman, että tiedostoa suljetaan, avataan uudelleen tai prosessoidaan välissä uudestaan.
* Jos muunnostuloksen kohde on JSONArray, yksi tai useampi sen elementti voi itsessään olla kahden JSONString-arvon muodostama JSONArray (joita seuraavassa kuvauksessa kutsutaan ensimmäiseksi ja toiseksi puoliskoksi). Tämä käynnistää stemmojen erottamisen: jokaisen tällaisen kaksikon kohdalla kaikki partituurin olemassa olevat stemmat tallennetaan *yksitellen*. Tiedostonimet muodostetaan yhdistämällä ensimmäinen puolisko, stemman nimi (otsikko) ja toinen puolisko. Tuloksena olevan merkkijonon on oltava kelvollinen tiedostonimi (tiedostopäätteineen, joka määrittää tulostusmuodon). Jos partituurille ei ole määritetty stemmoja (otteita), tämä ohitetaan hiljaisesti ilman virheilmoitusta.
* Sallitut tiedostopäätteet tulostiedostoille ovat:
  * `flac`

    FLAC (Ilmainen häviötön äänikoodekki, pakattu ääni)
  * `metajson`

    erilaiset partituurin metatiedot (JSON)
  * `mid`

    normaali MIDI-tiedosto
  * `midi`

    normaali MIDI-tiedosto
  * `mlog`

    sisäisen tiedostotarkistuksen loki (JSON)
  * `mp3`

    MPEG Layer III (häviöllisesti pakattu ääni)
  * `mpos`

    tahtien sijainnit (XML)
  * `mscx`

    pakkaamaton MuseScore-tiedosto
  * `mscz`

    pakattu MuseScore-tiedosto
  * `musicxml`

    pakkaamaton MusicXML-tiedosto
  * `mxl`

    pakattu MusicXML-tiedosto
  * `ogg`

    OGG Vorbis (häviöllisesti pakattu ääni)
  * `pdf`

    siirrettävä dokumenttitiedosto (tulostettava)
  * `png`

    kannettava verkkografiikka (kuva) – Ohjelma luo erilliset tiedostot jokaisesta partituurin sivusta. Tiedostonimeen lisätään yhdysviiva ja sivunumero ennen tiedostopäätettä.
  * `spos`

    segmenttien sijainnit (XML)
  * `svg`

    skaalautuva vektorigrafiikka (kuva)
  * `wav`

    RIFF-aaltomuoto (pakkaamaton ääni)
  * `xml`

    pakkaamaton MusicXML-tiedosto

Katso esimerkki alta.

### ENVIRONMENT

* `SKIP_LIBJACK`

  Aseta tämä (arvolla ei ole väliä), jos haluat ohittaa JACK Audio Connection Kit -kirjaston alustuksen siltä varalta, että se aiheuttaa ongelmia.
* `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/fi/support/revert-to-factory-settings) (troubleshooting)
* [https://github.com/musescore/MuseScore/issues](https://handbook.musescore.org/fi/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 pyrkii noudattamaan seuraavia standardeja:

* MusicXML 4.0 (score interchange format)
* SF2 (SoundFont 2.01)
* SF3 (SoundFont, jossa on OGG Vorbis -pakattuja ääninäytteitä)
* SFZ (Sforzato soundfont)
* SMuFL (Standard Music Font Layout 1.4)

### HISTORY

MuseScore erotettiin MusE-sekvensseristä omaksi projektikseen vuonna 2002, ja siitä on sittemmin tullut maailman johtava avoimen lähdekoodin nuotinnusohjelmisto.

### 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 ei noudata */etc/papersize*-tiedoston asetuksia.
* Check the project’s bug tracker (cf. [*SEE ALSO*](#see-also)).