Antarmuka Baris Perintah

Bawa OpenShot ke dalam alur kerja baris perintah Anda. Impor rekaman, potong dan susun klip, terapkan efek, animasikan properti dengan keyframe, dan ekspor video dari terminal Anda. Gunakan beberapa perintah untuk mengotomatisasi pengeditan berulang, tulis skrip untuk proyek yang berulang, atau biarkan agen AI membantu merakit dan menyempurnakan video.

Baris perintah bekerja dengan proyek yang sama seperti editor. Anda dapat mengontrol editor yang terbuka dan meninjau perubahan saat berjalan, atau bekerja dalam sesi tanpa kepala tanpa membuka jendela. Sesi menjaga proyek Anda tetap terbuka antara perintah, termasuk pengeditannya, riwayat batal, dan pekerjaan ekspor. Simpan sebagai proyek .osp kapan pun Anda ingin melanjutkan pengeditan nanti.

Memulai

Gunakan executable OpenShot yang terpasang diikuti dengan --cli. Mulai dengan intro untuk panduan singkat tentang sesi, pengeditan, animasi, dan penyimpanan, atau help untuk gambaran perintah. Perintah ini tidak memerlukan sesi aktif. Contoh di bawah memerlukan build OpenShot yang menyertakan pengeditan baris perintah.

Linux AppImage

Dari direktori yang berisi AppImage yang Anda unduh:

./OpenShot.AppImage --cli intro
./OpenShot.AppImage --cli help

Ganti OpenShot.AppImage dengan nama file yang Anda unduh. Jika AppImageLauncher menampilkan dialog integrasi desktop, atur APPIMAGELAUNCHER_DISABLE=1 sebelum menjalankan perintah:

APPIMAGELAUNCHER_DISABLE=1 ./OpenShot.AppImage --cli intro

Untuk skrip atau perintah berulang, atur sekali di shell Anda saat ini:

export APPIMAGELAUNCHER_DISABLE=1
./OpenShot.AppImage --cli session start

Variabel harus diatur sebelum menjalankan AppImage: AppImageLauncher dapat mencegatnya sebelum OpenShot menerima --cli. Jalur media relatif dan file @batch.json diselesaikan dari direktori kerja Anda. Jaga file AppImage tetap tersedia saat sesi atau ekspornya berjalan.

Linux Snap

Untuk OpenShot Snap, gunakan:

snap run openshot-qt --cli intro
snap run openshot-qt --cli help
snap run openshot-qt --cli session start

Izin file Snap juga berlaku untuk pengeditan baris perintah. Simpan media, proyek, dan ekspor di lokasi yang dapat diakses Snap, seperti folder rumah Anda. Untuk mengizinkan akses ke drive eksternal, sambungkan izin removable-media:

sudo snap connect openshot-qt:removable-media

Windows

Penting

Gunakan openshot-qt-cmd.exe untuk pengeditan baris perintah di Windows. Executable konsol ini menampilkan hasil perintah, bantuan, dan kesalahan di terminal Anda. Executable desktop, openshot-qt.exe, tidak menampilkan output standar di terminal interaktif, sehingga perintah tidak memiliki umpan balik yang terlihat dan membuat CLI sulit digunakan.

Di PowerShell, dari direktori instalasi OpenShot:

& .\openshot-qt-cmd.exe --cli intro
& .\openshot-qt-cmd.exe --cli help
& .\openshot-qt-cmd.exe --cli session start

Jika Anda berada di direktori berbeda, gunakan jalur lengkap ke openshot-qt-cmd.exe. Pertahankan --cli setelah nama executable.

macOS

Untuk instalasi di Applications:

"/Applications/OpenShot Video Editor.app/Contents/MacOS/openshot-qt" --cli intro
"/Applications/OpenShot Video Editor.app/Contents/MacOS/openshot-qt" --cli help

Menemukan perintah

Sepanjang panduan ini, openshot-cli adalah singkatan untuk perintah instalasi Anda di atas, seperti snap run openshot-qt --cli atau ./OpenShot.AppImage --cli. Beberapa instalasi juga menyediakan perintah openshot-cli secara langsung. Saat menjalankan dari sumber, gunakan python3 src/launch.py --cli di lingkungan Python OpenShot.

--cli saja, --cli help, dan --cli --help menampilkan gambaran yang sama. Bantuan menjadi lebih spesifik saat Anda menavigasi perintah:

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

Bantuan grup menjelaskan alur kerja dengan contoh; bantuan operasi menjelaskan argumen dan perilaku. --help setara dengan help di akhir. Semua perintah bantuan bekerja tanpa sesi pengeditan.

effects list menampilkan efek yang tersedia dengan deskripsi singkat. Bantuan efek menjelaskan properti, default, pilihan, dan rentang mereka. effects instances mencantumkan efek yang sudah terpasang pada klip, dengan ID klip induk. Nama kelas, nama tampilan, dan alias garis bawah mengidentifikasi efek yang sama.

Bekerja dengan skrip dan agen AI

Agen pengkodean AI seperti Codex dan Claude Code dapat menggunakan CLI untuk memeriksa dan mengedit proyek OpenShot melalui perintah terminal. Berikan agen Anda jalur ke executable OpenShot Anda, media atau proyek yang akan dikerjakan, dan hasil yang diinginkan: durasi, dimensi, gaya animasi, dan lokasi output. Minta untuk membaca --cli intro sebelum memulai. Perintah yang sama berfungsi saat Anda mengetiknya sendiri atau menjalankannya dari skrip.

