Scrcpy: Display and control your Android devices connected over USB or TCP/IP

https://github.com/Genymobile/scrcpy

by thunderbong • 3 years ago

681 143 3 years ago

github.com

Ologn• 3 years ago

Comes in handy for me on my Macbook.

moondev2• 3 years ago

Other notable features:

* Works in tandem with upstream android adb, so after usb(or wireless) debugging is enabled on the target device, there are no apps daemons or hacks needed and it just works.

* Install apks that are "unavailable for your device" in the official google play store (on things like chromecasts)

* Full Screen or screen section + audio recording

* Stream device screen when it's physically off on target device.

* scrcpy cli runs on macOS, Windows and Linux as well as containerized

* Option to connect over USB for insane performance and resolution

nirajd• 3 years ago

Can you share more about using scrcpy to install APKs that are unavailable for the device via Play?

MishaalRahman• 3 years ago

You can just drag and drop APK files onto the scrcpy window to initiate an install (it just does 'adb install' basically).

geraldhh2• 3 years ago

it's called 'sideloading'

olejorgenb• 3 years ago

And does not require a rooted phone

hunter2_5• 3 years ago

Install apks .. on things like chromecasts

Once an apk is on a Chromecast, how does one launch it? I've loaded APKs onto a Fire Stick, but that OS actually has a launcher. For a Chromecast, would I be limited to launching via adb and apps that launch themselves by being cast to? That would still be useful, like for example SmartTubeNext is one of the apps I put on my Fire Stick (highly recommended) and in addition to launching via the GUI, it auto-launches when cast to. Would be great to move it to the Chromecast because it's the only reason I have a Fire Stick...

archon810• 3 years ago

I think we are talking strictly the Chromecast with Google TV here, which is a full Android TV stick.

netfortius• 3 years ago

How do you exclude (split tunneling config) the wireless part required for scrcpy, when using a VPN app? The IP of my wireless debugging option shows as the one handed out via the tunnel interface, not the one from my wifi network, and I can't find a way to make this an exclusion, as I make other apps, in the split tunneling option of the VPN app.

atomicnature• 3 years ago

It's an excellent piece of software, our team uses it throughout our workdays. Kudos to the devs for building and sharing with the world.

kej2• 3 years ago

I'm sure there are many more practical uses, but it's great for automating mobile games.

julianeon• 3 years ago

How does that work - what do you do in the games from your computer for example? Just curious.

cfn3• 3 years ago

Not the original commenter but I would use AutoIt or some other automation software on the computer to click around the game window.

kej2• 3 years ago

I started using Autopy [0] for writing scripts to automate games on Windows, and then discovered that scrcpy lets me do the same for Android. I've used it for solving picross puzzles and right now I'm working on a solver for the Zachtronics solitaire games.

[0] https://pypi.org/project/autopy/

quartzic• 3 years ago

Works well for streaming video from a Quest 2 to a computer.

wkat4242• 3 years ago

It has built-in Chromecast functionality too.

In case you know, is there a quality difference? I generally find the Chromecast to be very low fps, is this better?

netheril96• 3 years ago

Is there a reverse scrcpy where I see my computer screen on Android? No need for control, just mirroring screen is enough.

arcanemachiner• 3 years ago

VNC server/client?

stevenhuang• 3 years ago

Checkout rustdesk, open source vnc with Android client

Tajnymag2• 3 years ago

Deskreen

aruggirello• 3 years ago

weylus?

ASinclair• 3 years ago

Chrome Remote Desktop works

smusamashah5• 3 years ago

I have tried a number of times to connect a phone with broken/dead screen. Touch and audio works.

I have probably managed to enter pin and login but clicking 'Allow usb debugging' checkbox when I run scrcpy is apparently impossible or may be I am missing from some other critical step.

Has someone done anything like that using this tool? It seems like a perfect use case.

mightyoj• 3 years ago

Not using this tool, but actually to use this tool. My nexus device had a cracked screen like yours and I ended up running an android emulator to find where to blindly click to finally allow adb

smusamashah5• 3 years ago

This is a very clever advice. Thanks you. Have to try this out.

wastu• 3 years ago

You can use mouse with usb otg.

geraldhh2• 3 years ago

