رابط خط فرمان

OpenShot را به جریان کاری خط فرمان خود بیاورید. فیلم‌ها را وارد کنید، کلیپ‌ها را برش دهید و مرتب کنید، افکت‌ها را اعمال کنید، ویژگی‌ها را با کلیدهای انیمیشن متحرک کنید و ویدیوها را از ترمینال خود صادر کنید. از چند دستور برای خودکارسازی ویرایش‌های تکراری، نوشتن اسکریپت برای پروژه‌های مکرر، یا اجازه دادن به یک عامل هوش مصنوعی برای کمک به مونتاژ و بهبود ویدیو استفاده کنید.

خط فرمان با همان پروژه‌هایی که در ویرایشگر استفاده می‌شود کار می‌کند. می‌توانید یک ویرایشگر باز را کنترل کنید و تغییرات را در حین کار مرور کنید، یا در یک جلسه بدون رابط گرافیکی بدون باز کردن پنجره کار کنید. یک جلسه پروژه شما را بین دستورات باز نگه می‌دارد، شامل ویرایش‌ها، تاریخچه بازگردانی و کارهای صادرات. هر زمان که خواستید ویرایش را ادامه دهید، آن را به عنوان یک پروژه .osp ذخیره کنید.

شروع کار

از فایل اجرایی نصب‌شده OpenShot خود به همراه --cli استفاده کنید. با intro شروع کنید تا راهنمای کوتاهی درباره جلسات، ویرایش، انیمیشن و ذخیره‌سازی دریافت کنید، یا برای مرور دستورات از help استفاده کنید. این دستورات نیازی به جلسه فعال ندارند. مثال‌های زیر نیازمند نسخه‌ای از OpenShot هستند که ویرایش خط فرمان را شامل می‌شود.

اپ‌ایمیج لینوکس

از دایرکتوری که اپ‌ایمیج دانلود شده شما در آن قرار دارد:

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

OpenShot.AppImage را با نام فایل دانلود شده خود جایگزین کنید. اگر AppImageLauncher دیالوگ‌های ادغام دسکتاپ را نشان می‌دهد، قبل از اجرای دستور، APPIMAGELAUNCHER_DISABLE=1 را تنظیم کنید:

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

برای اسکریپت‌ها یا دستورات تکراری، یک بار در شل فعلی خود تنظیم کنید:

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

این متغیر باید قبل از اجرای AppImage تنظیم شود: AppImageLauncher ممکن است قبل از دریافت --cli توسط OpenShot آن را رهگیری کند. مسیرهای رسانه نسبی و فایل‌های @batch.json از دایرکتوری کاری شما حل می‌شوند. در حالی که جلسات یا صادرات در حال اجرا هستند، فایل AppImage را در دسترس نگه دارید.

اسنپ لینوکس

برای OpenShot Snap، استفاده کنید:

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

مجوزهای فایل اسنپ برای ویرایش خط فرمان نیز اعمال می‌شود. رسانه‌ها، پروژه‌ها و صادرات را در مکان‌هایی نگه دارید که اسنپ به آن‌ها دسترسی دارد، مانند پوشه خانگی شما. برای اجازه دسترسی به درایوهای خارجی، مجوز removable-media را متصل کنید:

sudo snap connect openshot-qt:removable-media

ویندوز

مهم

برای ویرایش خط فرمان در ویندوز از openshot-qt-cmd.exe استفاده کنید. این فایل اجرایی کنسول نتایج دستورات، راهنما و خطاها را در ترمینال شما نمایش می‌دهد. فایل اجرایی دسکتاپ، openshot-qt.exe، خروجی استاندارد را در ترمینال تعاملی نمایش نمی‌دهد، که باعث می‌شود دستورات بدون بازخورد قابل مشاهده باشند و استفاده از CLI دشوار شود.

در PowerShell، از دایرکتوری نصب OpenShot:

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

اگر در دایرکتوری دیگری هستید، از مسیر کامل openshot-qt-cmd.exe استفاده کنید. --cli را بعد از نام فایل اجرایی نگه دارید.

مک‌اواس

برای نصب در Applications:

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

یافتن دستورات

در سراسر این راهنما، openshot-cli مخفف دستور نصب شما در بالا است، مانند snap run openshot-qt --cli یا ./OpenShot.AppImage --cli. برخی نصب‌ها همچنین دستور openshot-cli را به طور مستقیم ارائه می‌دهند. هنگام اجرای از سورس، از python3 src/launch.py --cli در محیط پایتون OpenShot استفاده کنید.

دستورات ساده --cli, --cli help و --cli --help همان نمای کلی را نشان می‌دهند. راهنما با حرکت در دستورات خاص‌تر می‌شود:

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

راهنمای گروهی گردش کارها را با مثال توضیح می‌دهد؛ راهنمای عملیات آرگومان‌ها و رفتار را شرح می‌دهد. --help معادل help در انتهای دستور است. همه دستورات راهنما بدون جلسه ویرایش کار می‌کنند.

effects list افکت‌های موجود را با توضیحات کوتاه نشان می‌دهد. راهنمای افکت ویژگی‌ها، پیش‌فرض‌ها، گزینه‌ها و دامنه‌ها را توضیح می‌دهد. effects instances افکت‌هایی که قبلاً به کلیپ‌ها متصل شده‌اند را همراه با شناسه‌های کلیپ والد فهرست می‌کند. نام کلاس‌ها، نام‌های نمایشی و نام‌های مستعار با زیرخط همان افکت را شناسایی می‌کنند.

کار با اسکریپت‌ها و عوامل هوش مصنوعی

عوامل کدنویسی هوش مصنوعی مانند Codex و Claude Code می‌توانند از CLI برای بررسی و ویرایش پروژه‌های OpenShot از طریق دستورات ترمینال استفاده کنند. مسیر فایل اجرایی OpenShot، رسانه یا پروژه‌ای که باید با آن کار شود، و نتیجه مورد نظر: مدت زمان، ابعاد، سبک انیمیشن و محل خروجی را به عامل خود بدهید. از آن بخواهید قبل از شروع --cli intro را بخواند. همان دستورات وقتی خودتان تایپ می‌کنید یا از اسکریپت اجرا می‌کنید نیز کار می‌کنند.

با intro شروع کنید، سپس در صورت نیاز از راهنمای مخصوص هر دستور استفاده کنید. یک جریان کاری مفید این است که یک جلسه را انتخاب کنید، پروژه را بررسی کنید، مجموعه کوچکی از تغییرات را اعمال کنید، نتیجه را مرور کنید و ذخیره کنید. دستورات JSON ساختاریافته بازمی‌گردانند تا اسکریپت‌ها و عوامل بتوانند به جای تفسیر خروجی صفحه، مستقیماً از شناسه‌های اشیاء و نتایج استفاده کنند.

  • قبل از ویرایش بررسی کنید. از شناسه‌ها و اطلاعات ویژگی بازگشتی استفاده کنید به جای حدس زدن نام‌ها، شماره‌های ترک یا زمان‌بندی. وقتی بیش از یک پروژه باز است، جلسه را به طور صریح انتخاب کنید.

  • ویرایش‌های تکراری را گروه‌بندی کنید. برای یک دنباله از تغییرات از edit apply استفاده کنید یا برای اعمال یک قالب روی کلیپ‌های انتخاب شده از edit bulk استفاده کنید. قبل از اعمال یک دسته، با --dry-run اعتبارسنجی کنید.

  • بررسی انیمیشن. یک فضای مختصات انتخاب کنید، با چند کلید فریم شروع کنید و از پیش‌تنظیم‌های تسهیل برای حرکت آشنا استفاده کنید. keyframe preview منحنی را نمونه‌برداری می‌کند تا بتوانید توقف‌ها یا جهش‌ها را قبل از صادر کردن تشخیص دهید. حرکت رندر شده را نیز مرور کنید؛ یک برگه تماس به تنهایی نمی‌تواند احساس یک انیمیشن را نشان دهد.

  • ذخیره و پیگیری صادرات. پروژه را به‌طور صریح ذخیره کنید و وضعیت کار صادرات را قبل از در نظر گرفتن خروجی به عنوان کامل بررسی کنید. اگر یک درخواست زمان‌بندی شد، وضعیت آن را قبل از تکرار ویرایش بررسی کنید.

