Commandoregelinterface
Breng OpenShot in je commandoregelworkflow. Importeer beeldmateriaal, knip en rangschik clips, pas effecten toe, animeer eigenschappen met keyframes en exporteer video’s vanuit je terminal. Gebruik een paar commando’s om repetitieve bewerkingen te automatiseren, schrijf een script voor een terugkerend project, of laat een AI-agent helpen bij het samenstellen en verfijnen van een video.
De commandoregel werkt met dezelfde projecten als de editor. Je kunt een geopende editor bedienen en wijzigingen direct bekijken, of werken in een headless sessie zonder een venster te openen. Een sessie houdt je project open tussen commando’s, inclusief bewerkingen, geschiedenis van ongedaan maken en exporttaken. Sla het op als een .osp-project wanneer je later verder wilt bewerken.
Aan de slag
Gebruik je geïnstalleerde OpenShot-uitvoerbaar bestand gevolgd door --cli. Begin met intro voor een korte gids over sessies, bewerken, animatie en opslaan, of help voor een overzicht van commando’s. Deze commando’s hebben geen actieve sessie nodig. De onderstaande voorbeelden vereisen een OpenShot-build die commandoregelbewerking ondersteunt.
Linux AppImage
Vanaf de map met je gedownloade AppImage:
./OpenShot.AppImage --cli intro
./OpenShot.AppImage --cli help
Vervang OpenShot.AppImage door je gedownloade bestandsnaam. Als AppImageLauncher dialoogvensters voor desktopintegratie toont, stel dan APPIMAGELAUNCHER_DISABLE=1 in voordat je het commando uitvoert:
APPIMAGELAUNCHER_DISABLE=1 ./OpenShot.AppImage --cli intro
Voor scripts of herhaalde commando’s, stel het één keer in je huidige shell in:
export APPIMAGELAUNCHER_DISABLE=1
./OpenShot.AppImage --cli session start
De variabele moet worden ingesteld voordat je de AppImage start: AppImageLauncher kan deze onderscheppen voordat OpenShot --cli ontvangt. Relatieve mediapaden en @batch.json-bestanden worden opgelost vanuit je werkmap. Houd het AppImage-bestand beschikbaar zolang sessies of exports actief zijn.
Linux Snap
Voor de OpenShot Snap, gebruik:
snap run openshot-qt --cli intro
snap run openshot-qt --cli help
snap run openshot-qt --cli session start
De bestandsrechten van Snap gelden ook voor commandoregelbewerking. Bewaar media, projecten en exports op locaties waar Snap toegang toe heeft, zoals je thuismap. Om toegang tot externe schijven toe te staan, verbind je de removable-media permissie:
sudo snap connect openshot-qt:removable-media
Windows
Belangrijk
Gebruik openshot-qt-cmd.exe voor commandoregelbewerking op Windows. Dit console-uitvoerbare bestand toont commandoresultaten, hulp en fouten in je terminal. Het desktop-uitvoerbare bestand, openshot-qt.exe, toont geen standaarduitvoer in een interactieve terminal, waardoor commando’s geen zichtbare feedback geven en de CLI moeilijk te gebruiken is.
In PowerShell, vanuit de OpenShot-installatiemap:
& .\openshot-qt-cmd.exe --cli intro
& .\openshot-qt-cmd.exe --cli help
& .\openshot-qt-cmd.exe --cli session start
Als je in een andere map bent, gebruik dan het volledige pad naar openshot-qt-cmd.exe. Houd --cli achter de naam van het uitvoerbare bestand.
macOS
Voor een installatie in Applications:
"/Applications/OpenShot Video Editor.app/Contents/MacOS/openshot-qt" --cli intro
"/Applications/OpenShot Video Editor.app/Contents/MacOS/openshot-qt" --cli help
Commando’s vinden
In deze gids is openshot-cli een afkorting voor het commando van jouw installatie hierboven, zoals snap run openshot-qt --cli of ./OpenShot.AppImage --cli. Sommige installaties bieden ook direct een openshot-cli commando. Bij uitvoering vanuit de broncode, gebruik python3 src/launch.py --cli in de Python-omgeving van OpenShot.
Alleen --cli, --cli help en --cli --help tonen hetzelfde overzicht. Hulp wordt specifieker naarmate je door commando’s navigeert:
openshot-cli clip help
openshot-cli clip keyframe help
openshot-cli clip keyframe set help
openshot-cli edit help
openshot-cli text help
openshot-cli effects list
openshot-cli effects audiovisualization help
openshot-cli effects audiovisualization help --property background
Groepshulp legt workflows uit met voorbeelden; operationele hulp beschrijft argumenten en gedrag. --help is gelijk aan het achtervoegsel help. Alle hulpcommando’s werken zonder een bewerksessie.
effects list toont de beschikbare effecten met korte beschrijvingen. Effecthulp legt hun eigenschappen, standaardwaarden, keuzes en bereiken uit. effects instances toont effecten die al aan clips zijn gekoppeld, met ID’s van de bovenliggende clips. Klassennamen, weergavenamen en underscore-aliases identificeren hetzelfde effect.
Werken met scripts en AI-agents
AI-codeeragents zoals Codex en Claude Code kunnen de CLI gebruiken om OpenShot-projecten te inspecteren en te bewerken via terminalcommando’s. Geef je agent het pad naar je OpenShot-uitvoerbaar bestand, de media of het project om mee te werken, en het gewenste resultaat: duur, afmetingen, animatiestijl en uitvoerlocatie. Vraag het om --cli intro te lezen voordat het begint. Dezelfde commando’s werken wanneer je ze zelf typt of vanuit een script uitvoert.
Begin met intro, gebruik daarna commando-specifieke hulp indien nodig. Een nuttige workflow is het selecteren van een sessie, het inspecteren van het project, het aanbrengen van een kleine set wijzigingen, het beoordelen van het resultaat en opslaan. Commando’s geven gestructureerde JSON terug zodat scripts en agents object-ID’s en resultaten direct kunnen gebruiken in plaats van schermuitvoer te interpreteren.
Inspecteer voordat je bewerkt. Gebruik geretourneerde ID’s en eigenschapsinformatie in plaats van namen, tracknummers of timing te raden. Selecteer een sessie expliciet wanneer meer dan één project open is.
Groeperen van herhaalde bewerkingen. Gebruik
edit applyvoor een reeks wijzigingen ofedit bulkom een sjabloon toe te passen op geselecteerde clips. Valideer met--dry-runvoordat je een batch toepast.Controleer animatie. Kies een coördinatenruimte, begin met een paar keyframes en gebruik easing-voorinstellingen voor vertrouwde beweging.
keyframe previewbemonstert de curve zodat je pauzes of sprongen kunt zien voordat je exporteert. Bekijk ook de gerenderde beweging; een contactblad alleen kan niet laten zien hoe een animatie aanvoelt.Sla op en volg exports. Sla het project expliciet op en controleer de status van de exporttaak voordat je een uitvoer als voltooid beschouwt. Als een verzoek time-out krijgt, controleer dan de status voordat je een bewerking herhaalt.
De onderstaande secties leggen deze workflows en hun timingconventies uit.
Sessies en uitvoer
Een sessie starten of vinden
Start één headless sessie (zonder editorvenster):
openshot-cli session start
Om een bestaand project bij het opstarten te openen, voeg toe --project "/pad/project.osp". De succesvolle JSON-respons bevat result.session_id. Kopieer die waarde. Als OpenShot al draait of je de ID bent vergeten, vind beschikbare sessies met:
openshot-cli session list
Kies de sessie voor het project dat je wilt bewerken. Je hoeft niet voor elke opdracht een nieuwe sessie te starten.
Een sessie selecteren
Tip
Stel OPENSHOT_SESSION één keer in en voer daarna opdrachten normaal uit. Je terminal onthoudt de geselecteerde sessie, dus je hoeft niet bij elke opdracht --session mee te geven. Gebruik het onderstaande PowerShell- of Bash-voorbeeld.
Vervang SESSION_ID hieronder door de session_id die wordt teruggegeven door session start of session list.
Windows PowerShell:
$env:OPENSHOT_SESSION = "SESSION_ID"
& .\openshot-qt-cmd.exe --cli timeline view
& .\openshot-qt-cmd.exe --cli export start "C:\path\test.mp4" --wait
Linux Bash:
export OPENSHOT_SESSION="SESSION_ID"
./OpenShot.AppImage --cli timeline view
./OpenShot.AppImage --cli export start "/path/test.mp4" --wait
Gebruik op macOS dezelfde export-syntaxis. Voor macOS- of Snap-opdrachten vervang je het uitvoerbare bestand door dat van jouw installatie uit Aan de slag. De selectie geldt voor deze terminal en opdrachten die ervan worden gestart. Stel het opnieuw in in een nieuwe terminal of werk het bij bij het wisselen naar een andere sessie.
De resterende voorbeelden voor bewerken en exporteren gaan ervan uit dat OPENSHOT_SESSION is ingesteld. De volgende subsectie laat zien hoe je de ID automatisch kunt vastleggen voor scripts.
Om een andere sessie te gebruiken voor slechts één opdracht, gebruik --session. Dit overschrijft OPENSHOT_SESSION zonder de selectie van je terminal te wijzigen:
openshot-cli --session OTHER_SESSION_ID project get
Bij een verpakt uitvoerbaar bestand plaats je deze override na --cli en vóór de opdrachtgroep: --cli --session ANDERE_SESSIE_ID project get.
Automatische selectie werkt alleen als er precies één bereikbare sessie bestaat. Als je session_required ziet, voer dan session list uit en selecteer expliciet de bedoelde sessie. Als deze niet meer wordt weergegeven, start hem dan opnieuw en gebruik de nieuwe ID. Help, intro en sessie-ontdekking vereisen geen geselecteerde sessie.
De sessie-ID automatisch vastleggen
Scripts kunnen result.session_id direct lezen uit de JSON die wordt teruggegeven door session start en OPENSHOT_SESSION instellen voor volgende opdrachten. Het is niet nodig om de ID handmatig te kopiëren of een logbestand te lezen. Controleer of het opstarten is gelukt voordat je de teruggegeven ID gebruikt.
Windows PowerShell (stel het pad naar het uitvoerbare bestand van je installatie in):
$openshot = "C:\Program Files\OpenShot Video Editor\openshot-qt-cmd.exe"
$reply = & $openshot --cli session start
if ($LASTEXITCODE -ne 0) { throw "OpenShot session startup failed" }
$session = $reply | ConvertFrom-Json
if (-not $session.ok -or -not $session.result.session_id) {
throw "OpenShot did not return a session ID"
}
$env:OPENSHOT_SESSION = $session.result.session_id
& $openshot --cli timeline view
Linux Bash (vereist jq om JSON te lezen):
openshot="/full/path/to/OpenShot.AppImage"
export APPIMAGELAUNCHER_DISABLE=1
if reply=$("$openshot" --cli session start) &&
session_id=$(printf '%s' "$reply" | jq -er 'select(.ok == true) | .result.session_id | strings | select(length > 0)'); then
export OPENSHOT_SESSION="$session_id"
"$openshot" --cli timeline view
else
echo "OpenShot session startup failed" >&2
fi
De omgevingsvariabele selecteert een sessie voor opdrachten die vanuit deze terminal worden gestart; het verandert geen systeeminstelling. Het starten van een sessie stelt de variabele niet automatisch in. Na het stoppen van de sessie, wis je de selectie met Remove-Item Env:OPENSHOT_SESSION in PowerShell of unset OPENSHOT_SESSION in Bash.
Een sessie tonen en stoppen
Om de geselecteerde sessie in de editor te tonen:
openshot-cli session show
Op een desktop maakt session show de editor aan in hetzelfde proces en behoudt het het live project, ID’s, geschiedenis, exporttaken en verbinding. Herhaalde oproepen brengen het bestaande venster naar voren. session start --show opent het direct. Sessies gestart zonder display, of met QT_QPA_PLATFORM=offscreen/minimal, kunnen later geen desktopvenster tonen. Voor die sessies, sla het project op en open het in een nieuwe desktop-sessie. Zodra het getoond wordt, sluit je de sessie via het editorvenster.
Globale opties (--session, --timeout) komen vóór de opdracht. session serve blijft op de voorgrond voor supervisors; session start keert terug nadat een achtergrondhost zich registreert. session stop weigert niet-opgeslagen wijzigingen en actieve exports. Gebruik --discard alleen om niet-opgeslagen bewerkingen bewust te verwijderen.
Opdrachtuitvoer
Resultaten zijn JSON op stdout, behalve de standaard tekst-tijdlijnweergave. Fouten zijn JSON op stderr met exitstatus 1; argument-parser fouten exit 2. Mutaties geven compacte samenvattingen met een inspect-opdracht. get geeft native object JSON terug. Projectantwoorden bevatten een revisie; effectcatalogusantwoorden vereisen geen sessie. Logs van headless sessies staan naast hun registerrecords. OPENSHOT_SESSION_DIR overschrijft de standaardmap ~/.openshot_qt/sessions.
Sessies accepteren opdrachten lokaal op uw computer. Houd het sessieregister privé, omdat het de referenties bevat die worden gebruikt om toegang te krijgen tot uw bewerksessies. Exporten werken vanuit een momentopname, zodat u kunt blijven bewerken terwijl een taak wordt uitgevoerd.
Projecten openen en opslaan
Een OpenShot-project (.osp) slaat uw bewerkbare tijdlijn op. Exporteren maakt een voltooid video; het opslaan van het project stelt u in staat later terug te keren naar de clips, effecten en keyframes. Sla uw project apart op, zelfs wanneer u ook een video exporteert.
Een project openen
Start een sessie met een bestaand project:
openshot-cli session start --project "/home/me/Videos/My Project.osp"
Voeg --show toe om ook het editorvenster te openen. Om een editor te gebruiken die al draait, vind deze met session list. Stel OPENSHOT_SESSION in op de geretourneerde sessie-ID, en open of inspecteer vervolgens een project:
openshot-cli project open "/home/me/Videos/My Project.osp"
openshot-cli project get
Vervang het voorbeeldpad door uw eigen pad en zet paden met spaties tussen aanhalingstekens. project open vervangt het huidige project van de geselecteerde sessie. Het weigert niet-opgeslagen bewerkingen te verwijderen tenzij u expliciet --discard toevoegt; sla die bewerkingen eerst op als u ze wilt behouden. Openen via de CLI toont geen interactieve dialoogvensters voor ontbrekende media, dus houd de bronmedia van het project beschikbaar.
Voor een nieuw, leeg project gebruikt u session start zonder --project, importeer vervolgens media en voeg clips toe zoals beschreven onder Bewerken.
Een project of een kopie opslaan
Opslaan naar een nieuw bestand, of maak een aparte versie voordat u meer wijzigingen aanbrengt:
openshot-cli project save "/home/me/Videos/My Project v2.osp"
Om een bestaand bestand bij te werken, sta vervanging expliciet toe:
openshot-cli project save "/home/me/Videos/My Project v2.osp" --overwrite
Geef altijd het bestemmingspad op. Het opslaan van een .osp verpakt niet al uw bronmateriaal in dat bestand; houd de verwijzende media beschikbaar bij het verplaatsen of opnieuw openen van het project.
Een video exporteren
Automatiseer het renderen en exporteren vanuit scripts of AI-agents, met gebruik van de projectinstellingen of door voor elke render een ander uitvoerprofiel te kiezen. Exporttaken kunnen op de achtergrond draaien of wachten tot ze voltooid zijn voordat uw script doorgaat. Om een MP4 te renderen met de resolutie en framerate van het project:
openshot-cli export start "/home/me/Videos/video.mp4" --wait
Standaard gebruikt OpenShot H.264 video en AAC audio. Vervang het voorbeeldpad door uw bestemming, gebruik een bestaande map en een nieuwe bestandsnaam. Bestaande uitvoerbestanden worden nooit overschreven. Exporteren slaat uw bewerkbare .osp project niet op; gebruik project save apart om uw bewerkingen te bewaren.
De optie --wait houdt het commando actief totdat de export voltooid is of een fout meldt. Bekijk de voltooide video voordat u deze deelt.
Exportvoortgang controleren
Laat --wait weg om een export op de achtergrond te starten. De reactie bevat een taak-ID die u kunt gebruiken om de voortgang te controleren:
openshot-cli export start "/home/me/Videos/video.mp4"
openshot-cli export status JOB_ID
openshot-cli export status JOB_ID --wait
openshot-cli export list
Vervang JOB_ID door de geretourneerde ID. Als het wachten verloopt, blijft de export doorgaan; controleer dezelfde taak in plaats van een nieuwe export te starten. Om een taak te stoppen, gebruik export cancel JOB_ID. Elke taak legt de tijdlijn vast bij het starten, zodat latere bewerkingen een lopende export niet wijzigen.
Wachten is standaard 600 seconden; pas dit aan met --wait-timeout. Dit is gescheiden van de globale per-aanvraag --timeout. Exportfouten, annuleringen en wachttijdoverschrijdingen stoppen met status 1 en bevatten taakdetails.
Exporteren in meerdere profielen
Exporteer dezelfde tijdlijn in verschillende resoluties of beeldverhoudingen door voor elke uitvoer een exportprofiel te kiezen. Een exportprofiel geldt alleen voor die taak; het verandert het profiel van het bewerkingsproject niet. Een profiel bepaalt afmetingen, framerate en beeldverhouding; een exportpreset selecteert coderingsinstellingen zoals MP4/H.264.
Vind de beschikbare profielen en bekijk hun instellingen:
openshot-cli profile list --search 720
openshot-cli profile list --search 1080
openshot-cli profile get builtin:01280x0720p0030_16-09
Exporteer bijvoorbeeld landschapsversies op 720p en 1080p, en daarna een vierkante versie van 1080 bij 1080. Deze profielen gebruiken allemaal 30 fps:
openshot-cli export start "/home/me/Videos/video-720p.mp4" --profile builtin:01280x0720p0030_16-09 --wait
openshot-cli export start "/home/me/Videos/video-1080p.mp4" --profile builtin:01920x1080p0030_16-09 --wait
openshot-cli export start "/home/me/Videos/video-square.mp4" --profile builtin:01080x1080p0030_01-01 --wait
Gebruik voor elke versie een andere uitvoernaam. Houd bewerkingen ongewijzigd tussen taken als u overeenkomende versies wilt. Het wijzigen van de beeldverhouding kan de compositie veranderen: controleer elke uitvoer, vooral titels en geanimeerde onderwerpen. Voor een apart samengestelde vierkante of portretversie, sla een kopie van het project op, wijzig het projectprofiel en pas de clips aan voordat u exporteert. Zie Profielen en de exportinstellingen hieronder voor aangepaste profielen en coderingsopties.
Batch-export van meerdere projecten
Herbruik één headless sessie om meerdere opgeslagen projecten achter elkaar te renderen. Open een project, exporteer het met --wait, en open dan het volgende project. De onderstaande voorbeelden gebruiken de eigen resolutie en framerate van elk project en maken MP4-bestanden naast de .osp bestanden. Voeg --profile PROFILE_ID toe aan het exportcommando om voor elk project hetzelfde uitvoerprofiel te gebruiken.
Voer eerst het overeenkomende automatische session-ID-voorbeeld hierboven succesvol uit in dezelfde terminal. Het definieert openshot en selecteert de nieuwe sessie. Vervang de projectpaden hieronder door uw eigen paden. Gebruik unieke uitvoernaam die nog niet bestaan; de voorbeelden controleren alle bestemmingen voordat de batch wordt gestart.
Windows PowerShell:
$projects = @(
"C:\VideoProjects\First.osp",
"C:\VideoProjects\Second.osp"
)
foreach ($project in $projects) {
if (-not (Test-Path -LiteralPath $project -PathType Leaf)) {
throw "Project not found: $project"
}
$output = [System.IO.Path]::ChangeExtension($project, ".mp4")
if (Test-Path -LiteralPath $output) { throw "Output already exists: $output" }
}
foreach ($project in $projects) {
$output = [System.IO.Path]::ChangeExtension($project, ".mp4")
& $openshot --cli project open $project
if ($LASTEXITCODE -ne 0) { throw "Could not open: $project" }
& $openshot --cli export start $output --wait --wait-timeout 86400
if ($LASTEXITCODE -ne 0) { throw "Export needs attention: $output" }
}
& $openshot --cli session stop
if ($LASTEXITCODE -ne 0) { throw "Could not stop the session" }
Remove-Item Env:OPENSHOT_SESSION
Linux Bash (de haakjes houden foutafhandeling lokaal binnen de batch):
(
set -e
: "${OPENSHOT_SESSION:?Run the session startup example first}"
projects=(
"/home/me/VideoProjects/First.osp"
"/home/me/VideoProjects/Second.osp"
)
for project in "${projects[@]}"; do
test -f "$project" || { echo "Project not found: $project" >&2; exit 1; }
output="${project%.osp}.mp4"
test ! -e "$output" || { echo "Output already exists: $output" >&2; exit 1; }
done
for project in "${projects[@]}"; do
"$openshot" --cli project open "$project"
"$openshot" --cli export start "${project%.osp}.mp4" --wait --wait-timeout 86400
done
"$openshot" --cli session stop
) && unset OPENSHOT_SESSION
Beide recepten stoppen de batch bij een commando-fout en laten de sessie beschikbaar voor inspectie. De wachttijdlimiet is hier 24 uur per export. Een wachttijdoverschrijding laat de render doorgaan: gebruik export list en export status JOB_ID --wait voordat u het opnieuw probeert. Voltooide video’s blijven op de schijf; verwijder voltooide projecten uit de batch voordat u verdergaat. Stop de sessie en wis de omgevingsvariabele nadat u een fout hebt opgelost.
Voorinstellingen en coderingsinstellingen kiezen
Ontdek de geïnstalleerde exportvoorinstellingen en ondersteunde instellingen:
openshot-cli export preset list
openshot-cli export preset get builtin:format_mp4_x264
openshot-cli export capabilities
openshot-cli export start /tmp/reel.mp4 --preset builtin:format_mp4_x264 --quality med --wait
Export accepteert ook --from-file FILE_ID met optionele --create-custom. Instellingen worden in deze volgorde toegepast: projectstandaarden, voorinstelling, geavanceerde JSON, expliciete profiel/kwaliteit/bereik-vlaggen. Geavanceerde JSON toont video-/audiocodecs en bitrate, audio-indeling/snelheid/kanalen, native codec-opties, hardwareapparaatinstellingen en thread-aantallen.
Selecteer bijvoorbeeld een encoderoptie via geavanceerde JSON:
openshot-cli export start /tmp/small.mp4 --profile builtin:00640x0360p0030_16-09 --json '{"video_options":{"preset":"fast"}}' --wait
Exportinstellingen valideren
Controleer instellingen voordat u een render start:
openshot-cli export validate /tmp/reel.mp4 --preset builtin:format_mp4_x264
Mogelijkhedenrapport toont gecompileerde codec-beschikbaarheid, niet fysieke GPU-beschikbaarheid. Validatie gaat verder: het opent de encoders (inclusief hardware-encoders) en de container met de exacte instellingen, in een apart proces, zonder een bestand te schrijven. Een combinatie die de container niet aankan faalt met incompatible_export, FFmpeg’s eigen uitleg, en de instelling die gewijzigd moet worden (details.cause.path):
openshot-cli export validate /tmp/song.mp3 --json '{"mode":"audio","format":"mp3","audio_codec":"aac"}'
De exportwerker voert dezelfde controle uit vóór het renderen.
Een framebereik renderen
Gebruik --start-frame en --end-frame om een deel van de tijdlijn te renderen. Bereiken zijn inclusief en tellen vanaf 1 bij de FPS van het exportprofiel. Render bijvoorbeeld de eerste 90 frames bij 30 fps (drie seconden):
openshot-cli export start /tmp/excerpt.mp4 --profile builtin:01280x0720p0030_16-09 --start-frame 1 --end-frame 90 --wait
Alleen-audio-exporten en afbeeldingsreeksen
Kies een uitvoermodus met geavanceerde JSON:
openshot-cli export start /tmp/music.wav --json '{"mode":"audio","format":"wav","audio_codec":"pcm_s16le"}' --wait
openshot-cli export start /tmp/frames --json '{"mode":"image_sequence","format":"png"}' --end-frame 3 --wait
Afbeeldingsreeksen vereisen een nieuwe uitvoermap. Bestaande uitvoerbestanden worden nooit overschreven.
Bewerken
Clips en effecten toevoegen
Gebruik de ID’s die worden teruggegeven door importeren/toevoegen/lijst, en ontdek laagnummers met project get:
openshot-cli file import /absolute/path/video.mp4
openshot-cli clip add FILE_ID --layer 2000000 --position 3 --start 10 --end 17 --volume 0
openshot-cli clip set CLIP_ID --json '{"volume":0.5}'
openshot-cli clip keyframe set CLIP_ID --property volume --frame 301 --value 0
openshot-cli clip keyframe set CLIP_ID --property volume --frame 331 --value 1
openshot-cli effects add CLIP_ID saturation
openshot-cli effects set EFFECT_ID --json '{"saturation":1.2}'
openshot-cli project save /absolute/path/edit.osp
Kies het projectprofiel zo vroeg mogelijk; ingevulde projecten ondersteunen ook profielwijzigingen via de bestaande FPS-conversie en het ongedaan maken-systeem. --audio-only bij het maken van een clip onderdrukt video, inclusief ingebedde coverart in muziekbestanden. Om die clip in plaats daarvan voor Audio Visualisatie te gebruiken, schakel video en audio in en volg de hulp van het effect voor transparante overlays en laagplaatsing.
Begrijpen van clip-timing
De voorbeeld-keyframes gaan uit van een 30fps-project en een clip die bij bron 10s is bijgesneden. Positie is in tijdlijnseconden; start/eind zijn bronseconden, waarbij het einde exclusief is. Frames beginnen bij 1. Miniatuurframes van bestanden gebruiken bron-FPS. Tijdlijnframes gebruiken project-FPS. Clip-keyframes gebruiken broncoördinaten bij project-FPS, dus het bijsnijden van de clip verplaatst de eerste zichtbare keyframe niet naar frame 1.
Eigenschappen wijzigen
set voegt eigenschappen op het hoogste niveau samen. Scalars veranderen keyframe-eigenschappen in constanten. Een opgegeven geneste curve vervangt die curve; gebruik keyframe set om slechts één punt te wijzigen. JSON-argumenten accepteren inline JSON, @file.json, of - voor stdin. Eigenschapsnamen, types, enums, keyframes, referenties en timing worden gevalideerd voordat het project wordt bewerkt. Fouten identificeren het veld, verwachte waarde, ontvangen waarde en een correctie waar mogelijk. GUI-sliderbereiken zijn adviserend waar de engine waarden daarbuiten ondersteunt.
Fades toevoegen
clip fade ID --in 0.5 --out 0.5 berekent automatisch de keyframe-coördinaten van de bron-bijsnijding. Het vervangt de alfacurve; --property volume --value 0.25 maakt in plaats daarvan een audiofade met een piekversterking van 0,25. Duur moet passen tussen de eerste en laatste zichtbare frames; fade-out bereikt nul op het laatste frame.
Clips splitsen
clip split ID --at 6.5 gebruikt tijdlijnseconden, sluit aan op het dichtstbijzijnde projectframe en behoudt beide helften. Het behoudt broncoördinaatcurves en dupliceert effecten met nieuwe ID’s aan de rechterhelft, volgens het snijgedrag van de editor. De linkerhelft behoudt zijn ID. De respons rapporteert gevraagde/werkelijke splitstijden en beide samenvattingen; een benoemd batchresultaat ondersteunt {"$ref":"cut.right.id"}. Splitsen weigeren eindpunten en vergrendelde sporen. Ongedaan maken herstelt de originele clip in één transactie.
Tekst toevoegen en opmaken
text add maakt een tekst aan en plaatst deze als een clip, gebruikmakend van dezelfde tekst als de Tekst-tool van de editor. Opties die je weglaat gebruiken de standaardstijl van de editor:
openshot-cli text add --text "Opening Night" --layer 5000000 --position 2 --duration 4 \
--place lower-third --font "Noto Sans" --size 72 --bold --color "#ffffff" \
--background "#80000000" --background-padding 16 --background-corner 12
openshot-cli text get CLIP_ID
openshot-cli text set CLIP_ID --stroke black --stroke-width 3
openshot-cli text set CLIP_ID --text $'Two\nlines' --line-spacing 1.4
openshot-cli text fonts --search noto
openshot-cli text list --search opening
De woorden, het lettertype, de grootte, uitlijning, boxbreedte en standaardkleuren behoren tot de tekst in Projectbestanden en worden gedeeld door elke clip die het gebruikt, net als in de editor. text set op één clip verandert ze allemaal en toont ze in changed_clip_ids; --this-clip-only geeft die clip eerst een eigen kopie. clip add FILE_ID plaatst een andere clip van een tekst uit text list. Grootten zijn in pixels bij de projectresolutie, en kleuren zijn #RRGGBB, #AARRGGBB (met alfa), een CSS-naam, of transparent. --place plaatst de box in het midden, aan een rand of hoek, of in een onderste derde. --line-spacing is een veelvoud van de normale afstand tussen regels (1 is normaal), en --background-corner maakt de hoeken van achtergrond en rand afgerond met dat aantal pixels.
Een tekstclip is een gewone clip. Positie, schaal, rotatie, doorzichtigheid, timing, fades, bewegingsvoorinstellingen en effecten gebruiken allemaal de normale clip-opdrachten. Lettergrootte, padding, boxbreedte, en letter- en regelafstand bepalen de grootte van het tekstvak, dus die kunnen niet met keyframes worden geanimeerd; om de grootte van tekst te animeren, keyframe je de schaal van de clip. Elke clip kan zijn eigen tekstkleuren en omtrek- en randbreedtes animeren met dezelfde keyframe-opdrachten als elke andere eigenschap:
openshot-cli clip keyframe list CLIP_ID
openshot-cli clip keyframe set CLIP_ID --property text_color.alpha --space clip --unit seconds --at 0 --value 0
openshot-cli clip keyframe set CLIP_ID --property text_color.alpha --space clip --unit seconds --at 1 --value 255
De geanimeerde eigenschappen zijn text_color, text_background, text_stroke en text_border (kleuren, met .red, .green, .blue en .alpha van 0 tot 255), plus text_stroke_width, text_border_width en text_background_corner. De eigen animatie van een clip heeft voorrang boven de gedeelde stijl, en text get toont welke stijlen een clip animeert. text reset CLIP_ID zet een clip terug naar de standaardstijl, zoals Tekst → Stijl resetten; --keyframes-only verwijdert alleen de eigen animatie van de clip. Om meerdere teksten tegelijk te stijlen, selecteer ze met {"text":true}:
openshot-cli edit bulk --select '{"text":true}' --json '[{"method":"text.set","params":{"font_family":"Noto Sans","stroke_width":2}}]'
Een batch bewerkingen toepassen
edit apply --json @edits.json --expect-revision 12 accepteert tot 256 geordende mutatieopdrachten, met puntgescheiden opdrachtnamen zoals clip.set en effects.add (de oudere spelling effect.add werkt ook):
[
{"method":"project.profile.set","params":{"id":"builtin:01280x0720p0024_16-09"}},
{"method":"file.import","as":"media","params":{"path":"/tmp/video.mp4"}},
{"method":"clip.add","as":"shot","params":{"file_id":{"$ref":"media.id"},"layer":1000000,"start":10,"end":15}},
{"method":"clip.fade","params":{"id":{"$ref":"shot.id"},"fade_in":0.5,"fade_out":0.5}}
]
De optionele as koppelt een resultaat voor latere opdrachten in dezelfde batch. Een {"$ref":"shot.id"} object vervangt het veld van dat resultaat. Referenties lossen alleen eerdere namen op; spelfouten, vooruitverwijzingen en dubbele namen falen vóór live updates. De respons bevat geordende compacte resultaten en een refs-kaart van daadwerkelijke ID’s. Alle wijzigingen in een succesvolle batch vormen één ongedaan/ongedaan maken stap. project.profile.set ondersteunt ook gevulde tijdlijnen. Openen, opslaan, exporteren en inspectie-opdrachten blijven buiten bewerkingsbatches. De help van elke opdracht toont de JSON-parameter namen, inclusief de underscore-spelling van shell-vlaggen (bijvoorbeeld --fps-num wordt fps_num).
Batches valideren en fouten afhandelen
Alle opdrachten in bewerkingsbatches worden vooraf gecontroleerd tegen een losgekoppeld project vóór live updates. Ongeldige invoer laat het live project en de revisie ongewijzigd. Geldige batches vormen één ongedaanmaakgroep. Onverwachte runtime-fouten kunnen nog steeds gedeeltelijke wijzigingen veroorzaken; fouten rapporteren voltooide bewerkingen. Een time-out betekent geen annulering, dus controleer de status vóór het opnieuw proberen van mutaties.
Nauwkeurige keyframe-bewerking
clip, transition en effects ondersteunen keyframe list, set, remove, clear, transform, copy en paste. Eigenschappaden kunnen geneste curves adresseren, zoals color.red op een Chroma Key-effect. Het bewerken van een geneste curve behoudt broederkanalen. Voer keyframe list ID uit zonder eigenschap om curvepaden en aantal punten te ontdekken. Ontdekking en puntlijsten bevatten trim-/positie-timingcontext; puntlijsten rapporteren ook native framecoördinaten. get en properties tonen het volledige native object en eigenschapsmetadata. Fouten identificeren ongeldige velden, suggereren vergelijkbare eigenschapsnamen en leggen coördinatencorrecties uit.
Kies coördinaten expliciet met --space native|clip|timeline en --unit frames|seconds. Alle frames gebruiken de project-FPS en zijn 1-gebaseerd; seconden beginnen bij nul en worden vastgezet op het dichtstbijzijnde frame. Native is de bestaande engine-keyframe-coördinaat (inclusief bron-trim). Clip-coördinaten beginnen bij het zichtbare clip-inpunt; tijdlijncoördinaten beginnen bij projecttijd nul. Aangehechte effecten gebruiken de timing van hun bovenliggende clip. Deze coördinaten verwijzen naar animatietijd, niet naar de mediakaders geselecteerd door een tijd-hermappingcurve.
Voor een clip gepositioneerd op 5 seconden, bijgesneden op 2 seconden, in een project van 30 fps, verwijzen clip frame 1, tijdlijn frame 151 en native frame 61 naar hetzelfde punt. Positie en trimmen sluiten onafhankelijk aan op het project frame raster. Het weergeven van een volledige curve kan verborgen punten bevatten met niet-positieve clip/tijdlijn coördinaten. Legacy --frame betekent nog steeds een native frame en kan niet gecombineerd worden met --at.
Voorbeelden:
openshot-cli clip keyframe set CLIP --property location_x --space clip --unit seconds --at 0 --value -1
openshot-cli clip keyframe set CLIP --property location_x --space clip --unit seconds --at 1 --value 0 --interpolation bezier --handles '{"handle_left":{"X":0.2,"Y":0.9}}'
openshot-cli effects keyframe set EFFECT --property color.red --space clip --at 31 --value 200
openshot-cli clip keyframe list CLIP --property location_x --space clip --unit seconds
openshot-cli clip keyframe transform CLIP --property location_x --space clip --start 1 --end 31 --scale 2 --offset 15
openshot-cli clip keyframe copy TARGET --property location_x --source-id SOURCE --space clip --start 1 --end 31 --at 1 --mode merge
openshot-cli clip keyframe remove CLIP --property location_x --space clip --at 31
openshot-cli clip keyframe clear CLIP --property location_x --value 0
Interpolatie, easing en voorbeeldweergave
Interpolatie beschrijft het segment naar het bestemmingspunt toe. Lineair geeft een constante snelheid tussen punten. Constant houdt de voorgaande waarde vast tot het bestemmingspunt, en springt dan. Native standaard Bezier-handvatten zorgen voor easing aan beide uiteinden van elk segment. Het toevoegen van een tussenliggend punt kan daarom een onbedoelde vertraging veroorzaken; voor één eased beweging begin met twee eindpunten. Laat handvatten normaal gesproken ongemoeid en kies een benoemde preset voor een specifieke stijl.
Ontdek dezelfde easing-presets die door de menu’s van de editor worden gebruikt, zonder een sessie:
openshot-cli clip keyframe presets
Pas een preset toe op het binnenkomende segment door de bestemming in te stellen:
openshot-cli clip keyframe set CLIP --property scale_x --space clip --unit seconds --at 0 --value 1
openshot-cli clip keyframe set CLIP --property scale_x --space clip --unit seconds --at 4 --value 1.2 --easing ease-in-out
De easing-optie impliceert Bezier. Het stelt het uitgaande handvat van het vorige punt en het binnenkomende handvat van de bestemming samen in, waarbij andere handvatten en puntwaarden behouden blijven. Er moet een eerder punt bestaan. Combineer dit niet met aangepaste handvatten of een andere interpolatie. Presets werken in batches en bulk-sjablonen. De GUI-preset ease (“Ease (Default)”) verschilt van de native handvatten die door gewone Bezier-interpolatie worden gebruikt. Back-presets kunnen eindpuntwaarden overschrijden.
Inspecteer beweging voor het renderen, met behulp van de native curve evaluator:
openshot-cli clip keyframe preview CLIP --property scale_x --space clip --unit seconds --start 0 --end 4
openshot-cli clip keyframe preview CLIP --property scale_x --space clip --unit seconds --at 2
Voorbeeldweergave is alleen-lezen en werkt identiek voor effecten en overgangen. Het geeft waarden en getekende inkomende snelheid / uitgaande snelheid in eigenschapseenheden per seconde terug, berekend uit direct aangrenzende frames. Dit zijn eindige verschillen, geen analytische afgeleiden. Bij native frame 1 is de inkomende snelheid nul. Snelheden van aangrenzende frames kunnen buiten het gevraagde bereik inspecteren. Bijna-nul snelheden rond een binnenliggend punt tonen een pauze; verschillende snelheden tonen een snelheidsverandering. Constante interpolatie toont een sprong bij de bestemming.
Zonder een bereik beslaat de voorbeeldweergave de eerste en laatste punten van de curve. Bereiken zijn inclusief, met standaard 17 gelijkmatig verdeelde samples (–count: 2–256). Keyframes en hun directe buren binnen het bereik zijn ook inbegrepen, zodat een laag aantal samples een keyframe-stilstand niet verbergt. Het maximum is 1024 samples; grotere verzoeken vereisen een smaller bereik. –at samplet één frame. Voorbeeldweergave rapporteert coördinaten in de gevraagde ruimte en daadwerkelijke native frames; seconden sluiten aan op projectframes zoals bij het bewerken.
Voor geavanceerde aangepaste handvatten worden zowel X als Y genormaliseerd ten opzichte van het segment: X is een fractie van de frame-span; Y is een fractie van de waardeverandering. De eerste controle komt van het rechterhandvat van het vorige punt, de tweede van het linkerhandvat van de bestemming. Native standaardwaarden zijn rechts=(0.5, 0), links=(0.5, 1), met vlakke eindpunt-tangenten. Alleen het wijzigen van handle_type herberekent geen continue tangens door omliggende punten. Bestaande handvatten blijven behouden bij het verplaatsen van een punt.
Keyframe-bereiken zijn inclusief, in tegenstelling tot clip-selectie tijdsbereiken. List geeft points uit waarvan de co.X waarden de gevraagde coördinatenruimte/-eenheid gebruiken. Geef die array door aan keyframe paste --json @points.json met dezelfde ruimte/-eenheid, kies --mode merge (vervang overeenkomende frames, behoud anderen) of --mode replace (vervang de hele curve). copy accepteert een bron van hetzelfde objecttype, een optionele --source-property, en verankert het eerste geselecteerde bronpunt op --at op het doel. Andere curves en bronobjecten blijven ongewijzigd.
transform past een positieve tijdsschaal toe rond het eerste geselecteerde punt, of --pivot, gevolgd door een getekende --offset in de gekozen eenheid. Frame-snapping die dubbele coördinaten creëert wordt geweigerd, inclusief botsingen met punten buiten het geselecteerde bereik. Native coördinaten moeten minimaal 1 blijven. Native genormaliseerde Bézier-handvatten en interpolatie bewegen mee met elk punt; handvatten zijn geen absolute frame-coördinaten. set --handles wijzigt alleen de opgegeven handvatten. Interpolatie behoort toe aan het bestemmingspunt.
clear behoudt een constant basispunt bij native frame 1: specificeer --value of neem een sample van de bestaande curve met --at (standaard native frame 1). Het verwijderen van het laatste punt behoudt ook een constante basis, zodat volgende keyframe-toevoegingen geldig blijven.
Veel clips selecteren en bewerken
Gebruik edit apply --dry-run om een batch te valideren zonder het project te wijzigen. Gebruik edit bulk om een kleine opdrachttemplate te herhalen voor elke geselecteerde clip, waarbij alle wijzigingen worden gegroepeerd in één ongedaan maken-stap.
Bekijk eerst een selectie vooraf:
openshot-cli edit select --json '{"layer":1000000,"start":5,"end":20,"effect":"Saturation"}'
Selectors ondersteunen ids (unieke clip-ID-array), layer, start/end (tijdlijnseconden), file_id, effect (klassenaam of alias), en text (true selecteert tekstclips). Filters worden gecombineerd met EN. Tijdsintervallen selecteren clips die overlappen met [start, end); ze knippen die clips niet bij. Resultaten worden geordend op positie, laag, dan ID, en bevatten ID’s, samenvattingen, vergrendelingsstatus en de huidige revisie. Onbekende ID’s zijn fouten. Een lege selector wordt afgewezen; gebruik expliciet {"all":true} voor elke clip. Selecties zijn beperkt tot 256 clips en worden nooit stilzwijgend afgekapt.
Sla bijvoorbeeld deze array op als templates.json:
[
{"method":"clip.adjust","params":{"values":{"position":{"add":2},"volume":{"multiply":0.5}}}},
{"method":"effects.add","as":"look","params":{"type":"Saturation"}},
{"method":"effects.keyframe.set","params":{"id":{"$ref":"look.id"},"property":"saturation","space":"clip","at":1,"value":0}},
{"method":"effects.keyframe.set","params":{"id":{"$ref":"look.id"},"property":"saturation","space":"clip","at":31,"value":1.2}}
]
Valideer het, en pas het vervolgens toe op de revisie die door de selectie is teruggegeven:
openshot-cli edit bulk --select '{"ids":["CLIP_A","CLIP_B"]}' --json @templates.json --dry-run
openshot-cli edit bulk --select '{"ids":["CLIP_A","CLIP_B"]}' --json @templates.json --expect-revision 42
Bestaande clip-commando’s erven id; effects.add erft clip_id. Laat deze doelparameters weg in sjablonen. Effectbewerkingen moeten verwijzen naar een eerder benoemd resultaat. Namen zijn lokaal voor elke geselecteerde clip, dus look.id verwijst naar een ander effect voor elke clip. Om bestaande effectinstanties te wijzigen via expliciete ID, blijf edit apply gebruiken. De geselecteerde ID-set is vastgelegd vóór uitbreiding; wijzigingen in positie of effecten veranderen de resterende doelen niet.
clip set past absolute eigenschappen toe; clip adjust past eerst multiply en daarna add toe op een numerieke eigenschap of elke waarde in een curve, waarbij de timing van punten, interpolatie en genormaliseerde handvatten behouden blijven. Het valideert de resulterende waarden, inclusief niet-negatieve posities en volume. Structurele velden blijven beschermd.
Bulkbewerkingen wijzen lege selecties, vergrendelde doelsporen en meer dan 256 uitgebreide commando’s af. Elke uitgebreide bewerking doorloopt een losgekoppelde preflight vóór een live bewerking. Droge runs reserveren geen gegenereerde ID’s. Gebruik --expect-revision om verouderde selecties af te wijzen. Succesvolle batches vormen één ongedaanmaakstap, ook na opslaan/heropenen. GUI-verversingen worden gebundeld. Onverwachte runtime-/listenerfouten kunnen nog steeds een gedeeltelijke transactie achterlaten; de fout rapporteert voltooide bewerkingen en ongedaan maken herstelt die groep, zoals bij edit apply.
Profielen
Ontdek profielen en koppel geïmporteerde video zonder ID’s te raden:
openshot-cli profile list --search 720
openshot-cli profile get builtin:01280x0720p0024_16-09
openshot-cli profile match --file FILE_ID
openshot-cli project profile get
openshot-cli project profile set --from-file FILE_ID
openshot-cli project profile set builtin:01280x0720p0024_16-09
openshot-cli project profile set --json '{"width":640,"height":352,"display_ratio":{"num":20,"den":11},"fps":{"num":24000,"den":1001}}'
Catalogusvermeldingen bevatten stabiele ID’s, beschrijvingen, afmetingen, rationale FPS, beeldverhoudingen en scaninstellingen. Lijsten/zoeken is gepagineerd. Bronmatching geeft exacte ID’s en gerangschikte alternatieven met expliciete verschillen terug. Instellen vanuit een bestand vereist een exacte match tenzij --create-custom is opgegeven; het kiest nooit stilzwijgend een nabijgelegen profiel. Statische afbeeldingen en alleen-audio bronnen kunnen geen videoprofiel definiëren. Matching gebruikt de opgegeven bron-FPS.
Aangepaste instellingen zijn ingebed in het opgeslagen project, inclusief rationale snelheden, zodat heropenen geen installatie van een apart profielbestand vereist. Wijzigingen in het projectprofiel gebruiken bestaande framerateconversie en één ongedaanmaaktransactie. Ongedaan maken/herhalen herstelt clip-timing en keyframes, inclusief afrondingsgevoelige posities. Export kan onafhankelijk een profiel selecteren zonder het project te wijzigen.
Opgeslagen ongedaanmaakgeschiedenis volgt de voorkeur voor geschiedenislimiet van de editor. De limiet is een zachte actiegrens: alle records behorend tot behouden transacties worden bewaard, dus opslaan kan een grote batch niet inkorten tot een gedeeltelijke ongedaanmaakactie. Nul schakelt opgeslagen geschiedenis uit. De aparte limiet van 256 commando’s per batch blijft van toepassing.
Media en tijdlijnen inspecteren
Inspecteer clip-timing en spoorindeling als tekst of JSON, of render afbeeldingen om compositie en kader te beoordelen vóór export.
Tijdlijnsamenvattingen
Gebruik een tekstweergave voor een snel overzicht, of gestructureerde JSON voor scripts en agents:
openshot-cli timeline view --start 5 --end 12
openshot-cli timeline view --start 5 --end 12 --format json
openshot-cli timeline overview --start 5 --end 12
timeline view gebruikt standaard compacte tekst met gebruikte sporen, object-ID’s, tijdlijn-/bronintervallen, streamstatus, versterking en gaten/overlappingen. Gebruik --detail summary|clips|full om detailniveau te kiezen, --format json voor gestructureerde context, en --start/--end, --layer en paginering om het resultaat te focussen.
timeline overview levert compacte gestructureerde context zonder afbeeldingsbytes: geordende ID’s, volgorde per spoor, tijdlijn-/bronintervallen, zichtbare trimbereiken, framecoördinaten, audio-/videostatus, effecten en aangrenzende gaten of overlappingen. Intervallen en framebereiken zijn exclusief het einde; framenummers zijn één-gebaseerd. Bronframes gebruiken bron-FPS; tijdlijn- en keyframecoördinaten gebruiken project-FPS. Gebruik --layer en --start/--end om te focussen, en --limit/--offset om te pagineren (standaard 100, maximaal 500 items). Tijd-geremapte clips onthouden expliciet afgeleide bronkoppelingen. Gebruik de geretourneerde revisie met edit apply --expect-revision.
Frame-voorbeelden en contactvellen
Render een enkel frame met thumbnail of neem een bereik als voorbeeld met strip. Gebruik file om bronmedia te inspecteren en timeline om de samengestelde video te inspecteren, inclusief effecten en gelaagde clips:
openshot-cli file thumbnail FILE_ID --frame 301 --output /tmp/source.png
openshot-cli file strip FILE_ID --start 10 --end 20 --count 12 --output /tmp/source-strip.png
openshot-cli timeline thumbnail --frame 91 --output /tmp/timeline-frame.png
openshot-cli timeline strip --start 0 --end 20 --count 12 --output /tmp/timeline-strip.png
Frame-afbeeldingen zijn standaard 320x180 pixels; contactvellen standaard 160x90 per tegel, plus timecodelabels. Gebruik --width en --height om uitvoerpixels te kiezen. Antwoorden bevatten exacte sample-/framemetadata. Contactvellen helpen bij het beoordelen van compositie over een reeks; gebruik keyframe-voorbeelden en gerenderde video om beweging tussen die samples te beoordelen.
Tijdlijnafbeeldingen
Leg de spoorindeling van de editor vast, inclusief de liniaal, miniaturen, effecten, overgangen en golfvormen:
openshot-cli timeline view --start 0 --end 20 --pixels-per-second 80 --output /tmp/tracks.png
Het opgeven van --output selecteert het afbeeldingsformaat; --format image selecteert dit ook expliciet. De opname verandert het viewport of project van de editor niet. Antwoorden bevatten clip-ID’s en timing naast pixelgrenzen.
Afbeeldingen zijn standaard 1280 pixels breed, met hoogte aangepast aan gebruikte sporen. Gebruik --width, --height of --all-tracks om de lay-out aan te passen, en --track-size of --track-label-width om sporen en labels aan te passen. Het start-/eindbereik bepaalt de zoom; --pixels-per-second bepaalt in plaats daarvan de breedte op basis van het tijdsbereik.
Audiogolfvormweergaven
Kies --mode waveforms om audio-omslagen op de tijdlijn te inspecteren:
openshot-cli timeline view --start 5 --end 12 --mode waveforms --output /tmp/waves.png
--mode auto gebruikt de bestaande gecachte golfvormweergave; --mode thumbnails toont in plaats daarvan miniaturen. Golfvormen geven bronpiek-/RMS-niveaus weer met clipvolume- en timingaanpassingen, vóór audio-effecten of mixen.
Niet-gecachete golfvormextractie decodeert volledige bronnen, beperkt tot 600 seconden per bron en 1200 bron-seconden per verzoek. Het verkleinen van het zichtbare bereik vermindert dat decodeerwerk niet. Voor langere bronnen genereer eerst golfvormen in de editor of gebruik miniatuurmodus. Latere verzoeken kunnen gecachte golfvormen hergebruiken.
Afbeeldingsuitvoer en limieten
Afbeeldingspaden moeten nieuwe PNG-bestanden zijn in bestaande mappen. Afbeeldingen zijn beperkt tot 4096 pixels per as, 8.388.608 totale pixels en 64 contact-sheet monsters. Verzoeken buiten deze limieten mislukken vóór het renderen.
Afbeeldingen worden naar bestanden geschreven; JSON-antwoorden bevatten hun paden en image_bytes-groottes. Inspectie wacht tot de afbeelding klaar is, en grote verzoeken kunnen de editor kort bezet houden.
Omgaan met time-outs van opdrachten
Een time-out van een verzoek betekent niet dat een wijziging is mislukt. Gebruik de operatie-ID in de foutmelding met operation get ID voordat u het opnieuw probeert. operation list toont recente wijzigingen en hun status, revisies en resultaten. Voltooide operaties bewaren hun resultaten als ze klein genoeg zijn, inclusief geretourneerde object-ID’s. De opslag is beperkt tot 100 operaties en 4 MiB, waarbij individuele resultaatlichamen boven 256 KiB worden weggelaten. Deze records blijven alleen bestaan tijdens de lopende sessie. Ze herstellen projecten niet na een crash en voorkomen niet dat een herhaalde opdracht dezelfde bewerking opnieuw toepast. Exporttaken hebben hun eigen status-/lijstopdrachten.