Komentorivin käyttö

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

• -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 alta)

• -L | --layout-debug

  Käynnistä MuseScore asettelun virheenkorjaustilassa

• -M | --midi-operations tiedosto

  Määritä MIDI-tuonnin toimintoja ohjaava tiedosto (katso ESIMERKIT 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.

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 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 (troubleshooting)

• https://github.com/musescore/MuseScore/issues

  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.

• http://doc.qt.io/qt-5/qguiapplication.html#supported-command-line-optio…

  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 <[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 ei noudata /etc/papersize-tiedoston asetuksia.

• Check the project’s bug tracker (cf. SEE ALSO).