still have to hit an invisible button

alisonatwork• 3 years ago

The first thing I do whenever I get a new phone (or OS update on an old phone) is enable USB debugging, plug it into my computer, and then click trust this device. It's insurance for the time when the phone screen inevitably dies, because then I can plug it back in and immediately drive it using scrcpy. It's saved me twice so far.

nousermane• 3 years ago

With newer android versions, you might want to check the "disable adb authorization timeout" option too. Otherwise, phone will "forget" your computer's adb key after a week.

andrewaylett3• 3 years ago

It's worth learning how to use TalkBack anyway because of the insight it gives you into how accessibility tooling works, and also it's perfect for this use-case.

smusamashah5• 3 years ago

Can I turn the talk back on blindly? This phone is a pixel 2. Again, this does sound like a very good advice which I can try on emulator first. Thanks.

lazylion2• 3 years ago

if you have access to your phones files (or the phone backs up photos automatically ) you could try to use screenshots to guide you, or screenshare

smusamashah5• 3 years ago

Can you explain a bit more please. I do have some random screenshots backed up in Google photos. How does that help?

tux• 3 years ago

Very cool, is there something like this for Apple iOS phones?

ldenoue• 3 years ago

You can use QuickTime on MacOS to see your iPhone as a video. Not sure other platforms.

cfn3• 3 years ago

The difference is that you can't control the phone from QuickTime, you can only view it. That is a pity because it is easier to control the phone with a mouse when developing apps (less tiring).

AlexeyBrin• 3 years ago

Yes, it is built into iOS - swipe down from the top right corner and chose mirror screen, this will mirror your screen on a compatible device (I only tested with a MacBook).

KORraN• 3 years ago

As other comment mentions below, this does not allow controlling the device.

joshvm3• 3 years ago

Stupidly useful when I broke my phone in Antarctica and had to wait months for a replacement to arrive (it did, mere days before station close). Also a shout out to gnirehtet which is I think by the same devs? Reverse tether your phone for times when wifi and cell are both unavailable.

princevegeta893• 3 years ago

Wow you went to Antarctica? Why?

bartvk• 3 years ago

Probably science.

mnky9800n• 3 years ago

If you want to go to Antarctica for free find a PhD program they goes to Antarctica and you will get to go to Antarctica.

ly3xqhl8g9• 3 years ago

Was curious about the cost:

    Overall Antarctica Cruise Cost [1]: 

    Low Budget     $9,340
    Mid-Range     $13,010
    Luxury        $26,100

Guess the prices will only go up once climate change fully deploys the 3-degrees-warmer world [2].

[1] https://www.antarcticaguide.com/antarctica-travel-cost#:~:te...

[2] Impacts of Climate Change in Antarctica, https://discoveringantarctica.org.uk/challenges/sustainabili...

joshvm3• 3 years ago

I wintered for IceCube. Happy to answer any questions about careers. My background isn't in polar research and while I have a PhD in (unrelated) physics, it's not a requirement by any means. Lots of jobs down there just require specific skillsets (and there is plenty of IT work).

https://icecube.wisc.edu/

carstenhag2• 3 years ago

Many years ago, my Samsung S3's wifi chip broke. I had to resort to mobile data for everything. Luckily I was able to use gnirehtet to download apps/updates for some time until I was able to buy a new phone :)

rejap• 3 years ago

Very practical for phones without display port alt mode (notably pixels). Works with rpi.

SeriousM• 3 years ago

A tool called "Vysor" does that very well. Need to compare.

cfn3• 3 years ago

I bought Vysor when it was the only option but since moved to Scrcpy because it is simpler to use and had better stability. I remember that Vysor had more features but also had some issues with activating the license on some computers.

EDIT: I forgot to say both did the same thing: mirror the device on the PC.

eddieroger2• 3 years ago

Used to use Vysor, switched to scrcpy. First, this is free, so that's a big up in its win column. I had trouble with stability in Visor that I never had with scrcpy. Plus, it's open source. There's no comparison to me.

princevegeta893• 3 years ago

This tool is a godsend. I use it as a way to control my phone when I'm at my desk on my mac - with wireless adb, without even looking at the phone screen at all.

