Ctrlk
Main website

Gebruik van de opdrachtregel

LET OP: Deze pagina is gekopieerd van de equivalente pagina in het MuseScore 3 Handboek. Als je een optie vindt die niet meer werkt in MuseScore 4, meld dit dan op GitHub.

MSCORE(1) — Algemene commando handleiding pagina

NAAM

mscore, MuseScore4  -  MuseScore 4 muzieknotatieprogramma

SYNOPSIS

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

  • mscore [opties] [bestandsnaam …] (Mac en Linux/BSD/Unix)

  • musescore [opties] [bestandsnaam …] (Linux/BSD/Unix)

  • mscore4portable [opties] [bestandsnaam …] (Linux AppImage)

  • MuseScore4.exe [opties] [bestandsnaam …] (Windows)

[opties] en [bestandsnaam] zijn optioneel. Om dit te laten werken, moet het uitvoerbare bestand van MuseScore zich in %PATH% (Windows) of $PATH (Mac en Linux) bevinden. Als dit niet het geval is, raadpleeg dan Terugzetten naar fabrieksinstellingen voor gedetailleerde instructies over hoe en waar je het uitvoerbare bestand van MuseScore kunt vinden en uitvoeren vanaf de opdrachtregel op de verschillende ondersteunde 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 bestand] [-e | --experimental] [-F | --factory-settings] [-f | --force] [-h | -? | --help] [-I | --dump-midi-in] [-i | --load-icons] [-j | --job bestand.json] [-L | --layout-debug] [-M | --midi-operations bestand] [-m | --no-midi] [-n | --new-score] [-O | --dump-midi-out] [-o | --export-to bestand] [-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] [bestand ...]

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 bestand

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

  • -e | --experimental

    Schakel experimentele functies in.

  • -F | --factory-settings

    Gebruik alleen de standaard ingebouwde voorinstellingen ("fabrieksinstellingen") en verwijder gebruikersvoorkeuren; vergelijk dit met de -R optie (zie ook Terugzetten naar fabrieksinstellingen).

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

    Een conversietaak verwerken (zie voorbeelden hieronder).

  • -L | --layout-debug

    Start MuseScore in de opmaak debug modus.

  • -M | --midi-operations bestand

    Specificeer het MIDI-importbewerkingenbestand (zie voorbeelden hieronder).

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

    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

    Gebruik alleen de standaard ingebouwde voorinstellingen ("fabrieksinstellingen"), maar verwijder geen gebruikersvoorkeuren; vergelijk met de -F optie.

  • -r | --image-resolution DPI

    Stel de beeldresolutie in voor conversie naar PNG-bestanden. Standaard: 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

    Verwijder de witruimte rondom de partituur bij het exporteren van PNG- en SVG-afbeeldingen. De opgegeven marge, in pixels, blijft behouden (gebruik 0 voor een strakke uitsnede). Bij het exporteren naar SVG werkt deze optie alleen voor partituren van één pagina.

  • -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 ondersteunt ook de automatische Qt-opdrachtregelopties.

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: Waarde is de naam van het invoerbestand (de te converteren partituur), als JSONString.

    • plugin: De waarde is de bestandsnaam van een plugin (met de extensie .qml), die wordt gelezen vanuit het globale of gebruiker specifieke plugin pad en uitgevoerd voordat de conversie-output plaatsvindt, als JSONString. Optioneel, maar ten minste één van plugin en out moet worden opgegeven.

    • out: De waarde is het conversie-uitvoerdoel, zoals hieronder gedefinieerd. Optioneel, maar ten minste één van plugin en out moet worden opgegeven.

  • 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

    Locatie van gebruikersconfiguratie; standaard ~/.config indien niet ingesteld.

  • XDG_DATA_HOME

    Locatie van gebruikersgegevens; standaard ~/.local/share indien niet ingesteld.