Mulailah dengan intro, lalu gunakan bantuan khusus perintah sesuai kebutuhan. Alur kerja yang berguna adalah memilih sesi, memeriksa proyek, membuat beberapa perubahan kecil, meninjau hasil, dan menyimpan. Perintah mengembalikan JSON terstruktur sehingga skrip dan agen dapat menggunakan ID objek dan hasil secara langsung tanpa menginterpretasikan output layar.

  • Periksa sebelum mengedit. Gunakan ID yang dikembalikan dan informasi properti daripada menebak nama, nomor trek, atau waktu. Pilih sesi secara eksplisit ketika lebih dari satu proyek terbuka.

  • Kelompokkan pengeditan berulang. Gunakan edit apply untuk rangkaian perubahan atau edit bulk untuk menerapkan template ke klip yang dipilih. Validasi dengan --dry-run sebelum menerapkan batch.

  • Periksa animasi. Pilih ruang koordinat, mulai dengan beberapa keyframe, dan gunakan preset easing untuk gerakan yang familiar. keyframe preview mengambil sampel kurva sehingga Anda dapat melihat jeda atau loncatan sebelum mengekspor. Tinjau juga gerakan yang dirender; lembar kontak saja tidak dapat menunjukkan bagaimana perasaan sebuah animasi.

  • Simpan dan pantau ekspor. Simpan proyek secara eksplisit dan periksa status pekerjaan ekspor sebelum menganggap output selesai. Jika permintaan habis waktu, periksa statusnya sebelum mengulangi pengeditan.

Bagian-bagian di bawah ini menjelaskan alur kerja ini dan konvensi waktunya.

Sesi dan output

Memulai atau menemukan sesi

Mulai satu sesi headless (tanpa jendela editor):

openshot-cli session start

Untuk membuka proyek yang sudah ada saat startup, tambahkan --project "/path/project.osp". Respon JSON yang berhasil berisi result.session_id. Salin nilai tersebut. Jika OpenShot sudah berjalan, atau Anda lupa ID-nya, cari sesi yang tersedia dengan:

openshot-cli session list

Pilih sesi untuk proyek yang ingin Anda edit. Anda tidak perlu memulai sesi baru untuk setiap perintah.

Memilih sesi

Tip

Tetapkan OPENSHOT_SESSION sekali, lalu jalankan perintah seperti biasa. Terminal Anda mengingat sesi yang dipilih, jadi Anda tidak perlu menyertakan --session pada setiap perintah. Gunakan contoh PowerShell atau Bash di bawah ini.

Ganti SESSION_ID di bawah ini dengan session_id yang dikembalikan oleh session start atau 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

Di macOS, gunakan sintaks export yang sama. Untuk perintah macOS atau Snap, ganti dengan executable instalasi Anda dari Getting started. Pilihan ini berlaku untuk terminal ini dan perintah yang dijalankan darinya. Tetapkan lagi di terminal baru, atau perbarui saat beralih ke sesi yang berbeda.

Contoh pengeditan dan ekspor berikutnya mengasumsikan OPENSHOT_SESSION sudah ditetapkan. Subbagian berikut menunjukkan cara menangkap ID secara otomatis untuk skrip.

Untuk menargetkan sesi berbeda hanya untuk satu perintah, gunakan --session. Ini menggantikan OPENSHOT_SESSION tanpa mengubah pilihan terminal Anda:

openshot-cli --session OTHER_SESSION_ID project get

Dengan executable yang dikemas, letakkan penggantian ini setelah --cli dan sebelum grup perintah: --cli --session OTHER_SESSION_ID project get.

Pemilihan otomatis hanya berfungsi ketika tepat satu sesi yang dapat dijangkau ada. Jika Anda melihat session_required, jalankan session list dan pilih sesi yang dimaksud secara eksplisit. Jika tidak lagi terdaftar, mulai lagi dan gunakan ID baru. Bantuan, intro, dan penemuan sesi tidak memerlukan sesi yang dipilih.

Menangkap ID sesi secara otomatis

Skrip dapat membaca result.session_id langsung dari JSON yang dikembalikan oleh session start dan menetapkan OPENSHOT_SESSION untuk perintah berikutnya. Tidak perlu menyalin ID secara manual atau membaca file log. Periksa bahwa startup berhasil sebelum menggunakan ID yang dikembalikan.

Windows PowerShell (tetapkan jalur executable untuk instalasi Anda):

$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 (memerlukan jq untuk membaca JSON):

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

Variabel lingkungan memilih sesi untuk perintah yang dijalankan dari terminal ini; ini tidak mengubah pengaturan sistem secara keseluruhan. Memulai sesi tidak secara otomatis menetapkan variabel ini. Setelah menghentikan sesi, hapus pilihan dengan Remove-Item Env:OPENSHOT_SESSION di PowerShell atau unset OPENSHOT_SESSION di Bash.

Menampilkan dan menghentikan sesi

Untuk menampilkan sesi yang dipilih di editor:

openshot-cli session show

Di desktop, session show membuat editor dalam proses yang sama dan mempertahankan proyek langsung, ID, riwayat, pekerjaan ekspor, dan koneksi. Panggilan berulang akan memunculkan jendela yang sudah ada. session start --show membukanya segera. Sesi yang dimulai tanpa tampilan, atau dengan QT_QPA_PLATFORM=offscreen/minimal, tidak dapat menampilkan jendela desktop kemudian. Untuk sesi tersebut, simpan dan buka proyek di sesi desktop baru. Setelah ditampilkan, tutup sesi melalui jendela editor.

Opsi global (--session, --timeout) diletakkan sebelum perintah. session serve tetap di latar depan untuk supervisor; session start kembali setelah host latar belakang terdaftar. session stop menolak perubahan yang belum disimpan dan ekspor aktif. Gunakan --discard hanya untuk sengaja membuang pengeditan yang belum disimpan.

Output perintah