Allows me to continue using my phone as I use my mac with a kb and mouse.

dcreater• 3 years ago

So scrcpy over wifi??

princevegeta893• 3 years ago

Yup

nprateem4• 3 years ago

If anyone's looking for an android project, please make one that forwards all hotspot traffic over whatever VPN is enabled. I guess the phone will need rooting.

wingmanjd2• 3 years ago

I think my Wireguard VPN already does this, sans root? I enable my VPN and my hotspot connected laptop is now routing its traffic via my house.

Or am I missing what you're looking for?

RedComet• 3 years ago

Are you running lineage or some other custom build? Stock android doesn’t do this afaik.

nprateem4• 3 years ago

Are you sure? By default if you use a VPN, only apps on the device will use it. If you enable a wifi hotspot, any devices connected to the hotspot won't route their traffic over the VPN. Have you tried checking your IP from your laptop?

ttarr• 3 years ago

Why the down votes for this comment?

My Android does have that option, under: Hotspot and tethering > Allow clients to use VPNs.

Note however, my ROM is based on LineageOS, probably the reason why not everyone got it?

ChiptuneIsCool• 3 years ago

Try this https://github.com/pyamsoft/tetherfi It will route all hotspot traffic through your phone and vpn. Works even without root

nprateem4• 3 years ago

That seems cool, but I'm looking for something that would be totally transparent to connected devices (i.e. wouldn't require reconfiguring them at all).

jeroenhd• 3 years ago

For what it's worth: LineageOS (and probably other ROMs too) has a setting ("Allow clients to use VPNs") for this in the tethering settings screen. With root and four or five lines of bash script you can replicate this behaviour according to various StackExchange answers.

I'm not sure if this is a setting that comes from LineageOS or from upstream AOSP, but at least the feature is there as a starting point.

Edit: looks like it's a LineageOS feature: https://review.lineageos.org/c/LineageOS/android_frameworks_...

nprateem4• 3 years ago

Thanks for these comments re LineageOS (& @ttarr). I dug out an old device I'd already installed it on and sure enough it works. Thanks so much :)

donato2• 3 years ago

I used to use this with my Xiaomi phone connected over TCP/IP, but after a while the phone automatically disables wireless debugging so I have to enable it again on the phone directly, which is quite annoying

apienx• 3 years ago

My 7 year-old phone has had a completely smashed screen for the past year. Thanks to this (super-easy-to-run script), I haven't felt the need to repair the screen at all.

10/10 would recommend.

Kelamir• 3 years ago

That's a surprisingly great idea. A mobile phone can be used as a server, and for their capabilities, they are cheaper than Raspberry Pi when with some issues especially. Out of curiosity I just found an offer for a used Pixel 6 Pro for 70 EUR, supposedly only broken screen and the rest is working, where it has 12GB RAM with CPU Octa-core (copypasting: 2x2.80 GHz Cortex-X1 & 2x2.25 GHz Cortex-A76 & 4x1.80 GHz Cortex-A55), that's a fairly good offer.

throwaway20562• 3 years ago

how can you enable ADB/dev settings on the phone with a smashed screen?

throwaway20562• 3 years ago

Do I assume you already have adb/dev settings enabled?

kramerger2• 3 years ago

For the use cases mentioned in the comments here, I don't think you really need a third party tool like this.

Connect your phone to a USB-C display and viola! Screen is mirrored and network, mouse and keyboard connected to the display are now connected to the phone.

There is also the Microsoft phone app for win10/11, and Samsung Dex.

tjoff• 3 years ago

That is not the same though. I use this as a daily driver and I don't need to dedicate a display or keyboard for it, just use the ones I use for everything else and have the phone just as a normal window on my desktop.

Also lots of phones are unable to output video at all. Such as all Google pixel/nexus devices ever made (unless I missed one).

carstenhag2• 3 years ago

Pretty sure the market share of usb-c Displays is still very low. Also, most people (source needed) use laptops nowadays.

kramerger2• 3 years ago

I believe people using laptops at home are the ones with USB-C monitors :)

slig• 3 years ago

Most USB-C to anything/everything dongles used by MacBook users have an HDMI output.

andrewaylett3• 3 years ago

