Använda kommandoraden

Updated 2 months ago

OBS: Den här sidan kopierades från motsvarande sida i handboken till MuseScore 3. Om du hittar ett alternativ som inte längre fungerar i MuseScore 4, rapportera det på GitHub och gör en notering vid det alternativet på den här sidan. Om alternativet togs bort avsiktligen från MuseScore 4 kan du ta bort det från den här sidan.

MSCORE(1) —Manualsida för allmänna kommandon

NAMN

mscore, MuseScore4—MuseScore 4 notskriftsprogram

SAMMANFATTNING

Du kan starta MuseScore från kommandoraden genom att skriva

mscore [alternativ] [filnamn …] (Mac och Linux/BSD/Unix)
musescore [alternativ] [filnamn …] (Linux/BSD/Unix)
mscore4portable [alternativ] [filnamn …] (Linux AppImage)
MuseScore4.exe [alternativ] [filnamn …] (Windows)

[alternativ] och [filnamn] är valfria att använda. För att det här ska fungera måste körfilen för MuseScore finnas i %PATH% (Windows) respektive $PATH (Mac och Linux). Om inte, se Revert to factory settings (kapitel för MuseScore 3 som saknar svensk översättning; klicka vidare från den sidan till en översatt sida för MuseScore 4) för detaljerade instruktioner om hur och var du hittar och kör MuseScore-körfilen från kommandoraden på de olika plattformarna som stöds.

En mer detaljerad sammanfattning följer:

BESKRIVNING

**MuseScore är ett plattformsneutralt och flerspråkigt WYSIWYG musikkompositions- och notskriftsprogram som använder fri och öppen källkod, och släpps under licensen GNU General Public License (GPL v3).

Att köra mscore utan extra alternativ startar hela det grafiska MuseScore-programmet, och öppnar eventuella filer som anropas på kommandoraden.

Alternativen är som följer:

-b | --bitrate bithastighet: Ange bithastighet för MP3-utdata i kbit/s
-c | --config-folder sökvägsnamn: Använd en annan mapp för konfiguration och inställningar
-D | --monitor-resolution DPI: Ange skärmupplösning (åsidosätt autoupptäckt)
-d | --debug: Starta MuseScore i felsökningsläge
-E | --install-extension utökningsfil: Installera en utökningsfil; soundfonts läsas in som standard om inte -e också används
-e | --experimental: Aktivera experimentella funktioner, som lager
-F | --factory-settings: Använd endast inbyggda förinställningar ("fabriksinställningar"), och radera användarinställningar; jämför med alternativet -R (se även Revert to factory settings)
-f | --force: Ignorera trasigt partitur och varningar om olika versioner i “konverteringsläge”
-h | -? | --help: Visa en översikt över anropsinstruktioner (fungerar inte i Windows)
-I | --dump-midi-in: Visar ann MIDI-indata i konsolen
-i | --load-icons: Läs in ikoner från filsystemet; användbart om du vill redigera MuseScores ikoner och förhandsgranska ändringarna
-j | --job fil.json: Utför ett konverteringsjobb (se EXEMPEL nedanför)
-L | --layout-debug: Starta MuseScore i layout-felsökningsläge
-M | --midi-operations fil: Ange fil för MIDI-importåtgärder (se EXEMPEL nedanför)
-m | --no-midi: Avaktivera MIDI-indata
-n | --new-score: Starta med guiden Nytt partitur, oavsett om den är aktiverad eller inaktiverad i användarinställningarna
-O | --dump-midi-out: Visa all MIDI-utdata i konsolen
-o | --export-to fil: Exportera angiven (eller nu öppen) fil til angiven utdatafil. Filtyp beror på ändelsen i angivet filnamn. Alternativet växlar till “konverteringsläge” och undviker det grafiska gränssnittet.
-P | --export-score-parts: Vid konvertering till PDF med alternativet -o, lägg till varje stämmas sidor till PDF-filen som skapas. Om partituret saknar stämmor kommer alla standardstämmor att tillfälligt genereras automatiskt.
-p | --plugin namn: Kör angivet insticksprogram
-R | --revert-settings: Använd bara de inbyggda förinställningarna ("fabriksinställningar"), men radera inte användarinställningar; jämför med alternativet -F
-r | --image-resolution DPI: Ange bildupplösning för konvertering till PNG-filer. Förval: 300 DPI (egentligen värdet för “Upplösning” för PNG-alternativgruppen i fliken Exportera i inställningarna)
-S | --style stil: Läs först in en stilfil; används med fördel tillsammans med alternativet -o
-s | --no-synthesizer: Avaktivera den integrerade mjukvarusynten
-T | --trim-image marginal: Beskär exporterade PNG- och SVG-bilder för att ta bort tomma ytor runt partituret. Den angivna marginalen, i bildpunkter, kommer att bevaras (använd 0 för en snävt beskuren bild). Vid export till SVG fungerar alternativet bara med partitur som får plats på en sida.
-t | --test-mode: Sätter testlägesflaggan för alla filer; inkluderar --template-mode
-v | --version: Visar namn och version för programmet utan att starta det grafiska gränssnittet (fungerar inte i Windows)
-w | --no-webview: Avaktiverar webbvykomponenten i Startcentralen
-x | --gui-scaling faktor: Skala partiturvisning och andra grafiska element med angiven faktor; avsedd att användas för högupplösta skärmar
--diff: Visa en upputsad diff mellan angivna partitur
--long-version: Visar fullständigt namn, version och git-revision för programmet utan att starta det grafiska gränssnittet (fungerar inte i Windows)
--no-fallback-font: Använd inte Bravura som räddningsteckensnitt för musikaliska tecken
--raw-diff: Visa en rå diff mellan givna partitur
--run-test-script: Kör skripttest som listas i kommandoradsargumenten
--score-media: Exportera all media (förutom MP3) för ett givet partitur som ett enda JSON-dokument till standardutdata
--highlight-config: Ange färgmärkning för SVG, som genereras från ett givet partitur
--score-meta: Exportera ett partiturs metadata till JSON-dokument och skriv till standardutdata
--score-parts: Generera stämdata för det givna partituret, och spara dem till separata mscz-filer
--score-parts-pdf: Generera stämdata för det givna partituret, och exportera det som ett enda JSON-dokument till standardutdata
--score-transpose: Transponera givet partitur och exportera datan till en enda JSON-fil, och skriv till standardutdata
--sound-profile ljudprofil: Använd med '-o .mp3' eller med '-j ', åsidosätt ljudprofilen i det givna partituren.
Möjliga värden: "MuseScore Basic", "Muse Sounds"
--source-update: Uppdatera källan i givet partitur
--template-mode: Spara filer i malläge (dvs. utan sidstorlekar)