Hasil berupa JSON di stdout, kecuali tampilan timeline teks default. Kesalahan berupa JSON di stderr dengan status keluar 1; kesalahan argument-parser keluar 2. Mutasi mengembalikan ringkasan ringkas dengan perintah inspect. get mengembalikan JSON objek asli. Balasan proyek menyertakan revisi; balasan katalog efek tidak memerlukan sesi. Log dari sesi headless berada di samping catatan registri mereka. OPENSHOT_SESSION_DIR menggantikan direktori default ~/.openshot_qt/sessions.

Sesi menerima perintah secara lokal di komputer Anda. Jaga registri sesi tetap pribadi, karena berisi kredensial yang digunakan untuk mengakses sesi pengeditan Anda. Ekspor bekerja dari snapshot, sehingga Anda dapat melanjutkan pengeditan saat pekerjaan berjalan.

Membuka dan menyimpan proyek

Proyek OpenShot (.osp) menyimpan timeline yang dapat Anda edit. Mengekspor membuat video jadi; menyimpan proyek memungkinkan Anda kembali ke klip, efek, dan keyframe-nya nanti. Simpan proyek Anda secara terpisah meskipun Anda juga mengekspor video.

Membuka proyek

Mulai sesi dengan proyek yang sudah ada:

openshot-cli session start --project "/home/me/Videos/My Project.osp"

Tambahkan --show untuk membuka jendela editor-nya juga. Untuk menggunakan editor yang sudah berjalan, temukan dengan session list. Atur OPENSHOT_SESSION ke ID sesi yang dikembalikan, lalu buka atau periksa proyek:

openshot-cli project open "/home/me/Videos/My Project.osp"
openshot-cli project get

Ganti jalur contoh dengan milik Anda sendiri, dan beri tanda kutip pada jalur yang mengandung spasi. project open menggantikan proyek saat ini dari sesi yang dipilih. Ini menolak untuk membuang suntingan yang belum disimpan kecuali Anda secara eksplisit menambahkan --discard; simpan suntingan tersebut terlebih dahulu jika ingin menyimpannya. Membuka melalui CLI tidak menampilkan dialog media hilang interaktif, jadi jaga media sumber proyek tetap tersedia.

Untuk proyek baru yang kosong, gunakan session start tanpa --project, lalu impor media dan tambahkan klip seperti yang dijelaskan di bagian Pengeditan.

Menyimpan proyek atau salinannya

Simpan ke file baru, atau buat versi terpisah sebelum melakukan perubahan lebih lanjut:

openshot-cli project save "/home/me/Videos/My Project v2.osp"

Untuk memperbarui file yang sudah ada, izinkan penggantian secara eksplisit:

openshot-cli project save "/home/me/Videos/My Project v2.osp" --overwrite

Selalu berikan jalur tujuan. Menyimpan .osp tidak mengemas semua rekaman sumber Anda ke dalam file tersebut; jaga media yang direferensikan tetap tersedia saat memindahkan atau membuka kembali proyek.

Mengekspor video

Otomatiskan rendering dan ekspor dari skrip atau agen AI, menggunakan pengaturan proyek atau memilih profil keluaran berbeda untuk setiap render. Pekerjaan ekspor dapat berjalan di latar belakang atau menunggu selesai sebelum skrip Anda melanjutkan. Untuk merender MP4 menggunakan resolusi dan frame rate proyek:

openshot-cli export start "/home/me/Videos/video.mp4" --wait

Secara default, OpenShot menggunakan video H.264 dan audio AAC. Ganti jalur contoh dengan tujuan Anda, menggunakan folder yang sudah ada dan nama file baru. Output yang sudah ada tidak pernah ditimpa. Mengekspor tidak menyimpan proyek .osp yang dapat diedit; gunakan project save secara terpisah untuk menyimpan pekerjaan pengeditan Anda.

Opsi --wait menjaga perintah tetap berjalan sampai ekspor selesai atau melaporkan kegagalan. Tinjau video yang selesai sebelum membagikannya.

Memeriksa kemajuan ekspor

Jangan gunakan --wait untuk memulai ekspor di latar belakang. Respons mencakup ID pekerjaan yang dapat Anda gunakan untuk memeriksa kemajuannya:

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

Ganti JOB_ID dengan ID yang dikembalikan. Jika waktu tunggu habis, ekspor tetap berjalan; periksa pekerjaan yang sama daripada memulai ekspor lain. Untuk menghentikan pekerjaan, gunakan export cancel JOB_ID. Setiap pekerjaan menangkap timeline saat dimulai, jadi suntingan berikutnya tidak mengubah ekspor yang sedang berjalan.

Waktu tunggu default adalah 600 detik; sesuaikan dengan --wait-timeout. Ini terpisah dari --timeout global per permintaan. Kegagalan ekspor, pembatalan, dan waktu tunggu keluar dengan status 1 dan menyertakan detail pekerjaan.

Mengekspor dengan beberapa profil

Ekspor timeline yang sama pada resolusi atau rasio aspek berbeda dengan memilih profil ekspor untuk setiap keluaran. Profil ekspor hanya berlaku untuk pekerjaan itu saja; tidak mengubah profil proyek pengeditan. Profil mengatur dimensi, frame rate, dan rasio aspek; preset ekspor memilih pengaturan encoding seperti MP4/H.264.

Temukan profil yang tersedia dan periksa pengaturannya:

openshot-cli profile list --search 720
openshot-cli profile list --search 1080
openshot-cli profile get builtin:01280x0720p0030_16-09

Misalnya, ekspor versi lanskap pada 720p dan 1080p, lalu versi persegi pada 1080 x 1080. Semua profil ini menggunakan 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

Gunakan nama file keluaran berbeda untuk setiap versi. Jaga suntingan tetap tidak berubah antar pekerjaan jika Anda menginginkan versi yang cocok. Mengubah rasio aspek dapat mengubah framing: tinjau setiap keluaran, terutama judul dan subjek animasi. Untuk versi persegi atau potret yang disusun terpisah, simpan salinan proyek, ubah profil proyeknya, dan sesuaikan klip sebelum mengekspor. Lihat Profil dan pengaturan ekspor di bawah untuk profil khusus dan opsi encoding.