Merk op dat MuseScore ook de normale Qt-omgevingsvariabelen ondersteunt, zoals QT_QPA_GENERIC_PLUGINS, QT_QPA_PLATFORM, QT_QPA_PLATFORMTHEME, QT_QPA_PLATFORM_PLUGIN_PATH, QT_STYLE_OVERRIDE, DISPLAY, enz.

BESTANDEN

/usr/share/mscore-4.0/ bevat de applicatieondersteuningsgegevens (demo's, instrumenten, lokalisatie, systeemwijde plugins, soundfonts, stijlen, akkoorden, sjablonen en achtergronden). In de Debian-pakketten worden systeemwijde soundfonts in plaats daarvan geïnstalleerd in /usr/share/sounds/sf2/, /usr/share/sounds/sf3/ of /usr/share/sounds/sfz/.

De gebruiker specifieke gegevens (extensies, plugins, soundfonts, stijlen, sjablonen) en bestanden (afbeeldingen, partituren) worden normaal gesproken geïnstalleerd in submappen onder ~/MuseScore4/ maar dit kan worden gewijzigd in de configuratie. Houd er rekening mee dat snapshot-, alpha- en bètaversies MuseScore4Development gebruiken in plaats van MuseScore4 in al deze paden.

$XDG_CONFIG_HOME/MuseScore/MuseScore4.ini bevat de gebruikersvoorkeuren, een lijst met recent gebruikte bestanden en hun locaties, venstergroottes en -posities, enz. Zie hierboven voor de paden naar de ontwikkelingsversie.

$XDG_DATA_HOME/data/MuseScore/MuseScore4/ bevat bijgewerkte lokalisatiebestanden die vanuit het programma zijn gedownload, plugin informatie, gecachete partituren, inloggegevens voor de communitywebsite musescore.com, sessie-informatie, synthesizerinstellingen, aangepaste toonsoorten en maatsoorten en sneltoetsen. Zie hierboven voor paden naar ontwikkelingsversies.

VOORBEELDEN

Converteer een partituur naar PDF via de opdrachtregel.

Voer een batchtaak uit om meerdere documenten te converteren.

Dit vereist dat er een bestand job.json in de huidige werkmap aanwezig is met inhoud die vergelijkbaar is met het volgende:

Als MyScore3.mscz fragmenten (instrumentale partijen) bevat, zorgt de bovenstaande syntax ervoor dat bestanden zoals “MyScore3 (Violin part).pdf” worden gegenereerd, samen met de PDF- en MusicXML-bestanden van de dirigent en een MIDI-bestand met het volledige orkestgeluid. Als MyScore3.mscz geen fragmenten bevat, worden alleen de PDF- en MusicXML-bestanden van de dirigent en het MIDI-bestand van het orkest gegenereerd, terwijl het verzoek om PDF-bestanden van de partijen stilzwijgend wordt genegeerd.

MIDI-importbewerkingen

Het bijgevoegde bestand midi_import_options.xml is een voorbeeld van een MIDI-importbewerkingenbestand voor de -M optie.

DIAGNOSTIEK

Het programma mscore sluit af met exitcode 0 bij succes en met een waarde groter dan 0 als er een fout optreedt.

ZIE OOK

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

STANDAARDEN

MuseScore streeft ernaar de volgende standaarden te implementeren:

  • MusicXML 4.0 (formaat voor het uitwisselen van partituren)

  • 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 ontwikkeld door MuseScore Limited en anderen.

Deze handleidingpagina is geschreven door mirabilos <[email protected]>.

VOORBEHOUDEN

De automatisch gegenereerde Qt-opdrachtregelopties worden uit de argumentenvector verwijderd voordat de applicatie de kans krijgt om de opties te verwerken; dit betekent dat een aanroep zoals mscore -S -reverse geen kans van slagen heeft, omdat -reverse eerst door Qt wordt verwijderd.

DEFECTEN

  • MuseScore Studio ondersteunt geen /etc/papersize.

  • Raadpleeg de bugtracker van het project (ZIE OOK).

VorigeProbleemoplossingVolgendeAlle sneltoetsen

Laatst bijgewerkt

Was dit nuttig?