Screen#
TL;DR
- On your computer, click Show screen on your phone in Ferret.
- On the phone, choose to share the entire screen, then Start.
- Done? Click Stop. That's it.
Your phone is charging across the desk. A message comes in, or you want to show an app in a call. Picking the phone up every time gets old.
With Ferret, the phone's screen shows up on your computer. Over your own Wi-Fi, nothing else.
π One button#
Show screen is on every phone and tablet in Ferret, connected or not. It is all you need to know.
Ferret picks the way by itself:
- Ferret on the phone, over your Wi-Fi. The phone asks you every time. You can look, and click and type once the phone says yes. See Control over Wi-Fi below.
- A cable, when Ferret can't reach the phone. You can look, click and type. See Show a phone with a cable.
- An iPhone or iPad gets three steps to do on the iPhone. See Show an iPhone's screen.
The name on top of the page says which one you got: Wi-Fi, Cable or AirPlay.
In Ferret's window, Screen is also one of the phone's sections in the device list. It starts with the same button.
A no is a no. If someone taps Cancel on the phone, Ferret NEVER goes around it with the cable.
Phone not connected? The page says so, waits, and starts by itself the moment the phone shows up.
πͺ A window in the phone's shape#
A phone is tall. A window is wide. Put one in the other and you get a small picture with a lot of nothing around it.
So on a Mac the phone gets its OWN window. Click Show screen anywhere, the menubar popover included, and it opens.
- It has the phone's shape. Drag any edge or corner: the shape holds, so there are never bars around the picture.
- A slim bar on top holds the phone's name and its controls, next to the window's own buttons. The picture sits whole under it. Drag the bar to move the window.
- Turn the phone and the window turns with it.
- Each phone gets its size and place back next time.
- The title says whose screen it is: "Pixel β Screen".
Three sizes on the usual keys:
| Keys | Size |
|---|---|
β0 | Actual size: one phone pixel per screen pixel, bar not counted |
β+ | Larger |
ββ | Smaller |
Meanwhile the phone's Screen section in Ferret's window says where things stand: "Showing Pixel's screen", since when and which way, with Bring to front and Stop.
Closing the window stops sharing. That is the only way to be sure nothing shares behind your back.
On Windows and Linux the picture lives in the Screen section itself, or in a page on a small window.
β³ While the phone asks#
The page tells you what to tap, and how long the question stays:
- "On Pixel, choose to share the entire screen, then Start."
- A clock counts down the minute you have.
- Nothing on the phone after a few seconds? Open the notice from Ferret there.
Android asks every time. Ferret can't skip it, and wouldn't.
π§° The toolbar#
One small toolbar, and it NEVER covers the phone's screen.
- In the phone's own window it sits in the bar on top: Back, Home, Recents, β’β’β’ and Stop. The rest waits behind β’β’β’. Stop moving the pointer and the buttons go quiet. Move, and they are back. Their room stays, so the picture never jumps.
- Everywhere else it sits under the picture, or beside it with words when that leaves the picture bigger. Short on room? The picture gets smaller, never covered.
| Button | Does | Keys |
|---|---|---|
| Back | The phone's Back | right-click, β[, Esc |
| Home | Home | middle-click, β1 |
| Recents | Recent apps | β2 |
| Rotate | Turns the phone's picture | βR |
| Screenshot | Saves the picture as it is right now | β§βS |
| Keyboard | A field for accents, emoji, another language | βK |
| The three bars | How the picture is doing, and its presets | |
| β’β’β’ | Sound, Keep toolbar visible, Notifications panel, Volume, Power | |
| Stop | Ends it on both devices |
On Windows and Linux the keys use Ctrl.
The phone's own buttons only show when you can press them. Over Wi-Fi you first get one chip: Control. Click it and the phone asks. Phone without Ferret control set up? The chip says View only, and a click on it says how to turn it on. Phone already plugged in? It offers Control with the cable too.
Too narrow for all of it? The toolbar folds what you use least behind β’β’β’.
Want the window's buttons to stay lit? β’β’β’ β Keep toolbar visible.
πΈ Screenshot#
Click the camera, or press β§βS. Ferret saves the phone's screen as a PNG in Downloads βΊ Ferret, at the phone's full size, whatever size the window has.
A line above the picture says "Saved to Downloads βΊ Ferret", with Show in Finder (Show in folder on Windows and Linux). Easy, right?
It works over Wi-Fi too. You can't click a phone that is View only, but you can keep what you see.
π Sound#
A video on the phone, and the sound stays in your pocket. Not anymore.
Over Wi-Fi, the phone decides. On the phone, open Ferret, then Settings β To your computer, and turn on Send sound too. Android asks for its "record audio" permission once. It files it under Microphone, but Ferret only captures what the phone PLAYS: music, videos, games. Never the microphone.
From then on, the phone's question says so, and so does its notice: "Sharing screen and sound with MacBook". Sound goes only while the screen is shown.
Over a cable, it just works on Android 11 and later.
On the computer, open β’β’β’ β Sound:
- On this computer: the phone's sound plays here, with a volume slider.
- On Pixel: it stays on the phone.
Over Wi-Fi the phone keeps playing too. Turn its volume down to hear it only on your computer. Easy, right?
Ferret keeps sound and picture together. A late bit of sound is dropped, never played behind the picture.
π±οΈ The mouse is a finger#
This is for a phone on a cable, or one that let you control it over Wi-Fi:
- Click is a touch. Drag is a swipe. Click and hold is a long press.
- Right-click is Back. Middle-click is Home.
- The wheel scrolls. So do two fingers on a trackpad.
- Typing types. Letters go as text, so your keyboard layout holds.
-
βVpastes your computer's clipboard on the phone.βC,βX,βAandβZdo on the phone what they do here. - Accents and emoji go through the phone's clipboard. You don't have to think about it.
πΉοΈ Control over Wi-Fi#
No cable on the desk? Click and type on your phone over Wi-Fi anyway.
- Show the phone's screen, then click Control in the toolbar.
- The phone asks: Let MacBook Air control Pixel 7? Tap Once, Always or No.
- That's it. Back, Home and Recents show up, and the mouse is a finger.
Your phone needs a way to take the clicks. Ferret picks it by itself:
- Power-ups (Shizuku or root) when you turned them on. See Shizuku and Root.
- Otherwise Ferret control, an accessibility service. It is OFF until you turn it on: on the phone, open Ferret, then Settings β To your computer β Turn on Ferret controlβ¦. Ferret says what it does, then opens Android's Accessibility settings. Tap Ferret control and turn it on.
While it lasts, the phone says Being controlled by MacBook Air with Stop control, on Home and in a notice you can't swipe away. Stop sharing screen next to it ends the picture too. Control ends with the picture, always.
Always skips the question next time for that computer. Changed your mind? Ask every time in the same settings.
A few things work differently with Ferret control than with a cable or power-ups:
- A drag lands on the phone once you let go of the mouse button. Taps, long presses and the wheel feel the same.
- Typing goes into the text field that has the cursor. Arrow up and down, and keys outside a text field, do nothing.
-
βC,βX,βVandβAwork in text fields.βZdoesn't.
An iPhone can't be controlled from a computer. iOS doesn't let any app do that, so Ferret can't either.
πΆ Good, Slow, Poor#
No row of numbers under the picture. Three bars, one word.
Click the bars for three presets:
- Auto: Ferret adapts.
- Sharp: full size.
- Fast: smaller, smooth.
Over a cable a change restarts the picture at once. Over Wi-Fi the phone would have to ask you again, so it applies next time.
The numbers are still there, at the bottom of that panel, for when you want them.
π When the connection drops#
Wi-Fi hiccups. Ferret keeps the last picture, dims it and says "Reconnecting to Pixelβ¦".
Back within 20 seconds? The picture goes on, with NO new prompt. It is the same sharing you said yes to.
Longer than that, the phone stops sharing for real. The page says "Lost Pixel" and waits. When the phone is back, Ferret asks it again, once.
Pulled the cable? Plug it back in and the picture picks up by itself.
π Stopping#
Stop ends it on both devices. So does closing the phone's window, and leaving the page where there is no window: Back asks "Stop showing Pixel?" first.
Nothing shares from a window or a page that is closed.
While a screen is shown, Activity has a pinned line, "Showing Pixel's screen", with Stop. Click it to bring the picture back to the front.
Asked for a second phone while one is on screen? Ferret asks before it swaps them. Never silently.
Rotate the phone and the picture follows. Screen off? The picture dims and says so, with Wake when the phone is on a cable.
Want it the other way round, your phone driving the computer? That is Control.
π You stay in charge#
Nobody sees your screen without you knowing.
- Every time, Android asks you with its own prompt. Ferret never remembers a yes. There is no "Always".
- While it happens, a notice you can't swipe away says "Sharing screen with MacBook" with Stop. The home card says it too, and Android shows its own icon in the status bar.
- Over a cable it is different. A phone that allowed your computer for debugging doesn't ask each time, and shows no notice. Ferret says so the first time, right above the picture. Only do this with your own phone.
- Afterwards, both devices keep a line such as "MacBook saw this phone's screen for 12 min at 21:10". The last 20 are under Screen: in Settings β To your computer on the phone, in Settings β From your phone on the computer.
- Don't want it at all? On the phone, turn off Let my computers ask to see this screen in Settings β To your computer.
- Only one computer you'd rather keep out? On the phone, open that computer in Ferret and turn off Ask to see this phone's screen. It can't even ask anymore.
Phone in your pocket when the computer asks? Ferret posts a notice: "MacBook wants to see this screen". Tap it to get the prompt. The question stays for a minute.
Said no? The same computer can ask again after 30 seconds, not before.
Only devices you paired can even ask. One computer at a time.
π©Ί When it doesn't start#
The page always says why, with the button that fits:
| It says | What to do |
|---|---|
| Pixel said no | Someone tapped Cancel on the prompt. Ask again lights up after half a minute, with a countdown |
| Nobody answered on Pixel | Wake the phone, then Ask again |
| Pixel isn't connected | Open Ferret on the phone, or plug it in. It starts by itself |
| Pixel couldn't show the question | Open Ferret on the phone, or allow its notifications |
| Screen sharing is off on Pixel | On Pixel: open Ferret's settings, then Screen, and turn it on |
| Stopped on Pixel | Someone tapped Stop there. Show again |
| Pixel stopped sharing | Android ends sharing when the phone locks (Android 15 and later) or when you stop it from the status bar. Unlock it, then Show again |
| Lost Pixel | The page waits and picks up when the phone is back |
Try again only shows after a real failure.
ποΈ How the picture travels#
The phone encodes its screen as H.264 video with its hardware encoder: up to 1080p, up to 60 frames per second, 2 to 8 Mbps. Ferret picks the bitrate from how the connection is doing, and drops frames instead of falling behind.
It travels inside the same encrypted connection as everything else in Ferret. No server, no cloud.
A Mac decodes it with its own hardware decoder. Windows and Linux get a JPEG picture about 10 times per second for now: slower, but it works everywhere with nothing to install.
π§ Limits per platform#
| Phone | Shares its screen |
|---|---|
| Android 7 and later | Yes |
| iPhone and iPad | No. iOS only lets an app record itself |
| Computer | Shows the phone | Picture | Its own window |
|---|---|---|---|
| macOS | Yes | H.264, up to 60 fps | Yes |
| Windows | Yes | JPEG, about 10 fps | Not yet: in Ferret's window |
| Linux | Yes | JPEG, about 10 fps | Not yet: in Ferret's window |
- Sound needs Android 10 or later over Wi-Fi, Android 11 or later over a cable. Some apps (a few video and call apps) don't let their sound be captured: they stay silent on the computer.
- Protected screens stay black. Banking apps, password fields and DRM video can tell Android to hide them from any capture. Ferret can't see them, and shouldn't.
- One app only: on Android 14 and later the prompt lets you share a single app instead of the whole screen. Ferret shows whatever you pick.
- One phone at a time. A second phone takes the first one's place, after asking.
- No full screen for the phone's window yet. The green button makes it as big as the screen allows.