Ekspor batch beberapa proyek

Gunakan kembali satu sesi headless untuk merender beberapa proyek yang disimpan secara berurutan. Buka proyek, ekspor dengan --wait, lalu buka proyek berikutnya. Contoh di bawah menggunakan resolusi dan frame rate masing-masing proyek dan membuat file MP4 di samping file .osp. Tambahkan --profile PROFILE_ID ke perintah ekspor untuk menggunakan satu profil keluaran untuk setiap proyek.

Jalankan terlebih dahulu contoh session-ID otomatis yang cocok di atas dengan sukses, di terminal yang sama. Ini mendefinisikan openshot dan memilih sesi baru. Ganti jalur proyek di bawah dengan milik Anda sendiri. Gunakan nama output yang berbeda yang belum ada; contoh memeriksa semua tujuan sebelum memulai batch.

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 (tanda kurung menjaga penanganan kesalahan tetap lokal pada batch):

(
    set -e
    : "${OPENSHOT_SESSION:?Run the session startup example first}"
    projects=(
        "/home/me/VideoProjects/First.osp"
        "/home/me/VideoProjects/Second.osp"
    )
    for project in "${projects[@]}"; do
        test -f "$project" || { echo "Project not found: $project" >&2; exit 1; }
        output="${project%.osp}.mp4"
        test ! -e "$output" || { echo "Output already exists: $output" >&2; exit 1; }
    done
    for project in "${projects[@]}"; do
        "$openshot" --cli project open "$project"
        "$openshot" --cli export start "${project%.osp}.mp4" --wait --wait-timeout 86400
    done
    "$openshot" --cli session stop
) && unset OPENSHOT_SESSION

Kedua resep menghentikan batch saat perintah gagal dan membiarkan sesi tersedia untuk pemeriksaan. Batas waktu tunggu di sini adalah 24 jam per ekspor. Timeout tunggu membiarkan render berjalan: gunakan export list dan export status JOB_ID --wait sebelum mencoba lagi. Video yang selesai tetap ada di disk; hapus proyek yang selesai dari batch sebelum melanjutkan. Setelah menyelesaikan kegagalan, hentikan sesi dan bersihkan variabel lingkungan saat Anda selesai.

Memilih preset dan pengaturan encoding

Temukan preset ekspor yang terpasang dan pengaturan yang didukung:

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

Ekspor juga menerima --from-file FILE_ID dengan opsi --create-custom. Pengaturan diselesaikan dalam urutan ini: default proyek, preset, JSON lanjutan, flag profil/kualitas/rentang eksplisit. JSON lanjutan menampilkan codec video/audio dan bitrate, tata letak/audio/kanal, opsi codec asli, pengaturan perangkat keras, dan jumlah thread.

Misalnya, pilih opsi encoder melalui JSON lanjutan:

openshot-cli export start /tmp/small.mp4 --profile builtin:00640x0360p0030_16-09 --json '{"video_options":{"preset":"fast"}}' --wait

Memvalidasi pengaturan ekspor

Periksa pengaturan sebelum memulai render:

openshot-cli export validate /tmp/reel.mp4 --preset builtin:format_mp4_x264

Laporan kemampuan menyusun ketersediaan codec, bukan ketersediaan GPU fisik. Validasi lebih lanjut: membuka encoder (termasuk encoder perangkat keras) dan kontainer dengan pengaturan tepat, dalam proses terpisah, tanpa menulis file. Kombinasi yang tidak dapat ditampung kontainer gagal dengan incompatible_export, penjelasan FFmpeg sendiri, dan pengaturan yang harus diubah (details.cause.path):

openshot-cli export validate /tmp/song.mp3 --json '{"mode":"audio","format":"mp3","audio_codec":"aac"}'

Pekerja ekspor menjalankan pemeriksaan yang sama sebelum merender.

Merender rentang frame

Gunakan --start-frame dan --end-frame untuk merender sebagian timeline. Rentang inklusif dan berbasis satu pada FPS profil ekspor. Misalnya, render 90 frame pertama pada 30 fps (tiga detik):

openshot-cli export start /tmp/excerpt.mp4 --profile builtin:01280x0720p0030_16-09 --start-frame 1 --end-frame 90 --wait

Ekspor hanya audio dan urutan gambar

Pilih mode output dengan JSON lanjutan:

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

Urutan gambar memerlukan direktori output baru. Output yang ada tidak pernah ditimpa.

Mengedit

Menambahkan klip dan efek

Gunakan ID yang dikembalikan oleh import/add/list, dan temukan nomor lapisan dengan 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

Pilih profil proyek lebih awal jika memungkinkan; proyek yang sudah terisi juga mendukung perubahan profil melalui konversi FPS dan sistem undo yang ada. --audio-only saat pembuatan klip menonaktifkan video, termasuk sampul tertanam pada file musik. Untuk menggunakan klip itu untuk Visualisasi Audio, aktifkan video dan audio-nya, dan ikuti bantuan efek untuk overlay transparan dan penempatan lapisan.

Memahami waktu klip

Keyframe contoh mengasumsikan proyek 30fps dan klip dipangkas pada sumber 10 detik. Posisi dalam detik timeline; mulai/akhir adalah detik sumber, dengan akhir eksklusif. Frame mulai dari 1. Frame thumbnail file menggunakan FPS sumber. Frame timeline menggunakan FPS proyek. Keyframe klip menggunakan koordinat sumber pada FPS proyek, jadi memangkas klip tidak memindahkan keyframe terlihat pertama ke frame 1.

Mengubah properti