بخش‌های زیر این جریان‌های کاری و قراردادهای زمانی آن‌ها را توضیح می‌دهند.

جلسات و خروجی‌ها

شروع یا یافتن یک جلسه

شروع یک جلسه بدون رابط گرافیکی (بدون پنجره ویرایشگر):

openshot-cli session start

برای باز کردن یک پروژه موجود هنگام راه‌اندازی، --project "/path/project.osp" را اضافه کنید. پاسخ موفق JSON شامل result.session_id است. آن مقدار را کپی کنید. اگر OpenShot در حال اجرا است یا شناسه را فراموش کرده‌اید، جلسات موجود را با دستور زیر پیدا کنید:

openshot-cli session list

جلسه مربوط به پروژه‌ای که قصد ویرایش آن را دارید انتخاب کنید. نیازی به شروع جلسه جدید برای هر دستور نیست.

انتخاب یک جلسه

نکته

یک بار OPENSHOT_SESSION را تنظیم کنید، سپس دستورات را به‌طور معمول اجرا کنید. ترمینال شما جلسه انتخاب شده را به خاطر می‌سپارد، بنابراین نیازی به ارسال --session با هر دستور نیست. از مثال‌های PowerShell یا Bash زیر استفاده کنید.

SESSION_ID زیر را با session_id بازگشتی از session start یا 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

در macOS، از همان نحو export استفاده کنید. برای دستورات macOS یا Snap، فایل اجرایی نصب خود را از بخش شروع به کار جایگزین کنید. انتخاب برای این ترمینال و دستورات اجرا شده از آن باقی می‌ماند. در یک ترمینال جدید دوباره تنظیم کنید یا هنگام تغییر به جلسه‌ای دیگر آن را به‌روزرسانی کنید.

باقی مثال‌های ویرایش و صادرات فرض می‌کنند OPENSHOT_SESSION تنظیم شده است. بخش بعدی نشان می‌دهد چگونه شناسه را به‌طور خودکار برای اسکریپت‌ها دریافت کنید.

برای هدف قرار دادن یک جلسه متفاوت فقط برای یک دستور، از --session استفاده کنید. این گزینه OPENSHOT_SESSION را بدون تغییر انتخاب ترمینال شما نادیده می‌گیرد:

openshot-cli --session OTHER_SESSION_ID project get

با یک فایل اجرایی بسته‌بندی شده، این جایگزینی را بعد از --cli و قبل از گروه دستورات قرار دهید: --cli --session OTHER_SESSION_ID project get.

انتخاب خودکار فقط زمانی کار می‌کند که دقیقاً یک جلسه قابل دسترسی وجود داشته باشد. اگر session_required را دیدید، session list را اجرا کنید و جلسه مورد نظر را به‌طور صریح انتخاب کنید. اگر دیگر در فهرست نیست، دوباره آن را شروع کنید و از شناسه جدید استفاده کنید. راهنما، intro و کشف جلسه نیازی به جلسه انتخاب شده ندارند.

دریافت خودکار شناسه جلسه

اسکریپت‌ها می‌توانند result.session_id را مستقیماً از JSON بازگشتی از session start بخوانند و OPENSHOT_SESSION را برای دستورات بعدی تنظیم کنند. نیازی به کپی دستی شناسه یا خواندن فایل لاگ نیست. قبل از استفاده از شناسه بازگشتی، اطمینان حاصل کنید که راه‌اندازی موفق بوده است.

Windows PowerShell (مسیر فایل اجرایی نصب خود را تنظیم کنید):