That does depend on the hardware though -- I don't think any of the phones in my household support USB C DP or HDMI alt modes, and none of the displays are DisplayLink, so while they might manage to transfer power and possibly even connect peripherals there's no common ground for transferring video.

liendolucas• 3 years ago

This is one of those tools that you really want to know about just in case of disaster. Very nice indeed! I unfamiliar with mobile apps, that been said now dumb question: are there nice tools out there that you would recommend to do full backups from a mobile phone to alinux box with the command line? I was thinking about rsync but I don't know if possible, or any limitations at all.

qwertox• 3 years ago

Thank you! Now I can finally play back the podcasts while hearing them on the PC.

owaislone• 3 years ago

Incredibly useful for live demos in meetings when working on mobile apps/web.

mamborambo• 3 years ago

Last year my Samsung S20+ suffered the notorious "green vertical lines" and then soon after the "white out screens" (a pandemic-level hardware failure wave that has been widely reported), rendering it impossible to see clearly what is on the screen, even though everything else was still working.

Luckily because I was playing with scrcpy, I immediately knew it was my solution.

By using scrcpy to connect to a PC, I could still unlock the screen with my pattern or thumbprint, and when the app asks for passwords it is still possible to use the onscreen keyboard.

askvictor• 3 years ago

Are there any tools along this line, but act more like an external monitor does when plugged into your laptop (in external-monitor-only mode)? I.e. can run at a different resolution/size, rather than just mirroring the phone screen? Something like what Android Auto does when you plug into a head unit, but for 'normal' android.

manucardoen• 3 years ago

Samsung Dex does this but it only works on some devices.

rodoxcasta• 3 years ago

I do that with two tablets and a laptop. On the notebook I run some vnc server with an X built-in, then some x or vnc tool that links the different X instances running as if they are other monitors, so you only have to move your mouse to some lateral to get focus on the other X. Then on the tablets just use some generic VNC client.

There are multiple options for ever one of the three programs os this setup, but it takes some work to make all run well together. I can check the exact binaries that I'm using or send the scripts, if there's someone interested.

Edit: to make it work well enough with wifi, I had to make some tricks to deal with the tablet's wifi powersave behavior. On usb it works perfectly though.

keyP• 3 years ago

Big fan of this tool, I use it any time I'm doing presentations or writing a document that requires a recording of my Android's screen.

auselen• 3 years ago

Any explanation on how does it work? Is it via Android’s virtual display feature?

syntaxing• 3 years ago

Whoa this is awesome, I have a “throw away” tablet that loads all my bloatware apps that’s unfortunately necessary for a lot of home automation and messaging stuff. I just install the app and either use a home assistant or matrix plugin. I can now store my tablet in the server room instead and access it remotely!

phreack• 3 years ago

Just chiming in to say I've been using this for what feels like years and it's never failed me. Controlling a phone on a second monitor just because it's convenient, sharing a phone during meetings to showcase stuff, automating a couple apps, you can do it all!

chx• 3 years ago

This is incredible software with a small caveat: some apps can't be mirrored -- the ones which show blank on the task switcher view. This is more of an OS limitation than scrcpy's fault.

VWWHFSfQ• 3 years ago

This is most likely just because the app has the secure display flag set, not any OS limitation. It's a feature of android

hunter2_5• 3 years ago

I know almost nothing about Android app development and especially disassembly (if that's even the correct term): Is it possible to modify an apk to eliminate this flag anywhere it's set?

I assume in the case of apps trying to protect copyrighted content, the answer is likely "yes but the app might check its own signature and exit if it's not valid, which it won't be at that point, so you'd also need to rip that out, which makes the job way harder."

whalesalad• 3 years ago

can we stop naming things worse than strptime and strftime

eddieroger2• 3 years ago

You should not look in to their other project then, gnitehtet[1]. It's a reverse tethering app named "tethering" in reverse. These two apps have saved my butt more times than I can count, so they can all it whatever they want for all I care.

1. https://github.com/Genymobile/gnirehtet

mahathu4• 3 years ago

I recently tried this with my old Huawei phone which had a broken screen but also a bunch of photos I would've wanted to save locally. It wouldn't even show up on `adb devices` let alone the programs that relied on adb IIUC. I even tried tapping the sequence for my code on the broken screen, as well as trying to turn on voice control to manually unlock the phone, but that didn't work either. I would be happy to give it another try though.

magneticmonkey• 3 years ago

I wonder if I can use this while debugging an android app. It would be nice to have a real device on my desktop screens while coding.

mathijs• 3 years ago

Android Studio offers this out of the box since the beginning of this year, I believe

m4lvin2• 3 years ago

This also solves remote-support problems for me! Afaik there is no VNC Server / TeamViewer / AnyDesk / etc (server!) for Android, but telling someone to plug their phone into some computer I can control is easy enough :-)

