Sučelje naredbenog retka
Uvedite OpenShot u svoj radni tijek naredbenog retka. Uvezite snimke, izrežite i rasporedite isječke, primijenite efekte, animirajte svojstva pomoću ključnih okvira i izvezite videozapise iz terminala. Koristite nekoliko naredbi za automatizaciju ponavljajućih uređivanja, napišite skriptu za ponavljajući projekt ili dopustite AI agentu da pomogne sastaviti i doraditi video.
Naredbeni redak radi sa istim projektima kao i uređivač. Možete kontrolirati otvoreni uređivač i pregledavati promjene tijekom rada ili raditi u headless sesiji bez otvaranja prozora. Sesija drži vaš projekt otvorenim između naredbi, uključujući uređivanja, povijest poništavanja i zadatke izvoza. Spremite ga kao .osp projekt kad god želite nastaviti uređivanje kasnije.
Početak rada
Koristite instaliranu OpenShot izvršnu datoteku praćenu s --cli. Počnite s intro za kratki vodič o sesijama, uređivanju, animaciji i spremanju, ili help za pregled naredbi. Ove naredbe ne zahtijevaju aktivnu sesiju. Primjeri u nastavku zahtijevaju OpenShot verziju koja uključuje uređivanje putem naredbenog retka.
Linux AppImage
Iz direktorija koji sadrži preuzeti AppImage:
./OpenShot.AppImage --cli intro
./OpenShot.AppImage --cli help
Zamijenite OpenShot.AppImage s imenom vaše preuzete datoteke. Ako AppImageLauncher prikazuje dijaloge za integraciju na radnu površinu, postavite APPIMAGELAUNCHER_DISABLE=1 prije pokretanja naredbe:
APPIMAGELAUNCHER_DISABLE=1 ./OpenShot.AppImage --cli intro
Za skripte ili ponovljene naredbe, postavite ga jednom u vašem trenutnom shellu:
export APPIMAGELAUNCHER_DISABLE=1
./OpenShot.AppImage --cli session start
Varijabla mora biti postavljena prije pokretanja AppImage: AppImageLauncher može presresti varijablu prije nego što OpenShot primi --cli. Relativne putanje do medija i @batch.json datoteke rješavaju se iz vašeg radnog direktorija. Držite AppImage datoteku dostupnom dok su sesije ili izvozi u tijeku.
Linux Snap
Za OpenShot Snap, koristite:
snap run openshot-qt --cli intro
snap run openshot-qt --cli help
snap run openshot-qt --cli session start
Dozvole datoteka Snap-a vrijede i za uređivanje putem naredbenog retka. Držite medije, projekte i izvoze na lokacijama kojima Snap može pristupiti, poput vaše korisničke mape. Za dopuštanje pristupa vanjskim diskovima, povežite dozvolu removable-media:
sudo snap connect openshot-qt:removable-media
Windows
Važno
Koristite openshot-qt-cmd.exe za uređivanje putem naredbenog retka na Windowsu. Ova konzolna izvršna datoteka prikazuje rezultate naredbi, pomoć i pogreške u vašem terminalu. Desktop izvršna datoteka, openshot-qt.exe, ne prikazuje standardni izlaz u interaktivnom terminalu, ostavljajući naredbe bez vidljive povratne informacije i otežavajući korištenje CLI-ja.
U PowerShellu, iz direktorija instalacije OpenShot-a:
& .\openshot-qt-cmd.exe --cli intro
& .\openshot-qt-cmd.exe --cli help
& .\openshot-qt-cmd.exe --cli session start
Ako ste u drugom direktoriju, koristite puni put do openshot-qt-cmd.exe. Zadržite --cli nakon imena izvršne datoteke.
macOS
Za instalaciju u Applications:
"/Applications/OpenShot Video Editor.app/Contents/MacOS/openshot-qt" --cli intro
"/Applications/OpenShot Video Editor.app/Contents/MacOS/openshot-qt" --cli help
Pronalaženje naredbi
U ovom vodiču, openshot-cli je skraćenica za naredbu vaše instalacije gore, poput snap run openshot-qt --cli ili ./OpenShot.AppImage --cli. Neke instalacije također izravno pružaju naredbu openshot-cli. Pri pokretanju iz izvornog koda, koristite python3 src/launch.py --cli u OpenShot Python okruženju.
Sami --cli, --cli help i --cli --help prikazuju isti pregled. Pomoć postaje specifičnija kako prelazite kroz naredbe:
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
Grupna pomoć objašnjava radne tokove s primjerima; pomoć za operacije opisuje argumente i ponašanje. --help je ekvivalentno završnom help. Sve naredbe pomoći rade bez uređivačke sesije.
effects list prikazuje dostupne efekte s kratkim opisima. Pomoć za efekte objašnjava njihova svojstva, zadane vrijednosti, izbore i raspon. effects instances navodi efekte već pridružene isječcima, s ID-ovima roditeljskih isječaka. Imena klasa, prikazna imena i aliasi s donjom crtom identificiraju isti efekt.
Rad sa skriptama i AI agentima
AI kodni agenti poput Codex i Claude Code mogu koristiti CLI za pregled i uređivanje OpenShot projekata putem terminalskih naredbi. Dajte agentu put do vaše OpenShot izvršne datoteke, medije ili projekt za rad i željeni rezultat: trajanje, dimenzije, stil animacije i lokaciju izlaza. Zamolite ga da pročita --cli intro prije početka. Iste naredbe rade kada ih sami upisujete ili pokrećete iz skripte.
Počnite s intro, zatim koristite pomoć specifičnu za naredbu prema potrebi. Koristan radni tok je odabrati sesiju, pregledati projekt, napraviti mali skup promjena, pregledati rezultat i spremiti. Naredbe vraćaju strukturirani JSON tako da skripte i agenti mogu koristiti ID-jeve objekata i rezultate izravno umjesto tumačenja izlaza na zaslonu.
Pregledajte prije uređivanja. Koristite vraćene ID-jeve i informacije o svojstvima umjesto nagađanja imena, brojeva traka ili vremena. Izričito odaberite sesiju kada je otvoreno više projekata.
Grupirajte ponovljena uređivanja. Koristite
edit applyza niz promjena iliedit bulkza primjenu predloška na odabrane isječke. Provjerite s--dry-runprije primjene grupe.Provjerite animaciju. Odaberite koordinatni prostor, započnite s nekoliko ključnih okvira i koristite unaprijed postavljene efekte ublažavanja za poznati pokret.
keyframe previewuzorkuje krivulju kako biste mogli uočiti pauze ili skokove prije izvoza. Također pregledajte renderirani pokret; sam kontaktni list ne može pokazati kako animacija izgleda.Spremite i pratite izvoze. Izričito spremite projekt i provjerite status zadatka izvoza prije nego što smatrate izlaz dovršenim. Ako zahtjev istekne, provjerite njegov status prije ponovnog uređivanja.
Donji odjeljci objašnjavaju ove radne tokove i njihove vremenske konvencije.
Sesije i izlazi
Pokretanje ili pronalaženje sesije
Pokrenite jednu sesiju bez sučelja (bez prozora uređivača):
openshot-cli session start
Za otvaranje postojećeg projekta pri pokretanju, dodajte --project "/path/project.osp". Uspješan JSON odgovor sadrži result.session_id. Kopirajte tu vrijednost. Ako je OpenShot već pokrenut ili ste zaboravili ID, pronađite dostupne sesije pomoću:
openshot-cli session list
Odaberite sesiju za projekt koji namjeravate uređivati. Ne morate pokretati novu sesiju za svaku naredbu.
Odabir sesije
Savjet
Postavite OPENSHOT_SESSION jednom, zatim pokrećite naredbe normalno. Vaš terminal pamti odabranu sesiju, tako da ne morate svaki put koristiti --session. Koristite primjer za PowerShell ili Bash u nastavku.
Zamijenite SESSION_ID u nastavku s session_id koji vraća session start ili 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
Na macOS-u koristite istu export sintaksu. Za macOS ili Snap naredbe, zamijenite izvršnu datoteku s onom iz vašeg instalacijskog vodiča. Odabir vrijedi za ovaj terminal i naredbe pokrenute iz njega. Postavite ga ponovno u novom terminalu ili ažurirajte pri prelasku na drugu sesiju.
Preostali primjeri uređivanja i izvoza pretpostavljaju da je OPENSHOT_SESSION postavljen. Sljedeći pododjeljak pokazuje kako automatski dohvatiti ID za skripte.
Za ciljanje druge sesije samo za jednu naredbu, koristite --session. To nadjačava OPENSHOT_SESSION bez promjene odabira u vašem terminalu:
openshot-cli --session OTHER_SESSION_ID project get
Kod pakiranog izvršnog programa, stavite ovu zamjenu nakon --cli i prije grupe naredbi: --cli --session OTHER_SESSION_ID project get.
Automatski odabir radi samo ako postoji točno jedna dostupna sesija. Ako vidite session_required, pokrenite session list i eksplicitno odaberite željenu sesiju. Ako više nije na popisu, pokrenite je ponovno i koristite novi ID. Pomoć, intro i otkrivanje sesija ne zahtijevaju odabranu sesiju.
Automatsko dohvaćanje ID-a sesije
Skripte mogu izravno pročitati result.session_id iz JSON-a koji vraća session start i postaviti OPENSHOT_SESSION za naredbe koje slijede. Nema potrebe ručno kopirati ID ili čitati datoteku dnevnika. Provjerite je li pokretanje uspjelo prije korištenja vraćenog ID-a.
Windows PowerShell (postavite putanju izvršne datoteke za vašu instalaciju):
$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 (za čitanje JSON-a zahtijeva jq):
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
Varijabla okoline odabire sesiju za naredbe pokrenute iz ovog terminala; ne mijenja sistemsku postavku. Pokretanje sesije ne postavlja varijablu automatski. Nakon zaustavljanja sesije, očistite odabir s Remove-Item Env:OPENSHOT_SESSION u PowerShellu ili unset OPENSHOT_SESSION u Bashu.
Prikazivanje i zaustavljanje sesije
Za prikaz odabrane sesije u uređivaču:
openshot-cli session show
Na radnoj površini, session show stvara uređivač u istom procesu i održava aktivni projekt, ID-ove, povijest, zadatke izvoza i vezu. Ponavljani pozivi podižu postojeći prozor. session start --show otvara ga odmah. Sesije pokrenute bez prikaza ili s QT_QPA_PLATFORM=offscreen/minimal ne mogu kasnije prikazati prozor radne površine. Za te sesije spremite i otvorite projekt u novoj sesiji radne površine. Nakon prikaza, zatvorite sesiju kroz prozor uređivača.
Globalne opcije (--session, --timeout) idu prije naredbe. session serve ostaje u prvom planu za nadzornike; session start se vraća nakon registracije pozadinskog domaćina. session stop odbija nespremljene promjene i aktivne izvoze. Koristite --discard samo za namjerno odbacivanje nespremljenih izmjena.
Izlaz naredbe
Rezultati su JSON na stdout, osim zadane tekstualne vremenske linije. Pogreške su JSON na stderr s izlaznim statusom 1; pogreške parsera argumenata izlaze s 2. Mutacije vraćaju sažete sažetke s naredbom inspect. get vraća izvorni JSON objekta. Odgovori projekta uključuju reviziju; odgovori kataloga efekata ne zahtijevaju sesiju. Dnevnici iz sesija bez sučelja nalaze se uz njihove zapise u registru. OPENSHOT_SESSION_DIR nadjačava zadani direktorij ~/.openshot_qt/sessions.
Sesije prihvaćaju naredbe lokalno na vašem računalu. Držite registar sesija privatnim, jer sadrži vjerodajnice za pristup vašim uređivačkim sesijama. Izvozi rade iz snimke, tako da možete nastaviti uređivati dok posao traje.
Otvaranje i spremanje projekata
OpenShot projekt (.osp) pohranjuje vašu uređivu vremensku liniju. Izvoz stvara gotov video; spremanje projekta omogućuje vam povratak na njegove isječke, efekte i ključne okvire kasnije. Spremite svoj projekt zasebno čak i kada izvozite video.
Otvaranje projekta
Pokrenite sesiju s postojećim projektom:
openshot-cli session start --project "/home/me/Videos/My Project.osp"
Dodajte --show za otvaranje i njegovog prozora uređivača. Za korištenje uređivača koji je već pokrenut, pronađite ga pomoću session list. Postavite OPENSHOT_SESSION na vraćeni ID sesije, zatim otvorite ili pregledajte projekt:
openshot-cli project open "/home/me/Videos/My Project.osp"
openshot-cli project get
Zamijenite primjer puta vlastitim i stavite navodnike oko putova koji sadrže razmake. project open zamjenjuje trenutni projekt odabrane sesije. Odbija odbaciti nespremljene izmjene osim ako eksplicitno ne dodate --discard; prvo spremite te izmjene ako ih želite sačuvati. Otvaranje putem CLI ne prikazuje interaktivne dijaloge za nedostajući medij, stoga držite izvorni medij projekta dostupan.
Za novi, prazan projekt, koristite session start bez --project, zatim uvezite medije i dodajte isječke kao što je opisano u odjeljku Uređivanje.
Spremanje projekta ili kopije
Spremite u novu datoteku ili napravite zasebnu verziju prije daljnjih promjena:
openshot-cli project save "/home/me/Videos/My Project v2.osp"
Za ažuriranje postojeće datoteke, eksplicitno dopustite zamjenu:
openshot-cli project save "/home/me/Videos/My Project v2.osp" --overwrite
Uvijek navedite odredišnu putanju. Spremanje .osp ne uključuje sav izvorni materijal u tu datoteku; držite referencirani medij dostupan prilikom premještanja ili ponovnog otvaranja projekta.
Izvoz videa
Automatizirajte renderiranje i izvoz iz skripti ili AI agenata, koristeći postavke projekta ili birajući drugačiji izlazni profil za svaki render. Izvozni poslovi mogu se izvoditi u pozadini ili čekati dovršetak prije nastavka vaše skripte. Za renderiranje MP4 koristeći rezoluciju i broj sličica projekta:
openshot-cli export start "/home/me/Videos/video.mp4" --wait
Po zadanim postavkama, OpenShot koristi H.264 video i AAC audio. Zamijenite primjer puta s vašom odredišnom putanjom, koristeći postojeću mapu i novo ime datoteke. Postojeći izlazi se nikada ne prepisuju. Izvoz ne sprema vaš uređivi .osp projekt; koristite project save zasebno za čuvanje vašeg uređivačkog rada.
Opcija --wait drži naredbu aktivnom dok izvoz ne završi ili ne prijavi neuspjeh. Pregledajte gotov video prije dijeljenja.
Provjera napretka izvoza
Nemojte koristiti --wait za pokretanje izvoza u pozadini. Odgovor uključuje ID posla koji možete koristiti za provjeru napretka:
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
Zamijenite JOB_ID vraćenim ID-om. Ako čekanje istekne, izvoz se nastavlja; provjerite isti posao umjesto pokretanja drugog izvoza. Za zaustavljanje posla koristite export cancel JOB_ID. Svaki posao snima vremensku liniju pri pokretanju, tako da kasnije izmjene ne mijenjaju izvoz koji je već u tijeku.
Čekanje je zadano na 600 sekundi; prilagodite to pomoću --wait-timeout. Ovo je odvojeno od globalnog po zahtjevu --timeout. Neuspjesi izvoza, otkazivanje i isteci čekanja završavaju s statusom 1 i uključuju detalje posla.
Izvoz u više profila
Izvezite istu vremensku liniju u različitim rezolucijama ili omjerima stranica odabirom izvoznog profila za svaki izlaz. Izvozni profil se odnosi samo na taj posao; ne mijenja profil uređivačkog projekta. Profil postavlja dimenzije, broj sličica i omjer stranica; izvozni preset odabire postavke kodiranja poput MP4/H.264.
Pronađite dostupne profile i pregledajte njihove postavke:
openshot-cli profile list --search 720
openshot-cli profile list --search 1080
openshot-cli profile get builtin:01280x0720p0030_16-09
Na primjer, izvezite verzije u pejzažnom formatu na 720p i 1080p, zatim kvadratnu verziju 1080 x 1080. Svi ovi profili koriste 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
Koristite različito ime izlazne datoteke za svaku verziju. Ostavite izmjene nepromijenjene između poslova ako želite usklađene verzije. Promjena omjera stranica može promijeniti kadriranje: pregledajte svaki izlaz, posebno naslove i animirane objekte. Za zasebno sastavljenu kvadratnu ili portretnu verziju, spremite kopiju projekta, promijenite njegov projektni profil i prilagodite isječke prije izvoza. Pogledajte Profile i postavke izvoza u nastavku za prilagođene profile i opcije kodiranja.
Serijski izvoz više projekata
Ponovno koristite jednu sesiju bez sučelja za renderiranje nekoliko spremljenih projekata jedan za drugim. Otvorite projekt, izvezite ga s --wait, zatim otvorite sljedeći projekt. Primjeri u nastavku koriste rezoluciju i broj sličica svakog projekta i stvaraju MP4 datoteke pored .osp datoteka. Dodajte --profile PROFILE_ID u naredbu izvoza za korištenje jednog izlaznog profila za svaki projekt.
Prvo uspješno pokrenite odgovarajući primjer automatskog session-ID-a gore, u istom terminalu. On definira openshot i odabire novu sesiju. Zamijenite putanje projekata u nastavku vlastitim. Koristite različita imena izlaza koja već ne postoje; primjeri provjeravaju sve destinacije prije pokretanja serije.
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 (zagrade održavaju lokalno rukovanje pogreškama unutar serije):
(
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
Oba recepta zaustavljaju seriju pri neuspjehu naredbe i ostavljaju sesiju dostupnom za pregled. Ovdje je ograničenje čekanja 24 sata po izvozu. Istek vremena čekanja ostavlja renderiranje aktivnim: prije ponovnog pokušaja koristite export list i export status JOB_ID --wait. Završeni videozapisi ostaju na disku; uklonite dovršene projekte iz serije prije nastavka. Nakon rješavanja pogreške, zaustavite sesiju i očistite njezinu varijablu okoline kad završite.
Odabir predložaka i postavki kodiranja
Otkrijte instalirane predloške izvoza i podržane postavke:
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
Izvoz također prihvaća --from-file FILE_ID s opcionalnim --create-custom. Postavke se rješavaju ovim redoslijedom: zadane postavke projekta, predložak, napredni JSON, eksplicitne zastavice profila/kvalitete/raspona. Napredni JSON otkriva video/audio kodeke i bitrate, raspored/stopu/kanale zvuka, izvorne opcije kodeka, postavke hardverskih uređaja i broj niti.
Na primjer, odaberite opciju enkodera putem naprednog JSON-a:
openshot-cli export start /tmp/small.mp4 --profile builtin:00640x0360p0030_16-09 --json '{"video_options":{"preset":"fast"}}' --wait
Provjera valjanosti postavki izvoza
Provjerite postavke prije početka renderiranja:
openshot-cli export validate /tmp/reel.mp4 --preset builtin:format_mp4_x264
Izvještaj o mogućnostima prikazuje dostupnost sastavljenih kodeka, a ne fizičku dostupnost GPU-a. Validacija ide dalje: otvara enkodere (uključujući hardverske enkodere) i spremnik s točnim postavkama, u zasebnom procesu, bez pisanja datoteke. Kombinacija koju spremnik ne može podržati ne uspijeva s incompatible_export, FFmpegovim vlastitim objašnjenjem i postavkom za promjenu (details.cause.path):
openshot-cli export validate /tmp/song.mp3 --json '{"mode":"audio","format":"mp3","audio_codec":"aac"}'
Radnik za izvoz izvodi istu provjeru prije renderiranja.
Renderiranje raspona okvira
Koristite --start-frame i --end-frame za renderiranje dijela vremenske linije. Rasponi su uključivi i broje se od jedan prema FPS-u profila izvoza. Na primjer, renderirajte prvih 90 okvira pri 30 fps (tri sekunde):
openshot-cli export start /tmp/excerpt.mp4 --profile builtin:01280x0720p0030_16-09 --start-frame 1 --end-frame 90 --wait
Izvozi samo zvuka i nizovi slika
Odaberite način izlaza pomoću naprednog JSON-a:
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
Nizovi slika zahtijevaju novi direktorij izlaza. Postojeći izlazi se nikada ne prepisuju.
Uređivanje
Dodavanje isječaka i efekata
Koristite ID-jeve vraćene naredbama import/add/list i otkrijte brojeve slojeva pomoću 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
Kad god je moguće, odaberite profil projekta rano; popunjeni projekti također podržavaju promjene profila kroz postojeći sustav konverzije FPS-a i poništavanja. --audio-only pri stvaranju isječka isključuje video, uključujući ugrađene naslovnice u glazbenim datotekama. Za korištenje tog isječka za Audio Vizualizaciju, omogućite njegov video i audio te slijedite upute efekta za prozirne slojeve i postavljanje slojeva.
Razumijevanje vremenskog rasporeda isječka
Primjer ključnih okvira pretpostavlja projekt od 30 fps i isječak skraćen na izvornih 10 s. Pozicija je u sekundama vremenske linije; početak/kraj su u sekundama izvora, pri čemu je kraj isključen. Okviri počinju od 1. Okviri sličica datoteke koriste izvorni FPS. Okviri vremenske linije koriste FPS projekta. Ključni okviri isječka koriste izvorne koordinate pri FPS-u projekta, tako da skraćivanje isječka ne pomiče njegov prvi vidljivi ključni okvir na okvir 1.
Promjena svojstava
set spaja svojstva najviše razine. Skalarni podaci pretvaraju svojstva s ključnim okvirima u konstante. Dostavljena ugniježđena krivulja zamjenjuje tu krivulju; koristite keyframe set za promjenu samo jedne točke. JSON argumenti prihvaćaju inline JSON, @file.json ili - za stdin. Imena svojstava, tipovi, enumeracije, ključni okviri, reference i vremenski raspored provjeravaju se prije uređivanja projekta. Pogreške identificiraju polje, očekivanu vrijednost, primljenu vrijednost i ispravak gdje je moguće. Rasponi klizača GUI-ja su savjetodavni tamo gdje motor podržava vrijednosti izvan njih.
Dodavanje prijelaza
clip fade ID --in 0.5 --out 0.5 automatski izračunava koordinate ključnih okvira za izvorno skraćivanje. Zamjenjuje alfa krivulju; --property volume --value 0.25 umjesto toga stvara audio prijelaz s vršnim pojačanjem od 0.25. Trajanja moraju stati između prvog i zadnjeg vidljivog okvira; izblijedjenje doseže nulu na zadnjem okviru.
Razdvajanje isječaka
clip split ID --at 6.5 koristi sekunde vremenske linije, prilagođava se najbližem okviru projekta i zadržava oba dijela. Zadržava krivulje izvornog koordinatnog sustava i duplicira efekte s novim ID-jevima na desnoj polovici, slijedeći ponašanje rezanja uređivača. Lijeva polovica zadržava svoj ID. Odgovor prikazuje tražena/stvarna vremena rezanja i oba sažetka; imenovani rezultat serije podržava {"$ref":"cut.right.id"}. Rezanja odbacuju krajnje točke i zaključane tragove. Poništi vraća izvorni isječak u jednoj transakciji.
Dodavanje i oblikovanje teksta
text add stvara tekst i postavlja ga kao isječak, koristeći isti tekst kao i alat Text u uređivaču. Opcije koje izostavite koriste zadani stil uređivača:
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
Riječi, font, veličina, poravnanje, širina okvira i zadane boje pripadaju tekstu u Projektnoj datoteci i dijele se među svim isječcima koji ga koriste, kao i u uređivaču. text set na jednom isječku mijenja sve njih i navodi ih u changed_clip_ids; --this-clip-only prvo daje tom isječku njegovu vlastitu kopiju. clip add FILE_ID postavlja drugi isječak teksta iz text list. Veličine su u pikselima pri rezoluciji projekta, a boje su #RRGGBB, #AARRGGBB (s alfa kanalom), CSS ime ili transparent. --place postavlja okvir u centar, na rub ili kut, ili donju trećinu. --line-spacing je višekratnik normalnog razmaka između redaka (1 je normalno), a --background-corner zaokružuje kutove pozadine i obruba za toliko piksela.
Tekstualni isječak je običan isječak. Položaj, skaliranje, rotacija, prozirnost, vremensko usklađivanje, izblijedjenja, predlošci pokreta i efekti svi koriste uobičajene clip naredbe. Veličina fonta, razmak, širina okvira te razmak između slova i redaka određuju veličinu tekstualnog okvira, pa ih nije moguće animirati ključnim okvirima; za animaciju veličine teksta, animirajte skaliranje isječka. Svaki isječak može animirati svoje boje teksta, obrub i širine obruba koristeći iste naredbe za ključne okvire kao i za bilo koje drugo svojstvo:
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
Animirana svojstva su text_color, text_background, text_stroke i text_border (boje, s .red, .green, .blue i .alpha od 0 do 255), plus text_stroke_width, text_border_width i text_background_corner. Vlastita animacija isječka ima prednost nad zajedničkim stilom, a text get navodi koje stilove isječak animira. text reset CLIP_ID vraća isječak na zadani stil, kao u Text → Reset Style; --keyframes-only uklanja samo vlastitu animaciju isječka. Za oblikovanje više tekstova odjednom, odaberite ih s {"text":true}:
openshot-cli edit bulk --select '{"text":true}' --json '[{"method":"text.set","params":{"font_family":"Noto Sans","stroke_width":2}}]'
Primjena serije izmjena
edit apply --json @edits.json --expect-revision 12 prihvaća do 256 naredbi mutacije u redoslijedu, koristeći nazive naredbi s točkama poput clip.set i effects.add (stariji oblik effect.add također radi):
[
{"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}}
]
Opcionalni as veže rezultat za kasnije naredbe u istoj seriji. Objekt {"$ref":"shot.id"} zamjenjuje polje tog rezultata. Reference rješavaju samo ranije nazive; pogreške u pisanju, buduće reference i duplicirani nazivi ne uspijevaju prije ažuriranja uživo. Odgovor uključuje uređene kompaktne rezultate i mapu refs stvarnih ID-eva. Sve promjene u uspješnoj seriji čine jedan korak poništavanja/ponavljanja. project.profile.set također podržava popunjene vremenske linije. Naredbe za otvaranje, spremanje, izvoz i inspekciju ostaju izvan serija izmjena. Pomoć za svaku naredbu navodi nazive JSON parametara, uključujući oblik s donjom crtom za zastavice ljuske (na primjer, --fps-num postaje fps_num).
Provjera serija i rukovanje pogreškama
Sve naredbe u serijama izmjena prethodno se provjeravaju na odvojenom projektu prije bilo kakvih ažuriranja uživo. Nevažeći unos ostavlja živi projekt i reviziju nepromijenjenima. Valjane serije čine jednu grupu poništavanja. Neočekivani kvarovi u izvođenju mogu ipak proizvesti djelomične promjene; pogreške izvještavaju o dovršenim operacijama. Istek vremena ne znači otkazivanje, stoga provjerite stanje prije ponovnog pokušaja izmjena.
Precizno uređivanje ključnih okvira
clip, transition i effects podržavaju keyframe list, set, remove, clear, transform, copy i paste. Putanje svojstava mogu adresirati ugniježđene krivulje, poput color.red na efektu Chroma Key. Uređivanje ugniježđene krivulje čuva susjedne kanale. Pokrenite keyframe list ID bez svojstva za otkrivanje putanja krivulja i broja točaka. Otkrivanje i popisi točaka uključuju kontekst vremenskog podešavanja trim/pozicije; popisi točaka također prikazuju izvorne koordinate okvira. get i properties izlažu kompletan izvorni objekt i metapodatke svojstava. Pogreške identificiraju nevažeća polja, predlažu slična imena svojstava i objašnjavaju korekcije koordinata.
Izričito odaberite koordinate pomoću --space native|clip|timeline i --unit frames|seconds. Svi okviri koriste FPS projekta i numerirani su od 1; sekunde počinju od nule i zaokružuju se na najbliži okvir. Native su postojeće koordinate ključnog okvira motora (uključujući izrez izvora). Koordinate isječka počinju od vidljive ulazne točke isječka; koordinate vremenske linije počinju od nule vremena projekta. Priloženi efekti koriste vremensko usklađivanje roditeljskog isječka. Ove koordinate se odnose na vrijeme animacije, a ne na medijske okvire odabrane krivuljom vremenskog preslikavanja.
Za isječak pozicioniran na 5 sekundi, skraćen na 2 sekunde, u projektu od 30 fps, okvir isječka 1, okvir vremenske crte 151 i izvorni okvir 61 adresiraju istu točku. Pozicija i skraćivanje neovisno se poravnavaju na mrežu okvira projekta. Popis cijele krivulje može uključivati skrivene točke s nepozitivnim koordinatama isječka/vremenske crte. Naslijeđeni --frame i dalje znači izvorni okvir i ne može se kombinirati s --at.
Primjeri:
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
Interpolacija, ublažavanje i pregled
Interpolacija opisuje segment do odredišne točke. Linearna daje stalnu brzinu između točaka. Konstantna drži prethodnu vrijednost do odredišta, zatim skače. Izvorni zadani Bezier upravljači ublažavaju na oba kraja svakog segmenta. Dodavanje međutočke može stoga uzrokovati neželjeno usporavanje; za jedan ublaženi pokret, započnite s dvije krajnje točke. Obično ostavite upravljače netaknutima i odaberite imenovani predložak za određeni stil.
Otkrijte iste predloške ublažavanja koje koriste izbornici uređivača, bez sesije:
openshot-cli clip keyframe presets
Primijenite predložak na dolazni segment postavljanjem njegove odredišne točke:
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
Opcija ublažavanja podrazumijeva Bezier. Postavlja izlazni upravljač prethodne točke i ulazni upravljač odredišne točke zajedno, čuvajući ostale upravljače i vrijednosti točaka. Mora postojati ranija točka. Nemojte je kombinirati s prilagođenim upravljačima ili drugačijom interpolacijom. Predlošci rade u serijama i masovnim predlošcima. GUI predložak ease („Ublažavanje (zadano)”) razlikuje se od izvornog upravljača koji koristi obična Bezier interpolacija. Povratni predlošci mogu premašiti vrijednosti krajnjih točaka.
Pregledajte pokret prije renderiranja, koristeći izvorni evaluator krivulje:
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
Pregled je samo za čitanje i radi identično za efekte i prijelaze. Vraća vrijednosti i potpisane incoming_rate / outgoing_rate u jedinicama svojstva po sekundi, izračunate iz neposredno susjednih okvira. To su konačne razlike, a ne analitički derivati. Na izvornom okviru 1 dolazna brzina je nula. Stope susjednih okvira mogu pregledavati izvan traženog raspona. Stope blizu nule oko unutarnje točke otkrivaju pauzu; različite stope otkrivaju promjenu brzine. Konstantna interpolacija otkriva skok na odredištu.
Bez raspona, pregled obuhvaća prve i posljednje točke krivulje. Rasponi su uključivi, s 17 ravnomjerno raspoređenih uzoraka prema zadanim postavkama (–count: 2–256). Ključni okviri i njihovi neposredni susjedi unutar raspona također su uključeni, tako da rijedak broj uzoraka neće sakriti zastoj ključnog okvira. Maksimum je 1024 uzorka; veći zahtjevi zahtijevaju uži raspon. –at uzorkuje jedan okvir. Pregled izvještava koordinate u traženom prostoru i stvarne izvorne okvire; sekunde se poravnavaju s okvirima projekta kao i kod uređivanja.
Za napredne prilagođene upravljače, i X i Y su normalizirani na segment: X je dio njegovog raspona okvira; Y je dio promjene njegove vrijednosti. Prva kontrola dolazi iz handle_right prethodne točke, druga iz handle_left odredišne točke. Izvorne zadane vrijednosti su right=(0.5, 0), left=(0.5, 1), s ravnim tangensima na krajevima. Promjena samo handle_type ne preračunava kontinuirani tangens kroz okolne točke. Postojeći upravljači se čuvaju pri pomicanju točke.
Rasponi ključnih okvira su uključivi, za razliku od vremenskih raspona odabira isječaka. Popis emitira points čije vrijednosti co.X koriste traženi koordinatni prostor/jedinicu. Proslijedite taj niz u keyframe paste --json @points.json s istim prostorom/jedinicom, birajući --mode merge (zamijeni podudarajuće okvire, zadrži ostale) ili --mode replace (zamijeni cijelu krivulju). copy prihvaća izvor iste vrste objekta, opcionalni --source-property, i sidri prvu odabranu izvornu točku na --at na odredištu. Ostale krivulje i izvorni objekti ostaju nepromijenjeni.
transform primjenjuje pozitivnu vremensku skalu oko prve odabrane točke ili --pivot, praćenu potpisanim --offset u odabranoj jedinici. Poravnanje okvira koje stvara duplicirane koordinate odbija se, uključujući sudare s točkama izvan odabranog raspona. Izvorne koordinate moraju ostati barem 1. Izvorni normalizirani Bézier upravljači i interpolacija putuju s svakom točkom; upravljači nisu apsolutne koordinate okvira. set --handles mijenja samo dane upravljače. Interpolacija pripada odredišnoj točki.
clear zadržava konstantnu baznu točku na izvornom okviru 1: navedite --value ili uzorkujte postojeću krivulju s --at (zadano izvorni okvir 1). Uklanjanje posljednje točke također zadržava konstantnu bazu, tako da naknadna dodavanja ključnih okvira ostaju valjana.
Odabir i uređivanje mnogih isječaka
Koristite edit apply --dry-run za provjeru serije bez mijenjanja projekta. Koristite edit bulk za ponavljanje malog predloška naredbe za svaki odabrani isječak, sa svim promjenama grupiranim u jedan korak poništavanja.
Prvo pregledajte odabir:
openshot-cli edit select --json '{"layer":1000000,"start":5,"end":20,"effect":"Saturation"}'
Selektori podržavaju ids (jedinstveni niz ID-ova isječaka), layer, start/end (sekunde na vremenskoj liniji), file_id, effect (naziv klase ili alias) i text (true odabire tekstualne isječke). Filtri se kombiniraju s AND. Vremenski rasponi odabiru isječke koji se preklapaju s [start, end); oni ne skraćuju te isječke. Rezultati su poredani po poziciji, sloju, zatim ID-u, i uključuju ID-ove, sažetke, stanje zaključavanja i trenutnu reviziju. Nepoznati ID-ovi su pogreške. Prazan selektor se odbacuje; koristite {"all":true} eksplicitno za svaki isječak. Odabiri su ograničeni na 256 isječaka i nikada se ne skraćuju tiho.
Na primjer, spremite ovaj niz kao 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}}
]
Potvrdite ga, zatim primijenite na reviziju vraćenu odabirom:
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
Naredbe za postojeće isječke nasljeđuju id; effects.add nasljeđuje clip_id. Izostavite ove ciljne parametre u predlošcima. Uređivanja efekata moraju se odnositi na ranije imenovani rezultat. Imena su lokalna za svaki odabrani isječak, pa look.id odnosi se na različiti efekt za svaki isječak. Za promjenu postojećih instanci efekata po eksplicitnom ID-u nastavite koristiti edit apply. Odabrani skup ID-ova je fiksiran prije proširenja; promjene položaja ili efekata ne mijenjaju preostale ciljeve.
clip set primjenjuje apsolutna svojstva; clip adjust primjenjuje multiply zatim add na numeričko svojstvo ili svaku vrijednost u krivulji, čuvajući vremenski raspored točaka, interpolaciju i normalizirane ručke. Provjerava dobivene vrijednosti, uključujući nenegativne položaje i glasnoću. Strukturna polja ostaju zaštićena.
Masovne operacije odbacuju prazne odabire, zaključane ciljne tragove i više od 256 proširenih naredbi. Svaka proširena operacija prolazi odvojenu provjeru prije bilo kakve žive izmjene. Suhi testovi ne rezerviraju generirane ID-ove. Koristite --expect-revision za odbacivanje zastarjelih odabira. Uspješne serije su jedan korak poništavanja, uključujući nakon spremanja/ponovnog otvaranja. Osvježavanja GUI-ja su grupirana. Neočekivane pogreške u runtime-u/slušaču mogu ostaviti djelomičnu transakciju; pogreška prijavljuje dovršene operacije, a poništavanje vraća tu grupu, kao kod edit apply.
Profili
Otkrivanje profila i usklađivanje uvezenog videa bez nagađanja ID-ova:
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}}'
Unosi u katalog uključuju stabilne ID-ove, opise, dimenzije, racionalni FPS, omjere širine i visine te postavke skeniranja. Popis/pretraživanje je paginirano. Usklađivanje izvora vraća točne ID-ove i rangirane alternative s eksplicitnim razlikama. Postavljanje iz datoteke zahtijeva točno podudaranje osim ako nije specificirano --create-custom; nikada tiho ne bira bliski profil. Statične slike i izvori samo za zvuk ne mogu definirati video profil. Usklađivanje koristi deklarirani FPS izvora.
Prilagođene postavke ugrađene su u spremljeni projekt, uključujući racionalne stope, tako da ponovno otvaranje ne zahtijeva instalaciju zasebne datoteke profila. Promjene profila projekta koriste postojeću konverziju brzine kadrova i jednu transakciju poništavanja. Poništi/ponovi vraća vremenski raspored isječaka i ključne okvire, uključujući pozicije osjetljive na zaokruživanje. Izvoz može neovisno odabrati profil bez mijenjanja projekta.
Spremljena povijest poništavanja slijedi preferenciju ograničenja povijesti uređivača. Ograničenje je mekani proračun akcija: svi zapisi koji pripadaju zadržanim transakcijama se čuvaju, tako da spremanje ne može skratiti veliku seriju u djelomičnu akciju poništavanja. Nula onemogućuje spremljenu povijest. I dalje vrijedi zasebno ograničenje zahtjeva za seriju od 256 naredbi.
Pregled medija i vremenskih linija
Pregledajte vremenski raspored isječaka i raspored tragova kao tekst ili JSON, ili renderirajte slike za pregled kompozicije i kadriranja prije izvoza.
Sažeci vremenske linije
Koristite tekstualni prikaz za brz pregled ili strukturirani JSON za skripte i agente:
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 prema zadanim postavkama prikazuje kompaktni tekst s korištenim tragovima, ID-ovima objekata, intervalima vremenske linije/izvora, stanjem toka, pojačanjem i prazninama/preklapanjima. Koristite --detail summary|clips|full za odabir detalja, --format json za strukturirani kontekst, te --start/--end, --layer i paginaciju za fokusiranje rezultata.
timeline overview pruža kompaktni strukturirani kontekst bez bajtova slike: poredani ID-ovi, redoslijed po tragu, intervali vremenske linije/izvora, vidljivi rasponi rezanja, koordinate okvira, stanje zvuka/videa, efekti i susjedne praznine ili preklapanja. Intervali i rasponi okvira su isključivi na kraju; brojevi okvira su jedinični. Izvorni okviri koriste FPS izvora; koordinate vremenske linije i ključnih okvira koriste FPS projekta. Koristite --layer i --start/--end za fokusiranje, te --limit/--offset za paginaciju (zadano 100, maksimalno 500 stavki). Isječci s vremenskim preslikavanjem eksplicitno zadržavaju zaključane izvore. Koristite vraćenu reviziju s edit apply --expect-revision.
Pregledi okvira i kontaktne ploče
Renderirajte jedan okvir s thumbnail ili uzorkujte raspon s strip. Koristite file za pregled izvornog medija i timeline za pregled složenog videa, uključujući efekte i slojevite isječke:
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
Slike okvira prema zadanim postavkama su 320x180 piksela; kontaktne ploče prema zadanim postavkama su 160x90 po pločici, plus oznake vremenskog koda. Koristite --width i --height za odabir izlaznih piksela. Odgovori uključuju točne metapodatke uzorka/okvira. Kontaktne ploče pomažu u pregledu kompozicije kroz sekvencu; koristite preglede ključnih okvira i renderirani video za procjenu pokreta između tih uzoraka.
Slike vremenske crte
Zabilježite raspored traka uređivača, uključujući njegovu ravnalo, sličice, efekte, prijelaze i valne oblike:
openshot-cli timeline view --start 0 --end 20 --pixels-per-second 80 --output /tmp/tracks.png
Navođenjem --output odabire se format slike; --format image također ga eksplicitno odabire. Snimka ne mijenja prikaz uređivača ili projekt. Odgovori uključuju ID-ove isječaka i vremenske oznake uz granice piksela.
Slike su zadano široke 1280 piksela, a visina se prilagođava korištenim trakama. Koristite --width, --height ili --all-tracks za prilagodbu rasporeda, te --track-size ili --track-label-width za prilagodbu traka i oznaka. Početni/krajnji raspon određuje zum; --pixels-per-second umjesto toga izračunava širinu iz vremenskog raspona.
Prikazi valnih oblika zvuka
Odaberite --mode waveforms za pregled audio omotnica na vremenskoj crti:
openshot-cli timeline view --start 5 --end 12 --mode waveforms --output /tmp/waves.png
--mode auto koristi postojeći predmemorirani prikaz valnog oblika; --mode thumbnails prikazuje umjesto toga sličice. Valni oblici predstavljaju vršne/RMS razine izvora s prilagodbama glasnoće isječka i vremena, prije audio efekata ili miksanja.
Ekstrakcija valnog oblika bez predmemorije dekodira cijele izvore, ograničeno na 600 sekundi po izvoru i 1200 sekundi izvora po zahtjevu. Sužavanje vidljivog raspona ne smanjuje taj posao dekodiranja. Za duže izvore prvo generirajte valne oblike u uređivaču ili koristite način sličica. Naknadni zahtjevi mogu ponovno koristiti predmemorirane valne oblike.
Izlaz slike i ograničenja
Putanje slika moraju biti nove PNG datoteke u postojećim direktorijima. Slike su ograničene na 4096 piksela po osi, ukupno 8.388.608 piksela i 64 uzorka kontakt lista. Zahtjevi izvan ovih ograničenja ne uspijevaju prije renderiranja.
Slike se zapisuju u datoteke; JSON odgovori uključuju njihove putanje i veličine image_bytes. Inspekcija čeka da se slika završi, a veliki zahtjevi mogu nakratko zauzeti uređivač.
Rukovanje istekom vremena naredbi
Istek vremena zahtjeva ne znači da je izmjena neuspjela. Koristite ID operacije iz pogreške s operation get ID prije ponovnog pokušaja. operation list otkriva nedavne izmjene i njihova stanja, revizije i ishode. Završene operacije zadržavaju svoje rezultate ako su dovoljno male, uključujući vraćene ID-eve objekata. Pohrana je ograničena na 100 operacija i 4 MiB, s pojedinačnim tijelima rezultata izostavljenim iznad 256 KiB. Ti zapisi traju samo tijekom aktivne sesije. Ne obnavljaju projekte nakon pada niti sprječavaju ponovljenu naredbu da ponovno primijeni istu izmjenu. Izvozne zadatke imaju vlastite naredbe statusa/liste.