$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 (نیازمند jq برای خواندن 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

متغیر محیطی یک جلسه را برای دستورات اجرا شده از این ترمینال انتخاب می‌کند؛ این متغیر تنظیمات سراسری سیستم را تغییر نمی‌دهد. شروع یک جلسه به‌طور خودکار این متغیر را تنظیم نمی‌کند. پس از توقف جلسه، انتخاب را با دستور Remove-Item Env:OPENSHOT_SESSION در PowerShell یا unset OPENSHOT_SESSION در Bash پاک کنید.

نمایش و توقف یک جلسه

برای نمایش جلسه انتخاب شده در ویرایشگر:

openshot-cli session show

در دسکتاپ، session show ویرایشگر را در همان فرآیند ایجاد می‌کند و پروژه زنده، شناسه‌ها، تاریخچه، کارهای صادرات و اتصال را حفظ می‌کند. فراخوانی‌های مکرر پنجره موجود را بالا می‌آورد. session start --show آن را فوراً باز می‌کند. جلساتی که بدون نمایش یا با QT_QPA_PLATFORM=offscreen/minimal شروع شده‌اند، نمی‌توانند بعداً پنجره دسکتاپ را نشان دهند. برای این جلسات، پروژه را ذخیره و در یک جلسه دسکتاپ جدید باز کنید. پس از نمایش، جلسه را از طریق پنجره ویرایشگر ببندید.

گزینه‌های کلی (--session, --timeout) قبل از دستور قرار می‌گیرند. session serve برای ناظران در پیش‌زمینه باقی می‌ماند؛ session start پس از ثبت میزبان پس‌زمینه بازمی‌گردد. session stop تغییرات ذخیره نشده و صادرات فعال را رد می‌کند. از --discard فقط برای حذف عمدی ویرایش‌های ذخیره نشده استفاده کنید.

خروجی دستور

نتایج به صورت JSON در stdout هستند، به جز نمای پیش‌فرض جدول زمانی متنی. خطاها به صورت JSON در stderr با وضعیت خروج ۱ هستند؛ خطاهای تجزیه‌کننده آرگومان با وضعیت خروج ۲. تغییرات خلاصه‌های فشرده با دستور inspect بازمی‌گردانند. get JSON شیء بومی را بازمی‌گرداند. پاسخ‌های پروژه شامل یک بازنگری هستند؛ پاسخ‌های فهرست افکت نیازی به جلسه ندارند. لاگ‌های جلسات بدون رابط گرافیکی کنار سوابق ثبت آن‌ها ذخیره می‌شوند. OPENSHOT_SESSION_DIR دایرکتوری پیش‌فرض ~/.openshot_qt/sessions را بازنویسی می‌کند.

جلسات دستورات را به صورت محلی روی رایانه شما می‌پذیرند. رجیستری جلسه را خصوصی نگه دارید، زیرا شامل مدارکی است که برای دسترسی به جلسات ویرایش شما استفاده می‌شود. صادرات از یک تصویر لحظه‌ای انجام می‌شود، بنابراین می‌توانید در حالی که یک کار در حال اجرا است به ویرایش ادامه دهید.

باز کردن و ذخیره پروژه‌ها

یک پروژه OpenShot (.osp) جدول زمانی قابل ویرایش شما را ذخیره می‌کند. صادرات یک ویدئوی نهایی ایجاد می‌کند؛ ذخیره پروژه به شما امکان می‌دهد بعداً به کلیپ‌ها، افکت‌ها و کلیدفریم‌های آن بازگردید. حتی زمانی که ویدئو صادر می‌کنید، پروژه خود را جداگانه ذخیره کنید.

باز کردن یک پروژه

شروع یک جلسه با یک پروژه موجود:

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

برای باز کردن پنجره ویرایشگر آن نیز، --show را اضافه کنید. برای استفاده از ویرایشگری که در حال اجرا است، آن را با session list پیدا کنید. OPENSHOT_SESSION را به شناسه جلسه بازگردانده شده تنظیم کنید، سپس یک پروژه را باز یا بررسی کنید:

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

مسیر نمونه را با مسیر خود جایگزین کنید و مسیرهایی که شامل فاصله هستند را در نقل‌قول قرار دهید. project open پروژه فعلی جلسه انتخاب شده را جایگزین می‌کند. مگر اینکه صراحتاً --discard را اضافه کنید، از حذف ویرایش‌های ذخیره نشده خودداری می‌کند؛ اگر می‌خواهید آن‌ها را نگه دارید ابتدا آن ویرایش‌ها را ذخیره کنید. باز کردن از طریق CLI دیالوگ‌های تعاملی رسانه‌های گمشده را نشان نمی‌دهد، بنابراین رسانه‌های منبع پروژه را در دسترس نگه دارید.

برای یک پروژه جدید و خالی، از session start بدون --project استفاده کنید، سپس رسانه‌ها را وارد کرده و کلیپ‌ها را همانطور که در بخش ویرایش توضیح داده شده اضافه کنید.

ذخیره یک پروژه یا یک نسخه

ذخیره در یک فایل جدید، یا ایجاد نسخه‌ای جداگانه قبل از اعمال تغییرات بیشتر:

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

برای به‌روزرسانی یک فایل موجود، جایگزینی را صراحتاً مجاز کنید:

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

همیشه مسیر مقصد را ارائه دهید. ذخیره یک فایل .osp تمام فیلم‌های منبع شما را در آن فایل بسته‌بندی نمی‌کند؛ هنگام جابجایی یا باز کردن مجدد پروژه، رسانه‌های ارجاع شده را در دسترس نگه دارید.

صادرات یک ویدئو

رندر و صادرات را از طریق اسکریپت‌ها یا عامل‌های هوش مصنوعی خودکار کنید، با استفاده از تنظیمات پروژه یا انتخاب پروفایل خروجی متفاوت برای هر رندر. کارهای صادرات می‌توانند در پس‌زمینه اجرا شوند یا منتظر تکمیل بمانند قبل از اینکه اسکریپت شما ادامه یابد. برای رندر یک MP4 با استفاده از وضوح و نرخ فریم پروژه:

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

به طور پیش‌فرض، OpenShot از ویدئوی H.264 و صدای AAC استفاده می‌کند. مسیر نمونه را با مقصد خود جایگزین کنید، با استفاده از یک پوشه موجود و نام فایل جدید. خروجی‌های موجود هرگز بازنویسی نمی‌شوند. صادرات پروژه قابل ویرایش .osp شما را ذخیره نمی‌کند؛ برای نگهداری کار ویرایش خود به طور جداگانه از project save استفاده کنید.

گزینه --wait فرمان را تا زمانی که صادرات کامل شود یا خطایی گزارش شود، در حال اجرا نگه می‌دارد. قبل از به اشتراک‌گذاری، ویدئوی نهایی را بررسی کنید.

بررسی پیشرفت صادرات

برای شروع صادرات در پس‌زمینه، --wait را حذف کنید. پاسخ شامل شناسه کاری است که می‌توانید برای بررسی پیشرفت آن استفاده کنید:

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 را با شناسه بازگردانده شده جایگزین کنید. اگر زمان انتظار تمام شود، صادرات ادامه می‌یابد؛ به جای شروع صادرات جدید، همان کار را بررسی کنید. برای توقف یک کار، از export cancel JOB_ID استفاده کنید. هر کار هنگام شروع جدول زمانی را ضبط می‌کند، بنابراین ویرایش‌های بعدی صادراتی که در حال انجام است را تغییر نمی‌دهد.

زمان انتظار به طور پیش‌فرض ۶۰۰ ثانیه است؛ این را با --wait-timeout تنظیم کنید. این جدا از --timeout جهانی برای هر درخواست است. شکست‌های صادرات، لغو و زمان‌های انتظار منقضی شده با وضعیت ۱ خارج می‌شوند و شامل جزئیات کار هستند.

صادرات در چندین پروفایل

جدول زمانی یکسان را با وضوح‌ها یا نسبت‌های تصویر مختلف صادر کنید با انتخاب یک پروفایل صادرات برای هر خروجی. یک پروفایل صادرات فقط برای همان کار اعمال می‌شود؛ پروفایل پروژه ویرایش را تغییر نمی‌دهد. یک پروفایل ابعاد، نرخ فریم و نسبت تصویر را تعیین می‌کند؛ یک پیش‌تنظیم صادرات تنظیمات کدگذاری مانند MP4/H.264 را انتخاب می‌کند.

پروفایل‌های موجود را پیدا کرده و تنظیمات آن‌ها را بررسی کنید:

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

برای مثال، نسخه‌های منظره را در ۷۲۰p و ۱۰۸۰p صادر کنید، سپس نسخه مربعی را در ۱۰۸۰ در ۱۰۸۰. همه این پروفایل‌ها از ۳۰ فریم بر ثانیه استفاده می‌کنند:

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

برای هر نسخه از نام فایل خروجی متفاوت استفاده کنید. وقتی نسخه‌های مطابقت دارند، ویرایش‌ها را بین کارها بدون تغییر نگه دارید. تغییر نسبت تصویر می‌تواند قاب‌بندی را تغییر دهد: هر خروجی را بررسی کنید، به ویژه عناوین و موضوعات متحرک. برای نسخه مربعی یا پرتره جداگانه، یک کپی از پروژه ذخیره کنید، پروفایل پروژه را تغییر دهید و کلیپ‌ها را قبل از صادرات تنظیم کنید. برای پروفایل‌های سفارشی و گزینه‌های کدگذاری به بخش پروفایل‌ها و تنظیمات صادرات زیر مراجعه کنید.

صادرات دسته‌ای چندین پروژه

یک جلسه بدون رابط کاربری را برای رندر چندین پروژه ذخیره شده به صورت متوالی مجدداً استفاده کنید. یک پروژه را باز کنید، آن را با --wait صادر کنید، سپس پروژه بعدی را باز کنید. مثال‌های زیر از وضوح و نرخ فریم هر پروژه استفاده می‌کنند و فایل‌های MP4 را کنار فایل‌های .osp ایجاد می‌کنند. برای استفاده از یک پروفایل خروجی برای هر پروژه، --profile PROFILE_ID را به فرمان صادرات اضافه کنید.

ابتدا مثال شناسه جلسه خودکار مطابقت داده شده بالا را با موفقیت در همان ترمینال اجرا کنید. این کار openshot را تعریف کرده و جلسه جدید را انتخاب می‌کند. مسیرهای پروژه زیر را با مسیرهای خود جایگزین کنید. از نام‌های خروجی متمایز که قبلاً وجود ندارند استفاده کنید؛ مثال‌ها قبل از شروع دسته، همه مقصدها را بررسی می‌کنند.

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 (پرانتزها مدیریت خطا را محدود به دسته نگه می‌دارند):

(
    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

هر دو روش در صورت شکست دستور، دسته را متوقف کرده و جلسه را برای بررسی در دسترس می‌گذارند. محدودیت انتظار اینجا ۲۴ ساعت برای هر خروجی است. زمان انتظار منقضی شده باعث ادامه رندر می‌شود: قبل از تلاش مجدد از export list و export status JOB_ID --wait استفاده کنید. ویدیوهای تکمیل شده روی دیسک باقی می‌مانند؛ پروژه‌های تکمیل شده را قبل از ادامه از دسته حذف کنید. پس از رفع خطا، جلسه را متوقف کرده و متغیر محیطی آن را پاک کنید.

انتخاب پیش‌تنظیم‌ها و تنظیمات کدگذاری

پیش‌تنظیم‌های نصب شده خروجی و تنظیمات پشتیبانی شده را کشف کنید:

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

خروجی همچنین --from-file FILE_ID را با گزینه اختیاری --create-custom می‌پذیرد. تنظیمات به این ترتیب حل می‌شوند: پیش‌فرض‌های پروژه، پیش‌تنظیم، JSON پیشرفته، پرچم‌های صریح پروفایل/کیفیت/محدوده. JSON پیشرفته کدک‌های ویدئو/صدا و نرخ بیت، چیدمان/نرخ/کانال‌های صوتی، گزینه‌های کدک بومی، تنظیمات دستگاه سخت‌افزاری و تعداد رشته‌ها را آشکار می‌کند.

برای مثال، یک گزینه کدگذار را از طریق JSON پیشرفته انتخاب کنید:

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

اعتبارسنجی تنظیمات خروجی

قبل از شروع رندر، تنظیمات را بررسی کنید:

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

گزارش قابلیت‌ها در دسترس بودن کدک‌های کامپایل شده را نشان می‌دهد، نه در دسترس بودن فیزیکی GPU. اعتبارسنجی فراتر می‌رود: کدگذارها (شامل کدگذارهای سخت‌افزاری) و کانتینر را با تنظیمات دقیق، در یک فرآیند جداگانه و بدون نوشتن فایل باز می‌کند. ترکیبی که کانتینر نمی‌تواند نگه دارد با incompatible_export شکست می‌خورد، توضیح خود FFmpeg و تنظیمی که باید تغییر کند (details.cause.path):

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

کارگر خروجی همان بررسی را قبل از رندر اجرا می‌کند.

رندر کردن بازه‌ای از فریم‌ها

برای رندر بخشی از جدول زمانی از --start-frame و --end-frame استفاده کنید. بازه‌ها شامل هر دو انتها هستند و از ۱ بر اساس نرخ فریم پروفایل خروجی (export profile's FPS) شروع می‌شوند. برای مثال، ۹۰ فریم اول را با نرخ ۳۰ فریم بر ثانیه (سه ثانیه) رندر کنید:

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

خروجی‌های فقط صوت و دنباله‌های تصویری

یک حالت خروجی با JSON پیشرفته انتخاب کنید:

openshot-cli export start /tmp/music.wav --json '{"mode":"audio","format":"wav","audio_codec":"pcm_s16le"}' --wait
openshot-cli export start /tmp/frames --json '{"mode":"image_sequence","format":"png"}' --end-frame 3 --wait

دنباله‌های تصویری نیاز به یک پوشه خروجی جدید دارند. خروجی‌های موجود هرگز بازنویسی نمی‌شوند.

ویرایش

افزودن کلیپ‌ها و افکت‌ها

از شناسه‌های بازگشتی توسط import/add/list استفاده کنید و شماره لایه‌ها را با 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

در صورت امکان، پروفایل پروژه را زود انتخاب کنید؛ پروژه‌های پر شده همچنین تغییر پروفایل را از طریق تبدیل FPS موجود و سیستم بازگردانی پشتیبانی می‌کنند. --audio-only هنگام ایجاد کلیپ، ویدئو را سرکوب می‌کند، شامل کاور آرت جاسازی شده در فایل‌های موسیقی. برای استفاده از آن کلیپ برای تجسم صوتی، ویدئو و صدا را فعال کنید و راهنمای افکت را برای پوشش‌های شفاف و جایگذاری لایه دنبال کنید.

درک زمان‌بندی کلیپ

کی‌فریم‌های نمونه فرض می‌کنند پروژه ۳۰ فریم بر ثانیه است و کلیپ در منبع از ۱۰ ثانیه برش خورده است. موقعیت بر حسب ثانیه جدول زمانی است؛ شروع/پایان بر حسب ثانیه منبع هستند، با پایان غیرشامل. فریم‌ها از ۱ شروع می‌شوند. فریم‌های تصویر بندانگشتی فایل از نرخ فریم منبع استفاده می‌کنند. فریم‌های جدول زمانی از نرخ فریم پروژه استفاده می‌کنند. کی‌فریم‌های کلیپ از مختصات منبع در نرخ فریم پروژه استفاده می‌کنند، بنابراین برش کلیپ باعث جابجایی اولین کی‌فریم قابل مشاهده به فریم ۱ نمی‌شود.

تغییر ویژگی‌ها

set ویژگی‌های سطح بالا را ادغام می‌کند. مقادیر اسکالر ویژگی‌های کی‌فریم‌دار را به ثابت تبدیل می‌کنند. یک منحنی تو در تو ارائه شده جایگزین آن منحنی می‌شود؛ برای تغییر فقط یک نقطه از keyframe set استفاده کنید. آرگومان‌های JSON، JSON خطی، @file.json یا - برای ورودی استاندارد را می‌پذیرند. نام ویژگی‌ها، نوع‌ها، شمارش‌ها، کی‌فریم‌ها، مراجع و زمان‌بندی قبل از ویرایش پروژه اعتبارسنجی می‌شوند. خطاها فیلد، مقدار مورد انتظار، مقدار دریافت شده و اصلاح ممکن را مشخص می‌کنند. محدوده‌های لغزنده رابط کاربری توصیه‌ای هستند وقتی موتور مقادیر فراتر از آن‌ها را پشتیبانی می‌کند.

افزودن محو شدن‌ها

clip fade ID --in 0.5 --out 0.5 مختصات کی‌فریم برش منبع را به طور خودکار محاسبه می‌کند. این منحنی آلفا را جایگزین می‌کند؛ --property volume --value 0.25 به جای آن یک محو شدن صوتی با اوج ۰.۲۵ ایجاد می‌کند. مدت‌ها باید بین اولین و آخرین فریم قابل مشاهده قرار گیرند؛ محو شدن خروجی در آخرین فریم به صفر می‌رسد.

تقسیم کلیپ‌ها

clip split ID --at 6.5 از ثانیه‌های جدول زمانی استفاده می‌کند، به نزدیک‌ترین فریم پروژه چسبیده و هر دو نیمه را نگه می‌دارد. منحنی‌های مختصات منبع را حفظ کرده و افکت‌ها را با شناسه‌های جدید در نیمه راست تکثیر می‌کند، مطابق رفتار برش ویرایشگر. نیمه چپ شناسه خود را حفظ می‌کند. پاسخ زمان‌های تقسیم درخواست شده/واقعی و هر دو خلاصه را گزارش می‌دهد؛ نتیجه دسته‌ای نام‌گذاری شده از {"$ref":"cut.right.id"} پشتیبانی می‌کند. تقسیم‌ها نقاط انتهایی و ترک‌های قفل شده را رد می‌کنند. بازگردانی، کلیپ اصلی را در یک تراکنش بازیابی می‌کند.

پیش‌تنظیم‌های منوی کلیپ

تنظیمات پیش‌فرض منوی کلیپ ویرایشگر از همان کد خط فرمان استفاده می‌کنند. هر دستور تنظیمات پیش‌فرض خود را در راهنمایش فهرست می‌کند و هر کدام یک مرحله بازگردانی واحد هستند:

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

تنظیمات پیش‌فرض حرکت نسبت به تبدیل فعلی کلیپ هستند. تنظیمات Look یک افکت را اضافه یا جایگزین می‌کنند و none آن را حذف می‌کند. سرعت و تکرار زمان‌بندی هر کلید فریم را تغییر داده و طول کلیپ را تغییر می‌دهند؛ clip speed --mode reset سرعت عادی را بازیابی می‌کند. سایر عملیات منو ویرایش‌های ساده هستند: چرخش و چیدمان با clip set، برش با effects add Crop. این دستورات همچنین در edit apply و edit bulk کار می‌کنند.

افزودن و سبک‌دهی متن

text add متنی ایجاد کرده و آن را به عنوان یک کلیپ قرار می‌دهد، با استفاده از همان متنی که ابزار Text ویرایشگر دارد. گزینه‌هایی که وارد نکنید از سبک پیش‌فرض ویرایشگر استفاده می‌کنند:

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

کلمات، قلم، اندازه، تراز، عرض جعبه و رنگ‌های پیش‌فرض متعلق به متن در فایل‌های پروژه هستند و توسط هر کلیپی که از آن استفاده می‌کند به اشتراک گذاشته می‌شوند، درست مانند ویرایشگر. text set روی یک کلیپ همه آنها را تغییر می‌دهد و در changed_clip_ids فهرست می‌کند؛ --this-clip-only ابتدا یک نسخه اختصاصی به آن کلیپ می‌دهد. clip add FILE_ID کلیپ دیگری از متنی از text list قرار می‌دهد. اندازه‌ها بر حسب پیکسل در وضوح پروژه هستند و رنگ‌ها می‌توانند #RRGGBB, #AARRGGBB (با آلفا)، نام CSS یا transparent باشند. --place جعبه را در مرکز، لبه یا گوشه، یا یک سوم پایین قرار می‌دهد. --line-spacing ضریبی از فاصله معمول بین خطوط است (1 طبیعی است) و --background-corner گوشه‌های پس‌زمینه و حاشیه را به اندازه آن پیکسل‌ها گرد می‌کند.

کلیپ متن یک کلیپ معمولی است. موقعیت، مقیاس، چرخش، شفافیت، زمان‌بندی، محو شدن‌ها، تنظیمات حرکت و افکت‌ها همه از دستورات معمول clip استفاده می‌کنند. اندازه قلم، فاصله داخلی، عرض جعبه و فاصله حروف و خطوط اندازه جعبه متن را تعیین می‌کنند، بنابراین نمی‌توانند کلید فریم شوند؛ برای انیمیشن دادن اندازه متن، مقیاس کلیپ را کلید فریم کنید. هر کلیپ می‌تواند رنگ‌های متن، خطوط بیرونی و عرض حاشیه خود را با همان دستورات کلید فریم سایر ویژگی‌ها انیمیشن دهد:

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

ویژگی‌های انیمیشنی عبارتند از text_color, text_background, text_stroke و text_border (رنگ‌ها، با .red, .green, .blue و .alpha از ۰ تا ۲۵۵)، به علاوه text_stroke_width, text_border_width و text_background_corner. انیمیشن اختصاصی یک کلیپ بر سبک مشترک برتری دارد و text get فهرست می‌کند کدام سبک‌ها توسط کلیپ انیمیشن داده می‌شوند. text reset CLIP_ID کلیپ را به سبک پیش‌فرض بازمی‌گرداند، مانند Text → Reset Style؛ --keyframes-only فقط انیمیشن اختصاصی کلیپ را حذف می‌کند. برای سبک‌دهی همزمان به چند متن، آنها را با {"text":true} انتخاب کنید:

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

اعمال یک دسته ویرایش‌ها

edit apply --json @edits.json --expect-revision 12 تا ۲۵۶ دستور تغییر مرتب شده را می‌پذیرد، با استفاده از نام‌های دستوری نقطه‌دار مانند clip.set و effects.add (املا قدیمی‌تر effect.add نیز کار می‌کند):

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

گزینه اختیاری as نتیجه‌ای را برای دستورات بعدی در همان دسته متصل می‌کند. یک شیء {"$ref":"shot.id"} جایگزین فیلد آن نتیجه می‌شود. ارجاعات فقط نام‌های قبلی را حل می‌کنند؛ اشتباهات املایی، ارجاعات رو به جلو و نام‌های تکراری قبل از به‌روزرسانی زنده شکست می‌خورند. پاسخ شامل نتایج فشرده مرتب شده و نقشه refs از شناسه‌های واقعی است. همه تغییرات در یک دسته موفق یک مرحله بازگردانی/ازنو را تشکیل می‌دهند. project.profile.set همچنین از جدول‌های زمانی پر شده پشتیبانی می‌کند. دستورات باز کردن، ذخیره، صادر کردن و بازرسی خارج از دسته‌های ویرایش باقی می‌مانند. راهنمای هر دستور نام‌های پارامتر JSON آن را فهرست می‌کند، از جمله املا با زیرخط پرچم‌های شل (برای مثال، --fps-num به fps_num تبدیل می‌شود).

اعتبارسنجی دسته‌ها و مدیریت خطاها

تمام دستورات در دسته‌های ویرایش قبل از هر به‌روزرسانی زنده، روی پروژه جدا شده آزمایش می‌شوند. ورودی نامعتبر پروژه زنده و نسخه را تغییر نمی‌دهد. دسته‌های معتبر یک گروه بازگردانی تشکیل می‌دهند. خطاهای غیرمنتظره زمان اجرا هنوز می‌توانند تغییرات جزئی ایجاد کنند؛ خطاها عملیات‌های انجام شده را گزارش می‌دهند. تایم‌اوت به معنی لغو نیست، بنابراین قبل از تلاش مجدد تغییرات، وضعیت را بررسی کنید.

ویرایش دقیق کلید فریم

clip, transition و effects از دستورات keyframe list, set, remove, clear, transform, copy و paste پشتیبانی می‌کنند. مسیرهای ویژگی می‌توانند به منحنی‌های تو در تو اشاره کنند، مانند color.red روی افکت Chroma Key. ویرایش منحنی تو در تو کانال‌های هم‌رده را حفظ می‌کند. اجرای keyframe list ID بدون ویژگی مسیرهای منحنی و تعداد نقاط را کشف می‌کند. کشف و فهرست نقاط شامل زمینه زمان‌بندی برش/موقعیت است؛ فهرست نقاط همچنین مختصات فریم بومی را گزارش می‌دهد. get و properties شیء بومی کامل و متادیتای ویژگی را نمایش می‌دهند. خطاها فیلدهای نامعتبر را شناسایی، نام‌های نزدیک به ویژگی را پیشنهاد و اصلاحات مختصات را توضیح می‌دهند.

مختصات را به‌طور صریح با --space native|clip|timeline و --unit frames|seconds انتخاب کنید. همه فریم‌ها از FPS پروژه استفاده می‌کنند و از ۱ شروع می‌شوند؛ ثانیه‌ها از صفر شروع شده و به نزدیک‌ترین فریم چسبیده می‌شوند. Native مختصات کلید فریم موتور موجود است (شامل برش منبع). مختصات کلیپ از نقطه شروع کلیپ قابل مشاهده شروع می‌شود؛ مختصات جدول زمانی از زمان صفر پروژه شروع می‌شود. افکت‌های متصل از زمان‌بندی کلیپ والد خود استفاده می‌کنند. این مختصات به زمان انیمیشن اشاره دارند، نه فریم‌های رسانه انتخاب شده توسط منحنی باززمان‌بندی.

برای یک کلیپ که در ۵ ثانیه قرار دارد و در ۲ ثانیه برش خورده است، در پروژه‌ای با نرخ ۳۰ فریم بر ثانیه، فریم کلیپ ۱، فریم جدول زمانی ۱۵۱ و فریم بومی ۶۱ به همان نقطه اشاره می‌کنند. موقعیت و برش به طور مستقل به شبکه فریم پروژه چسبیده می‌شوند. فهرست کردن کل منحنی می‌تواند نقاط مخفی با مختصات غیرمثبت کلیپ/جدول زمانی را شامل شود. گزینه قدیمی --frame هنوز به معنای فریم بومی است و نمی‌تواند با --at ترکیب شود.

نمونه‌ها:

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

درون‌یابی، تسهیل و پیش‌نمایش

درون‌یابی بخش به نقطه مقصد را توصیف می‌کند. خطی نرخ ثابتی بین نقاط ارائه می‌دهد. ثابت مقدار قبلی را تا مقصد نگه می‌دارد و سپس جهش می‌کند. دسته‌های پیش‌فرض بزی بومی در هر دو انتهای هر بخش تسهیل را مدیریت می‌کنند. افزودن یک نقطه میانی می‌تواند باعث کندی ناخواسته شود؛ برای یک حرکت تسهیل‌شده، با دو نقطه انتهایی شروع کنید. معمولاً دسته‌ها را دست نزنید و یک پیش‌تنظیم نام‌دار برای سبک خاص انتخاب کنید.

پیش‌تنظیم‌های تسهیل مشابه آنچه در منوهای ویرایشگر استفاده می‌شود را بدون جلسه کشف کنید:

openshot-cli clip keyframe presets

با تنظیم مقصد، یک پیش‌تنظیم را به بخش ورودی اعمال کنید:

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

گزینه تسهیل به بزی اشاره دارد. این گزینه دسته خروجی نقطه قبلی و دسته ورودی مقصد را با هم تنظیم می‌کند و دسته‌ها و مقادیر نقاط دیگر را حفظ می‌کند. نقطه قبلی باید وجود داشته باشد. آن را با دسته‌های سفارشی یا درون‌یابی متفاوت ترکیب نکنید. پیش‌تنظیم‌ها به صورت دسته‌ای و قالب‌های حجمی کار می‌کنند. پیش‌تنظیم GUI ease ("Ease (Default)") با دسته‌های بومی استفاده‌شده در درون‌یابی ساده بزی متفاوت است. پیش‌تنظیم‌های باز می‌توانند مقادیر انتهایی را بیش از حد ببرند.

حرکت را قبل از رندر با استفاده از ارزیاب منحنی بومی بررسی کنید:

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

پیش‌نمایش فقط خواندنی است و برای افکت‌ها و انتقال‌ها به طور یکسان کار می‌کند. این مقدارها و نرخ ورودی/خروجی علامت‌دار را در واحدهای ویژگی بر ثانیه بازمی‌گرداند که از فریم‌های مجاور محاسبه شده‌اند. این‌ها تفاوت‌های متناهی هستند، نه مشتق‌های تحلیلی. در فریم بومی ۱ نرخ ورودی صفر است. نرخ‌های فریم مجاور می‌توانند خارج از محدوده درخواست شده را بررسی کنند. نرخ‌های نزدیک به صفر در اطراف یک نقطه داخلی توقف را نشان می‌دهند؛ نرخ‌های متفاوت تغییر سرعت را نشان می‌دهند. درون‌یابی ثابت جهشی در مقصد را نشان می‌دهد.

بدون محدوده، پیش‌نمایش از اولین تا آخرین نقطه منحنی را در بر می‌گیرد. محدوده‌ها شامل نقاط انتهایی هستند و به طور پیش‌فرض ۱۷ نمونه با فاصله مساوی (--count: 2–256) دارند. کلیدفریم‌ها و همسایگان نزدیک آن‌ها در محدوده نیز شامل می‌شوند، بنابراین تعداد نمونه کم باعث پنهان شدن توقف کلیدفریم نمی‌شود. حداکثر ۱۰۲۴ نمونه است؛ درخواست‌های بزرگ‌تر نیاز به محدوده باریک‌تر دارند. --at یک فریم نمونه‌برداری می‌کند. پیش‌نمایش مختصات فضای درخواست شده و فریم‌های بومی واقعی را گزارش می‌دهد؛ ثانیه‌ها به فریم‌های پروژه چسبیده‌اند همانطور که در ویرایش نیز هست.

برای دسته‌های سفارشی پیشرفته، هر دو محور X و Y به بخش نرمال‌سازی شده‌اند: X کسری از بازه فریم آن است؛ Y کسری از تغییر مقدار آن است. کنترل اول از دسته راست نقطه قبلی و کنترل دوم از دسته چپ مقصد می‌آید. پیش‌فرض‌های بومی عبارتند از راست=(0.5, 0)، چپ=(0.5, 1) با مماس‌های انتهایی صاف. تغییر تنها نوع دسته باعث بازمحاسبه مماس پیوسته از طریق نقاط اطراف نمی‌شود. دسته‌های موجود هنگام جابجایی نقطه حفظ می‌شوند.

محدوده‌های کلیدفریم شامل نقاط انتهایی هستند، بر خلاف محدوده‌های زمانی انتخاب کلیپ. فهرست points را صادر می‌کند که مقادیر co.X آن‌ها از فضای/واحد مختصات درخواست شده استفاده می‌کند. آن آرایه را به keyframe paste --json @points.json با همان فضا/واحد بدهید و --mode merge (جایگزینی فریم‌های مطابقت یافته، حفظ بقیه) یا --mode replace (جایگزینی کل منحنی) را انتخاب کنید. copy منبعی از همان نوع شیء، یک --source-property اختیاری می‌پذیرد و اولین نقطه انتخاب شده منبع را در --at روی هدف لنگر می‌کند. سایر منحنی‌ها و اشیاء منبع بدون تغییر باقی می‌مانند.

transform یک مقیاس زمانی مثبت را حول اولین نقطه انتخاب شده یا --pivot اعمال می‌کند، که به دنبال آن یک --offset علامت‌دار در واحد انتخاب شده می‌آید. چسبیدن فریم که باعث ایجاد مختصات تکراری شود رد می‌شود، از جمله برخورد با نقاط خارج از محدوده انتخاب شده. مختصات بومی باید حداقل ۱ باقی بمانند. دسته‌های بزی نرمال‌شده بومی و درون‌یابی با هر نقطه حرکت می‌کنند؛ دسته‌ها مختصات مطلق فریم نیستند. set --handles فقط دسته‌های ارائه شده را تغییر می‌دهد. درون‌یابی متعلق به نقطه مقصد است.

clear یک نقطه پایه ثابت را در فریم بومی ۱ حفظ می‌کند: --value را مشخص کنید یا منحنی موجود را با --at نمونه‌برداری کنید (پیش‌فرض فریم بومی ۱). حذف آخرین نقطه نیز پایه ثابتی را حفظ می‌کند، بنابراین افزودن کلیدفریم‌های بعدی معتبر باقی می‌ماند.

انتخاب و ویرایش چندین کلیپ

برای اعتبارسنجی یک دسته بدون تغییر پروژه از edit apply --dry-run استفاده کنید. برای تکرار یک قالب فرمان کوچک برای هر کلیپ انتخاب شده و گروه‌بندی همه تغییرات در یک مرحله بازگشت، از edit bulk استفاده کنید.

ابتدا یک انتخاب را پیش‌نمایش کنید:

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

انتخاب‌کننده‌ها از ids (آرایه شناسه‌های یکتا کلیپ)، layer، start/end (ثانیه‌های جدول زمانی)، file_id، effect (نام کلاس یا مستعار)، و text (true کلیپ‌های متنی را انتخاب می‌کند) پشتیبانی می‌کنند. فیلترها با AND ترکیب می‌شوند. بازه‌های زمانی کلیپ‌هایی را که با [start, end) همپوشانی دارند انتخاب می‌کنند؛ این بازه‌ها کلیپ‌ها را کوتاه نمی‌کنند. نتایج بر اساس موقعیت، لایه، سپس شناسه مرتب می‌شوند و شامل شناسه‌ها، خلاصه‌ها، وضعیت قفل و نسخه جاری هستند. شناسه‌های ناشناخته خطا محسوب می‌شوند. انتخاب‌کننده خالی رد می‌شود؛ برای هر کلیپ به‌طور صریح از {"all":true} استفاده کنید. انتخاب‌ها به ۲۵۶ کلیپ محدود شده و هرگز به‌طور خاموش قطع نمی‌شوند.

برای مثال، این آرایه را به صورت 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}}
]