set menggabungkan properti tingkat atas. Skalar mengubah properti ber-keyframe menjadi konstan. Kurva bersarang yang diberikan menggantikan kurva tersebut; gunakan keyframe set untuk mengubah hanya satu titik. Argumen JSON menerima JSON inline, @file.json, atau - untuk stdin. Nama properti, tipe, enum, keyframe, referensi, dan waktu divalidasi sebelum mengedit proyek. Kesalahan mengidentifikasi bidang, nilai yang diharapkan, nilai yang diterima, dan koreksi jika memungkinkan. Rentang slider GUI bersifat saran jika mesin mendukung nilai di luar itu.

Menambahkan fade

clip fade ID --in 0.5 --out 0.5 menghitung koordinat keyframe potongan sumber secara otomatis. Ini menggantikan kurva alfa; --property volume --value 0.25 malah membuat fade audio dengan puncak gain 0.25. Durasi harus sesuai antara frame terlihat pertama dan terakhir; fade-out mencapai nol pada frame terakhir.

Memisahkan klip

clip split ID --at 6.5 menggunakan detik timeline, menempel ke frame proyek terdekat, dan mempertahankan kedua bagian. Ini mempertahankan kurva koordinat sumber dan menggandakan efek dengan ID baru pada bagian kanan, mengikuti perilaku pemotongan editor. Bagian kiri mempertahankan ID-nya. Respons melaporkan waktu pemisahan yang diminta/aktual dan kedua ringkasan; hasil batch bernama mendukung {"$ref":"cut.right.id"}. Pemisahan menolak titik akhir dan trek terkunci. Undo mengembalikan klip asli dalam satu transaksi.

Preset menu klip

Preset menu klip editor menggunakan kode yang sama dari baris perintah. Setiap perintah mencantumkan presetnya dalam bantuan, dan masing-masing adalah satu langkah batal ulang:

openshot-cli clip motion CLIP_ID --preset slide-in-left
openshot-cli clip motion CLIP_ID --preset pulse --at 4.5
openshot-cli clip look CLIP_ID --effect ColorGrade --preset warm_up
openshot-cli clip look CLIP_ID --effect all --preset none
openshot-cli clip speed CLIP_ID --mode forward --factor 2
openshot-cli clip speed CLIP_ID --mode freeze --at 3 --duration 2
openshot-cli clip repeat CLIP_ID --passes 3 --pattern pingpong
openshot-cli clip waveform CLIP_ID

Preset gerak relatif terhadap transformasi klip saat ini. Preset tampilan menambahkan atau mengganti satu efek, dan none menghapusnya. Kecepatan dan pengulangan mengatur ulang waktu setiap keyframe dan mengubah panjang klip; clip speed --mode reset mengembalikan kecepatan normal. Aksi menu lain adalah pengeditan biasa: putar dan tata letak dengan clip set, potong dengan effects add Crop. Perintah juga berfungsi di edit apply dan edit bulk.

Menambahkan dan menata teks

text add membuat teks dan menempatkannya sebagai klip, menggunakan teks yang sama dengan alat Text editor. Opsi yang tidak Anda isi menggunakan gaya default editor:

openshot-cli text add --text "Opening Night" --layer 5000000 --position 2 --duration 4 \
    --place lower-third --font "Noto Sans" --size 72 --bold --color "#ffffff" \
    --background "#80000000" --background-padding 16 --background-corner 12
openshot-cli text get CLIP_ID
openshot-cli text set CLIP_ID --stroke black --stroke-width 3
openshot-cli text set CLIP_ID --text $'Two\nlines' --line-spacing 1.4
openshot-cli text fonts --search noto
openshot-cli text list --search opening

Kata-kata, font, ukuran, perataan, lebar kotak, dan warna default milik teks dalam Berkas Proyek dan dibagikan oleh setiap klip yang menggunakannya, sama seperti di editor. text set pada satu klip mengubah semuanya dan mencantumkannya di changed_clip_ids; --this-clip-only memberi klip itu salinannya sendiri terlebih dahulu. clip add FILE_ID menempatkan klip lain dari teks dari text list. Ukuran dalam piksel pada resolusi proyek, dan warna adalah #RRGGBB, #AARRGGBB (dengan alfa), nama CSS, atau transparent. --place menempatkan kotak di tengah, tepi atau sudut, atau sepertiga bawah. --line-spacing adalah kelipatan jarak normal antar baris (1 adalah normal), dan --background-corner membulatkan sudut latar belakang dan batas sebanyak piksel tersebut.

Klip teks adalah klip biasa. Posisi, skala, rotasi, opasitas, waktu, efek memudar, preset gerak, dan efek semuanya menggunakan perintah clip biasa. Ukuran font, padding, lebar kotak, dan jarak huruf serta baris mengatur ukuran kotak teks, jadi tidak bisa diberi keyframe; untuk menganimasikan ukuran teks, beri keyframe pada skala klip. Setiap klip dapat menganimasikan warna teksnya sendiri serta garis tepi dan lebar batas dengan perintah keyframe yang sama seperti properti lain:

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

Properti yang dianimasikan adalah text_color, text_background, text_stroke dan text_border (warna, dengan .red, .green, .blue dan .alpha dari 0 sampai 255), plus text_stroke_width, text_border_width dan text_background_corner. Animasi klip sendiri mengalahkan gaya bersama, dan text get mencantumkan gaya yang dianimasikan klip. text reset CLIP_ID mengembalikan klip ke gaya default, seperti Text → Reset Style; --keyframes-only hanya menghapus animasi klip sendiri. Untuk menata banyak teks sekaligus, pilih dengan {"text":true}:

openshot-cli edit bulk --select '{"text":true}' --json '[{"method":"text.set","params":{"font_family":"Noto Sans","stroke_width":2}}]'

Menerapkan sekumpulan suntingan

edit apply --json @edits.json --expect-revision 12 menerima hingga 256 perintah mutasi berurutan, menggunakan nama perintah bertitik seperti clip.set dan effects.add (ejaan lama effect.add juga berfungsi):

