Ubuntu Manpage: mkvpropedit - Endre egenskapene til eksisterende Matroska filer uten en fullstendig demultipleksing

NAME

       mkvpropedit - Endre egenskapene til eksisterende Matroska filer uten en fullstendig demultipleksing

SAMMENDRAG

       mkvpropedit [alternativer] {kildefilnavn} {handlinger}

BESKRIVELSE

Dette programmet analyserer en eksisterende Matroska fil og endrer noen av dens egenskaper. Deretter
skriver den disse endringene til den eksisterende filen. Blant egenskapene som kan endres, er
segmentinformasjonselementene (f.eks. tittelen) og spordatahodene (f.eks. språkkoden,
'standardspor'-flagget eller navnet).

Alternativer:

-l, --list-property-names
Viser alle kjente og redigerbare egenskapsnavn, deres type (streng, heltall, boolsk osv.) og en kort
beskrivelse. Programmet avsluttes etterpå. Parameteren kilde-filnavn trenger derfor ikke å angis.

-p, --parse-mode modus
Angir analysemodusen. Parameteren 'modus' kan enten være 'fast' (som også er standard) eller 'full'.
'Rask'-modus analyserer ikke hele filen, men bruker metasøkelementene for å finne de nødvendige
elementene i en kildefil. I 99% av alle tilfeller er dette nok. Men for filer som ikke inneholder
metasøkingselementer eller som er skadet, må brukeren kanskje sette "full"-analysemodus. En full
skanning av en fil kan ta et par minutter, mens en rask skanning bare tar sekunder.

Handlinger som omhandler egenskaper for spor- og segmentinformasjon:

-e, --edit selektor
Angir Matroska fildelen (segmentinformasjon eller datahodene til et bestemt spor) som alle
etterfølgende legg til, angi og slett-handlinger fungerer på. Dette alternativet kan brukes flere
ganger for å gjøre endringer i mer enn ett element.

Som standard vil mkvpropedit(1) redigere segmentinformasjonsdelen.

Se avsnittet om rediger-selektorer for en fullstendig beskrivelse av syntaksen.

-a, --add navn=verdi
Legger til en egenskap navn med verdien verdi. Egenskapen vil bli lagt til selv om en slik egenskap
allerede eksisterer. Vær oppmerksom på at de fleste egenskaper er unike og ikke kan forekomme mer enn
én gang.

-s, --set navn=verdi
Setter alle forekomster av egenskapen navn til verdien verdi. Hvis ingen slik egenskap eksisterer,
vil den bli lagt til.

-d, --delete navn
Sletter alle forekomster av egenskapen navn. Vær oppmerksom på at enkelte egenskaper er obligatoriske
og ikke kan slettes.

Handlinger som omhandler tagger og kapitler:

-t, --tags selektor:filnavn
Legg til eller erstatt tagger i filen med de fra filnavnet, eller fjern dem hvis filnavnet er tomt.
mkvpropedit(1) leser det samme XML-taggformatet som mkvmerge(1) leser også.

Selektoren må være et av ordene all, global eller track. For all vil mkvpropedit(1) erstatte eller
fjerne alle tagger i en fil. Med global vil bare globale tagger bli erstattet eller fjernet.

Med track vil mkvpropedit(1) erstatte tagger for et bestemt spor. I tillegg vil taggene som leses fra
filnavn bli tilordnet samme spor. Sporet spesifiseres på samme måte som rediger-selektorer
spesifiseres (se nedenfor), f.eks. --tags track:a1:nye-lyd-tagger.xml.

--add-track-statistics-tags
Beregner statistikk for alle spor i en fil og legger til nye statistikktagger for dem. Hvis filen
allerede inneholder slike tagger, blir de oppdatert.

--delete-track-statistics-tags
Sletter alle eksisterende sporstatistikktagger fra en fil. Hvis filen ikke inneholder
sporstatistikktagger, blir den ikke endret.