آن را اعتبارسنجی کنید، سپس بر اساس نسخه بازگردانده شده توسط انتخاب اعمال کنید:

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

دستورات کلیپ موجود id را به ارث می‌برند؛ effects.add clip_id را به ارث می‌برد. این پارامترهای هدف را در قالب‌ها حذف کنید. ویرایش‌های افکت باید به نتیجه نام‌گذاری شده قبلی ارجاع دهند. نام‌ها محلی برای هر کلیپ انتخاب شده هستند، بنابراین look.id به افکت متفاوتی برای هر کلیپ اشاره دارد. برای تغییر نمونه‌های افکت موجود با شناسه صریح، به استفاده از edit apply ادامه دهید. مجموعه شناسه‌های انتخاب شده قبل از گسترش ثابت است؛ تغییرات موقعیت یا افکت‌ها اهداف باقی‌مانده را تغییر نمی‌دهند.

clip set ویژگی‌های مطلق را اعمال می‌کند؛ clip adjust ابتدا multiply سپس add را به یک ویژگی عددی یا هر مقدار در یک منحنی اعمال می‌کند، در حالی که زمان‌بندی نقاط، درون‌یابی و دسته‌های نرمال‌شده را حفظ می‌کند. مقادیر حاصل را اعتبارسنجی می‌کند، از جمله موقعیت‌ها و حجم غیرمنفی. فیلدهای ساختاری محافظت شده باقی می‌مانند.