[
  {"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}}
]

Opsi as mengikat hasil untuk perintah berikutnya dalam batch yang sama. Objek {"$ref":"shot.id"} menggantikan bidang hasil tersebut. Referensi hanya menyelesaikan nama sebelumnya; kesalahan ejaan, referensi maju, dan nama duplikat gagal sebelum pembaruan langsung. Respons mencakup hasil ringkas berurutan dan peta refs dari ID sebenarnya. Semua perubahan dalam batch yang berhasil membentuk satu langkah batal ulang. project.profile.set juga mendukung timeline yang terisi. Perintah membuka, menyimpan, mengekspor, dan inspeksi tetap di luar batch suntingan. Bantuan setiap perintah mencantumkan nama parameter JSON-nya, termasuk ejaan garis bawah dari flag shell (misalnya, --fps-num menjadi fps_num).

Memvalidasi batch dan menangani kesalahan

Semua perintah dalam batch suntingan diuji terlebih dahulu terhadap proyek terpisah sebelum pembaruan langsung. Input tidak valid meninggalkan proyek dan revisi langsung tanpa perubahan. Batch valid membentuk satu grup batal ulang. Kegagalan runtime tak terduga masih dapat menghasilkan perubahan parsial; kesalahan melaporkan operasi yang selesai. Waktu habis tidak berarti pembatalan, jadi periksa status sebelum mencoba ulang mutasi.

Pengeditan keyframe yang tepat

clip, transition, dan effects mendukung keyframe list, set, remove, clear, transform, copy, dan paste. Jalur properti dapat mengakses kurva bersarang, seperti color.red pada efek Chroma Key. Mengedit kurva bersarang mempertahankan saluran saudara. Jalankan keyframe list ID tanpa properti untuk menemukan jalur kurva dan jumlah titik. Penemuan dan daftar titik mencakup konteks waktu trim/posisi; daftar titik juga melaporkan koordinat frame asli. get dan properties menampilkan objek asli lengkap dan metadata properti. Kesalahan mengidentifikasi bidang tidak valid, menyarankan nama properti yang mirip, dan menjelaskan koreksi koordinat.

Pilih koordinat secara eksplisit dengan --space native|clip|timeline dan --unit frames|seconds. Semua frame menggunakan FPS proyek dan berbasis 1; detik mulai dari nol dan menempel pada frame terdekat. Native adalah koordinat keyframe mesin yang ada (termasuk trim sumber). Koordinat klip mulai dari titik masuk klip yang terlihat; koordinat timeline mulai dari waktu nol proyek. Efek terpasang menggunakan waktu klip induknya. Koordinat ini mengacu pada waktu animasi, bukan frame media yang dipilih oleh kurva pemetaan ulang waktu.

Untuk klip yang diposisikan pada 5 detik, dipangkas pada 2 detik, dalam proyek 30 fps, frame klip 1, frame timeline 151, dan frame native 61 menunjuk ke titik yang sama. Posisi dan pemangkasan snap secara independen ke grid frame proyek. Mendaftar seluruh kurva dapat mencakup titik tersembunyi dengan koordinat klip/timeline yang tidak positif. --frame warisan masih berarti frame native dan tidak dapat digabungkan dengan --at.

Contoh:

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

Interpolasi, easing, dan pratinjau

Interpolasi menggambarkan segmen menuju titik tujuan. Linear memberikan laju yang stabil antar titik. Konstan mempertahankan nilai sebelumnya sampai tujuan, lalu melompat. Bezier default native mengatur easing di kedua ujung setiap segmen. Menambahkan titik perantara dapat menyebabkan perlambatan yang tidak diinginkan; untuk satu gerakan eased, mulai dengan dua titik akhir. Biasanya biarkan pegangan apa adanya dan pilih preset bernama untuk gaya tertentu.

Temukan preset easing yang sama yang digunakan oleh menu editor, tanpa sesi:

openshot-cli clip keyframe presets

Terapkan preset ke segmen masuk dengan mengatur tujuannya:

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

Opsi easing mengimplikasikan Bezier. Ini mengatur pegangan keluar titik sebelumnya dan pegangan masuk tujuan bersama-sama, mempertahankan pegangan dan nilai titik lainnya. Titik sebelumnya harus ada. Jangan gabungkan dengan pegangan kustom atau interpolasi berbeda. Preset bekerja dalam batch dan template massal. Preset GUI ease ("Ease (Default)") berbeda dari pegangan native yang digunakan oleh interpolasi Bezier biasa. Preset back dapat melewati nilai titik akhir.

Periksa gerakan sebelum rendering, menggunakan evaluator kurva native:

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

Pratinjau hanya baca dan bekerja sama untuk efek dan transisi. Ini mengembalikan nilai dan incoming_rate / outgoing_rate bertanda dalam satuan properti per detik, dihitung dari frame yang berdekatan langsung. Ini adalah perbedaan hingga, bukan turunan analitik. Pada frame native 1, laju masuk adalah nol. Laju frame berdekatan dapat memeriksa di luar rentang yang diminta. Laju mendekati nol di sekitar titik interior menunjukkan jeda; laju berbeda menunjukkan perubahan kecepatan. Interpolasi konstan menunjukkan loncatan di tujuan.

Tanpa rentang, pratinjau mencakup titik pertama dan terakhir kurva. Rentang bersifat inklusif, dengan 17 sampel yang tersebar merata secara default (--count: 2–256). Keyframe dan tetangga terdekatnya di dalam rentang juga termasuk, sehingga jumlah sampel yang jarang tidak akan menyembunyikan jeda keyframe. Maksimum adalah 1024 sampel; permintaan lebih besar memerlukan rentang yang lebih sempit. --at mengambil sampel satu frame. Pratinjau melaporkan koordinat ruang yang diminta dan frame native aktual; detik disesuaikan ke frame proyek seperti saat pengeditan.

Untuk pegangan kustom lanjutan, baik X dan Y dinormalisasi ke segmen: X adalah fraksi dari rentang frame; Y adalah fraksi dari perubahan nilainya. Kontrol pertama berasal dari handle_right titik sebelumnya, yang kedua dari handle_left tujuan. Default native adalah right=(0.5, 0), left=(0.5, 1), dengan tangen titik akhir datar. Mengubah handle_type saja tidak menghitung ulang tangen kontinu melalui titik sekitar. Pegangan yang ada dipertahankan saat memindahkan titik.

Rentang keyframe bersifat inklusif, berbeda dengan rentang waktu pemilihan klip. Daftar mengeluarkan points yang nilai co.X-nya menggunakan ruang/satuan koordinat yang diminta. Kirim array itu ke keyframe paste --json @points.json dengan ruang/satuan yang sama, memilih --mode merge (ganti frame yang cocok, pertahankan lainnya) atau --mode replace (ganti seluruh kurva). copy menerima sumber dari jenis objek yang sama, --source-property opsional, dan menambatkan titik sumber pertama yang dipilih pada --at di target. Kurva dan objek sumber lain tetap tidak berubah.

transform menerapkan skala waktu positif di sekitar titik pertama yang dipilih, atau --pivot, diikuti oleh --offset bertanda dalam satuan yang dipilih. Snap frame yang menghasilkan koordinat duplikat ditolak, termasuk tabrakan dengan titik di luar rentang yang dipilih. Koordinat native harus tetap minimal 1. Pegangan Bézier normalisasi native dan interpolasi bergerak bersama setiap titik; pegangan bukan koordinat frame absolut. set --handles hanya mengubah pegangan yang disediakan. Interpolasi milik titik tujuan.

clear mempertahankan titik dasar konstan pada frame native 1: tentukan --value atau ambil sampel kurva yang ada dengan --at (default frame native 1). Menghapus titik terakhir juga mempertahankan dasar konstan, sehingga penambahan keyframe berikutnya tetap valid.

Memilih dan mengedit banyak klip

Gunakan edit apply --dry-run untuk memvalidasi batch tanpa mengubah proyek. Gunakan edit bulk untuk mengulangi template perintah kecil untuk setiap klip yang dipilih, dengan semua perubahan digabungkan menjadi satu langkah undo.

Pertama pratinjau sebuah pilihan:

openshot-cli edit select --json '{"layer":1000000,"start":5,"end":20,"effect":"Saturation"}'

Selector mendukung ids (array ID klip unik), layer, start/end (detik timeline), file_id, effect (nama kelas atau alias), dan text (true memilih klip teks). Filter digabung dengan AND. Rentang waktu memilih klip yang tumpang tindih [start, end); mereka tidak memotong klip tersebut. Hasil diurutkan berdasarkan posisi, layer, lalu ID, dan mencakup ID, ringkasan, status kunci, dan revisi saat ini. ID yang tidak dikenal adalah kesalahan. Selector kosong ditolak; gunakan {"all":true} secara eksplisit untuk setiap klip. Seleksi dibatasi hingga 256 klip dan tidak pernah dipotong secara diam-diam.

Sebagai contoh, simpan array ini sebagai 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}}
]