-c, --chapters filnavn
Legg til eller erstatt kapitler i filen med de fra filnavnet, eller fjern dem hvis filnavnet er tomt.
mkvpropedit(1) leser samme XML og enkle kapittelformater som mkvmerge(1) også leser.

Handlinger for håndtering av vedlegg:

--add-attachment filnavn
Legg til et nytt vedlegg fra filnavn.

Hvis alternativet --attachment-name har blitt brukt før dette alternativet, brukes verdien som navnet
på det nye vedlegget. Ellers er det avledet fra filnavn.

Hvis alternativet --attachment-mime-type er brukt før dette alternativet, brukes verdien som
MIME-typen for det nye vedlegget. Ellers oppdages det automatisk fra innholdet i filnavnet.

Hvis alternativet --attachment-description har blitt brukt før dette alternativet, brukes verdien som
beskrivelsen av det nye vedlegget. Ellers vil ingen beskrivelse bli satt.

Hvis alternativet --attachment-uid har blitt brukt før dette alternativet, brukes verdien som det nye
vedleggets UID. Ellers genereres en tilfeldig UID automatisk.

--replace-attachment selektor:filnavn
Erstatter ett eller flere vedlegg som samsvarer selektor med filen filnavn. Hvis mer enn ett
eksisterende vedlegg samsvarer med selektor, erstattes alt innholdet av innholdet i filnavnet.

Selektoren kan ha en av fire former. De er forklart nedenfor i avsnittet vedlegg-selektorer.

Hvis alternativet --attachment-name har blitt brukt før dette alternativet, angis verdien som det nye
navnet for hvert endret vedlegg. Ellers endres ikke navnene.

Hvis alternativet --attachment-mime-type har blitt brukt før dette alternativet, angis verdien som
den nye MIME-typen for hvert endret vedlegg. Ellers endres ikke MIME-typene.

Hvis alternativet --attachment-description har blitt brukt før dette alternativet, angis verdien som
den nye beskrivelsen for hvert modifisert vedlegg. Ellers endres ikke beskrivelsene.

Hvis alternativet --attachment-uid har blitt brukt før dette alternativet, angis verdien som den nye
UID-en for hvert endrede vedlegg. Ellers endres ikke UID-ene.

--update-attachment selektor
Angir egenskapene for ett eller flere vedlegg som samsvarer med selektoren. Hvis mer enn ett
eksisterende vedlegg samsvarer med selektoren, oppdateres alle egenskapene.

Selektoren kan ha en av fire former. De er forklart nedenfor i avsnittet vedlegg-selektorer.

Hvis alternativet --attachment-name har blitt brukt før dette alternativet, angis verdien som det nye
navnet for hvert endret vedlegg. Ellers endres ikke navnene.

Hvis alternativet --attachment-mime-type har blitt brukt før dette alternativet, angis verdien som
den nye MIME-typen for hvert endret vedlegg. Ellers endres ikke MIME-typene.

Hvis alternativet --attachment-description har blitt brukt før dette alternativet, angis verdien som
den nye beskrivelsen for hvert modifisert vedlegg. Ellers endres ikke beskrivelsene.

Hvis alternativet --attachment-uid har blitt brukt før dette alternativet, angis verdien som den nye
UID-en for hvert endrede vedlegg. Ellers endres ikke UID-ene.

--delete-attachment selektor
Sletter ett eller flere vedlegg som samsvarer med selektoren.

Selektoren kan ha en av fire former. De er forklart nedenfor i avsnittet vedlegg-selektorer.

Alternativer for vedleggshandlinger:

--attachment-name navn
Angir navnet som skal brukes for følgende --add-attachment- eller --replace-attachment-operasjon.

--attachment-mime-type mime-type
Angir MIME-typen som skal brukes for følgende --add-attachment- eller --replace-attachment-operasjon.