عملیات دسته‌ای انتخاب‌های خالی، ترک‌های هدف قفل‌شده و بیش از ۲۵۶ دستور گسترش‌یافته را رد می‌کنند. هر عملیات گسترش‌یافته قبل از هر ویرایش زنده، پیش‌پرواز جداشده را می‌گذراند. اجرای آزمایشی شناسه‌های تولید شده را رزرو نمی‌کند. از --expect-revision برای رد انتخاب‌های قدیمی استفاده کنید. دسته‌های موفق یک مرحله بازگردانی هستند، حتی پس از ذخیره/بازکردن مجدد. تازه‌سازی‌های رابط کاربری به صورت دسته‌ای انجام می‌شوند. خطاهای غیرمنتظره زمان اجرا/شنونده ممکن است هنوز تراکنش ناقصی باقی بگذارند؛ خطا عملیات تکمیل شده را گزارش می‌دهد و بازگردانی آن گروه را معکوس می‌کند، همانند edit apply.

پروفایل‌ها

پروفایل‌ها را کشف کنید و ویدئوی وارد شده را بدون حدس زدن شناسه‌ها مطابقت دهید:

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

ورودی‌های فهرست شامل شناسه‌های پایدار، توضیحات، ابعاد، نرخ فریم منطقی، نسبت‌های تصویر و تنظیمات اسکن هستند. فهرست/جستجو صفحه‌بندی شده است. تطبیق منبع شناسه‌های دقیق و جایگزین‌های رتبه‌بندی شده با تفاوت‌های صریح را بازمی‌گرداند. تنظیم از فایل نیازمند تطبیق دقیق است مگر اینکه --create-custom مشخص شده باشد؛ هرگز به‌طور خاموش پروفایل نزدیک را انتخاب نمی‌کند. تصاویر ثابت و منابع فقط صوتی نمی‌توانند پروفایل ویدئو تعریف کنند. تطبیق از نرخ فریم منبع اعلام شده استفاده می‌کند.