Validasi, lalu terapkan terhadap revisi yang dikembalikan oleh seleksi:

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

Perintah klip yang ada mewarisi id; effects.add mewarisi clip_id. Abaikan parameter target ini dalam template. Edit efek harus merujuk hasil bernama sebelumnya. Nama bersifat lokal untuk setiap klip yang dipilih, jadi look.id merujuk pada efek berbeda untuk setiap klip. Untuk mengubah instance efek yang ada dengan ID eksplisit, lanjutkan menggunakan edit apply. Set ID yang dipilih tetap sebelum ekspansi; perubahan posisi atau efek tidak mengubah target yang tersisa.

clip set menerapkan properti absolut; clip adjust menerapkan multiply lalu add pada properti numerik atau setiap nilai dalam kurva, mempertahankan waktu titik, interpolasi, dan pegangan ternormalisasi. Ini memvalidasi nilai hasil, termasuk posisi dan volume yang tidak negatif. Bidang struktural tetap terlindungi.

Operasi massal menolak seleksi kosong, trek target terkunci, dan lebih dari 256 perintah yang diperluas. Setiap operasi yang diperluas melewati preflight terpisah sebelum pengeditan langsung. Dry run tidak memesan ID yang dihasilkan. Gunakan --expect-revision untuk menolak seleksi usang. Batch yang berhasil adalah satu langkah undo, termasuk setelah simpan/buka ulang. Penyegaran GUI dilakukan secara batch. Kesalahan runtime/listener yang tidak terduga masih dapat meninggalkan transaksi parsial; kesalahan melaporkan operasi yang selesai dan undo membatalkan grup tersebut, seperti pada edit apply.

Profil

Temukan profil dan cocokkan video impor tanpa menebak ID:

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}}'

Entri katalog mencakup ID stabil, deskripsi, dimensi, FPS rasional, rasio aspek, dan pengaturan pemindaian. Daftar/pencarian dipaginasi. Pencocokan sumber mengembalikan ID tepat dan alternatif berperingkat dengan perbedaan eksplisit. Pengaturan dari file memerlukan kecocokan tepat kecuali --create-custom ditentukan; tidak pernah memilih profil terdekat secara diam-diam. Gambar diam dan sumber hanya audio tidak dapat mendefinisikan profil video. Pencocokan menggunakan FPS sumber yang dideklarasikan.

