You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
scrcpy/doc/windows.md

2.7 KiB

On Windows

Install

Download the latest release:

  • scrcpy-win64-v2.4.zip (64-bit)
    SHA-256: 9dc56f21bfa455352ec0c58b40feaf2fb02d67372910a4235e298ece286ff3a9
  • scrcpy-win32-v2.4.zip (32-bit)
    SHA-256: cf92acc45eef37c6ee2db819f92e420ced3bc50f1348dd57f7d6ca1fc80f6116

and extract it.

Alternatively, you could install it from packages manager, like Winget:

winget install scrcpy

or Chocolatey:

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

or 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:

To start scrcpy directly without opening a terminal, double-click on one of these files:

  • scrcpy-console.bat: start with a terminal open (it will close when scrcpy terminates, unless an error occurs);
  • scrcpy-noconsole.vbs: start without a terminal (but you won't see any error message).

Avoid double-clicking on scrcpy.exe directly: on error, the terminal would close immediately and you won't have time to read any error message (this executable is intended to be run from the terminal). Use scrcpy-console.bat instead.

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

Then just double-click on that file.

You could also edit (a copy of) scrcpy-console.bat or scrcpy-noconsole.vbs to add some arguments.