--attachment-description beskrivelse
Angir beskrivelsen som skal brukes for følgende --add-attachment- eller
--replace-attachment-operasjon.

--enable-legacy-font-mime-types
Aktiverer bruk av eldre MIME-typer for visse typer skriftvedlegg. For eksempel vil
'application/x-truetype-font' bli brukt for TrueType-fonter i stedet for 'fonts/ttf'.

Dette påvirker både å legge til nye vedlegg og erstatte eksisterende vedlegg, men bare hvis den nye
MIME-typen ikke er angitt. Andre eksisterende vedlegg endres ikke.

De berørte MIME-typene er 'font/sfnt', 'font/ttf' og 'font/collection' som alle er tilordnet
'application/x-truetype-fonts' og 'font/otf' som er tilordnet 'application/vnd' .ms-opentype'.

Andre alternativer:

--disable-language-ietf
Vanligvis når brukeren ber om endringer i 'language'-spordatahodet-egenskapen, vil mkvpropedit(1)
anvende den samme endringen på det nye LanguageIETF-spordatahodeelementet i tillegg til det eldre
Language-elementet. Hvis dette alternativet brukes, blir endringen bare brukt på det eldre
Language-elementet.

Dette alternativet påvirker ikke endringer forespurt via spordatahodeegenskapen 'language-ietf'.

--normalize-language-ietf modus
Gjør det mulig å normalisere alle IETF BCP 47-språktagger til enten deres kanoniske form med modus
'kanonisk', til deres utvidede språkundertagger dannes med modus 'extlang' eller slår den av med
modus 'av'. Som standard brukes normalisering til den kanoniske formen.

I kanonisk form erstattes alle undertagger som det finnes foretrukne verdier for, med de foretrukne
verdiene. Dette konverterer for eksempel 'zh-yue-jyutping' til 'yue-jyutping' eller 'fr-FX' til
'fr-FR'.

For undertaggene for utvidet språk bygges den kanoniske formen først. Deretter erstattes alle
primærspråk som det finnes en utvidet språkundertagg for, med den utvidede språkundertaggen og
prefikset. Dette konverterer for eksempel 'yue-jyutping' tilbake til 'zh-yue-jyutping', men har ingen
effekt på 'fr-FR' da 'fr' ikke er en undertagg for utvidet språk.

Denne normaliseringen anvendes bare på elementer som faktisk endres:

• Når du redigerer spordatahoder, påvirkes bare sporspråkelementene som angis via
redigeringsspesifikasjoner. Språk for spor som ikke redigeres, endres ikke. Hvis du redigerer et
spor, men bare angir andre egenskaper enn språket, påvirkes heller ikke språket.

• Når du redigerer kapitler, påvirkes alle språkelementer i alle kapittelelementene, da
eksisterende kapitler alltid erstattes fullstendig.

• Når du redigerer tagger, påvirkes bare språkelementene i taggene som faktisk erstattes. Når du
for eksempel erstatter globale tagger, påvirkes ikke eksisterende sportagger.

Den beste måten å normalisere alle eksisterende språktagger i en fil er å multiplekse den med
mkvmerge(1) og sette alternativet '--normalize-language-ietf' til ønsket modus.

--command-line-charset character-set
Angir tegnsettet for å konvertere strenger fra gitt på kommandolinjen. Den er standard til tegnsettet
gitt av systemets gjeldende lokalitet.

--output-charset character-set
Angir tegnsettet som strenger konverteres til som skal sendes ut. Den er standard til tegnsettet gitt
av systemets gjeldende lokalitet.

-r, --redirect-output filnavn
Skriver alle meldinger til filen filnavn i stedet for til konsollen. Selv om dette kan gjøres enkelt
med omdirigering av utdata, er det tilfeller der dette alternativet er nødvendig: når terminalen
tolker utdataene på nytt før du skriver den til en fil. Tegnsettet angitt med --output-charset er
hedret.