Pengaturan khusus disematkan dalam proyek yang disimpan, termasuk rasio rasional, sehingga membuka kembali tidak memerlukan pemasangan file profil terpisah. Perubahan profil proyek menggunakan konversi frame-rate yang ada dan satu transaksi undo. Undo/redo mengembalikan waktu klip dan keyframe, termasuk posisi sensitif pembulatan. Ekspor dapat memilih profil secara mandiri tanpa mengubah proyek.

Riwayat undo yang disimpan mengikuti preferensi batas riwayat editor. Batas ini adalah anggaran aksi lunak: semua catatan yang termasuk dalam transaksi yang dipertahankan disimpan, sehingga penyimpanan tidak dapat memotong batch besar menjadi aksi undo parsial. Nol menonaktifkan riwayat yang disimpan. Batas permintaan batch 256 perintah terpisah masih berlaku.

Memeriksa media dan timeline

Periksa waktu klip dan tata letak trek sebagai teks atau JSON, atau render gambar untuk meninjau komposisi dan framing sebelum mengekspor.

Ringkasan timeline

Gunakan tampilan teks untuk gambaran cepat, atau JSON terstruktur untuk skrip dan agen:

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 defaultnya adalah teks ringkas dengan trek yang digunakan, ID objek, interval timeline/sumber, status aliran, gain, dan celah/tumpang tindih. Gunakan --detail summary|clips|full untuk memilih detail, --format json untuk konteks terstruktur, dan --start/--end, --layer, serta paginasi untuk memfokuskan hasil.

timeline overview menyediakan konteks terstruktur ringkas tanpa byte gambar: ID terurut, urutan per trek, interval timeline/sumber, rentang trim yang terlihat, koordinat frame, status audio/video, efek, dan celah atau tumpang tindih tetangga. Interval dan rentang frame eksklusif di akhir; nomor frame berbasis satu. Frame sumber menggunakan FPS sumber; koordinat timeline dan keyframe menggunakan FPS proyek. Gunakan --layer dan --start/--end untuk memfokuskan, dan --limit/--offset untuk paginasi (default 100, maksimum 500 item). Klip yang di-time-remap secara eksplisit menahan pemetaan sumber yang disimpulkan. Gunakan revisi yang dikembalikan dengan edit apply --expect-revision.

Pratinjau frame dan lembar kontak

Render satu frame dengan thumbnail atau ambil sampel rentang dengan strip. Gunakan file untuk memeriksa media sumber dan timeline untuk memeriksa video yang disusun, termasuk efek dan klip berlapis:

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

Gambar frame defaultnya 320x180 piksel; lembar kontak defaultnya 160x90 per ubin, plus label timecode. Gunakan --width dan --height untuk memilih piksel keluaran. Respons mencakup metadata sampel/frame yang tepat. Lembar kontak membantu meninjau komposisi sepanjang urutan; gunakan pratinjau keyframe dan video yang dirender untuk menilai gerakan antar sampel tersebut.

Gambar garis waktu

Tangkap tata letak trek editor, termasuk penggaris, thumbnail, efek, transisi, dan gelombang suara:

openshot-cli timeline view --start 0 --end 20 --pixels-per-second 80 --output /tmp/tracks.png

Menentukan --output memilih format gambar; --format image juga memilihnya secara eksplisit. Tangkap tidak mengubah tampilan editor atau proyek. Respons mencakup ID klip dan waktu bersama batas piksel.

Gambar secara default berukuran lebar 1280 piksel, dengan tinggi disesuaikan dengan trek yang digunakan. Gunakan --width, --height, atau --all-tracks untuk mengatur tata letak, dan --track-size atau --track-label-width untuk mengatur trek dan label. Rentang mulai/akhir menentukan zoom; --pixels-per-second justru menentukan lebar dari rentang waktu.

Tampilan gelombang suara audio

Pilih --mode waveforms untuk memeriksa amplop audio pada garis waktu:

openshot-cli timeline view --start 5 --end 12 --mode waveforms --output /tmp/waves.png

--mode auto menggunakan tampilan gelombang yang sudah di-cache; --mode thumbnails menampilkan thumbnail sebagai gantinya. Gelombang suara mewakili level puncak/RMS sumber dengan penyesuaian volume klip dan waktu, sebelum efek audio atau pencampuran.

Ekstraksi gelombang suara tanpa cache mendekode seluruh sumber, dibatasi hingga 600 detik per sumber dan 1200 detik-sumber per permintaan. Memperkecil rentang yang terlihat tidak mengurangi pekerjaan dekode tersebut. Untuk sumber yang lebih panjang, buat gelombang suara di editor terlebih dahulu atau gunakan mode thumbnail. Permintaan berikutnya dapat menggunakan kembali gelombang suara yang di-cache.

Output gambar dan batasannya

Jalur gambar harus berupa file PNG baru di direktori yang sudah ada. Gambar dibatasi hingga 4096 piksel per sumbu, total 8.388.608 piksel, dan 64 sampel lembar kontak. Permintaan yang melebihi batas ini gagal sebelum proses rendering.

Gambar ditulis ke file; respons JSON mencakup jalur dan ukuran image_bytes. Pemeriksaan menunggu gambar selesai, dan permintaan besar dapat sementara menggunakan editor.

Menangani batas waktu perintah

Batas waktu permintaan tidak berarti mutasi gagal. Gunakan ID operasi dalam kesalahan dengan operation get ID sebelum mencoba lagi. operation list menemukan mutasi terbaru beserta status, revisi, dan hasilnya. Operasi yang selesai menyimpan hasilnya jika cukup kecil, termasuk ID objek yang dikembalikan. Penyimpanan dibatasi hingga 100 operasi dan 4 MiB, dengan isi hasil individu dihilangkan di atas 256 KiB. Catatan ini hanya bertahan selama sesi berjalan. Mereka tidak memulihkan proyek setelah crash atau mencegah perintah berulang menerapkan edit yang sama lagi. Pekerjaan ekspor memiliki perintah status/daftar sendiri.