SCRCPY(1) General Commands Manual SCRCPY(1)

scrcpy - نمایش و کنترل دستگاه اندروید شما

scrcpy [options]

scrcpy قابلیت نمایش و کنترل دستگاه‌های Android متصل از طریق USB (یا بستر TCP/IP) را فراهم می‌کند. این ابزار به هیچ دسترسی ریشه (root) نیاز ندارد.

همواره نگه‌داشتن پنجره scrcpy در بالاترین لایه (روی سایر پنجره‌ها).
چرخش محتوای ویدیو با یک زاویه سفارشی، برحسب درجه (در جهت عقربه‌های ساعت).
کدگذاری صدا در نرخ بیت مشخص‌شده، برحسب بیت بر ثانیه (bits/s). پسوندهای یکا پشتیبانی می‌شوند: 'K' (ضرب‌در ۱۰۰۰) و 'M' (ضرب‌در ۱۰۰۰۰۰۰).

مقدار پیش‌فرض 128K (128000) است.

پیکربندی تاخیر بافر صوتی (برحسب میلی‌ثانیه).

مقادیر کمتر تاخیر را کاهش می‌دهند، اما احتمال خالی شدن بافر (buffer underrun) را افزایش می‌دهند (که باعث ایجاد اختلال صوتی می‌شود).

مقدار پیش‌فرض 50 است.

انتخاب یک کدک صوتی (opus، aac، flac یا raw).

مقدار پیش‌فرض opus است.

تنظیم فهرستی از گزینه‌های جداشده با کاما به قالب key:type=value برای انکودر صوتی دستگاه.

مقادیر ممکن برای 'type' عبارتند از: 'int' (پیش‌فرض)، 'long'، 'float' و 'string'.

فهرست گزینه‌های کدک ممکن در مستندات Android در دسترس است:

https://d.android.com/reference/android/media/MediaFormat

تکثیر صدا (ضبط و ادامه پخش روی دستگاه).

این قابلیت فقط همراه با --audio-source=playback در دسترس است.

استفاده از یک انکودر صوتی MediaCodec مشخص (بسته به کدک ارائه‌شده توسط --audio-codec).

انکودرهای در دسترس را می‌توان با --list-encoders فهرست کرد.

انتخاب منبع صوتی. مقادیر ممکن عبارتند از:


- "output": کل خروجی صوتی را فوروارد می‌کند و پخش روی دستگاه را غیرفعال می‌سازد.
- "playback": پخش صدا را ضبط می‌کند (برنامه‌های Android می‌توانند انصراف دهند، بنابراین لزوماً کل خروجی ضبط نمی‌شود).
- "mic": صدای میکروفون را ضبط می‌کند.
- "mic-unprocessed": صدای پردازش‌نشده (خام) میکروفون را ضبط می‌کند.
- "mic-camcorder": صدای میکروفون تنظیم‌شده برای ضبط ویدیو را ضبط می‌کند، در صورت در دسترس بودن با همان جهت‌گیری دوربین.
- "mic-voice-recognition": صدای میکروفون بهینه‌شده برای تشخیص گفتار را ضبط می‌کند.
- "mic-voice-communication": صدای میکروفون بهینه‌شده برای ارتباط صوتی را ضبط می‌کند (برای مثال در صورت در دسترس بودن از حذف اکو یا کنترل خودکار بهره استفاده خواهد کرد).
- "voice-call": تماس صوتی را ضبط می‌کند.
- "voice-call-uplink": فقط ارسال تماس صوتی (uplink) را ضبط می‌کند.
- "voice-call-downlink": فقط دریافت تماس صوتی (downlink) را ضبط می‌کند.
- "voice-performance": صدایی را ضبط می‌کند که برای پردازش در اجرای زنده (کارائوکه) در نظر گرفته شده است، شامل هر دو صدای میکروفون و پخش دستگاه.

مقدار پیش‌فرض output است.

پیکربندی اندازه بافر خروجی صدای SDL (برحسب میلی‌ثانیه).

این تنظیم را تغییر ندهید مگر اینکه دلیل موجهی داشته باشید.

مقدار پیش‌فرض 10 است.