--ui-language kode
Tvinger oversettelsene for språk- koden som skal brukes (eks. 'de_DE' for tyske oversettelser). Ved å
skrive inn 'list' som koden vil føre til at programmet sender ut en liste over tilgjengelige
oversettelser.

--abort-on-warnings
Ber programmet om å avbryte etter at den første advarselen er sendt ut. Programmets avslutningskode
vil være 1.

--debug emne
Slå på feilsøking for en bestemt funksjon. Dette alternativet er bare nyttig for utviklere.

--engage funksjon
Slå på eksperimentelle funksjoner. En liste over tilgjengelige funksjoner kan bes med mkvpropedit
--engage-list. Disse funksjonene er ikke ment å brukes i normale situasjoner.

--gui-mode
Slår på det grafiske grensesnittet. I denne modusen kan spesialformaterte linjer være utdata som kan
fortelle et kontrollerende grafisk grensesnitt hva som skjer. Disse meldingene følger formatet
'#GUI#melding'. Meldingen kan etterfølges av nøkkel/verdipar som i
'#GUI#melding#nøkkel1=verdi1#nøkkel2=verdi2...'. Verken meldingene eller nøklene blir noen gang
oversatt og sendes alltid ut på engelsk.

-v, --verbose
Vær detaljert og vis alle de viktige Matroska elementene mens de leses.

-h, --help
Vis bruksinformasjon og avslutt.

-V, --version
Vis versjonsinformasjon og avslutt.

@alternativer-fil.json
Leser flere kommandolinjeargumenter fra filen alternativer-fil. Hvis du vil ha en fullstendig
forklaring på hvilke formater som støttes for slike filer, kan du se avsnittet "Alternativfiler" i
mkvmerge(1) manualside.

REDIGER-SELEKTORER

--edit-alternativet angir Matroska fildelen (segmentinformasjon eller datahodene til et bestemt spor) som
alle følgende add, set og delete handlinger opererer på. Dette forblir gyldig til neste
--edit-alternativet er funnet. Argumentet til dette alternativet kalles redigeringsselektoren.

Som standard vil mkvpropedit(1) redigere segmentinformasjonsdelen.

Segmentinformasjon
Segmentinformasjonen kan velges med ett av disse tre ordene: 'info', 'segment_info' eller 'segmentinfo'.
Den inneholder egenskaper som segmenttittelen eller segment-UID-en.

Spordatahoder
Spordatahoder kan velges med en litt mer kompleks selektor. Alle varianter starter med 'track:'.
Egenskapene for sporhodet inkluderer elementer som språkkoden, 'standardspor'-flagget eller sporets navn.

track:n
Hvis parameteren n er et tall, velges det n-te sporet. Sporrekkefølgen er den samme som mkvmerge(1)s
--identify-alternativutdata.

Nummereringen starter på 1.

track:tn
Hvis parameteren starter med ett enkelt tegn t etterfulgt av en nvil n-te spor av en bestemt sportype
vil bli valgt. Parameteren for sportype t må være en av disse fire tegnene: 'a' for et lydspor, 'b'
for et knappsor, 's'for et undertekstspor og 'v' for et videospor. Sporrekkefølgen er den samme som
mkvmerge(1)'s --identify-alternativet sender ut.

Nummereringen starter på 1.

track:=uid
Hvis parameteren starter med en '=' etterfulgt av en tall-uid, vil sporet hvis spor-UID-element
tilsvarer den gitte uid-en, velges. Spor-UID-er kan fås med mkvinfo(1).

track:@tall
Hvis parameteren starter med et '@' etterfulgt av et tallnummer, vil sporet hvis spornummerelement
tilsvarer dette nummeret bli valgt. Spornumre kan fås med mkvinfo(1).

Merknader
På grunn av sporredigeringsvelgernes natur er det mulig at flere selektorer faktisk samsvarer med de
samme spordatahodene. I slike tilfeller vil alle handlinger for disse redigeringsvelgerne bli kombinert
og utført i den rekkefølgen de er gitt på kommandolinjen.