MuseScore stödjer också de automatiska Qt-kommandoradsalternativen.

Batch-konverteringsjobb i JSON-format

Argumentet till alternativet -j måste vara sökvägen till en fil som består av ett giltigt JSON-dokument som lyder följande specifikation:

Toppnivåelementet måste vara en JSONArray, som kan vara tom.
Varje array-element måste vara ett JSONObject med följande nycklar:
- in: Värdet är namnet för indatafilen (partitur att konvertera), som JSONString.
- plugin: Värdet är filnamnet för ett insticksprogram (med ändelsen .qml), som kommer att läsas från antingen den globala eller den användardefinierade instickssökvägen och körs innan konverteringstutdatan kommer, som JSONString. Valfri, men minst en av plugin och out måste användas.
- out: Värdet är konverteringsutdatans destination, enligt nedanstående definition. Valfri, men minst en av plugin och out måste användas.
Konverteringens utdatadestination kan vara ett filnamn (med ändelse, vilket bestämmer formatet att konvertera till), som JSONString.
Konverteringens utdatadestination kan vara en JSONArray med filnamn som JSONString, som ovan, vilket gör att partituret skrivs till flera utdatafiler (i flera utdataformat) i turordning, utan att stängas, öppnas på nytt, och behandlas igen under tiden.
Om konverteringens utdatadestination är en JSONArray kan ett eller flera av dess element också vara, vart och ett, en JSONArray med två JSONString:ar (kallade första och andra halvor i följande beskrivning). Detta orsakar extraktion av stämmor: för varje sådant part kommer alla befintliga stämmor i partituret att sparas individuellt, med filnamn som skapas genom att sätta ihop den första halvan, namnet (titeln) av stämman, och den andra halvan. Den resulterande strängen måste vara ett giltigt filnamn (med ändelse som bestämmer utdataformat). OM ett partitur saknar definierade stämmor (utdrag) kommer detta att ignoreras utan att varningar visas.
Giltiga filändelser för utdata är:

flac

Free Lossless Audio Codec (komprimerat ljud)

metajson

diverse partitur-metadata (JSON)

mid

vanlig MIDI-fil

midi

vanlig MIDI-fil

mlog

intern loggfil för filintegritetskontroll (JSON)

mp3

MPEG Layer III (förstörande ljudkomprimering)

mpos

mätpositioner (XML)

mscx

okomprimerad MuseScore-fil

mscz

komprimerad MuseScore-fil

musicxml

okomprimerad MusicXML-fil

mxl

komprimerad MusicXML-fil

ogg

OGG Vorbis (förtörande ljudkomprimering)

pdf

portable document file (utskrift)

png

portable network graphics (bild) —Individuella filer, en per partitursida, med ett bindestreck följt av sidnummer innan filändelsen, kommer att genereras.

spos

segmentpositioner (XML)

svg

scalable vector graphics (bild)

wav

RIFF Waveform (okoprimerat ljud)

xml

okomprimerad MusicXML-fil

Se nedanför för exempel.

MILJÖ

SKIP_LIBJACK: Sätt detta (värdet har ingen betydelse) för att hoppa över initialisering av biblioteket JACK Audio Connection Kit, om det skulle orsaka problem.
XDG_CONFIG_HOME: Plats för användarkonfigurationsfiler; standard är ~/.config om variabeln inte sätts.
XDG_DATA_HOME: Plats för användardata; standard är ~/.local/share om variabeln inte sätts.

