aljaz/scrcpy
1
0
Fork 0
mirror of https://github.com/Genymobile/scrcpy.git synced 2026-02-14 10:24:29 +01:00
Code Issues Packages Projects Releases Wiki Activity
Files
pause-if-error-windows
scrcpy/doc/windows.md
Romain Vimont 93835f58f3 Keep Windows terminal open on error 
If scrcpy is launched by double-clicking scrcpy.exe in Windows Explorer,
automatically set --pause-on-exit=if-error.

Without this, the terminal would close immediately, preventing the user
from seeing the error.

Also remove scrcpy-console.bat, which is now useless.
2026-02-10 20:03:08 +01:00

2.5 KiB
Raw Permalink Blame History

On Windows

Install

From the official release

Download the latest release:

and extract it.

From a package manager

From WinGet (ADB and other dependencies will be installed alongside scrcpy):

winget install --exact Genymobile.scrcpy

From Chocolatey:

choco install scrcpy
choco install adb    # if you don't have it yet

From Scoop:

scoop install scrcpy
scoop install adb    # if you don't have it yet

See build.md to build and install the app manually.

Run

Make sure that your device meets the prerequisites.

Scrcpy is a command line application: it is mainly intended to be executed from a terminal with command line arguments.

To open a terminal at the expected location, double-click on open_a_terminal_here.bat in your scrcpy directory, then type your command. For example, without arguments:

scrcpy

or with arguments (here to disable audio and record to file.mkv):

scrcpy --no-audio --record=file.mkv

Documentation for command line arguments is available:

If you plan to always use the same arguments, create a file myscrcpy.bat (enable show file extensions to avoid confusion) containing your command, For example:

scrcpy --prefer-text --turn-screen-off --stay-awake

Add --pause-on-exit=if-error if you want the console to remain open when scrcpy fails:

scrcpy --prefer-text --turn-screen-off --stay-awake --pause-on-exit=if-error

Then just double-click on that file to run it.

To start scrcpy without opening a terminal, double-click scrcpy-noconsole.vbs (note that errors won't be shown). To pass arguments, edit (a copy of) scrcpy-noconsole.vbs add and the desired arguments.