Komut Satırı Arayüzü
OpenShot’u komut satırı iş akışınıza dahil edin. Görüntüleri içe aktarın, klipleri kırpın ve düzenleyin, efektler uygulayın, özellikleri anahtar karelerle canlandırın ve videoları terminalinizden dışa aktarın. Tekrarlayan düzenlemeleri otomatikleştirmek, tekrar eden bir proje için bir betik yazmak veya bir yapay zeka ajanının bir video oluşturup geliştirmesine yardımcı olmasını sağlamak için birkaç komut kullanın.
Komut satırı, editörle aynı projelerle çalışır. Açık bir editörü kontrol edebilir ve ilerlerken değişiklikleri gözden geçirebilir veya bir pencere açmadan başsız oturumda çalışabilirsiniz. Bir oturum, düzenlemeleriniz, geri alma geçmişiniz ve dışa aktarma işleri dahil olmak üzere komutlar arasında projenizi açık tutar. Daha sonra düzenlemeye devam etmek istediğinizde bunu .osp projesi olarak kaydedin.
Başlarken
Yüklü OpenShot çalıştırılabilir dosyanızı --cli ile birlikte kullanın. Oturumlar, düzenleme, animasyon ve kaydetme hakkında kısa bir rehber için intro ile başlayın veya komut genel bakışı için help kullanın. Bu komutlar aktif bir oturum gerektirmez. Aşağıdaki örnekler, komut satırı düzenlemeyi içeren bir OpenShot sürümü gerektirir.
Linux AppImage
İndirilen AppImage dosyanızın bulunduğu dizinden:
./OpenShot.AppImage --cli intro
./OpenShot.AppImage --cli help
OpenShot.AppImage dosyasını indirdiğiniz dosya adıyla değiştirin. Eğer AppImageLauncher masaüstü entegrasyon diyalogları gösteriyorsa, komutu çalıştırmadan önce APPIMAGELAUNCHER_DISABLE=1 olarak ayarlayın:
APPIMAGELAUNCHER_DISABLE=1 ./OpenShot.AppImage --cli intro
Betikler veya tekrar eden komutlar için, mevcut kabuğunuzda bir kez ayarlayın:
export APPIMAGELAUNCHER_DISABLE=1
./OpenShot.AppImage --cli session start
Değişken, AppImage başlatılmadan önce ayarlanmalıdır: AppImageLauncher, OpenShot --cli komutunu almadan önce bunu engelleyebilir. Göreli medya yolları ve @batch.json dosyaları çalışma dizininizden çözülür. Oturumlar veya dışa aktarmalar çalışırken AppImage dosyasını erişilebilir tutun.
Linux Snap
OpenShot Snap için kullanın:
snap run openshot-qt --cli intro
snap run openshot-qt --cli help
snap run openshot-qt --cli session start
Snap’in dosya izinleri komut satırı düzenlemesi için de geçerlidir. Medya, projeler ve dışa aktarmaları Snap’in erişebileceği yerlerde, örneğin ev klasörünüzde tutun. Harici sürücülere erişim izni vermek için removable-media iznini bağlayın:
sudo snap connect openshot-qt:removable-media
Windows
Önemli
Windows’ta komut satırı düzenlemesi için openshot-qt-cmd.exe kullanın. Bu konsol çalıştırılabilir dosyası, komut sonuçlarını, yardım ve hataları terminalinizde gösterir. Masaüstü çalıştırılabilir dosyası openshot-qt.exe ise etkileşimli terminalde standart çıktıyı göstermez, komutları görünür geri bildirim olmadan bırakır ve CLI kullanımını zorlaştırır.
PowerShell’de, OpenShot kurulum dizininden:
& .\openshot-qt-cmd.exe --cli intro
& .\openshot-qt-cmd.exe --cli help
& .\openshot-qt-cmd.exe --cli session start
Farklı bir dizindeyseniz, openshot-qt-cmd.exe için tam yolu kullanın. Çalıştırılabilir dosya adından sonra --cli bırakın.
macOS
Applications içindeki bir kurulum için:
"/Applications/OpenShot Video Editor.app/Contents/MacOS/openshot-qt" --cli intro
"/Applications/OpenShot Video Editor.app/Contents/MacOS/openshot-qt" --cli help
Komutları Bulma
Bu rehber boyunca, openshot-cli yukarıdaki kurulum komutunuzun kısaltmasıdır; örneğin snap run openshot-qt --cli veya ./OpenShot.AppImage --cli. Bazı kurulumlar doğrudan bir openshot-cli komutu da sağlar. Kaynaktan çalıştırırken, OpenShot’un Python ortamında python3 src/launch.py --cli kullanın.
Sadece --cli, --cli help ve --cli --help aynı genel bakışı gösterir. Komutlarda ilerledikçe yardım daha spesifik hale gelir:
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
Grup yardımı, iş akışlarını örneklerle açıklar; işlem yardımı ise argümanları ve davranışı tanımlar. --help, sonundaki help ile eşdeğerdir. Tüm yardım komutları düzenleme oturumu olmadan çalışır.
effects list mevcut efektleri kısa açıklamalarla gösterir. Efekt yardımı, özelliklerini, varsayılanları, seçenekleri ve aralıkları açıklar. effects instances kliplere zaten eklenmiş efektleri, üst klip kimlikleriyle listeler. Sınıf adları, görüntü adları ve alt çizgi takma adları aynı efekti tanımlar.
Betikler ve Yapay Zeka Ajanları ile Çalışma
Codex ve Claude Code gibi yapay zeka kodlama ajanları, terminal komutları aracılığıyla OpenShot projelerini incelemek ve düzenlemek için CLI’yi kullanabilir. Ajanınıza OpenShot çalıştırılabilir dosyanızın yolunu, çalışılacak medya veya projeyi ve istenen sonucu verin: süre, boyutlar, animasyon stili ve çıktı konumu. Başlamadan önce --cli intro komutunu okumasını isteyin. Aynı komutlar kendiniz yazdığınızda veya bir betikten çalıştırdığınızda da geçerlidir.
intro ile başlayın, ardından gerektiğinde komutlara özgü yardımı kullanın. Faydalı bir iş akışı, bir oturum seçmek, projeyi incelemek, küçük bir değişiklik seti yapmak, sonucu gözden geçirmek ve kaydetmektir. Komutlar yapılandırılmış JSON döndürür, böylece betikler ve ajanlar ekran çıktısını yorumlamak yerine nesne kimliklerini ve sonuçları doğrudan kullanabilir.
Düzenlemeden önce inceleyin. İsimleri, parça numaralarını veya zamanlamayı tahmin etmek yerine dönen kimlikleri ve özellik bilgilerini kullanın. Birden fazla proje açık olduğunda bir oturumu açıkça seçin.
Tekrarlanan düzenlemeleri gruplayın. Bir dizi değişiklik için
edit applyveya seçili kliplere bir şablon uygulamak içinedit bulkkullanın. Bir toplu işlemi uygulamadan önce--dry-runile doğrulayın.Animasyonu Kontrol Et. Bir koordinat alanı seçin, birkaç ana kare ile başlayın ve tanıdık hareketler için kolaylaştırma ön ayarlarını kullanın.
keyframe previeweğriyi örnekler, böylece dışa aktarmadan önce duraklamaları veya sıçramaları fark edebilirsiniz. Ayrıca işlenmiş hareketi gözden geçirin; sadece bir iletişim sayfası animasyonun nasıl hissettirdiğini gösteremez.Dışa Aktarımları Kaydedin ve Takip Edin. Projeyi açıkça kaydedin ve bir çıktıyı tamamlanmış olarak kabul etmeden önce dışa aktarma işinin durumunu kontrol edin. Bir istek zaman aşımına uğrarsa, düzenlemeyi tekrarlamadan önce durumunu inceleyin.
Aşağıdaki bölümler bu iş akışlarını ve zamanlama kurallarını açıklar.
Oturumlar ve çıktılar
Bir oturum başlatma veya bulma
Bir başsız oturum başlatın (düzenleyici penceresi olmadan):
openshot-cli session start
Başlangıçta mevcut bir projeyi açmak için --project "/path/project.osp" ekleyin. Başarılı JSON yanıtı result.session_id içerir. Bu değeri kopyalayın. Eğer OpenShot zaten çalışıyorsa veya ID’yi unuttuysanız, mevcut oturumları şu komutla bulun:
openshot-cli session list
Düzenlemeyi planladığınız proje için oturumu seçin. Her komut için yeni bir oturum başlatmanız gerekmez.
Bir oturum seçme
Tüyo
OPENSHOT_SESSION değişkenini bir kez ayarlayın, sonra komutları normal şekilde çalıştırın. Terminaliniz seçilen oturumu hatırlar, bu yüzden her komutta --session parametresini vermenize gerek yoktur. Aşağıdaki PowerShell veya Bash örneğini kullanın.
Aşağıdaki SESSION_ID değerini session start veya session list tarafından döndürülen session_id ile değiştirin.
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
macOS’ta aynı export sözdizimini kullanın. macOS veya Snap komutları için, Kurulum bölümünden yüklemenizin çalıştırılabilir dosyasını değiştirin. Seçim bu terminal ve buradan başlatılan komutlar için geçerlidir. Yeni bir terminalde tekrar ayarlayın veya farklı bir oturuma geçerken güncelleyin.
Kalan düzenleme ve dışa aktarma örnekleri OPENSHOT_SESSION ayarlandığını varsayar. Sonraki alt bölüm, betikler için ID’nin otomatik olarak nasıl yakalanacağını gösterir.
Sadece bir komut için farklı bir oturumu hedeflemek için --session kullanın. Bu, terminalinizin seçimini değiştirmeden OPENSHOT_SESSION değerini geçersiz kılar:
openshot-cli --session OTHER_SESSION_ID project get
Paketlenmiş bir çalıştırılabilir dosyada, bu geçersiz kılmayı --cli’den sonra ve komut grubundan önce koyun: --cli --session OTHER_SESSION_ID project get.
Otomatik seçim yalnızca tam olarak bir erişilebilir oturum olduğunda çalışır. session_required görürseniz, session list çalıştırın ve hedef oturumu açıkça seçin. Artık listelenmiyorsa, tekrar başlatın ve yeni ID’yi kullanın. Yardım, intro ve oturum keşfi seçilmiş bir oturum gerektirmez.
Oturum ID’sini otomatik olarak yakalama
Betikler, session start tarafından döndürülen JSON’dan doğrudan result.session_id okuyabilir ve sonraki komutlar için OPENSHOT_SESSION ayarlayabilir. ID’yi manuel olarak kopyalamaya veya bir günlük dosyası okumaya gerek yoktur. Döndürülen ID’yi kullanmadan önce başlangıcın başarılı olduğunu kontrol edin.
Windows PowerShell (yüklemeniz için çalıştırılabilir dosya yolunu ayarlayın):
$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 (JSON okumak için jq gerektirir):
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
Ortam değişkeni, bu terminalden başlatılan komutlar için bir oturum seçer; sistem genelinde bir ayarı değiştirmez. Bir oturum başlatmak değişkeni otomatik olarak ayarlamaz. Oturumu durdurduktan sonra, PowerShell’de Remove-Item Env:OPENSHOT_SESSION veya Bash’te unset OPENSHOT_SESSION ile seçimi temizleyin.
Bir oturumu gösterme ve durdurma
Seçilen oturumu düzenleyicide göstermek için:
openshot-cli session show
Bir masaüstünde, session show düzenleyiciyi aynı işlemde oluşturur ve canlı projeyi, ID’leri, geçmişi, dışa aktarma işlerini ve bağlantıyı korur. Tekrarlanan çağrılar mevcut pencereyi öne getirir. session start --show hemen açar. Görüntü olmadan veya QT_QPA_PLATFORM=offscreen/minimal ile başlatılan oturumlar daha sonra masaüstü penceresi gösteremez. Bu oturumlar için projeyi kaydedin ve yeni bir masaüstü oturumunda açın. Gösterildikten sonra, oturumu düzenleyici penceresinden kapatın.
Genel seçenekler (--session, --timeout) komuttan önce gelir. session serve denetleyiciler için ön planda kalır; session start arka plan sunucusu kaydolduktan sonra döner. session stop kaydedilmemiş değişiklikleri ve aktif dışa aktarımları reddeder. Kaydedilmemiş düzenlemeleri kasıtlı olarak atmak için yalnızca --discard kullanın.
Komut çıktısı
Sonuçlar, varsayılan metin zaman çizelgesi görünümü hariç stdout üzerinde JSON’dur. Hatalar stderr üzerinde JSON olarak ve çıkış durumu 1 ile döner; argüman ayrıştırıcı hataları çıkış durumu 2 ile döner. Değişiklikler inspect komutuyla kompakt özetler döner. get yerel nesne JSON’u döner. Proje yanıtları bir revizyon içerir; efekt kataloğu yanıtları oturum gerektirmez. Başsız oturumlardan gelen günlükler kayıt defteri kayıtlarının yanında bulunur. OPENSHOT_SESSION_DIR varsayılan ~/.openshot_qt/sessions dizinini geçersiz kılar.
Oturumlar bilgisayarınızda yerel olarak komutları kabul eder. Oturum kayıt defterini gizli tutun, çünkü düzenleme oturumlarınıza erişmek için kullanılan kimlik bilgilerini içerir. Dışa aktarmalar bir anlık görüntüden çalışır, böylece bir iş çalışırken düzenlemeye devam edebilirsiniz.
Projeleri açma ve kaydetme
Bir OpenShot projesi (.osp) düzenlenebilir zaman çizelgenizi saklar. Dışa aktarma tamamlanmış bir video oluşturur; projeyi kaydetmek, daha sonra kliplerine, efektlerine ve anahtar karelerine dönmenizi sağlar. Bir video dışa aktarsanız bile projenizi ayrı olarak kaydedin.
Bir projeyi açma
Mevcut bir projeyle oturum başlatın:
openshot-cli session start --project "/home/me/Videos/My Project.osp"
Düzenleyici penceresini de açmak için --show ekleyin. Zaten çalışan bir düzenleyiciyi kullanmak için session list ile bulun. OPENSHOT_SESSION değerini dönen oturum kimliğine ayarlayın, ardından bir projeyi açın veya inceleyin:
openshot-cli project open "/home/me/Videos/My Project.osp"
openshot-cli project get
Örnek yolu kendi yolunuzla değiştirin ve boşluk içeren yolları tırnak içine alın. project open seçili oturumun mevcut projesini değiştirir. Açıkça --discard eklemediğiniz sürece kaydedilmemiş düzenlemeleri atmayı reddeder; saklamak istiyorsanız önce bu düzenlemeleri kaydedin. CLI üzerinden açmak etkileşimli eksik medya diyaloglarını göstermez, bu yüzden projenin kaynak medyasını erişilebilir tutun.
Yeni, boş bir proje için --project olmadan session start kullanın, ardından Medya İçe Aktarma ve Klip Ekleme bölümünde açıklandığı gibi medyayı içe aktarın ve klipler ekleyin.
Bir projeyi veya kopyasını kaydetme
Yeni bir dosyaya kaydedin veya daha fazla değişiklik yapmadan önce ayrı bir sürüm oluşturun:
openshot-cli project save "/home/me/Videos/My Project v2.osp"
Mevcut bir dosyayı güncellemek için açıkça değiştirmeye izin verin:
openshot-cli project save "/home/me/Videos/My Project v2.osp" --overwrite
Her zaman hedef yolu belirtin. Bir .osp dosyasını kaydetmek, tüm kaynak görüntülerinizi o dosyaya paketlemez; projeyi taşırken veya yeniden açarken referans verilen medyayı erişilebilir tutun.
Bir video dışa aktarma
Projeye ait ayarları kullanarak veya her render için farklı bir çıktı profili seçerek, betiklerden veya yapay zeka ajanlarından render ve dışa aktarmayı otomatikleştirin. Dışa aktarma işleri arka planda çalışabilir veya betiğiniz devam etmeden önce tamamlanmasını bekleyebilir. Projenin çözünürlüğü ve kare hızıyla MP4 render etmek için:
openshot-cli export start "/home/me/Videos/video.mp4" --wait
Varsayılan olarak, OpenShot H.264 video ve AAC ses kullanır. Örnek yolu, mevcut bir klasör ve yeni bir dosya adı kullanarak hedefinizle değiştirin. Mevcut çıktılar asla üzerine yazılmaz. Dışa aktarma, düzenlenebilir .osp projenizi kaydetmez; düzenleme çalışmalarınızı korumak için ayrı olarak project save kullanın.
--wait seçeneği, dışa aktarma tamamlanana veya hata bildirene kadar komutun çalışmasını sürdürür. Paylaşmadan önce tamamlanan videoyu inceleyin.
Dışa aktarma ilerlemesini kontrol etme
Arka planda dışa aktarmayı başlatmak için --wait eklemeyin. Yanıt, ilerlemeyi kontrol etmek için kullanabileceğiniz bir iş kimliği içerir:
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
JOB_ID değerini dönen kimlikle değiştirin. Bekleme süresi dolarsa, dışa aktarma çalışmaya devam eder; başka bir dışa aktarma başlatmak yerine aynı işi kontrol edin. Bir işi durdurmak için export cancel JOB_ID kullanın. Her iş başladığında zaman çizelgesini yakalar, böylece sonraki düzenlemeler zaten devam eden dışa aktarmayı değiştirmez.
Bekleme süresi varsayılan olarak 600 saniyedir; bunu --wait-timeout ile ayarlayın. Bu, genel istek başına --timeout ayarından ayrıdır. Dışa aktarma hataları, iptaller ve bekleme zaman aşımı durumlarında durum 1 ile çıkılır ve iş detayları dahil edilir.
Birden çok profilde dışa aktarma
Her çıktı için bir dışa aktarma profili seçerek aynı zaman çizelgesini farklı çözünürlüklerde veya en boy oranlarında dışa aktarın. Bir dışa aktarma profili yalnızca o işe uygulanır; düzenleme projesinin profilini değiştirmez. Bir profil boyutları, kare hızını ve en boy oranını belirler; bir dışa aktarma ön ayarı MP4/H.264 gibi kodlama ayarlarını seçer.
Mevcut profilleri bulun ve ayarlarını inceleyin:
openshot-cli profile list --search 720
openshot-cli profile list --search 1080
openshot-cli profile get builtin:01280x0720p0030_16-09
Örneğin, 720p ve 1080p çözünürlüklerinde yatay versiyonları, ardından 1080x1080 karede kare bir versiyonu dışa aktarın. Bu profillerin hepsi 30 fps kullanır:
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
Her versiyon için farklı bir çıktı dosya adı kullanın. Eşleşen versiyonlar istediğinizde işler arasında düzenlemeleri değiştirmeden tutun. En boy oranını değiştirmek çerçeveyi değiştirebilir: her çıktıyı, özellikle başlıkları ve animasyonlu nesneleri inceleyin. Ayrı olarak oluşturulmuş kare veya portre versiyonu için proje kopyası kaydedin, proje profilini değiştirin ve dışa aktarmadan önce klipleri ayarlayın. Özel profiller ve kodlama seçenekleri için aşağıdaki Profiller ve dışa aktarma ayarlarına bakın.
Birden çok projeyi toplu dışa aktarma
Birden çok kaydedilmiş projeyi sırayla render etmek için tek bir başsız oturumu yeniden kullanın. Bir projeyi açın, --wait ile dışa aktarın, sonra sonraki projeyi açın. Aşağıdaki örnekler her projenin kendi çözünürlüğü ve kare hızını kullanır ve .osp dosyalarının yanında MP4 dosyaları oluşturur. Her proje için tek bir çıktı profili kullanmak üzere dışa aktarma komutuna --profile PROFILE_ID ekleyin.
İlk olarak yukarıdaki eşleşen otomatik oturum kimliği örneğini aynı terminalde başarıyla çalıştırın. Bu, openshot’u tanımlar ve yeni oturumu seçer. Aşağıdaki proje yollarını kendi yollarınızla değiştirin. Zaten var olmayan farklı çıktı isimleri kullanın; örnekler toplu işlem başlamadan önce tüm hedefleri kontrol eder.
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 (parantezler hata yönetimini toplu işlem içinde tutar):
(
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
Her iki yöntem de bir komut hatasında toplu işlemi durdurur ve oturumu inceleme için kullanılabilir bırakır. Buradaki bekleme sınırı ihracat başına 24 saattir. Bekleme zaman aşımı render işlemini çalışır durumda bırakır: yeniden denemeden önce export list ve export status JOB_ID --wait kullanın. Tamamlanan videolar diskte kalır; devam etmeden önce tamamlanan projeleri toplu işlemden kaldırın. Bir hatayı çözdükten sonra oturumu durdurun ve işiniz bittiğinde ortam değişkenini temizleyin.
Ön ayarları ve kodlama ayarlarını seçme
Yüklü ihracat ön ayarlarını ve desteklenen ayarları keşfedin:
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 ayrıca isteğe bağlı --create-custom ile birlikte --from-file FILE_ID kabul eder. Ayarlar şu sırayla çözülür: proje varsayılanları, ön ayar, gelişmiş JSON, açık profil/kalite/aralık bayrakları. Gelişmiş JSON video/ses kodekleri ve bit hızı, ses düzeni/hızı/kanalları, yerel kodek seçenekleri, donanım aygıt ayarları ve iş parçacığı sayıları gibi özellikleri açığa çıkarır.
Örneğin, gelişmiş JSON aracılığıyla bir kodlayıcı seçeneği seçin:
openshot-cli export start /tmp/small.mp4 --profile builtin:00640x0360p0030_16-09 --json '{"video_options":{"preset":"fast"}}' --wait
İhracat ayarlarını doğrulama
Render işlemine başlamadan önce ayarları kontrol edin:
openshot-cli export validate /tmp/reel.mp4 --preset builtin:format_mp4_x264
Yetenekler raporu derlenmiş kodek kullanılabilirliğini bildirir, fiziksel GPU kullanılabilirliğini değil. Doğrulama daha ileri gider: kodlayıcıları (donanım kodlayıcılar dahil) ve konteyneri tam ayarlarla, ayrı bir süreçte, dosya yazmadan açar. Konteynerin tutamadığı bir kombinasyon incompatible_export hatası verir, FFmpeg’in kendi açıklaması ve değiştirilmesi gereken ayar (details.cause.path) ile birlikte:
openshot-cli export validate /tmp/song.mp3 --json '{"mode":"audio","format":"mp3","audio_codec":"aac"}'
İhracat çalışanı render işleminden önce aynı kontrolü yapar.
Bir kare aralığını render etme
Zaman çizelgesinin bir bölümünü render etmek için --start-frame ve --end-frame kullanın. Aralıklar dahilidir ve ihracat profilinin FPS’ine göre 1 tabanlıdır. Örneğin, ilk 90 kareyi 30 fps (üç saniye) olarak render edin:
openshot-cli export start /tmp/excerpt.mp4 --profile builtin:01280x0720p0030_16-09 --start-frame 1 --end-frame 90 --wait
Yalnızca ses ihracatları ve görüntü dizileri
Gelişmiş JSON ile bir çıktı modu seçin:
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
Görüntü dizileri yeni bir çıktı dizini gerektirir. Mevcut çıktılar asla üzerine yazılmaz.
Düzenleme
Klipler ve efektler ekleme
import/add/list tarafından döndürülen kimlikleri kullanın ve katman numaralarını project get ile keşfedin:
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
Mümkün olduğunda proje profilini erken seçin; dolu projeler ayrıca mevcut FPS dönüşümü ve geri alma sistemi aracılığıyla profil değişikliklerini destekler. Klip oluştururken --audio-only video görüntüsünü, müzik dosyalarındaki gömülü kapak resmi dahil, engeller. Bu klibi Ses Görselleştirme için kullanmak istiyorsanız, video ve sesini etkinleştirin ve efektin şeffaf bindirmeler ve katman yerleşimi için yardımını izleyin.
Klip zamanlamasını anlama
Örnek anahtar kareler 30 fps projeyi ve kaynakta 10 saniyede kırpılmış bir klibi varsayar. Pozisyon zaman çizelgesi saniyesindedir; başlangıç/bitiş kaynak saniyesidir, bitiş hariçtir. Kareler 1’den başlar. Dosya küçük resim kareleri kaynak FPS kullanır. Zaman çizelgesi kareleri proje FPS kullanır. Klip anahtar kareleri proje FPS’de kaynak koordinatlarını kullanır, bu yüzden klip kırpılması ilk görünür anahtar kareyi kare 1’e taşımaz.
Özellikleri değiştirme
set üst düzey özellikleri birleştirir. Skalarlar anahtar kareli özellikleri sabitlere dönüştürür. Sağlanan iç içe eğri o eğrinin yerine geçer; sadece bir noktayı değiştirmek için keyframe set kullanın. JSON argümanları satır içi JSON, @file.json veya stdin için - kabul eder. Özellik adları, türleri, enumlar, anahtar kareler, referanslar ve zamanlama proje düzenlenmeden önce doğrulanır. Hatalar alanı, beklenen değeri, alınan değeri ve mümkünse düzeltmeyi belirtir. Motorun desteklediği durumlarda GUI kaydırıcı aralıkları öneri niteliğindedir.
Geçişler ekleme
clip fade ID --in 0.5 --out 0.5 kaynak kırpma anahtar kare koordinatlarını otomatik olarak hesaplar. Alfa eğrisinin yerine geçer; bunun yerine --property volume --value 0.25 0.25 tepe kazançlı bir ses geçişi oluşturur. Süreler ilk ve son görünür kareler arasında olmalıdır; geçiş çıkışı son karede sıfıra ulaşır.
Klipleri bölme
clip split ID --at 6.5 zaman çizelgesi saniyelerini kullanır, en yakın proje karesine yapışır ve her iki yarıyı da korur. Kaynak koordinat eğrilerini tutar ve sağ yarıda yeni kimliklerle efektleri çoğaltır, editörün dilimleme davranışını takip eder. Sol yarı kimliğini korur. Yanıt istenen/gerçek bölme zamanlarını ve her iki özetini rapor eder; adlandırılmış toplu sonuç {"$ref":"cut.right.id"} destekler. Bölmeler uç noktaları ve kilitli parçaları reddeder. Geri al işlemi orijinal klibi tek bir işlemde geri yükler.
Metin ekleme ve stil verme
text add bir metin oluşturur ve bunu klip olarak yerleştirir, editörün Metin aracındaki aynı metni kullanır. Atladığınız seçenekler editörün varsayılan stilini kullanır:
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
Kelime, yazı tipi, boyut, hizalama, kutu genişliği ve varsayılan renkler Proje Dosyalarındaki metne aittir ve editörde olduğu gibi onu kullanan her klip tarafından paylaşılır. Bir klipte text set bunların hepsini değiştirir ve changed_clip_ids içinde listeler; --this-clip-only önce o klibe kendi kopyasını verir. clip add FILE_ID text list den başka bir metin klibi yerleştirir. Boyutlar proje çözünürlüğünde pikseldir ve renkler #RRGGBB, #AARRGGBB (alfa ile), bir CSS adı veya transparent olabilir. --place kutuyu ortaya, bir kenara veya köşeye ya da alt üçte birine yerleştirir. --line-spacing satırlar arasındaki normal mesafenin katıdır (1 normaldir) ve --background-corner arka plan ve kenar köşelerini o kadar piksel yuvarlar.
Bir metin klibi sıradan bir kliptir. Konum, ölçek, döndürme, opaklık, zamanlama, geçişler, hareket ön ayarları ve efektler tümü normal clip komutlarını kullanır. Yazı tipi boyutu, dolgu, kutu genişliği ve harf ile satır aralığı metin kutusunun boyutunu belirler, bu yüzden ana karelenemezler; metin boyutunu canlandırmak için klibin ölçeğini ana kareleyin. Her klip, kendi metin renklerini, dış hat ve kenar genişliklerini diğer özelliklerdeki ana kare komutlarıyla canlandırabilir:
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
Canlandırılan özellikler text_color, text_background, text_stroke ve text_border (renkler, .red, .green, .blue ve 0 ile 255 arasında .alpha ile), ayrıca text_stroke_width, text_border_width ve text_background_corner dir. Bir klibin kendi animasyonu paylaşılan stilden üstün gelir ve text get bir klibin hangi stilleri canlandırdığını listeler. text reset CLIP_ID bir klibi varsayılan stile döndürür, tıpkı Metin → Stili Sıfırla gibi; --keyframes-only sadece klibin kendi animasyonunu kaldırır. Birden çok metni aynı anda stil vermek için {"text":true} ile seçin:
openshot-cli edit bulk --select '{"text":true}' --json '[{"method":"text.set","params":{"font_family":"Noto Sans","stroke_width":2}}]'
Bir dizi düzenlemeyi uygulama
edit apply --json @edits.json --expect-revision 12 noktalı komut isimleri kullanarak (örneğin clip.set ve effects.add; eski effect.add yazımı da çalışır) 256’ya kadar sıralı değişiklik komutunu kabul eder:
[
{"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}}
]
İsteğe bağlı as aynı partide sonraki komutlar için bir sonucu bağlar. {"$ref":"shot.id"} nesnesi o sonucun alanını yerine koyar. Referanslar yalnızca önceki isimleri çözer; yazım hataları, ileri referanslar ve yinelenen isimler canlı güncellemelerden önce başarısız olur. Yanıt sıralı sıkıştırılmış sonuçları ve gerçek kimliklerin refs haritasını içerir. Başarılı bir partideki tüm değişiklikler tek bir geri al/ileri adımı oluşturur. project.profile.set ayrıca dolu zaman çizelgelerini destekler. Açma, kaydetme, dışa aktarma ve inceleme komutları düzenleme partilerinin dışında kalır. Her komutun yardımında JSON parametre isimleri listelenir, kabuk bayraklarının alt çizgi yazımı dahil (örneğin, --fps-num fps_num olur).
Partileri doğrulama ve hataları yönetme
Düzenleme partilerindeki tüm komutlar, canlı güncellemelerden önce ayrılmış bir projeye karşı ön kontrol yapar. Geçersiz giriş, canlı proje ve revizyonu değiştirmez. Geçerli partiler tek bir geri alma grubu oluşturur. Beklenmeyen çalışma zamanı hataları yine de kısmi değişiklikler yapabilir; hatalar tamamlanan işlemleri bildirir. Zaman aşımı iptal anlamına gelmez, bu yüzden değişiklikleri yeniden denemeden önce durumu kontrol edin.
Hassas ana kare düzenleme
clip, transition ve effects keyframe list, set, remove, clear, transform, copy ve paste komutlarını destekler. Özellik yolları, Chroma Key efektindeki color.red gibi iç içe eğrilere erişebilir. İç içe eğri düzenleme kardeş kanalları korur. Eğri yollarını ve nokta sayılarını keşfetmek için bir özellik olmadan keyframe list ID çalıştırın. Keşif ve nokta listeleri kırpma/konum zamanlama bağlamını içerir; nokta listeleri ayrıca yerel kare koordinatlarını bildirir. get ve properties tam yerel nesne ve özellik meta verilerini açığa çıkarır. Hatalar geçersiz alanları tanımlar, yakın özellik isimleri önerir ve koordinat düzeltmelerini açıklar.
Koordinatları açıkça seçmek için --space native|clip|timeline ve --unit frames|seconds kullanın. Tüm kareler proje FPS’sini kullanır ve 1 tabanlıdır; saniyeler sıfırdan başlar ve en yakın kareye yapışır. Native mevcut motor ana kare koordinatıdır (kaynak kırpma dahil). Klip koordinatları görünür klibin başlangıç noktasından başlar; zaman çizelgesi koordinatları proje zaman sıfırından başlar. Ekli efektler ebeveyn klibin zamanlamasını kullanır. Bu koordinatlar animasyon zamanını adresler, zaman yeniden eşleme eğrisiyle seçilen medya karelerini değil.
30 fps projede 5 saniyede konumlandırılmış, 2 saniye kırpılmış bir klip için, klip karesi 1, zaman çizelgesi karesi 151 ve yerel kare 61 aynı noktaya işaret eder. Konum ve kırpma, proje kare ızgarasına bağımsız olarak yapışır. Tüm eğriyi listelemek, pozitif olmayan klip/zaman çizelgesi koordinatlarına sahip gizli noktaları içerebilir. Eski --frame hâlâ yerel kare anlamına gelir ve --at ile birleştirilemez.
Örnekler:
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
Enterpolasyon, kolaylaştırma ve önizleme
Enterpolasyon, hedef noktaya doğru olan segmenti tanımlar. Doğrusal, noktalar arasında sabit bir hız sağlar. Sabit, hedefe kadar önceki değeri tutar, sonra atlar. Yerel varsayılan Bezier tutamaçları her segmentin her iki ucunda kolaylaştırma yapar. Ara bir nokta eklemek istenmeyen bir yavaşlamaya neden olabilir; tek bir kolaylaştırılmış hareket için iki uç noktadan başlayın. Normalde tutamaçları değiştirmeyin ve belirli bir stil için isimlendirilmiş bir ön ayar seçin.
Oturum olmadan editörün menülerinde kullanılan aynı kolaylaştırma önayarlarını keşfedin:
openshot-cli clip keyframe presets
Hedefini ayarlayarak gelen segmente bir önayar uygulayın:
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
Kolaylaştırma seçeneği Bezier anlamına gelir. Önceki noktanın çıkan tutamağını ve hedefin gelen tutamağını birlikte ayarlar, diğer tutamaçları ve nokta değerlerini korur. Önceki bir nokta olmalıdır. Bunu özel tutamaçlarla veya farklı bir enterpolasyonla birleştirmeyin. Önayarlar toplu ve toplu şablonlarda çalışır. GUI önayarı ease (“Ease (Default)”) sade Bezier enterpolasyonunda kullanılan yerel tutamaçlardan farklıdır. Geri önayarlar uç nokta değerlerini aşabilir.
Yerel eğri değerlendiricisini kullanarak render almadan önce hareketi inceleyin:
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
Önizleme salt okunurdur ve efektler ile geçişler için aynı şekilde çalışır. Hemen bitişik karelerden hesaplanan, özellik birimi/saniye cinsinden değerler ve işaretli gelen_hız / giden_hız döner. Bunlar sonlu farklardır, analitik türevler değildir. Yerel kare 1’de gelen hız sıfırdır. Bitişik kare hızları istenen aralığın dışını inceleyebilir. İç noktadaki sıfıra yakın hızlar duraklamayı gösterir; farklı hızlar hız değişimini gösterir. Sabit enterpolasyon hedefte bir atlamayı gösterir.
Bir aralık olmadan, önizleme eğrinin ilk ve son noktalarını kapsar. Aralıklar kapsayıcıdır, varsayılan olarak 17 eşit aralıklı örnek (–count: 2–256). Aralıktaki anahtar kareler ve hemen yanlarındaki komşular da dahil edilir, böylece seyrek örnek sayısı bir anahtar kare duraklamasını gizlemez. Maksimum 1024 örnektir; daha büyük istekler daha dar bir aralık gerektirir. –at bir kare örnekler. Önizleme istenen alan koordinatlarını ve gerçek yerel kareleri raporlar; saniyeler düzenlemede olduğu gibi proje karelerine yapışır.
Gelişmiş özel tutamaçlar için, hem X hem Y segment için normalize edilir: X kare aralığının bir kesri; Y değer değişiminin bir kesri. İlk kontrol önceki noktanın handle_right’ından, ikincisi hedefin handle_left’inden gelir. Yerel varsayılanlar right=(0.5, 0), left=(0.5, 1) ve düz uç noktası teğetleridir. Sadece handle_type değiştirmek çevredeki noktalar boyunca sürekli bir teğeti yeniden hesaplamaz. Bir nokta taşınırken mevcut tutamaçlar korunur.
Anahtar kare aralıkları klip seçimi zaman aralıklarının aksine kapsayıcıdır. Liste, istenen koordinat alanı/birimini kullanan co.X değerlerine sahip points yayınlar. Bu diziyi aynı alan/birim ile keyframe paste --json @points.json komutuna geçin, --mode merge (eşleşen kareleri değiştir, diğerlerini koru) veya --mode replace (tüm eğriyi değiştir) seçin. copy aynı türden bir kaynak kabul eder, isteğe bağlı --source-property ve ilk seçilen kaynak noktasını hedefte --at ile sabitler. Diğer eğriler ve kaynak nesneler değişmeden kalır.
transform ilk seçilen nokta veya --pivot etrafında pozitif bir zaman ölçeği uygular, ardından seçilen birimde işaretli --offset gelir. Çoğaltılmış koordinatlar oluşturan kare yapışmaları reddedilir, seçilen aralık dışındaki noktalarla çakışmalar dahil. Yerel koordinatlar en az 1 olmalıdır. Yerel normalize edilmiş Bézier tutamaçları ve enterpolasyon her noktayla birlikte hareket eder; tutamaçlar mutlak kare koordinatları değildir. set --handles yalnızca sağlanan tutamaçları değiştirir. Enterpolasyon hedef noktaya aittir.
clear yerel kare 1’de sabit bir temel nokta tutar: --value belirtin veya mevcut eğriyi --at ile örnekleyin (varsayılan yerel kare 1). Son noktayı kaldırmak da sabit bir temel tutar, böylece sonraki anahtar kare eklemeleri geçerli kalır.
Birçok klibi seçme ve düzenleme
Projeyi değiştirmeden bir topluluğu doğrulamak için edit apply --dry-run kullanın. Seçilen her klip için küçük bir komut şablonunu tekrarlamak ve tüm değişiklikleri tek bir geri alma adımında gruplayarak uygulamak için edit bulk kullanın.
Önce bir seçimi önizleyin:
openshot-cli edit select --json '{"layer":1000000,"start":5,"end":20,"effect":"Saturation"}'
Seçiciler ids (benzersiz klip ID dizisi), layer, start/end (zaman çizelgesi saniyeleri), file_id, effect (sınıf adı veya takma ad) ve text (true metin kliplerini seçer) destekler. Filtreler VE ile birleştirilir. Zaman aralıkları [start, end) ile örtüşen klipleri seçer; bu klipleri kırpmaz. Sonuçlar pozisyona, katmana, sonra ID’ye göre sıralanır ve ID’ler, özetler, kilit durumu ve mevcut revizyonu içerir. Bilinmeyen ID’ler hata verir. Boş bir seçici reddedilir; her klip için açıkça {"all":true} kullanın. Seçimler 256 kliple sınırlandırılmıştır ve asla sessizce kısaltılmaz.
Örneğin, bu diziyi templates.json olarak kaydedin:
[
{"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}}
]
Doğrulayın, ardından seçimin döndürdüğü revizyona uygulayın:
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
Mevcut klip komutları id miras alır; effects.add clip_id miras alır. Şablonlarda bu hedef parametreleri atlayın. Efekt düzenlemeleri önceki adlandırılmış bir sonuca referans vermelidir. İsimler her seçili klibe özgüdür, bu yüzden look.id her klip için farklı bir efekti ifade eder. Mevcut efekt örneklerini açık ID ile değiştirmek için edit apply kullanmaya devam edin. Seçilen ID seti genişletmeden önce sabittir; pozisyon veya efekt değişiklikleri kalan hedefleri değiştirmez.
clip set mutlak özellikleri uygular; clip adjust sayısal bir özelliğe veya bir eğrideki her değere önce multiply sonra add uygular, nokta zamanlaması, enterpolasyon ve normalize edilmiş tutamaçları korur. Sonuç değerleri, negatif olmayan pozisyonlar ve ses seviyesi dahil olmak üzere doğrular. Yapısal alanlar korunmaya devam eder.
Toplu işlemler boş seçimleri, kilitli hedef parçaları ve 256’dan fazla genişletilmiş komutu reddeder. Her genişletilmiş işlem, canlı düzenlemeden önce bağımsız ön kontrolü geçer. Kuru çalıştırmalar oluşturulan ID’leri ayırmaz. Bayat seçimleri reddetmek için --expect-revision kullanın. Başarılı partiler, kaydetme/yeniden açma sonrası dahil olmak üzere tek bir geri alma adımıdır. GUI yenilemeleri toplu yapılır. Beklenmeyen çalışma zamanı/dinleyici hataları yine de kısmi bir işlem bırakabilir; hata tamamlanan işlemleri raporlar ve geri alma, edit apply ile olduğu gibi o grubu geri alır.
Profiller
Profilleri keşfedin ve ID tahmini yapmadan içe aktarılan videoyu eşleştirin:
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}}'
Katalog girdileri sabit ID’ler, açıklamalar, boyutlar, rasyonel FPS, en boy oranları ve tarama ayarlarını içerir. Listeleme/arama sayfalıdır. Kaynak eşleştirme tam ID’ler ve açık farklarla sıralanmış alternatifler döndürür. Dosyadan ayarlama, --create-custom belirtilmedikçe tam eşleşme gerektirir; asla yakın bir profili sessizce seçmez. Sabit görüntüler ve sadece ses kaynakları video profili tanımlayamaz. Eşleştirme bildirilen kaynak FPS’sini kullanır.
Özel ayarlar, rasyonel oranlar dahil olmak üzere kaydedilen projeye gömülüdür, böylece yeniden açmak ayrı bir profil dosyası yüklemeyi gerektirmez. Proje profil değişiklikleri mevcut kare hızı dönüşümünü ve tek bir geri alma işlemini kullanır. Geri al/yinele, yuvarlamaya duyarlı pozisyonlar dahil olmak üzere klip zamanlamasını ve anahtar kareleri geri yükler. Dışa aktarma, projeyi değiştirmeden bağımsız olarak bir profil seçebilir.
Kaydedilen geri alma geçmişi, editörün geçmiş sınırı tercihini takip eder. Bu sınır yumuşak bir işlem bütçesidir: tutulan işlemlere ait tüm kayıtlar saklanır, böylece kaydetme büyük bir partiyi kısmi geri alma işlemine kısaltamaz. Sıfır, kaydedilen geçmişi devre dışı bırakır. Ayrı 256 komutluk toplu istek sınırı hala geçerlidir.
Medya ve zaman çizelgelerini inceleme
Klip zamanlamasını ve parça düzenini metin veya JSON olarak inceleyin veya dışa aktarmadan önce kompozisyon ve çerçevelemeyi gözden geçirmek için görüntüler oluşturun.
Zaman çizelgesi özetleri
Hızlı genel bakış için metin görünümü veya betikler ve ajanlar için yapılandırılmış JSON kullanın:
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 varsayılan olarak kullanılan parçalar, nesne ID’leri, zaman çizelgesi/kaynak aralıkları, akış durumu, kazanç ve boşluk/örtüşmelerle kompakt metin gösterir. Ayrıntı seçmek için --detail summary|clips|full, yapılandırılmış bağlam için --format json, ve sonucu odaklamak için --start/--end, --layer ve sayfalama kullanın.
timeline overview görüntü baytları olmadan kompakt yapılandırılmış bağlam sağlar: sıralı ID’ler, parça başına sıra, zaman çizelgesi/kaynak aralıkları, görünür kırpma aralıkları, kare koordinatları, ses/görüntü durumu, efektler ve komşu boşluklar veya örtüşmeler. Aralıklar ve kare aralıkları son hariçtir; kare numaraları bir tabanlıdır. Kaynak kareler kaynak FPS’sini kullanır; zaman çizelgesi ve anahtar kare koordinatları proje FPS’sini kullanır. Odaklamak için --layer ve --start/--end, sayfalama için --limit/--offset kullanın (varsayılan 100, maksimum 500 öğe). Zaman yeniden eşlenen klipler açıkça çıkarılan kaynak eşlemelerini tutmaz. Döndürülen revizyonu edit apply --expect-revision ile kullanın.
Kare önizlemeleri ve iletişim sayfaları
Tek bir kareyi thumbnail ile oluşturun veya bir aralığı strip ile örnekleyin. Kaynak medyayı incelemek için file, efektler ve katmanlı klipler dahil oluşturulmuş videoyu incelemek için timeline kullanın:
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
Kare görüntüleri varsayılan olarak 320x180 pikseldir; iletişim sayfaları varsayılan olarak her karo için 160x90 ve zaman kodu etiketleri içerir. Çıktı pikselini seçmek için --width ve --height kullanın. Yanıtlar tam örnek/kare meta verilerini içerir. İletişim sayfaları, bir dizi boyunca kompozisyonu gözden geçirmeye yardımcı olur; bu örnekler arasındaki hareketi değerlendirmek için anahtar kare önizlemeleri ve oluşturulmuş videoyu kullanın.
Zaman Çizgisi Görüntüleri
Düzenleyicinin cetveli, küçük resimleri, efektleri, geçişleri ve dalga formları dahil olmak üzere parça düzenini yakalayın:
openshot-cli timeline view --start 0 --end 20 --pixels-per-second 80 --output /tmp/tracks.png
--output belirtmek görüntü formatını seçer; --format image de bunu açıkça seçer. Yakalama, düzenleyicinin görünüm alanını veya projesini değiştirmez. Yanıtlar, piksel sınırlarıyla birlikte klip kimlikleri ve zamanlamayı içerir.
Görüntüler varsayılan olarak 1280 piksel genişliğindedir ve yükseklik kullanılan parçalara göre ayarlanır. Düzeni ayarlamak için --width, --height veya --all-tracks kullanın; parçalar ve etiketler için --track-size veya --track-label-width kullanın. Başlangıç/bitiş aralığı yakınlaştırmayı belirler; --pixels-per-second ise genişliği zaman aralığından türetir.
Ses dalga formu görünümleri
Zaman çizgisinde ses zarfını incelemek için --mode waveforms seçin:
openshot-cli timeline view --start 5 --end 12 --mode waveforms --output /tmp/waves.png
--mode auto mevcut önbelleğe alınmış dalga formu görüntüsünü kullanır; --mode thumbnails ise küçük resimleri gösterir. Dalga formları, ses efektleri veya miksajdan önce klip ses seviyesi ve zamanlama ayarlarıyla kaynak tepe/RMS seviyelerini temsil eder.
Önbelleğe alınmamış dalga formu çıkarımı tüm kaynakları çözer, kaynak başına 600 saniye ve istek başına 1200 kaynak-saniye ile sınırlıdır. Görünen aralığı daraltmak bu çözümleme işini azaltmaz. Daha uzun kaynaklar için önce düzenleyicide dalga formları oluşturun veya küçük resim modunu kullanın. Sonraki istekler önbelleğe alınmış dalga formlarını yeniden kullanabilir.
Görüntü çıktısı ve sınırlar
Görüntü yolları mevcut dizinlerde yeni PNG dosyaları olmalıdır. Görüntüler eksen başına 4096 piksel, toplamda 8.388.608 piksel ve 64 kontak sayfası örneği ile sınırlıdır. Bu sınırların üzerindeki istekler render öncesi başarısız olur.
Görüntüler dosyalara yazılır; JSON yanıtları yollarını ve image_bytes boyutlarını içerir. İnceleme görüntünün bitmesini bekler ve büyük istekler düzenleyiciyi kısa süreliğine meşgul edebilir.
Komut zaman aşımı yönetimi
Bir istek zaman aşımı, bir değişikliğin başarısız olduğu anlamına gelmez. Yeniden denemeden önce hatadaki işlem kimliğini operation get ID ile kullanın. operation list son değişiklikleri, durumlarını, revizyonlarını ve sonuçlarını keşfeder. Tamamlanan işlemler, döndürülen nesne kimlikleri dahil olmak üzere yeterince küçük olduklarında sonuçlarını korur. Depolama 100 işlem ve 4 MiB ile sınırlıdır, 256 KiB üzerindeki bireysel sonuç gövdeleri atlanır. Bu kayıtlar yalnızca çalışan oturum için geçerlidir. Çökme sonrası projeleri geri yüklemez veya tekrarlanan bir komutun aynı düzenlemeyi tekrar uygulamasını engellemez. Dışa aktarma işleri kendi durum/liste komutlarına sahiptir.