Gebruik van de opdrachtregel

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) — Algemene commando handleiding pagina

NAAM

mscore, MuseScore4  -  MuseScore 4 sheet music editor

SYNOPSIS

Je kunt MuseScore starten vanaf de opdrachtregel door het volgende te typen:

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

Hieronder volgt een meer gedetailleerde samenvatting:

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

BESCHRIJVING

MuseScore is gratis en open source WYSIWYG-software voor meertalige muziekcompositie en -notatie, die platformonafhankelijk en compatibel is. De software is uitgebracht onder de GNU General Public Licence (GPLv3).

Door mscore zonder extra opties uit te voeren, wordt het volledige grafische MuseScore-programma gestart en worden alle bestanden geopend die op de opdrachtregel zijn opgegeven.

De opties zijn als volgt:

  • -b | --bitrate bitrate

    Stel de MP3-uitvoerbitrate in op kbit/s.

  • -c | --config-folder padnaam

    Overschrijf de configuratie- en instellingenmap

  • -D | --monitor-resolution DPI

    Geef de monitorresolutie op (automatische detectie overschrijven)

  • -d | --debug

    Start MuseScore in de debug modus.

  • -E | --install-extension extension file

    Installeer een extensiebestand; soundfonts worden standaard geladen, tenzij -e ook is gespecificeerd.

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

    Negeer waarschuwingen over beschadigde partituren en versieconflicten in de "convertermodus".

  • -h | -? | --help

    Toon een overzicht van de aanroepinstructies (werkt niet op Windows).

  • -I | --dump-midi-in

    Toon alle MIDI-input in de console.

  • -i | --load-icons

    Laad pictogrammen vanuit het bestandssysteem; handig als je de MuseScore-pictogrammen wilt bewerken en de wijzigingen wilt bekijken.

  • -j | --job file.json

    Process a conversion job (see EXAMPLES below)

  • -L | --layout-debug

    Start MuseScore in de opmaak debug modus.

  • -M | --midi-operations file

    Specify MIDI import operations file (see EXAMPLES below)

  • -m | --no-midi

    MIDI-invoer uitschakelen

  • -n | --new-score

    Begin met de wizard "Nieuwe partituur", ongeacht of deze is in- of uitgeschakeld in de gebruikersvoorkeuren.

  • -O | --dump-midi-out

    Toon alle MIDI-output in de console.

  • -o | --export-to file

    Exporteer het opgegeven (of momenteel geopende) bestand naar de opgegeven uitvoer bestand. Het bestandstype is afhankelijk van de extensie van de opgegeven bestandsnaam. Deze optie schakelt over naar de "conversiemodus" en vermijdt de grafische gebruikersinterface.

  • -P | --export-score-parts

    Bij het converteren naar PDF met de -o optie worden de pagina's van elk partituurdeel aan het aangemaakte PDF-bestand toegevoegd. Als de partituur geen partituren heeft, worden alle standaardpartituren tijdelijk automatisch gegenereerd.

  • -p | --plugin name

    Voer de genoemde plugin uit.

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

    Laad eerst een stijlbestand; handig voor gebruik met de -o optie.

  • -s | --no-synthesizer

    Schakel de geïntegreerde software-synthesizer uit.

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

    Stel de testmodus in voor alle bestanden, inclusief --template-mode.

  • -v | --version

    Toon de naam en versie van de applicatie zonder de grafische gebruikersinterface te starten (werkt niet op Windows).

  • -w | --no-webview

    Schakel de webweergavecomponent uit in het Startcentrum.

  • -x | --gui-scaling factor

    Schaal de scoreweergave en andere GUI-elementen met de opgegeven factor; bedoeld voor gebruik met beeldschermen met hoge resolutie.

  • --diff

    Print een geconditioneerd verschil tussen de gegeven partituren.

  • --long-version

    Toon de volledige naam, versie en Git-revisie van de applicatie zonder de grafische gebruikersinterface te starten (werkt niet op Windows).

  • --no-fallback-font

    Gebruik Bravura niet als reservelettertype voor muziek.

  • --raw-diff

    Print het ruwe verschil tussen de gegeven partituren.

  • --run-test-script

    Voer de scripttests uit die in de opdrachtregelargumenten worden vermeld.

  • --score-media

    Exporteer alle media (behalve MP3) voor een bepaalde partituur als één enkel JSON-document naar de standaarduitvoer.

  • --highlight-config

    Markeer de afbeelding op SVG, gegenereerd op basis van een gegeven partituur.

  • --score-meta

    Exporteer partituur metadata naar een JSON-document en print deze naar de standaarduitvoer.

  • --score-parts

    Genereer partij gegevens voor de gegeven partituur en sla deze op in aparte mscz-bestanden.

  • --score-parts-pdf

    Genereer partij gegevens voor de gegeven partituur en exporteer deze als één JSON-document naar de standaarduitvoer.

  • --score-transpose

    Transponeer de gegeven partituur en exporteer de gegevens naar één JSON-bestand, print dit vervolgens naar de standaarduitvoer.

  • --sound-profile sound-profile

    Gebruik met '-o .mp3' of met '-j ' om het geluidsprofiel in de betreffende partituur(en) te overschrijven. Mogelijke waarden: "MuseScore Basic", "Muse Sounds".

  • --source-update

    Werk de bron in de gegeven partituur bij.

  • --template-mode

    Sla bestanden op in sjabloonmodus (bijvoorbeeld zonder paginaformaten).