تنظیمات سفارشی در پروژه ذخیره شده جاسازی شده‌اند، از جمله نرخ‌های منطقی، بنابراین بازکردن مجدد نیاز به نصب فایل پروفایل جداگانه ندارد. تغییرات پروفایل پروژه از تبدیل نرخ فریم موجود و یک تراکنش بازگردانی استفاده می‌کنند. بازگردانی/ازسرگیری، زمان‌بندی کلیپ و کلیدفریم‌ها را بازیابی می‌کند، از جمله موقعیت‌های حساس به گرد کردن. صادرات می‌تواند به طور مستقل پروفایلی را بدون تغییر پروژه انتخاب کند.

تاریخچه بازگردانی ذخیره شده مطابق با ترجیح محدودیت تاریخچه ویرایشگر است. این محدودیت یک بودجه نرم برای عملیات است: همه رکوردهای متعلق به تراکنش‌های نگهداری شده حفظ می‌شوند، بنابراین ذخیره نمی‌تواند یک دسته بزرگ را به یک عملیات بازگردانی جزئی کوتاه کند. صفر تاریخچه ذخیره شده را غیرفعال می‌کند. محدودیت جداگانه درخواست دسته ۲۵۶ دستوری هنوز اعمال می‌شود.

بازرسی رسانه و جدول‌های زمانی