masfuerte• 3 years ago

This is a brilliant idea. I will set it up on my Mother's PC.

stavros• 3 years ago

I'm fairly sure there's a VNC server for rooted Android phones, am I mistaken?

Looks like this one will work without root: https://play.google.com/store/apps/details?id=net.christianb...

m4lvin2• 3 years ago

Cool, thank you!

student2k• 3 years ago

Can you control various android phones from one PC with it? Can't find it in th documentation.

sacredSatan• 3 years ago

I really like the doc for developers.

https://github.com/Genymobile/scrcpy/blob/master/doc/develop...

thecosmicfrog• 3 years ago

I always pronounce this project as "soccer copy".

grokx• 3 years ago

As a Genymobile employee, I'm happy to see this on HN! We use scrcpy internally also, it's really handy sometimes when we need to debug display issues with our Android emulator (Genymotion).

Romain is truly a talented developer, and deserves the success of scrcpy. If I remember correctly, scrcpy was also bundled with Genydeploy (an Android device provisioning solution) at the time.

Kudos Romain for your work!

rom1v4• 3 years ago

Thank you for your kind words Guillaume :)

samstave2• 3 years ago

hmm

https://i.imgur.com/JgcKvUa.png

Cant find ADB device...

rom1v4• 3 years ago

https://github.com/Genymobile/scrcpy/blob/master/FAQ.md#devi...

_odey• 3 years ago

You can also use this tool to take a screenshot of an app that normally does not allow you to.

Useful if the app has QR Codes that you want to have on hand even if there is no internet connection (like Tesco Clubcard)

EnigmaCurry• 3 years ago

Lots of apps will still show a black screen via scrcpy:

* The lock screen of the device

* AndOTP

* Bromite Incognito mode.

I think its called a "security screen" which prevents this, or something like that.

coolspot2• 3 years ago

Which you can remove by modifying APK file. I did it for RSA token and MS Authenticator and use them via scrcpy.

kevincox• 3 years ago

I've used this to play mobile games more comfortably at a computer. Combining this with a pen-tablet is a great experience for games that don't need multi-touxh, and you can sit up straight rather than hunched over a phone.

There were some minor compression artifacts at times but the quality was quite good and the latency was great.

rom1v4• 3 years ago

To minimize artifacts, you can increase the bitrate (`scrcpy -b12M`) or use h265 (`scrcpy --video-codec=h265 -b12M`). Depending on your device, the latency with h265 may be higher though (but it might also be lower).

denysvitali• 3 years ago

Super useful for my broken Pixel 6 Pro which has a broken screen (and replacement parts are still out of stock).

It does also support touch gestures, which makes it basically a software replacement for my screen since I can use my Thinkpad to touch-control the device over adb.

Kudos to Genymobile!

jesug34• 3 years ago

Como funciona

zikohh• 3 years ago

I love this project but it also makes me feel uneasy since no indicator is shown on the device when connected. If someone forgets their phone unlocked, connecting it to your pc and using ADB over WiFi can give you full control and the victim will never know.

IYasha2• 3 years ago

A life savior program for literally broken devices. I wish I knew earlier!

cosmojg• 3 years ago

I used this to recover data from a phone with a shattered screen and, later, turn it into a full-fledged remote server.

It is undeniably one of the most beautifully designed tools I've ever used. Major props to the developers.

alimbada• 3 years ago

Very useful little utility. I've used it to install SmartTube on my Chromecast with Google TV and previously to tinker with a Beelink box running Android.

Scrcpy: Display and control your Android devices connected over USB or TCP/IP

Related Stories