LogoFerret

Privacy#

Ferret is built so your stuff never leaves your devices. That is the whole point.

πŸ”’ What Ferret does#

  • Your devices talk directly to each other on your network. Nothing goes through a server.
  • Every connection is end-to-end encrypted with the Noise protocol (Noise_XX_25519_ChaChaPoly_SHA256).
  • A device can only connect after you paired it, by comparing six digits or scanning a code. Strangers on the same Wi-Fi can't read or send anything.
  • Devices you paired tell each other about your other devices, so you pair once. Only a device you already paired can add one, and you can turn this off under Settings β†’ Advanced.
  • To find each other, your devices announce their name and kind on your Wi-Fi. Nothing else, and never outside your network.
  • Each device has its own key, kept in the system keychain on phones and in a file only you can read on computers.

πŸ™… What Ferret never does#

  • No account. No sign-in. No email.
  • No cloud, no relay, no "fallback over the internet". If you run your own VPN (Tailscale, ZeroTier, WireGuard), Ferret can use it, but only for a device you turned that on for. See Reach your devices away from home.
  • No analytics, no crash reporting service, no ads, no tracking of any kind.
  • It never logs what you copy, the files you send, your messages or your notifications.

πŸ›‚ You stay in control#

  • Pause Ferret any time, for an hour or until you resume.
  • Unpair a device in one click; both sides forget each other.
  • Every feature is a switch in Settings, and sensitive ones (notifications, messages, calls) stay off until you turn them on.
  • Ferret asks for each system permission when you turn on the feature that needs it, after a line that says why. Never at first launch.

πŸ‘€ What each device can use#

Open a device and tap What Pixel 7 can use. You see every feature that device can reach on this one, with a switch each:

FeatureWhat it carries
ClipboardWhat you copy, both ways
FilesFiles and links you send, both ways
NotificationsA phone's notifications, and your replies
MessagesA phone's texts and contacts' names, and texts you send from a computer
CallsWho is calling, recent calls, answering and placing calls
ContinueThe page or thing you were on
MediaWhat's playing, and play, pause and skip
Screen Showing a phone's screen, each time only after it says yes, its sound when you turn on Send sound too there, and clicks and typing on it after it says yes to control
ControlMoving the pointer and typing, only after you allow it
FindRinging a device to find it
Computer actions Which action to run (sleep, restart, shut down, volume, or one of yours by name), and whether it worked. Never a command line, never what it printed
Wake-on-LAN A computer's network card (MAC) addresses, and asking a computer to wake another
Scripts A short notice a script on a computer sends with ferret-cli notify , shown only after you allowed that computer. See Scripting

Turn one off and it stops RIGHT AWAY, on both devices: Ferret reconnects, the other device no longer sees the feature, and anything it still sends for it is refused. Turn everything off does all of them in one tap and keeps the device paired. To stop it connecting at all, forget it.

πŸ™ˆ On a computer you share#

Notifications, texts, callers and copied text from a phone hide while the screen is locked or another account is in front. Show previews on this computer, at the bottom of What Pixel 7 can use, covers them all the time; it starts off on a computer where other accounts run Ferret. See A computer the family shares.

πŸ”‘ Passwords and codes#

  • Passwords you copy stay here. Password managers mark them as private (org.nspasteboard.ConcealedType on a Mac, "sensitive" on Android 13 and later, the KeePassXC and KDE hints on Linux), and Ferret skips them unless you turn on Include passwords. See Clipboard.
  • One-time codes in your phone's notifications stay on the phone. Your computer shows Code hidden. See Notifications.

🟒 You see it while it happens#

  • While another device sees your screen, your phone shows Android's own recording icon and Ferret's "Sharing screen with…" notification with Stop.
  • With Send sound too on, that notification says "Sharing screen and sound with…". Only what the phone plays is sent, never its microphone.
  • While a computer controls your phone over Wi-Fi, the phone says "Being controlled by…" with Stop control, on Home and in a notice you can't swipe away. It only starts after you tap Once or Always, and ends with the picture.
  • Ferret control, the accessibility service that carries those clicks, is off until you turn it on. It hears nothing about your screen until control starts. To type, it reads the one text field you type into, and keeps nothing.
  • While a phone controls your computer, Ferret shows "Pixel 7 is controlling this computer" until it stops.
  • On a Mac, the menubar icon keeps a dot for as long as either lasts, and its tooltip says who.

πŸ“‘ What leaves this device#

Checked against the code, line by line:

WhatWhere it goesWhen
Your device's name and kind Your Wi-Fi only (mDNS and a broadcast), so your devices find each other While Ferret runs and isn't paused
What your features carry (table above) Only to devices you paired, end-to-end encrypted When you use the feature
Whether someone is at this device, and its battery level and charging Only to devices you paired, end-to-end encrypted When it changes: the battery in 5% steps, each percent below 20%
A computer's network card (MAC) addresses and network, so your devices can wake it Only to devices you paired, end-to-end encrypted. Turn it off with Let my devices wake this computer When a device connects, and when the cards change
This device's VPN addresses (Tailscale, ZeroTier, WireGuard), so your devices can reach it away from home Only to paired devices that have Also reach … over your VPN on for this device, end-to-end encrypted When that device connects, and when it turns the switch on
A Wake-on-LAN magic packet (only the MAC address, repeated) Your network, as a broadcast and to the computer's last address Only when you tap Wake, or a phone of yours asks this computer to
Files and links Phones you share with through Quick Share or LocalSend, on your Wi-Fi Only when you turn that on in Drop
A download of Android's platform tools dl.google.com Only when you click Download , for mirroring with a cable

That's the whole list. Links you tap (like the Shizuku download page) open in your browser, not in Ferret. No update checks, no crash reports, no fonts or images from the internet.

πŸ—‚οΈ Where Ferret keeps its data#

On a computer, everything Ferret saves sits in one folder: ~/.sofluffy/ferret (%USERPROFILE%\.sofluffy\ferret on Windows).

FolderWhat's in it
settingsYour settings
secrets This device's key and your paired devices, readable only by you
featuresWhat features save, such as your saved texts
toolsAndroid's platform tools, if you downloaded them
cacheThings Ferret can rebuild
cli The ferret-cli command line's own key, pairings and settings
hooks Your own hook scripts , if you add any. Ferret never writes here
app_control.json While the app runs: the loopback port and one-time secret ferret-cli uses, readable only by you

On phones, Ferret keeps its data in its own app storage, and its key in the system keychain.

⏳ How long Ferret keeps things#

WhatKept
Clipboard history In memory only, the last 20. Gone when Ferret quits. Passwords you chose to sync: 2 minutes
Notifications from a phone In memory only. Clear all empties the list
A phone's texts, on a computer Saved in features/messages so they show offline. Forget saved texts in Settings deletes them, and unpairing the phone does too
What you continued between devices The last 50, never older than 30 days. Clear in Settings β†’ Continue & media
Times a phone controlled this computer The last few, with Clear history in Settings β†’ Control
Actions devices ran on this computer The last 20: which action, which device, when. Not what it printed. Clear history in Settings β†’ Control

Ferret writes no log file. Release builds print only short status lines to the system log (Console on a Mac, logcat on Android), never what you copy, send, read or type.

🧹 Removing Ferret#

  1. Unpair this computer on your other devices.
  2. Quit Ferret and delete the app.
  3. Delete ~/.sofluffy/ferret. That's it, nothing is left behind.

On a phone, uninstalling the app removes everything.

πŸ”“ Check it yourself#

Ferret is open source. The apps are GPL-3.0 and the protocol is MIT, documented in the protocol reference.