زمان‌بندی کلیپ و چیدمان ترک را به صورت متن یا JSON بررسی کنید، یا تصاویر را برای مرور ترکیب و قاب‌بندی قبل از صادرات رندر کنید.

خلاصه‌های جدول زمانی

برای مرور سریع از نمای متنی استفاده کنید، یا برای اسکریپت‌ها و عامل‌ها از JSON ساختاریافته استفاده کنید:

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 به طور پیش‌فرض متن فشرده با ترک‌های استفاده شده، شناسه‌های شیء، بازه‌های جدول زمانی/منبع، وضعیت جریان، بهره و فاصله‌ها/همپوشانی‌ها را نمایش می‌دهد. برای انتخاب جزئیات از --detail summary|clips|full، برای زمینه ساختاریافته از --format json و برای تمرکز نتیجه از --start/--end، --layer و صفحه‌بندی استفاده کنید.

timeline overview زمینه ساختاریافته فشرده بدون بایت‌های تصویر ارائه می‌دهد: شناسه‌های مرتب شده، توالی هر ترک، بازه‌های جدول زمانی/منبع، محدوده‌های برش قابل مشاهده، مختصات فریم، وضعیت صوتی/تصویری، افکت‌ها و فاصله‌ها یا همپوشانی‌های مجاور. بازه‌ها و گستره‌های فریم انتهای انحصاری دارند؛ شماره فریم‌ها از یک شروع می‌شوند. فریم‌های منبع از نرخ فریم منبع استفاده می‌کنند؛ مختصات جدول زمانی و کلیدفریم از نرخ فریم پروژه استفاده می‌کنند. برای تمرکز از --layer و --start/--end و برای صفحه‌بندی از --limit/--offset استفاده کنید (پیش‌فرض ۱۰۰، حداکثر ۵۰۰ مورد). کلیپ‌های زمان‌بندی شده به صراحت نگاشت‌های منبع استنباط شده را نگه نمی‌دارند. از نسخه بازگردانده شده با edit apply --expect-revision استفاده کنید.