Observera att MuseScore också stödjer normala Qt-miljövariabler som QT_QPA_GENERIC_PLUGINS, QT_QPA_PLATFORM, QT_QPA_PLATFORMTHEME, QT_QPA_PLATFORM_PLUGIN_PATH, QT_STYLE_OVERRIDE, DISPLAY, osv.

FILER

/usr/share/mscore-4.0/ innehåller programmets supportdata (demo-filer, instrument, översättningar, systemomfattande insticksprogram, soundfonts, stilar, ackord, mallar och bakgrundsbilder). I Debian-paketen installeras systemomfattande soundfonts istället i /usr/share/sounds/sf2/, /usr/share/sounds/sf3/ respektive /usr/share/sounds/sfz/.

Användarspecifik data (utökningar, insticksprogram, soundfonts, stilar, mallar) och filer (bilder, partitur) installeras normalt i undermappar under ~/MuseScore4/, men kan ändras i konfigurationen. Observera att ögonblicksbilder, alfa- och betaversioner använder MuseScore4Development istället för MuseScore4t i samtliga av dessa sökvägar.

$XDG_CONFIG_HOME/MuseScore/MuseScore4.ini innehåller användarinställningarna, listan över senast använda filer och deras sökvägar, fönsterstorlekar och positioner, osv. Se ovanför för sökvägar för utvecklingsversioner.

$XDG_DATA_HOME/data/MuseScore/MuseScore4/ innehåller uppdaterade översättningsfiler som laddas ned inuti programmet, information om insticksprogram, mellanlagrade partitur, inloggningsinformation för gemenskapssidan musescore.com, sessionsinformation, syntinställningar, egna ton- och taktarter och kortkommandon. Se ovanför för sökvägar för utvecklingsversioner.

EXEMPEL

Konvertera ett partitur till PDF från kommandoraden

mscore -o 'Min musik.pdf' 'Min musik.mscz'

Kör ett batch-jobb för att konvertera flera dokument

mscore -j jobb.json

Detta kräver och förutsätter att filen jobb.json finns i den aktiva arbetsmappen med ett innehåll som liknar det följande:

[
    {
        "in": "Minmusik1.mscz",
        "out": "Minmusik1.pdf"
    },
    {
        "in": "Minmusik2.mscz",
        "plugin": "colornotes.qml",
        "out": [
            "Minmusik2-notecolors.pdf",
            "Minmusik2-notecolors.svg"
        ]
    },
    {
        "in": "Minmusik3.mscz",
        "out": [
            "Minmusik3.pdf",
            "Minmusik3.musicxml",
            "Minmusik3.mid",
            [
                "Minmusik3 (",
                "stämma).pdf"
            ]
        ]
    }
]

Om Minmusik3.mscz innehåller utdrag (instrumentstämmor) kommer syntaxen ovan att leda till att filer som “Minmusik3 (Violinstämma).pdf” skapas tillsammans med dirigentens PDF- och MusicXML-filer, såväl som en MIDI-fil med det fullständiga orkesterljudet. Om Minmusik3.mscz inte har definierade utdrag kommer bara dirigentens PDF-filer, MusicXML-filer, och orkester-MIDI-filer att genereras, medan begäran för PDF-filer för stämmor ignoreras utan varningar.

MIDI-importåtgärder

Den bifogade midi_import_options.xml är en exempelfil med MIDI-importåtgärder för alternativet -M.

DIAGNOSTIK

Verktyget mscore ger avslutskod 0 när det är färdigt, och >0 om ett fel inträffar.

SE ÄVEN

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

https://musescore.org/handbook: Online-Handbok, fullständig användarmanual
https://musescore.org/forum: Hjälpforum
https://musescore.org/en/node/278582: Återställ till fabriksinställningar (problemlösning)
https://github.com/musescore/MuseScore/issues: Projektets ärendehantering —Kontrollera gärna här först för att se om felet du upptäckt redan har rapporterats. Om du bara behöver hjälp med något, använd istället hjälpforumet.
http://doc.qt.io/qt-5/qguiapplication.html#supported-command-line-optio…: Dokumentation för automatiska Qt-kommandoradsalternativ

STANDARDER

MuseScore försöker implementera följande standarder:

MusicXML 3.1 (format för att dela partitur)
SF2 (SoundFont 2.01)
SF3 (SoundFont med OGG Vorbis-komprimerade samplingar)
SFZ (Sforzato-soundfont)
SMuFL (Standard Music Font Layout 1.20)

HISTORIK

MuseScore grenade av från MusE-sekvenseraren år 2002, och har sedan dess blivit det främsta notationsprogrammet med öppen källkod.

UPPHOVSMÄN

MuseScore utvecklas av MuseScore BVBA och andra.

Den här manualsidan skrevs av mirabilos <tg@debian.org>.

PROBLEM

De automatiska Qt-kommandoradsalternativen tas bort från argumentvektorn innan programmet får en chans att behandla dem; detta innebär att ett anrop som mscore -S -reverse aldrig kan fungera eftersom -reverse först tas bort av Qt.

FEL

MuseScore Studio följer inte /etc/papersize.
Förmodligen ett par till; se projektets ärendehantering (hänv. SE ÄVEN).