VEDLEGGSVELGERE

       En vedleggsvelger brukes med de to handlingene --replace-attachment og --delete-attachment. Den kan ha en
       av følgende fire former:

        1. Valg etter vedleggs-ID. I denne formen er velgeren ganske enkelt et tall, vedleggets ID som sendt ut
           av mkvmerge(1)s identifikasjonskommando.

        2. Valg etter vedlegg-UID (unik ID). I denne formen er velgeren likhetstegnet = etterfulgt av et tall,
           vedleggets unike ID som utdata av mkvmerge(1)s ordrike identifikasjonskommando.

        3. Valg etter vedleggsnavn. I denne formen er velgeren det bokstavelige navnet: etterfulgt av det
           eksisterende vedleggets navn. Hvis denne velgeren brukes med --replace-attachment, må kolon i navnet
           som skal samsvare, unnslippes som \c.

        4. Valg etter MIME-type. I denne formen er velgeren det bokstavelige ordet mime-type: etterfulgt av det
           eksisterende vedleggets MIME-type. Hvis denne velgeren brukes med --replace-attachment, må koloner
           innenfor MIME-typen for å matche unnslippes som \c.

SPRåKHåNDTERING

mkvpropedit(1) prøver for det meste å gjøre det rette som standard. Derfor vil endringer i
language-egenskapen føre til at mkvpropedit(1) anvender den samme endringen på både det nye
"LanguageIETF"-elementet og det gamle "Language"-elementet på samme måte som mkvmerge(1) bruker språket
på begge elementene. For eksempel, når du bruker mkvpropedit film.mkv --edit track: 2 --set language =
zh-TW, vil "LanguageIETF" -elementet bli satt til zh-TW og det gamle "Language" -elementet til chi.

I tillegg er det en ny spordatahodeegenskap kalt language-ietf som kan settes eller fjernes. Endringer i
denne egenskapen gjelder kun for det nye "LanguageIETF"-sporhodeelementet. En advarsel er at det gamle
"Language" spordatahodeelementet er et obligatorisk element i Matroska - noe som betyr at selv om det
ikke er til stede i filen, har det fortsatt en underforstått verdi. Når brukeren bare setter
language-ietf-egenskapen, men ikke språkegenskapen, vil mkvpropedit(1) vil derfor legge til det gamle
"language"-elementet i visse tilfeller & sette den til und (som betyr "ubestemt") siden brukeren ikke
spesifiserte en verdi for den.

Når du leser XML-kapittel eller taggfiler fungerer mkvpropedit(1) som mkvmerge(1) gjør.

Opprettelsen av de nye elementene kan deaktiveres helt med kommandolinjealternativet
'--disable-language-ietf' som opererer på alle tre nye elementene.

Du kan velge normaliseringsmetoden som brukes på utvidede språkundertagger med parameteren
--normalize-language-ietf.