پیش‌نمایش فریم‌ها و برگه‌های تماس

یک فریم منفرد را با thumbnail رندر کنید یا بازه‌ای را با strip نمونه‌برداری کنید. برای بررسی رسانه منبع از file و برای بررسی ویدئوی ترکیب شده، شامل افکت‌ها و کلیپ‌های لایه‌ای، از timeline استفاده کنید:

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

تصاویر فریم به طور پیش‌فرض ۳۲۰x۱۸۰ پیکسل هستند؛ برگه‌های تماس به طور پیش‌فرض ۱۶۰x۹۰ پیکسل به ازای هر کاشی به علاوه برچسب‌های تایم‌کد دارند. برای انتخاب پیکسل‌های خروجی از --width و --height استفاده کنید. پاسخ‌ها شامل متادیتای دقیق نمونه/فریم هستند. برگه‌های تماس به مرور ترکیب در سراسر یک دنباله کمک می‌کنند؛ از پیش‌نمایش کلیدفریم‌ها و ویدئوی رندر شده برای ارزیابی حرکت بین آن نمونه‌ها استفاده کنید.

تصاویر جدول زمانی

ضبط چیدمان مسیرهای ویرایشگر، شامل خط‌کش، تصاویر کوچک، افکت‌ها، انتقال‌ها و موج‌های صوتی:

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

تعیین --output فرمت تصویر را انتخاب می‌کند؛ --format image نیز به‌طور صریح آن را انتخاب می‌کند. ضبط، نمای و پروژه ویرایشگر را تغییر نمی‌دهد. پاسخ‌ها شامل شناسه‌های کلیپ و زمان‌بندی همراه با محدوده‌های پیکسلی هستند.

تصاویر به‌طور پیش‌فرض ۱۲۸۰ پیکسل عرض دارند و ارتفاع متناسب با مسیرهای استفاده‌شده تنظیم می‌شود. برای تنظیم چیدمان از --width, --height یا --all-tracks استفاده کنید و برای تنظیم مسیرها و برچسب‌ها از --track-size یا --track-label-width بهره ببرید. بازه شروع/پایان بزرگنمایی را تعیین می‌کند؛ --pixels-per-second عرض را از بازه زمانی استخراج می‌کند.

نمایش‌های موج صوتی

برای بررسی پاکت‌های صوتی روی جدول زمانی، --mode waveforms را انتخاب کنید:

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

--mode auto از نمایش موج کش‌شده موجود استفاده می‌کند؛ --mode thumbnails به جای آن تصاویر کوچک را نشان می‌دهد. موج‌ها سطح اوج/RMS منبع را همراه با تنظیمات حجم و زمان‌بندی کلیپ نمایش می‌دهند، پیش از افکت‌ها یا میکس صوتی.

استخراج موج بدون کش کل منابع را رمزگشایی می‌کند، محدود به ۶۰۰ ثانیه برای هر منبع و ۱۲۰۰ ثانیه-منبع برای هر درخواست. کاهش محدوده قابل مشاهده باعث کاهش این کار رمزگشایی نمی‌شود. برای منابع طولانی‌تر، ابتدا موج‌ها را در ویرایشگر تولید کنید یا از حالت تصاویر کوچک استفاده کنید. درخواست‌های بعدی می‌توانند از موج‌های کش‌شده استفاده مجدد کنند.

خروجی تصویر و محدودیت‌ها

مسیرهای تصویر باید فایل‌های PNG جدید در دایرکتوری‌های موجود باشند. تصاویر محدود به ۴۰۹۶ پیکسل در هر محور، ۸٬۳۸۸٬۶۰۸ پیکسل کل و ۶۴ نمونه صفحه تماس هستند. درخواست‌های فراتر از این محدودیت‌ها قبل از رندر شکست می‌خورند.

تصاویر در فایل‌ها نوشته می‌شوند؛ پاسخ‌های JSON شامل مسیرها و اندازه‌های image_bytes آنها هستند. بازرسی منتظر اتمام تصویر می‌ماند و درخواست‌های بزرگ ممکن است به‌طور موقت ویرایشگر را اشغال کنند.

مدیریت زمان‌تمامی فرمان‌ها

زمان‌تمامی یک درخواست به معنای شکست تغییر نیست. قبل از تلاش مجدد، از شناسه عملیات در خطا با operation get ID استفاده کنید. operation list تغییرات اخیر و وضعیت‌ها، بازبینی‌ها و نتایج آنها را کشف می‌کند. عملیات‌های تکمیل‌شده نتایج خود را در صورت کوچک بودن حفظ می‌کنند، شامل شناسه‌های اشیاء بازگردانده‌شده. ذخیره‌سازی محدود به ۱۰۰ عملیات و ۴ مگابایت است، با حذف بدنه نتایج فردی بالای ۲۵۶ کیلوبایت. این رکوردها فقط برای جلسه جاری باقی می‌مانند. آنها پروژه‌ها را پس از کرش بازیابی نمی‌کنند و از اعمال دوباره همان ویرایش توسط فرمان تکراری جلوگیری نمی‌کنند. کارهای صادراتی دستورات وضعیت/فهرست مخصوص به خود را دارند.