Settings
Each one as the Settings tab shows it, with its default, its choices, when it applies, and the command that changes it. This page is made from the app itself.
A profile is a list of settings to switch to in one go: one for games, one for films, one for battery. Applying one changes only the settings in it.
Profiles.WhenFullscreenrex config set Profiles.WhenFullscreen Lowest latency
Profiles.WhenOnBatteryrex config set Profiles.WhenOnBattery Lowest latency
Profiles.PerPhonerex config set Profiles.PerPhone false
Profiles.PutBackrex config set Profiles.PutBack false
Profiles.Announcerex config set Profiles.Announce false
Profiles.AfterApplyingrex config set Profiles.AfterApplying restart
Profiles.Keysrex config set Profiles.Keys false
Profiles.InTrayrex config set Profiles.InTray false
Everything up to Show taps on the phone applies the next time the mirror starts. The soft background previews as you change it.
Mirror.MaxSizerex config set Mirror.MaxSize 0
Mirror.MaxFpsrex config set Mirror.MaxFps 0
Mirror.VideoBitRaterex config set Mirror.VideoBitRate 4M
Mirror.VideoCodecrex config set Mirror.VideoCodec h265
The part of the phone that makes the video. Its own choice suits almost every phone.
Mirror.VideoEncoderWidth:height:x:y in the phone's pixels. Empty shows the whole screen.
Mirror.CropKeep the picture one way, however the phone is held.
Mirror.CaptureOrientationrex config set Mirror.CaptureOrientation @
Only on this PC. Ctrl+Alt+Left and Ctrl+Alt+Right still turn it.
Mirror.StartOrientationrex config set Mirror.StartOrientation 90
Degrees clockwise, for a phone in a stand that is not quite straight.
Mirror.Anglerex config set Mirror.Angle 359
Off can make small text look a little sharper.
Mirror.SmoothScalingrex config set Mirror.SmoothScaling false
The phone draws a dot where it is touched, for recordings and for showing others. Put back when the mirror ends.
Mirror.ShowTouchesrex config set Mirror.ShowTouches true
A blurred copy of the phone screen fills the empty space around the mirror. Changes preview instantly.
Ambient.Enabledrex config set Ambient.Enabled false
Ambient.Placementrex config set Ambient.Placement left
Ambient.Scalingrex config set Ambient.Scaling fit
Ambient.Opacityrex config set Ambient.Opacity 1
0 shows the capture sharp
Ambient.Blurrex config set Ambient.Blur 80
Ambient.Sizerex config set Ambient.Size 3
Ambient.OffsetXrex config set Ambient.OffsetX 1
Ambient.OffsetYrex config set Ambient.OffsetY 1
Ambient.EdgeFaderex config set Ambient.EdgeFade 1
Ambient.TintStrengthrex config set Ambient.TintStrength 1
Ambient.TintHuerex config set Ambient.TintHue 360
How closely the background follows the video. Lower uses less power.
Ambient.FrameRaterex config set Ambient.FrameRate 60
Ambient.FlipHorizontalrex config set Ambient.FlipHorizontal true
Ambient.WhenZoomedrex config set Ambient.WhenZoomed hide
These apply the next time the mirror starts.
Mirror.Audiorex config set Mirror.Audio false
Mirror.AudioDuprex config set Mirror.AudioDup true
Mirror.AudioSourcerex config set Mirror.AudioSource output
Mirror.AudioBitRaterex config set Mirror.AudioBitRate 64K
Mirror.AudioCodecrex config set Mirror.AudioCodec aac
Evens out a shaky connection; 0 is the lowest delay.
Mirror.AudioBufferMsrex config set Mirror.AudioBufferMs 500
Raise it if the sound crackles or breaks up on this PC.
Mirror.AudioOutputBufferMsrex config set Mirror.AudioOutputBufferMs 200
When the phone cannot send its sound, the mirror stops and says why instead of going on silent.
Mirror.RequireAudiorex config set Mirror.RequireAudio true
How the phone's sound plays here. Only this PC is changed; the phone's own volume stays where it is. The sound button in the top bar does the same at a click.
Where a phone starts. With each phone remembered, the sound button in the top bar sets the one you are using.
Sound.Volumerex config set Sound.Volume 1
Sound.Mutedrex config set Sound.Muted true
Sound.Steprex config set Sound.Step 0.25
Off, every phone plays at the volume above.
Sound.RememberPerPhonerex config set Sound.RememberPerPhone false
From the next mirror on.
Sound.StartMutedrex config set Sound.StartMuted true
Sound.MuteWhenHiddenrex config set Sound.MuteWhenHidden true
Sound.MuteWhenBehindrex config set Sound.MuteWhenBehind true
Sound.MuteWhenLockedrex config set Sound.MuteWhenLocked true
Sound.LowerWhileTypingrex config set Sound.LowerWhileTyping true
Sound.LowerTorex config set Sound.LowerTo 1
Sound.LowerForMsrex config set Sound.LowerForMs 5000
Sound.FadeMsrex config set Sound.FadeMs 1000
Sound.Balancerex config set Sound.Balance 1
Sound.FollowMixerrex config set Sound.FollowMixer false
Sound.ShowLevelrex config set Sound.ShowLevel false
Sound.WheelOnButtonrex config set Sound.WheelOnButton false
Saves battery and blocks touches on the handset.
Session.TurnScreenOffrex config set Session.TurnScreenOff false
Over USB; a phone on Wi-Fi keeps its own timeout.
Session.StayAwakerex config set Session.StayAwake false
Session.PowerOffOnCloserex config set Session.PowerOffOnClose true
Session.RestartOnUnexpectedExitrex config set Session.RestartOnUnexpectedExit false
A mirror that ran for a minute counts as working again.
Session.RestartLimitrex config set Session.RestartLimit 20
For a time limit on a shared PC, or a recording of a set length.
Mirror.TimeLimitMinutesrex config set Mirror.TimeLimitMinutes 15
Even on Wi-Fi, while the mirror is open.
Session.KeepActiverex config set Session.KeepActive false
Session.WakeBeforeMirrorrex config set Session.WakeBeforeMirror false
A swipe-only lock screen gets out of the way by itself.
Session.DismissKeyguardrex config set Session.DismissKeyguard false
The phone's own comes back when the mirror ends.
Session.ScreenOffTimeoutSecondsrex config set Session.ScreenOffTimeoutSeconds 15
No screen saver or sleep while the phone is on screen.
Session.KeepPcAwakerex config set Session.KeepPcAwake true
Leave empty to open nothing
Session.StartAppZoom.Enabledrex config set Zoom.Enabled false
Zoom.WheelZoomrex config set Zoom.WheelZoom false
Zoom.PinchZoomrex config set Zoom.PinchZoom false
Zoom.ZoomAtPointerrex config set Zoom.ZoomAtPointer false
Zoom.InvertWheelrex config set Zoom.InvertWheel true
Zoom.ResetOnRotaterex config set Zoom.ResetOnRotate true
Zoom.ShowNavigatorrex config set Zoom.ShowNavigator false
The whole phone screen, small, with the part you are looking at framed.
Zoom.NavigatorPicturerex config set Zoom.NavigatorPicture false
Zoom.NavigatorAlwaysrex config set Zoom.NavigatorAlways true
Zoom.NavigatorCornerrex config set Zoom.NavigatorCorner bottom-left
Zoom.NavigatorWidthrex config set Zoom.NavigatorWidth 360
Zoom.NavigatorOpacityrex config set Zoom.NavigatorOpacity 1
How closely the navigator picture follows the video.
Zoom.NavigatorFrameRaterex config set Zoom.NavigatorFrameRate 60
Zoom.MaxZoomrex config set Zoom.MaxZoom 8
Zoom.WheelSteprex config set Zoom.WheelStep 0.5
How far Ctrl+Alt+Plus, Ctrl+Alt+Minus and the zoom buttons go each time.
Zoom.KeySteprex config set Zoom.KeyStep 1
How the touchpad, the mouse buttons, the keys and the clipboard reach the phone, on every copy too. Buttons, keys and the clipboard apply the next time the mirror starts; the rest change at once.
Off, the touchpad only moves the pointer over the phone.
Touchpad.Enabledrex config set Touchpad.Enabled false
Pinch, rotate and pan like on the phone screen.
Touchpad.TwoFingerToAndroidrex config set Touchpad.TwoFingerToAndroid false
Touchpad.Sensitivityrex config set Touchpad.Sensitivity 3
Sends raw keys instead of acting as a plugged-in keyboard. Only if typing misbehaves; applies when the mirror restarts.
Mirror.CompatibilityKeyboardrex config set Mirror.CompatibilityKeyboard true
Input.RightClickrex config set Input.RightClick home
Input.MiddleClickrex config set Input.MiddleClick back
Input.BackButtonrex config set Input.BackButton back
Input.ForwardButtonrex config set Input.ForwardButton back
Whatever the button is set to do above.
Input.ShiftClicksrex config set Input.ShiftClicks false
With the compatibility keyboard. The phone repeats keys itself otherwise.
Input.KeyRepeatrex config set Input.KeyRepeat false
For apps and games that react to hovering.
Input.MouseHoverrex config set Input.MouseHover false
Copying on the phone copies on the PC too, and pasting sends the PC's clipboard first.
Input.ClipboardAutosyncrex config set Input.ClipboardAutosync false
For phones that ignore a pasted clipboard.
Input.LegacyPasterex config set Input.LegacyPaste true
Through the main view only: every copy would add another controller.
Input.Gamepadrex config set Input.Gamepad uhid
Input.SwipeLengthrex config set Input.SwipeLength 1.5
Quicker swipes fling further, as they do under a finger.
Input.SwipeMillisecondsrex config set Input.SwipeMilliseconds 800
Extra live views of an upright phone, side by side, added from the Controls tab. Each copy is a session of its own, so each one asks the phone for another video encoder.
Only as many as fit the window at full height can be open, whatever this says.
Copies.Mostrex config set Copies.Most 5
Copies.Gaprex config set Copies.Gap 48
A lower one is lighter on the phone and the PC. Open copies restart with it.
Copies.MaxSizerex config set Copies.MaxSize 1920
A lower one is lighter on the phone and the PC. Open copies restart with it.
Copies.MaxFpsrex config set Copies.MaxFps 60
Copies.Rememberrex config set Copies.Remember false
One app on a display of its own, beside the phone or instead of it. Changes here open it again with the same app. Needs Android 10 or later.
SecondScreen.Placementrex config set SecondScreen.Placement instead
SecondScreen.Siderex config set SecondScreen.Side left
Below this, the phone's view shrinks first; then the second screen shows alone until there is room.
SecondScreen.MinWidthrex config set SecondScreen.MinWidth 1200
SecondScreen.Sizerex config set SecondScreen.Size phone
320 to 3840 pixels
SecondScreen.CustomWidth320 to 3840 pixels
SecondScreen.CustomHeightOff, a named size lies on its side, as a PC screen does. The phone's own size always keeps the phone's shape.
SecondScreen.Portraitrex config set SecondScreen.Portrait true
Off, it takes the new size once the drag ends.
SecondScreen.ResizeWhileDraggingrex config set SecondScreen.ResizeWhileDragging true
Smaller to the left, larger to the right; all the way left is the phone's own.
SecondScreen.Dpirex config set SecondScreen.Dpi 640
SecondScreen.MaxSizerex config set SecondScreen.MaxSize 480
SecondScreen.Decorationsrex config set SecondScreen.Decorations false
Off, closing it closes the app too.
SecondScreen.KeepAppsOnCloserex config set SecondScreen.KeepAppsOnClose false
SecondScreen.Keyboardrex config set SecondScreen.Keyboard phone
SecondScreen.ReopenOnStartrex config set SecondScreen.ReopenOnStart true
Views.Arrangementrex config set Views.Arrangement side
Views.Outlinerex config set Views.Outline always
Views.Captionsrex config set Views.Captions always
Views.Splitterrex config set Views.Splitter false
A second, different phone beside the first, each in a view of its own. The side panel, keys and buttons act on the one you click. Copies wait while two phones show.
SecondPhone.Enabledrex config set SecondPhone.Enabled false
SecondPhone.WhenConnectedrex config set SecondPhone.WhenConnected always
The one shown beside comes back by itself when it connects again.
SecondPhone.Rememberrex config set SecondPhone.Remember false
SecondPhone.Siderex config set SecondPhone.Side left
SecondPhone.Soundrex config set SecondPhone.Sound active
SecondPhone.ScreenOffrex config set SecondPhone.ScreenOff off
SecondPhone.MaxSizerex config set SecondPhone.MaxSize 480
SecondPhone.BitRaterex config set SecondPhone.BitRate 4M
It stops after five seconds out of sight and starts again when the window shows.
SecondPhone.PauseWhenHiddenrex config set SecondPhone.PauseWhenHidden true
The profile chosen for that phone, put back when you go back to the main one.
SecondPhone.FollowsProfilerex config set SecondPhone.FollowsProfile true
The Apps tab, and where favourite apps show up. Each phone keeps its own list, favourites and recent apps.
The apps that came with the phone, in a group of their own. A search finds them either way.
Apps.ShowSystemrex config set Apps.ShowSystem true
Apps.ShowPackagesrex config set Apps.ShowPackages false
Apps.OpenOnrex config set Apps.OpenOn second-screen
Apps.SortByrex config set Apps.SortBy recent
Apps.Layoutrex config set Apps.Layout grid
While sorting by name.
Apps.ShowRecentrex config set Apps.ShowRecent false
Apps.RecentCountrex config set Apps.RecentCount 50
Apps.FavouritesOnControlsrex config set Apps.FavouritesOnControls false
Apps.FavouritesOnControlsMostrex config set Apps.FavouritesOnControlsMost 12
Apps.FavouritesInHudrex config set Apps.FavouritesInHud true
In the order they are in. Off, those keys go to the phone.
Apps.FavouriteKeysrex config set Apps.FavouriteKeys false
Once the mirror is up. Off, it is read once and then with Read again.
Apps.ReadOnConnectrex config set Apps.ReadOnConnect false
Closes an app before opening it, so it starts from the beginning. Shift does it for one click.
Apps.OpenFreshrex config set Apps.OpenFresh true
Apps.CloseWhenMirrorStopsrex config set Apps.CloseWhenMirrorStops true
Apps.HiddenDrop, choose or paste files to copy them into the phone's shared storage. APK files may be installed instead.
Transfer.Enabledrex config set Transfer.Enabled false
Transfer.FolderTransfer.SortMediarex config set Transfer.SortMedia true
Transfer.Foldersrex config set Transfer.Folders refuse
Transfer.InstallApksrex config set Transfer.InstallApks false
Transfer.Replacerex config set Transfer.Replace false
Transfer.AllowDowngraderex config set Transfer.AllowDowngrade true
Transfer.GrantPermissionsrex config set Transfer.GrantPermissions true
Transfer.AllowTestAppsrex config set Transfer.AllowTestApps true
Transfer.ConfirmInstallrex config set Transfer.ConfirmInstall false
Transfer.OpenAfterInstallrex config set Transfer.OpenAfterInstall true
Transfer.ConfirmDropsrex config set Transfer.ConfirmDrops true
Transfer.ConfirmOverMbrex config set Transfer.ConfirmOverMb 0
Transfer.WhenNameExistsrex config set Transfer.WhenNameExists ask
Transfer.ScanMediarex config set Transfer.ScanMedia false
Transfer.ShowFolderAfterrex config set Transfer.ShowFolderAfter true
Transfer.AtOncerex config set Transfer.AtOnce 4
Transfer.TaskbarProgressrex config set Transfer.TaskbarProgress false
Transfer.NotifyWhenHiddenrex config set Transfer.NotifyWhenHidden false
Transfer.CancelWhenPhoneLeavesrex config set Transfer.CancelWhenPhoneLeaves false
Transfer.Historyrex config set Transfer.History 100
Appears in File Explorer's Send to menu.
Transfer.SendToMenurex config set Transfer.SendToMenu true
In fullscreen the controls hide themselves. Move the pointer to where you put them and they come back. Drag them anywhere by the dotted grip on their left.
Hud.Enabledrex config set Hud.Enabled false
The same bar over the top of the mirror, out of fullscreen. Handy with the top bar hidden.
Hud.ShowInWindowrex config set Hud.ShowInWindow true
Off puts the buttons in the order the actions are listed in.
Hud.KeepOrderrex config set Hud.KeepOrder true
Hud.AutoHiderex config set Hud.AutoHide false
Hud.Positionrex config set Hud.Position bottom
Hud.ShowMessagesrex config set Hud.ShowMessages false
Hud.Scalerex config set Hud.Scale 1.75
Hud.Opacityrex config set Hud.Opacity 1
Hud.HideSecondsrex config set Hud.HideSeconds 15
Hud.ButtonsFor phones whose secure lock screen mirrors as black.
PatternGuide.Enabledrex config set PatternGuide.Enabled false
PatternGuide.AutoShowOnKeyguardrex config set PatternGuide.AutoShowOnKeyguard false
Asks Android where the dots are each time the lock screen shows. Off keeps your calibration.
PatternGuide.AutoDiscoverGeometryrex config set PatternGuide.AutoDiscoverGeometry false
PatternGuide.AskPerDevicerex config set PatternGuide.AskPerDevice false
Ctrl+Alt+C, then the arrow keys.
PatternGuide.CalibrationEnabledrex config set PatternGuide.CalibrationEnabled false
PatternGuide.ShowCursorTrailrex config set PatternGuide.ShowCursorTrail false
PatternGuide.Opacityrex config set PatternGuide.Opacity 1
Larger dots are easier to hit while dragging the pattern.
PatternGuide.DotSizerex config set PatternGuide.DotSize 1.6
App.ScreenshotDirectoryStarts recording with the next mirror, into captures\recordings in the app's folder.
Mirror.RecordOnStartrex config set Mirror.RecordOnStart true
Mirror.RecordDirectoryPNG is exactly what the phone showed; JPG is much smaller.
App.ScreenshotFormatrex config set App.ScreenshotFormat jpg
App.CopyScreenshotsrex config set App.CopyScreenshots true
App.ScreenshotFlashrex config set App.ScreenshotFlash true
In the app Windows opens pictures with.
App.OpenScreenshotsrex config set App.OpenScreenshots true
Like android-{date}-{time}. A name already taken is never overwritten.
App.CaptureNamesMP4 plays anywhere; MKV survives a recording cut short.
Mirror.RecordFormatrex config set Mirror.RecordFormat mkv
How the window looks and where it opens. Everything here applies at once.
App.AlwaysOnToprex config set App.AlwaysOnTop true
App.SidebarSiderex config set App.SidebarSide left
Its text and controls larger or smaller; the panel keeps its width.
App.PanelScalerex config set App.PanelScale 1.5
The mirror area changes at once; the edges scrcpy draws itself, at the mirror's next start.
Mirror.Backdroprex config set Mirror.Backdrop black
The soft background and the navigator's picture, over Remote Desktop or in a virtual machine, where each frame is the processor's work.
App.WithoutGraphicsCardrex config set App.WithoutGraphicsCard same
The phone's name and its buttons. Without it, Ctrl+Alt+B still shows the side panel.
App.ShowTopBarrex config set App.ShowTopBar false
Tap to show or hide each one.
App.TopBarButtonsWhat the app is doing, under the mirror.
App.ShowStatusBarrex config set App.ShowStatusBar false
App.ShowHintsrex config set App.ShowHints false
Live, from scrcpy's own counter.
App.ShowFrameRaterex config set App.ShowFrameRate true
Off opens it in the middle of the screen at its usual size.
App.RememberPlacementrex config set App.RememberPlacement false
App.FitWindowOnStartrex config set App.FitWindowOnStart true
From the tray's Quit, or closing the window when nothing stays in the tray.
App.ConfirmQuitrex config set App.ConfirmQuit true
App.RunInBackgroundrex config set App.RunInBackground false
App.OpenOnConnectrex config set App.OpenOnConnect false
Once per version, in the bar above the mirror.
App.ShowWhatsNewrex config set App.ShowWhatsNew false
From the tray, while the window is closed or minimised.
App.NotifyConnectionsrex config set App.NotifyConnections true
From the tray, while the window is closed or minimised.
App.NotifyMirrorStopsrex config set App.NotifyMirrorStops true
Asks GitHub which version is newest; nothing else is sent. Off unless you turn it on.
App.CheckForUpdatesrex config set App.CheckForUpdates true
Keys that work while the window is hidden in the tray or behind other windows. To set one, click its box and press the keys; Backspace turns it off and Esc puts back what was there.
They take the key from every other app while this one runs. Not while an app running as administrator is in front.
GlobalKeys.Enabledrex config set GlobalKeys.Enabled false
GlobalKeys.ShowHiderex config set GlobalKeys.ShowHide Ctrl+Shift+F9
GlobalKeys.WhenBehindrex config set GlobalKeys.WhenBehind hide
GlobalKeys.WhenInFrontrex config set GlobalKeys.WhenInFront nothing
GlobalKeys.HideTorex config set GlobalKeys.HideTo taskbar
GlobalKeys.ShowFullscreenrex config set GlobalKeys.ShowFullscreen true
The phone has the keyboard the moment the window comes up.
GlobalKeys.TypeIntoPhonerex config set GlobalKeys.TypeIntoPhone false
Only while the window is hidden or minimised.
GlobalKeys.Announcerex config set GlobalKeys.Announce true
Any action, on a key of its own: a screenshot, the next video, muting.
GlobalKeys.ActionsClick a box and press the keys. Backspace takes a key away; Esc keeps the one it had. Find one with the search above.
Keys.WindowKeys.BrowseWhich sections the Controls tab shows and in what order, and the tiles in its grids. Everything here applies at once.
Controls.SectionsControls.PhoneTilesControls.ViewTilesControls.GestureTilesControls.Columnsrex config set Controls.Columns 4
Off shows the icons alone; each name stays in its tooltip.
Controls.TileLabelsrex config set Controls.TileLabels false
How the app finds phones and what it writes down while it works.
USB is faster and steadier; Wi-Fi is used only when there is no cable.
Session.PreferUsbrex config set Session.PreferUsb false
Shorter finds a phone sooner; longer asks ADB less often.
Session.PollSecondsrex config set Session.PollSeconds 30
After the mirror closes by itself, before it starts again.
Session.RetrySecondsrex config set Session.RetrySeconds 60
1 to 65535; Android's own is 5555
Wireless.PortLike 192.168.1.20, or 192.168.1.20:5555
Wireless.ManualHostsWhat happened, for when something goes wrong. It never holds what you type or see.
Logging.Enabledrex config set Logging.Enabled false
Logging.MaxBytesrex config set Logging.MaxBytes 1048576
Logging.KeepFilesrex config set Logging.KeepFiles 20
For a bug report. Where the screen was touched is left out.
Logging.Verboserex config set Logging.Verbose true
App.ConfirmSensitiveWritesrex config set App.ConfirmSensitiveWrites false
Off keeps the mirror on USB only.
Wireless.Enabledrex config set Wireless.Enabled true
While the phone is plugged in, open its wireless port and remember its address, so the reconnect has somewhere to go.
Wireless.EnableTcpipWhenUsbAvailablerex config set Wireless.EnableTcpipWhenUsbAvailable true
App.AutoRepairUsbrex config set App.AutoRepairUsb false
Holds each frame a moment to even out a shaky connection, such as wireless. Off is the lowest latency.
Mirror.VideoBufferMsrex config set Mirror.VideoBufferMs 50
Off stops the mirror instead and says why.
Mirror.DownsizeOnErrorrex config set Mirror.DownsizeOnError false
How scrcpy draws the picture here. Change it only if the picture flickers or stays black; software is slowest but always works.
Mirror.RenderDriverrex config set Mirror.RenderDriver direct3d
Passed to scrcpy at launch, for options this app does not expose
Mirror.ExtraArgsThese are in config.json, but the app sets them for you where it makes sense to.
Set by dragging the fullscreen controls.
Hud.XSet by dragging the fullscreen controls.
Hud.YSet by the phone picker.
Session.PreferredSerialManaged by the app.
Version