sill README

The project's README from github.com/Saffsanity/sill. As one markdown file: README.md.

Sill

Any window from your Mac, on your iPhone and iPad.

Sill shows a window from your Mac, or the whole desktop, on your iPhone or iPad. You use it there with touch, a trackpad, a keyboard or Apple Pencil. Sill for Mac captures the window, encodes it as HEVC video and sends it to the Sill app on your device. Your taps, clicks, scrolls and keys go back to your Mac. Your Mac and your device connect on the same network, over a USB cable, with Direct Wireless Connection when they share no network, or through your own VPN, such as Tailscale, with Remote Access. There is no account and no server in between.

getsill.app · Download for Mac · Support · Privacy · Terms

CI

Download on the App Store

Sill for Mac is a free, notarized download from getsill.app. Sill for iPhone and iPad is free on the App Store, and you can also build it from source (below).

Screenshots

These are the iPad screenshots from the App Store; on iPhone and iPhone Duo, Sill has layouts of its own.

Requirements

How it works

Good to know: Sill shows one window, or the whole desktop, at a time, and it does not play sound from your Mac. Only the iPhones and iPads you paired can connect, unless you turn off Require pairing in Settings › Devices; then any device on your network can, still encrypted. Pairing at home came with Sill for Mac 0.4.0 and Sill for iPhone and iPad 0.5 (2), and each needs the other: the iPhone and iPad app shows an older Sill for Mac as "Update Sill", and an older iPhone and iPad app can't connect to Sill for Mac 0.4.0 or later at home. Since 0.5.1 the two apps share one version number for each release. With Sill for Mac 0.3.1 or earlier, connections on your local network, over the cable and over Direct Wireless Connection are not encrypted, and anything that reaches your Mac there can connect without pairing: update it.

Tips

Sill is free, with no ads, no tracking and no subscription. If it is useful to you, a tip through GitHub Sponsors helps pay for the developer account. A tip unlocks nothing: every feature is free.

Building from source

You need a Mac with Xcode (Sill is built with Xcode 27; the iPhone and iPad app needs Xcode 27.1 or later, for the iPhone Duo's hinge and fold), selected as the active developer directory, with its license accepted.

Sill for Mac, from the repository's folder:

Scripts/make-app.sh --install --open

This builds Sill.app with SwiftPM, signs it with your Apple Development identity, replaces /Applications/Sill.app and opens it. If that was the Sill for Mac you downloaded, grant Screen Recording and Accessibility again and pair each device again: the download keeps its key and paired devices in the data-protection keychain, which only a Developer ID build with the project's provisioning profile reads, and a build of your own keeps them in your login keychain. Without --install it only builds .build/Sill.app. With no Apple Development identity it signs ad hoc, and then Screen Recording and Accessibility have to be granted again after every build.

For work on the host itself, swift run -c release SillHost runs the same host on the command line, with one difference: unless you add --pairing, its home door is plain and open, with no pairing and no encryption, and any device on your network can connect to it, so run it only while developing. The App Store's Sill for iPhone and iPad never dials such a door ("Update Sill"); a Debug build from this repository can (docs/DEVELOPMENT.md, Pairing at home). With --synthetic it streams a test pattern with no Screen Recording needed.

The iPhone and iPad app:

  1. Open iOSClient/Sill.xcodeproj.
  2. In the Sill target's Signing & Capabilities, pick your team, and change the bundle identifier me.saffer.sill to one of your own.
  3. Run it on an iPhone or iPad on the same network as your Mac, and tap your Mac. The first time, a Sill for Mac built from this repository asks you to pair: scan the code it shows, or connect the device with a USB cable.

docs/DEVELOPMENT.md has the rest: every command-line flag, the test tools and the simulator harness, permissions and how to reset them, Remote Access, troubleshooting and releases.

Contributing

Issues are welcome: bug reports, questions and ideas. For a pull request, keep to the conventions and decisions in CLAUDE.md: Swift and Apple frameworks only, no third-party dependencies, nothing that needs a server, and latency before picture quality. Open an issue before starting anything large. Before a pull request, Tests/checks/run-all.sh runs the same pure checks as CI, in about five minutes and with no device. Contributions are accepted under the project's license. Please report a security problem privately, as SECURITY.md says, not in a public issue.

License

Sill is licensed under the Apache License 2.0. Copyright 2026 Noah Saffer.

sill (Saffsanity/sill)

Searching Database…

2.8K ·GitHub
What is this?Sill streams a window from your Mac, or your whole desktop, live to your iPhone or iPad, so you can touch, type and draw on it as if it were local.
Is this an app or a service I sign into?It is two native apps (Mac and iOS/iPadOS) that talk directly to each other peer-to-peer; there is no account and no server in between.
How do I get it running?Download Sill for Mac from getsill.app, install the free Sill app on your iPhone or iPad from the App Store, then pair the device by scanning the code your Mac shows (or typing its 12 digits).
Do I need a special Mac or network setup?You need an Apple-silicon Mac on macOS 14+ and an iPhone/iPad on iOS/iPadOS 17+, connected on the same network, by USB cable, Direct Wireless Connection, or your own VPN like Tailscale when away.
What can't it do, like sound or multiple windows at once?Sill shows only one window or the whole desktop at a time and does not stream audio from your Mac.
Does my screen data go through any third-party server?No; the connection goes straight between your two devices over TLS 1.3, with no server involved, and the Mac app requires Screen Recording and Accessibility permissions to work.
Does it support Apple Pencil and gestures, not just taps?Yes: it supports touch, trackpad-style gestures (three-finger swipe/pinch for Mission Control and Spaces), a keyboard, and Apple Pencil as a pointer.
How does it behave on the iPhone Duo's foldable screen?Sill adapts to the hinge: open flat the Mac fills the inner display, half-open shows the picture above a trackpad and keys, and closed it runs on the cover display.
Can I use this away from home without port forwarding hassle?Yes, Remote Access lets paired devices reach your Mac through your own VPN (such as Tailscale) or a forwarded router port, and it automatically drops to a lower quality on slow links.
Is there a cost or subscription?No, Sill is completely free with no ads, tracking or subscription; GitHub Sponsors tips are optional and unlock nothing extra.
Creator
Saffsanity
Size
6.6 MB
Stars
2.8K
Age
25d
Commits · 90 Days