MuseScore also supports the automatic Qt command line options.

Batchconversietaak in JSON-formaat

Het argument voor de -j optie moet het pad zijn naar een bestand dat een geldig JSON-document bevat dat voldoet aan de volgende specificatie:

  • Het element op het hoogste niveau moet een JSONArray zijn, die leeg mag zijn.

  • Elk element van de array moet een JSONObject zijn met de volgende sleutels:

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

  • Het doel van de conversie-uitvoer kan een bestandsnaam zijn (inclusief extensie, die het conversieformaat bepaalt), of een JSONString.

  • Het doel van de conversie-uitvoer kan een JSONArray van bestandsnamen als JSONString zijn, zoals hierboven, waardoor de partituur achter elkaar naar meerdere uitvoerbestanden (in verschillende uitvoerformaten) wordt geschreven, zonder dat deze tussendoor worden gesloten, opnieuw geopend en opnieuw verwerkt.

  • Als het conversiedoel een JSONArray is, kunnen een of meer elementen ervan elk ook een JSONArray van twee JSONStrings zijn (hierna 'eerste helft' en 'tweede helft' genoemd). Dit zorgt voor het extraheren van partijen: voor elke dergelijke combinatie van twee partijen worden alle bestaande partijen van de partituur afzonderlijk opgeslagen, waarbij de bestandsnamen worden samengesteld door de eerste helft, de naam (titel) van de partij en de tweede helft samen te voegen. De resulterende string moet een geldige bestandsnaam zijn (inclusief extensie, die het uitvoerformaat bepaalt). Als een partituur geen partijen (fragmenten) heeft gedefinieerd, wordt dit stilzwijgend genegeerd zonder foutmelding.

  • Geldige bestandsextensies voor de uitvoer zijn:

    • flac

      Free Lossless Audio Codec (gecomprimeerde audio)

    • metajson

      diverse partituur metadata (JSON)

    • mid

      standaard MIDI bestand

    • midi

      standaard MIDI bestand

    • mlog

      logboek voor interne bestandscontrole (JSON)

    • mp3

      MPEG Layer III (audio met kwaliteitsverlies)

    • mpos

      maat posities (XML)

    • mscx

      niet-gecomprimeerd MuseScore-bestand

    • mscz

      gecomprimeerd MuseScore-bestand

    • musicxml

      niet-gecomprimeerd MusicXML-bestand

    • mxl

      gecomprimeerd MusicXML-bestand

    • ogg

      OGG Vorbis (gecomprimeerde audio met verlies)

    • pdf

      portable document file (afdruk)

    • png

      portable network graphics (afbeelding) — Er worden afzonderlijke bestanden gegenereerd, één per partituurpagina, met een minteken gevolgd door het paginanummer vóór de bestandsextensie.

    • spos

      segment posities (XML)

    • svg

      scalable vector graphics (afbeelding)

    • wav

      RIFF Waveform (ongecomprimeerde audio)

    • xml

      niet-gecomprimeerd MusicXML-bestand

Zie onderstaand voorbeeld.

OMGEVING

  • SKIP_LIBJACK

    Stel dit in (de waarde maakt niet uit) om de initialisatie van de JACK Audio Connection Kit-bibliotheek over te slaan, mocht dit problemen veroorzaken.

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

BESTANDEN

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

VOORBEELDEN

Converteer een partituur naar PDF via de opdrachtregel.

Voer een batchtaak uit om meerdere documenten te converteren.

This requires assumes a file job.json exists in the current working directory with content similar to the following:

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

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

DIAGNOSTIEK

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

ZIE OOK

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

STANDAARDEN

MuseScore streeft ernaar de volgende standaarden te implementeren:

  • MusicXML 4.0 (score interchange format)

  • SF2 (SoundFont 2.01)

  • SF3 (SoundFont met OGG Vorbis-gecomprimeerde samples)

  • SFZ (Sforzato soundfont)

  • SMuFL (Standard Music Font Layout 1.4)

GESCHIEDENIS

MuseScore is in 2002 afgesplitst van de MusE-sequencer en is sindsdien uitgegroeid tot de belangrijkste open-source software voor muzieknotatie.

AUTEURS

MuseScore is developed by MuseScore Limited and others.

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

VOORBEHOUDEN

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.

DEFECTEN

  • MuseScore Studio ondersteunt geen /etc/papersize.

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

Laatst bijgewerkt

Was dit nuttig?