EKSEMPLER

       Følgende eksempel redigerer en fil kalt 'film.mkv'. Den angir segmenttittelen og endrer språkkoden til en
       lyd og et undertekstspor. Merk at dette eksemplet kan forkortes ved å utelate det første
       --edit-alternativet fordi redigering av segmentinformasjonselementet er standard for alle alternativene
       som finnes før det første --edit-alternativet uansett.

           $ mkvpropedit film.mkv --edit info --set "title=Filmen" --edit track:a1 --set language=fre --edit track:a2 --set language=ita

       Det andre eksemplet fjerner 'standard sporflagg' fra det første undertekstsporet og angir det for det
       andre. Merk at mkvpropedit(1), i motsetning til mkvmerge(1), ikke setter 'standard sporflagg' for andre
       spor til '0' hvis den er satt til '1' for et annet spor automatisk.

           $ mkvpropedit film.mkv --edit track:s1 --set flag-default=0 --edit track:s2 --set flag-default=1

       Bytting av taggene for det andre undertekstsporet i en fil ser slik ut:

           $ mkvpropedit film.mkv --tags track:s2:nye-undertekst-tagger.xml

       Hvis du fjerner alle tagger, må du utelate filnavnet:

           $ mkvpropedit film.mkv --tags all:

       Erstatte kapitlene i en fil ser slik ut:

           $ mkvpropedit film.mkv --chapters nye-kapitler.xml

       Fjerning av alle kapitler krever at du utelater filnavnet:

           $ mkvpropedit film.mkv --chapters ''

       Legge til en fontfil (Arial.ttf) som et vedlegg:

           $ mkvpropedit film.mkv --add-attachment Arial.ttf

       Legge til en fontfil (89719823.ttf) som et vedlegg og gi litt informasjon siden det egentlig bare er
       Arial:

           $ mkvpropedit film.mkv --attachment-name Arial.ttf --attachment-description 'Arial-skriften som en TrueType skrift' --attachment-mime-type application/x-truetype-font --add-attachment 89719823.ttf

       Bytte ut en vedlagt font (Comic.ttf) fil med en annen (Arial.ttf):

           $ mkvpropedit film.mkv --attachment-name Arial.ttf --attachment-description 'Arial-skrift som en TrueType skrift' --replace-attachment name:Comic.ttf:Arial.ttf

       Sletting av den andre vedlagte filen, uansett hva den måtte være:

           $ mkvpropedit film.mkv --delete-attachment 2

       Sletter alle vedlagte skrifter etter MIME-type:

           $ mkvpropedit film.mkv --delete-attachment mime-type:application/x-truetype-font

AVSLUTNINGSKODER

       mkvpropedit(1) avsluttes med en av tre avslutningskoder:

       •   0 -- Denne avslutningskoden betyr at endringen er fullført.

       •   1 -- I dette tilfellet har mkvpropedit(1) sendt ut minst en advarsel, men endringen fortsatte. En
           advarsel er prefikset med teksten 'Advarsel:'. Avhengig av problemene som er involvert, kan de
           resulterende filene være ok eller ikke. Brukeren oppfordres til å sjekke både advarselen og
           resultatfilene.

       •   2 -- Denne avslutningskoden brukes etter at det oppstod en feil.  mkvpropedit(1) avbryter rett etter
           at feilmeldingen er sendt ut. Feilmeldinger varierer fra feil kommandolinjeargumenter over
           lese-/skrivefeil til ødelagte filer.

TEKSTFILER OG TEGNSETTKONVERTERINGER

       For en grundig diskusjon om hvordan alle verktøyene i MKVToolNix-pakken håndterer tegnsettkonverteringer,
       inndata- / utdatakoding, kommandolinjekoding og konsollkoding, se delen med identisk navn i mkvmerge(1)
       manualsiden.

MILJøVARIABLER

       mkvpropedit(1) bruker standardvariablene som bestemmer systemets lokalitet (for eksempel LANG og
       LC_*-familien). Ytterligere variabler:

       MKVPROPEDIT_DEBUG, MKVTOOLNIX_DEBUG og dens korte form MTX_DEBUG
           Innholdet behandles som om det hadde blitt sendt via --debug-alternativet.

       MKVPROPEDIT_ENGAGE, MKVTOOLNIX_ENGAGE og dens korte form MTX_ENGAGE
           Innholdet behandles som om det hadde blitt sendt via --engage-alternativet.

SE OGSå

       mkvmerge(1), mkvinfo(1), mkvextract(1), mkvtoolnix-gui(1)

WWW

       Den nyeste versjonen finner du alltid på MKVToolNixs hjemmeside[1].

AUTHOR

       Moritz Bunkus <moritz@bunkus.org>
           Utvikler

NOTES

        1. MKVToolNixs hjemmeside
           https://mkvtoolnix.download/