# Gebruik van de opdrachtregel ***LET OP:** Deze pagina is gekopieerd van de* [*equivalente pagina*](https://musescore.org/en/handbook/3/command-line-options) *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](/nl/support/revert-to-factory-settings.md) 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](/nl/support/revert-to-factory-settings.md)). * **-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*](#examples) hieronder). * **-L** | **--layout-debug** Start MuseScore in de opmaak debug modus. * **-M** | **--midi-operations** *bestand* Specificeer het MIDI-importbewerkingenbestand (zie [*voorbeelden*](#examples) 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](http://doc.qt.io/qt-5/qguiapplication.html#supported-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`: 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. ``` mscore -o 'My Score.pdf' 'My Score.mscz' ``` #### Voer een batchtaak uit om meerdere documenten te converteren. ``` mscore -j job.json ``` Dit vereist dat er een bestand `job.json` in de huidige werkmap aanwezig is met inhoud die vergelijkbaar is met het volgende: ``` [ { "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" ] ] } ] ``` 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`](https://musescore.org/sites/musescore.org/files/midi_import_options_0.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) * [https://handbook.musescore.org/nl](https://handbook.musescore.org/) Online handboek, volledige gebruikershandleiding * [https://musescore.org/nl/forum](https://musescore.org/forum) Ondersteuningsforum * [Zet terug naar fabrieksinstellingen](/nl/support/revert-to-factory-settings.md) (probleemoplossing) * [https://github.com/musescore/MuseScore/issues](/nl/support/revert-to-factory-settings.md) Project issue tracker. Controleer eerst of de bug die je tegenkomt al is gemeld. Als je alleen hulp nodig hebt met iets, gebruik dan het [ondersteuningsforum](https://musescore.org/forum). * [http://doc.qt.io/qt-5/qguiapplication.html#supported-command-line-optio…](http://doc.qt.io/qt-5/qguiapplication.html#supported-command-line-options) Documentatie van automatische Qt-opdrachtregelopties ### 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* <>. ### 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*](#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/nl/appendix/command-line-usage.md?ask= ``` 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.