کدگذاری ویدیو در نرخ بیت مشخص‌شده، برحسب بیت بر ثانیه (bits/s). پسوندهای یکا پشتیبانی می‌شوند: 'K' (ضرب‌در ۱۰۰۰) و 'M' (ضرب‌در ۱۰۰۰۰۰۰).

مقدار پیش‌فرض 8M (8000000) است.

تنظیم رنگ پس‌زمینه، کدگذاری‌شده به‌صورت کد رنگ شانزده‌شانزدهی (#RGB یا #RRGGBB).

مقدار پیش‌فرض #222 (خاکستری تیره) است.

انتخاب اندازه دوربین بر اساس نسبت ابعاد آن (+/- ۱۰٪).

مقادیر ممکن عبارتند از "sensor" (استفاده از نسبت ابعاد حسگر دوربین)، "num:den" (مانند "4:3") و "value" (مانند "1.6").

انتخاب دوربین دستگاه بر اساس جهت‌گیری آن.

مقادیر ممکن عبارتند از "front"، "back" و "external".

مشخص کردن نرخ فریم تصویربرداری دوربین.

در صورت مشخص نشدن، از نرخ فریم پیش‌فرض Android (۳۰ فریم بر ثانیه) استفاده می‌شود.

فعال کردن حالت تصویربرداری با سرعت بالای دوربین.

این حالت محدود به تفکیک‌پذیری‌ها و نرخ‌های فریم خاصی است که با --list-camera-sizes فهرست می‌شوند.

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

شناسه‌های دوربین در دسترس را می‌توان با --list-cameras فهرست کرد.

مشخص کردن اندازه دقیق تصویربرداری دوربین.
روشن کردن چراغ‌قوه دوربین هنگام شروع به کار دوربین.
مشخص کردن مقدار بزرگ‌نمایی اولیه دوربین.
مقادیر ممکن عبارتند از 0، 90، 180، 270، flip0، flip90، flip180 و flip270، که احتمالاً با پیشوند '@' همراه هستند.

عدد نشان‌دهنده چرخش در جهت عقربه‌های ساعت برحسب درجه است؛ کلیدواژه "flip" قبل از چرخش یک قرینه‌سازی افقی اعمال می‌کند.

اگر برای تصویربرداری از نمایشگر یک '@' ابتدایی وارد شود (@90)، چرخش قفل شده و نسبت به جهت‌گیری طبیعی دستگاه سنجیده می‌شود.

اگر '@' به‌تنهایی وارد شود، چرخش روی جهت‌گیری اولیه دستگاه قفل می‌شود.

مقدار پیش‌فرض 0 است.

برش دادن صفحه نمایش دستگاه روی سرور.

مقادیر بر اساس جهت‌گیری طبیعی دستگاه بیان می‌شوند (به‌طور معمول، عمودی برای گوشی، افقی برای تبلت).

استفاده از دستگاه USB (اگر دقیقاً یکی وجود داشته باشد، مانند adb -d).

همچنین -e (--select-tcpip) را ببینید.

غیرفعال کردن محافظ صفحه هنگام اجرای scrcpy.
مشخص کردن شناسه نمایشگر دستگاه برای بازتاب.

شناسه‌های نمایشگر در دسترس را می‌توان با --list-displays فهرست کرد.

مقدار پیش‌فرض 0 است..TP --display-ime-policy value تنظیم خط‌مشی برای انتخاب مکان نمایش IME.

مقادیر ممکن عبارتند از "local"، "fallback" و "hide":


- "local" به این معنی است که IME باید روی نمایشگر محلی ظاهر شود.
- "fallback" به این معنی است که IME باید روی نمایشگر پشتیبان (نمایشگر پیش‌فرض) ظاهر شود.
- "hide" به این معنی است که IME باید پنهان شود.

به طور پیش‌فرض، خط‌مشی IME بدون تغییر باقی می‌ماند.

تنظیم جهت‌گیری اولیه نمایشگر.

مقادیر ممکن عبارتند از 0، 90، 180، 270، flip0، flip90، flip180 و flip270. عدد بیانگر چرخش در جهت عقربه‌های ساعت بر حسب درجه است؛ کلیدواژه "flip" قبل از چرخش، یک بازتاب افقی اعمال می‌کند.

پیش‌فرض 0 است.

استفاده از دستگاه TCP/IP (اگر دقیقاً یکی وجود داشته باشد، مانند adb -e).

همچنین -d (--select-usb) را ببینید.

شروع در حالت تمام‌صفحه.
عدم تلاش برای استفاده از "adb reverse" جهت اتصال به دستگاه.
همانند --gamepad=uhid، یا در صورت تنظیم --otg، مانند --keyboard=aoa است.
انتخاب نحوه ارسال ورودی‌های گیم‌پد به دستگاه.

مقادیر ممکن عبارتند از "disabled"، "uhid" و "aoa":


- "disabled" ورودی‌های گیم‌پد را به دستگاه ارسال نمی‌کند.
- "uhid" گیم‌پدهای فیزیکی HID را با استفاده از ماژول هسته HID لینوکس در دستگاه شبیه‌سازی می‌کند.
- "aoa" گیم‌پدهای فیزیکی HID را با استفاده از پروتکل AOAv2 شبیه‌سازی می‌کند. این حالت ممکن است تنها از طریق USB کار کند.

همچنین --keyboard و R--mouse را ببینید.

چاپ این پیام راهنما.
نادیده گرفتن قابلیت‌های انکودر ویدیو.

این گزینه در صورتی که قابلیت‌های گزارش‌شده نادرست باشند، مفید است.

ممکن است به اجبار یک مقدار برای --min-size-alignment کمک کند.

همانند --keyboard=uhid، یا در صورت تنظیم --otg، مانند --keyboard=aoa است.
روشن نگه داشتن صفحه نمایش با شبیه‌سازی فعالیت کاربر.
انتخاب نحوه ارسال ورودی‌های صفحه‌کلید به دستگاه.

مقادیر ممکن عبارتند از "disabled"، "sdk"، "uhid" و "aoa":


- "disabled" ورودی‌های صفحه‌کلید را به دستگاه ارسال نمی‌کند.
- "sdk" از API سیستم اندروید برای تحویل رویدادهای صفحه‌کلید به برنامه‌ها استفاده می‌کند.
- "uhid" یک صفحه‌کلید فیزیکی HID را با استفاده از ماژول هسته HID لینوکس در دستگاه شبیه‌سازی می‌کند.
- "aoa" یک صفحه‌کلید فیزیکی HID را با استفاده از پروتکل AOAv2 شبیه‌سازی می‌کند. این حالت ممکن است تنها از طریق USB کار کند.

برای "uhid" و "aoa"، چیدمان صفحه‌کلید باید (یک‌بار برای همیشه) در دستگاه، از طریق Settings -> System -> Languages and input -> Physical keyboard پیکربندی شود. این صفحه تنظیمات را می‌توان مستقیماً با استفاده از میانبر MOD+k (به جز در حالت OTG)، یا با اجرای دستور زیر باز کرد:


adb shell am start -a android.settings.HARD_KEYBOARD_SETTINGS

این گزینه تنها زمانی در دسترس است که صفحه‌کلید HID فعال باشد (یا یک صفحه‌کلید فیزیکی متصل باشد).

همچنین --mouse و --gamepad را ببینید.

خاتمه دادن به فرآیند adb هنگام بسته شدن scrcpy.
تزریق متن کلیپ‌بورد رایانه به صورت توالی‌ای از رویدادهای کلید هنگام فشرده شدن Ctrl+v (مانند MOD+Shift+v).

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

فهرست کردن برنامه‌های اندروید نصب‌شده روی دستگاه.
فهرست کردن اندازه‌های معتبر تصویربرداری دوربین.
فهرست کردن دوربین‌های موجود روی دستگاه.
فهرست کردن انکودرهای صدا و ویدیوی موجود روی دستگاه.
فهرست کردن نمایشگرهای موجود روی دستگاه.
محدود کردن هم‌زمان عرض و ارتفاع ویدیو.

برای آینه‌کردن نمایشگر، بُعد دیگر به گونه‌ای محاسبه می‌شود که نسبت ابعاد دستگاه حفظ شود (به جز نمایشگرهای انعطاف‌پذیر).

برای آینه‌کردن دوربین، این مقدار در عوض برای انتخاب اندازه منبع دوربین استفاده می‌شود.

پیش‌فرض 0 (نامحدود) است.

همانند --mouse=uhid، یا در صورت تنظیم --otg، مانند --mouse=aoa است.
محدود کردن نرخ فریم تصویربرداری از صفحه نمایش (به طور رسمی از اندروید 10 پشتیبانی می‌شود، اما ممکن است روی نسخه‌های قدیمی‌تر نیز کار کند).
پیکربندی حداقل هم‌ترازی اندازه ویدیو.

این مقداری از توان‌های 2 (1، 2، 4، 8 یا 16) است که عرض و ارتفاع ویدیو باید مضربی از آن باشند.

هم‌ترازی واقعی، بیشینهٔ این مقدار و الزامات هم‌ترازی کدک ویدیو خواهد بود.

پیش‌فرض 1 است.

انتخاب نحوه ارسال ورودی‌های موشواره به دستگاه.

مقادیر ممکن عبارتند از "disabled"، "sdk"، "uhid" و "aoa":


- "disabled" ورودی‌های موشواره را به دستگاه ارسال نمی‌کند.
- "sdk" از API سیستم اندروید برای ارسال رویدادهای موشواره به برنامه‌ها استفاده می‌کند.
- "uhid" یک موشواره فیزیکی HID را با استفاده از ماژول هسته HID لینوکس در دستگاه شبیه‌سازی می‌کند.
- "aoa" یک موشواره فیزیکی را با استفاده از پروتکل AOAv2 شبیه‌سازی می‌کند. این حالت ممکن است تنها از طریق USB کار کند.

در حالت‌های "uhid" و "aoa"، موشواره رایانه برای کنترل مستقیم دستگاه ضبط می‌شود (حالت موشواره نسبی).

کلیدهای LAlt، LSuper یا RSuper حالت ضبط را تغییر می‌دهند تا کنترل موشواره به رایانه بازگردانده شود.

همچنین --keyboard و --gamepad را ببینید.

پیکربندی اتصالات کلیک‌های ثانویه.

آرگومان باید یک یا دو توالی (جداشده با ':') از دقیقاً 4 نویسه باشد، یکی برای هر کلیک ثانویه (به ترتیب: راست‌کلیک، کلیک وسط، کلیک چهارم، کلیک پنجم).

توالی اول اتصالات اولیه را تعیین می‌کند که هنگام فشرده شدن دکمه موشواره به تنهایی استفاده می‌شود. توالی دوم اتصالات ثانویه را تعیین می‌کند که هنگام فشرده شدن دکمه موشواره در حین نگه داشتن کلید Shift استفاده می‌شود.

اگر توالی دوم اتصالات نادیده گرفته شود، مانند توالی اول در نظر گرفته خواهد شد.

هر نویسه باید یکی از موارد زیر باشد:


- '+': ارسال کلیک به دستگاه
- '-': نادیده گرفتن کلیک
- 'b': اجرای میانبر BACK (یا روشن کردن صفحه در صورت خاموش بودن)
- 'h': اجرای میانبر HOME
- 's': اجرای میانبر APP_SWITCH
- 'n': اجرای میانبر "expand notification panel" (باز کردن پنل اعلان‌ها)

پیش‌فرض برای موشواره SDK مقدار 'bhsn:++++' و برای AOA و UHID مقدار '++++:bhsn' است..TP -n, --no-control غیرفعال کردن کنترل دستگاه (آینه‌کردن دستگاه به‌صورت فقط‌خواندنی).

غیرفعال کردن پخش ویدیو و صدا در رایانه (معادل با --no-video-playback --no-audio-playback).
ایجاد یک نمایشگر جدید با وضوح تصویر و تراکم مشخص‌شده. در صورت مشخص نشدن، به‌طور پیش‌فرض از ابعاد و DPI نمایشگر اصلی استفاده می‌شود.

مثال‌ها:


--new-display=1920x1080
--new-display=1920x1080/420
--new-display # اندازه و تراکم نمایشگر اصلی
--new-display=/240 # اندازه نمایشگر اصلی و تراکم 240 dpi

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

این گزینه این پاک‌سازی را غیرفعال می‌کند.

به‌طور پیش‌فرض، scrcpy پیش از ارسال کلید‌های میانبر Ctrl+v به‌طور خودکار کلیپ‌بورد رایانه را با کلیپ‌بورد دستگاه، و در صورت هرگونه تغییر در کلیپ‌بورد دستگاه، آن را با کلیپ‌بورد رایانه همگام‌سازی می‌کند.

این گزینه این همگام‌سازی خودکار را غیرفعال می‌کند.

به‌طور پیش‌فرض، هنگام بروز خطای MediaCodec، ابزار scrcpy به‌طور خودکار با وضوح تصویر پایین‌تر مجدداً تلاش می‌کند.

این گزینه این رفتار را غیرفعال می‌کند.

هنگام نگه‌داشتن یک کلید، رویدادهای تکرار کلید ارسال نشوند.
اگر موتور رندر OpenGL 3.0+ یا OpenGL ES 2.0+ باشد، mipmapها به‌طور خودکار برای بهبود کیفیت مقیاس‌دهی به پایین (downscaling) تولید می‌شوند. این گزینه تولید mipmapها را غیرفعال می‌کند.
رویدادهای حرکت شناور موش‌واره (حرکت موش‌واره بدون هیچ‌گونه کلیک) ارسال نشوند.
روشن نکردن دستگاه هنگام شروع.
غیرفعال کردن به‌روزرسانی عنوان ترمینال.
غیرفعال کردن پرچم «destroy content on removal» (حذف محتوا هنگام نابودی) در نمایشگر مجازی.

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

غیرفعال کردن پرچم تزئینات سیستمی (system decorations) نمایشگر مجازی.
غیرفعال کردن ارسال ویدیو.
غیرفعال کردن پخش ویدیو در رایانه.
غیرفعال کردن پنجرهٔ scrcpy. مستلزم فعال بودن --no-video-playback است.
غیرفعال کردن قفل نسبت ابعاد پنجره.
مشابه با --display-orientation=value --record-orientation=value.
اجرا در حالت OTG: شبیه‌سازی صفحه‌کلید و موش‌واره فیزیکی، درست مانند آن‌که صفحه‌کلید و موش‌واره رایانه مستقیماً از طریق یک کابل OTG به دستگاه متصل شده باشند.

در این حالت، نیازی به adb (اشکال‌زدایی USB) نبوده و آینه‌کردن تصویر غیرفعال است.

کلیدهای LAlt، LSuper یا RSuper حالت ضبط موش‌واره را تغییر وضعیت می‌دهند تا کنترل موش‌واره به رایانه بازگردانده شود.

صفحه‌کلید و موش‌واره را می‌توان به‌طور جداگانه با استفاده از --keyboard=disabled و --mouse=disabled غیرفعال کرد.

این ویژگی ممکن است فقط از طریق USB کار کند.

ببینید: --keyboard، --mouse و --gamepad.

تنظیم درگاه (محدوده درگاه) TCP مورد استفاده کلاینت برای شنود.

پیش‌فرض 27183:27199 است.

پیکربندی توقف در زمان خروج. مقادیر ممکن عبارتند از "true" (همیشه هنگام خروج مکث شود)، "false" (هرگز هنگام خروج مکث نشود) و "if-error" (مکث فقط در صورت وقوع خطا).

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

پیش‌فرض "false" است.

ارسال این گزینه بدون آرگومان، معادل مشخص کردن "true" است.

خاموش کردن صفحه نمایش دستگاه هنگام بستن scrcpy.
تزریق نویسه‌های الفبایی و فاصله به‌صورت رویدادهای متنی (text events) به جای رویدادهای کلیدی (key events).

این کار از بروز مشکلات هنگام ترکیب چند کلید برای ورود نویسه‌های خاص جلوگیری می‌کند، اما رفتار مورد انتظار کلیدهای الفبایی را در بازی‌ها (معمولاً WASD) مختل می‌کند.

شروع شمارندهٔ FPS برای چاپ لاگ‌های نرخ فریم در کنسول. این کار را می‌توان در هر زمان با استفاده از کلیدهای MOD+i شروع یا متوقف کرد.
تنظیم دایرکتوری مقصد برای فرستادن فایل‌ها به دستگاه با کشیدن و رها کردن (drag & drop). این مقدار بدون تغییر به "adb push" تحویل داده می‌شود.

پیش‌فرض "/sdcard/Download/" است.

ضبط صفحه نمایش در file.

فرمت ضبط توسط گزینهٔ --record-format در صورت تنظیم، یا بر اساس پسوند فایل تعیین می‌شود.

تزریق رویدادهای کلیدی برای تمام کلیدهای ورودی و نادیده گرفتن رویدادهای متنی.
اجبار به استفاده از فرمت ضبط (mp4، mkv، m4a، mka، opus، aac، flac یا wav).
تنظیم جهت چرخش هنگام ضبط.

مقادیر ممکن عبارتند از 0، 90، 180 و 270. این عدد نشان‌دهندهٔ چرخش بر حسب درجه در جهت عقربه‌های ساعت است.

پیش‌فرض 0 است.

درخواست از SDL برای استفاده از درایور رندر داده‌شده (این گزینه صرفاً یک پیشنهاد است).

نام‌های پشتیبانی‌شده در حال حاضر عبارتند از "direct3d"، "opengl"، "opengles2"، "opengles"، "metal" و "software".

https://wiki.libsdl.org/SDL_HINT_RENDER_DRIVER

تنظیم حالت render-fit برای پیکربندی نحوهٔ تطبیق رندر با پنجره.

مقادیر ممکن عبارتند از "letterbox"، "stretched" و "unscaled":


- "letterbox": حفظ نسبت ابعاد و تطبیق دادن تصویر با پنجره به بهترین شکل ممکن (در صورت نیاز نوارهای سیاهی در بالا و پایین یا در طرفین اضافه می‌شود).
- "stretched": پر کردن پنجره بدون حفظ نسبت تصویر.
- "unscaled": رندر کردن تصویر نمایشگر بدون هیچ مقیاس‌بندی.

پیش‌فرض "letterbox" است، مگر اینکه گزینهٔ --flex-display تنظیم شده باشد که در این حالت "unscaled" خواهد بود..TP --require-audio به‌طور پیش‌فرض، اگر ضبط صدا در دستگاه ناموفق باشد، scrcpy فقط تصویر را آینه‌سازی (mirror) می‌کند. این گزینه باعث می‌شود در صورتی که صدا فعال باشد اما کار نکند، scrcpy با خطا متوقف شود.

شماره سریال دستگاه. تنها در صورتی اجباری است که چندین دستگاه به adb متصل باشند.
صفحه نمایش دستگاه را فوراً خاموش می‌کند.
تنظیم مدت‌زمان وقفهٔ خاموش شدن صفحه نمایش در حین اجرای scrcpy (مقدار اولیه در زمان خروج بازگردانده می‌شود).
کلیدهای تغییردهنده (modifier) مورد استفاده برای میان‌برهای scrcpy را مشخص می‌کند. کلیدهای ممکن عبارت‌اند از "lctrl"، "rctrl"، "lalt"، "ralt"، "lsuper" و "rsuper".

می‌توان چندین کلید تغییردهنده میان‌بر را با جدا کردن توسط ',' تعیین کرد.

برای نمونه، جهت استفاده از LCtrl یا LSuper برای میان‌برهای scrcpy، مقدار "lctrl,lsuper" را بدهید.

پیش‌فرض "lalt,lsuper" است (Alt چپ یا Super چپ).

یک برنامه اندروید را با نام دقیق بسته (package name) آن اجرا می‌کند.

افزودن پیشوند '?' برای انتخاب برنامه‌ای که نام آن با نام ارائه‌شده آغاز می‌شود، بدون حساسیت به بزرگی و کوچکی حروف (دریافت نام برنامه‌ها در دستگاه ممکن است کمی زمان ببرد):


scrcpy --start-app=?firefox

افزودن پیشوند '+' برای توقف اجباری (force-stop) پیش از شروع برنامه:


scrcpy --new-display --start-app=+org.mozilla.firefox

هر دو پیشوند را می‌توان به همین ترتیب با هم استفاده کرد:


scrcpy --start-app=+?firefox

فعال‌سازی «نمایش لمس‌ها» در هنگام شروع، و بازگردانی مقدار اولیه در زمان خروج.

این گزینه فقط لمس‌های فیزیکی را نشان می‌دهد (نه کلیک‌های ناشی از scrcpy را).

پیکربندی و اتصال دستگاه از طریق TCP/IP.

اگر نشانی مقصد مشخص شده باشد، scrcpy پیش از شروع به این نشانی متصل می‌شود. دستگاه باید روی درگاه TCP مشخص‌شده منتظر اتصال باشد (پیش‌فرض 5555 است).

اگر هیچ نشانی مقصدی داده نشود، scrcpy تلاش می‌کند تا نشانی IP و پورت adb دستگاه فعلی (معمولاً متصل از طریق USB) را بیابد، در صورت نیاز حالت TCP/IP را فعال کند، و سپس پیش از شروع به این نشانی متصل شود.

برای اجبار به برقراری اتصال مجدد، پیشوند '+' را قبل از نشانی قرار دهید.

حداکثر زمان آینه‌سازی را بر حسب ثانیه تنظیم می‌کند.
نشانی IP تونل adb را برای دسترسی به سرور scrcpy تنظیم می‌کند. این گزینه به‌طور خودکار --force-adb-forward را فعال می‌کند.

پیش‌فرض localhost است.

درگاه TCP تونل adb را برای دسترسی به سرور scrcpy تنظیم می‌کند. این گزینه به‌طور خودکار --force-adb-forward را فعال می‌کند.

پیش‌فرض 0 است (اجباری نشده): از درگاه محلی استفاده‌شده برای برقراری تونل استفاده خواهد شد.

نسخهٔ scrcpy را چاپ می‌کند.
سطح ثبت وقایع (log level) را تنظیم می‌کند ("verbose"، "debug"، "info"، "warn" یا "error").

پیش‌فرض برای بیلد‌های پایانی "info" و برای بیلد‌های اشکال‌زدایی "debug" است.

ارسال خروجی به دستگاه v4l2loopback.
افزودن تأخیر بافرینگ (بر حسب میلی‌ثانیه) پیش از ارسال فریم‌ها. این گزینه با افزایش تأخیر، نوسان و ناپایداری (jitter) را جبران می‌کند.

این گزینه مشابه --video-buffer است، اما مختص مقصد V4L2 می‌باشد.

پیش‌فرض 0 است (بدون بافرینگ).

افزودن تأخیر بافرینگ (بر حسب میلی‌ثانیه) پیش از نمایش فریم‌های ویدیو.

این کار با افزایش تأخیر، نوسان (jitter) را جبران می‌کند.

پیش‌فرض 0 است (بدون بافرینگ).

انتخاب یک کدک ویدیو (h264، h265، av1، vp8 یا vp9).

پیش‌فرض h264 است.

تنظیم فهرستی از گزینه‌ها به صورت key:type=value جداشده با کاما برای رمزگذار ویدیوی دستگاه.

مقادیر مجاز برای 'type' عبارت‌اند از 'int' (پیش‌فرض)، 'long'، 'float' و 'string'.

فهرست گزینه‌های ممکن کدک در مستندات اندروید موجود است:

https://d.android.com/reference/android/media/MediaFormat

استفاده از یک رمزگذار ویدیوی MediaCodec خاص (بسته به کدک مشخص‌شده توسط --video-codec).

رمزگذارهای موجود را می‌توان با استفاده از --list-encoders فهرست کرد.

انتخاب منبع ویدیو (display یا camera).

آینه‌سازی دوربین نیازمند اندروید ۱۲ یا بالاتر است.

پیش‌فرض display است.

روشن نگه داشتن دستگاه در حین اجرای scrcpy، هنگامی که دستگاه به برق متصل است.
غیرفعال کردن حاشیه‌ها و تزیینات پنجره (نمایش پنجره بدون حاشیه).
تنظیم عنوان سفارشی پنجره.
تنظیم موقعیت افقی اولیه پنجره.

پیش‌فرض "auto" است.

تنظیم موقعیت عمودی اولیه پنجره.

پیش‌فرض "auto" است.

تنظیم عرض اولیه پنجره.

پیش‌فرض 0 است (خودکار).

تنظیم ارتفاع اولیه پنجره.

پیش‌فرض 0 است (خودکار).

تغییر مداوم ابعاد نمایشگر مجازی برای مطابقت با پنجره..SH "وضعیت خروج (EXIT STATUS)" scrcpy در صورت خاتمه عادی برنامه با کد 0 خارج می‌شود. اگر برقراری اتصال اولیه ممکن نباشد، کد خروج 1 بازگردانده خواهد شد. اگر دستگاه در حین فعال بودن یک نشست قطع شود، کد خروج 2 بازگردانده می‌شود.

در فهرست زیر، MOD کلید تبدیل (modifier) میانبر است. به‌طور پیش‌فرض، این کلید Alt (چپ) یا Super (چپ) است، اما می‌توان آن را با --shortcut-mod پیکربندی کرد (به بالا مراجعه کنید).

خروج
تغییر حالت تمام‌صفحه
چرخاندن صفحه به چپ
چرخاندن صفحه به راست
قرینه‌سازی افقی تصویر
قرینه‌سازی عمودی تصویر
مکث یا مکث مجدد تصویر
لغو مکث تصویر
بازنشانی ضبط/کدگذاری ویدیو
تغییر اندازه پنجره به نسبت 1:1 (دقت پیکسل به پیکسل)
تغییر اندازه پنجره برای حذف حاشیه‌های سیاه
کلیک روی HOME
کلیک روی BACK
کلیک روی APP_SWITCH
کلیک روی MENU
کلیک روی VOLUME_UP
کلیک روی VOLUME_DOWN
کلیک روی POWER (روشن/خاموش کردن صفحه)
روشن کردن صفحه
خاموش کردن صفحه دستگاه (ادامه بازتاب)
روشن کردن صفحه دستگاه
چرخاندن صفحه دستگاه
باز کردن پنل اعلان‌ها
بستن پنل اعلان‌ها
رونوشت در حافظه موقت (ارسال کد کلید COPY، تنها در Android >= 7)
برش در حافظه موقت (ارسال کد کلید CUT، تنها در Android >= 7)
رونوشت از حافظه موقت رایانه به دستگاه، سپس چسباندن (ارسال کد کلید PASTE، تنها در Android >= 7)
ارسال متن حافظه موقت رایانه به‌صورت توالی‌ای از رویدادهای کلید
باز کردن تنظیمات صفحه‌کلید در دستگاه (تنها برای صفحه‌کلید HID)
فعال/غیرفعال کردن شمارنده FPS (چاپ فریم در ثانیه در لاگ‌ها)
بزرگ‌نمایی با دو انگشت (Pinch-to-zoom) و چرخش از مرکز صفحه
شیب دادن عمودی (لغزاندن با ۲ انگشت)
شیب دادن افقی (لغزاندن با ۲ انگشت)
نصب APK از رایانه
انتقال فایل به دستگاه (نگاه کنید به --push-target)
روشن کردن چراغ‌قوه دوربین (تنها در حالت دوربین)
خاموش کردن چراغ‌قوه دوربین (تنها در حالت دوربین)
بزرگ‌نمایی دوربین به جلو (تنها در حالت دوربین)
بزرگ‌نمایی دوربین به عقب (تنها در حالت دوربین).SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
مسیر adb.
شماره سریال دستگاه برای استفاده در صورتی که هیچ انتخاب‌گری (-s، -d، -e یا --tcpip=addr) مشخص نشده باشد.
مسیر دایرکتوری آیکون.
مسیر فایل باینری سرور.

scrcpy توسط Romain Vimont نوشته شده است.

این صفحهٔ راهنما توسط Yangfl برای پروژهٔ Debian نوشته شده است (و می‌تواند توسط دیگران نیز استفاده شود).

باگ‌ها را به https://github.com/Genymobile/scrcpy/issues گزارش دهید.

حق نشر © 2018 Genymobile https://www.genymobile.com

حق نشر © 2018-2026 Romain Vimont <rom@rom1v.com>

تحت پروانهٔ Apache License، نسخهٔ 2.0 منتشر شده است.

https://github.com/Genymobile/scrcpy