Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

A Mac menu bar utility that adds a phone-shaped virtual display to UU Remote, so Mac windows fill an iPhone screen with native-style gestures.

232
16
Swift
MIT
3 days old

What it does

UU Remote normally compresses the whole Mac desktop into a phone screen, shrinking text and controls. Snug adds a dedicated portrait virtual display — the "Snug 手机屏" — whose aspect ratio matches the phone, so a chosen Mac window occupies the entire screen at readable size. Terminal apps such as Ghostty, iTerm2, VS Code, Cursor and Zed can enlarge their font per app, and the setting is remembered.

It also remaps touch input on that virtual display only: one-finger swipe scrolls with inertia, long-press then drag selects text, and long-press release opens the context menu. Other displays and the Mac's own trackpad and mouse are unaffected. An App Library home screen lists running apps and all installed apps, supports search by name, window title, pinyin or initials, and lets you open, switch, create, close or quit apps from the phone.

The project is a fork of UUyc-companion and keeps the original copyright and history; from 2.0 it is redesigned around the phone screen.

Install and first run

Requirements: macOS 14 or later on the Mac being controlled, with UU远程 installed; the phone only needs the UU Remote app.

  1. Download Snug.dmg from the domestic CDN mirror or GitHub Releases. Both channels serve the same package, and it is signed and notarized by Apple for Apple Silicon and Intel.
  2. Drag Snug into Applications and open it.
  3. Grant Accessibility permission from the welcome screen (called "设备控制和数据访问" starting with macOS 27).

Snug then lives in the menu bar. On the phone, connect through UU Remote and pick "Snug 手机屏" in the screen list; choose the phone model once, then tap an app or window in the App Library. To build from source you need Xcode and Swift 6:

git clone https://github.com/zephyr4123/snug.git
cd snug && scripts/snug install

If you previously used UUyc-companion, stop it first and, if its watchdog agent was enabled, remove it with the launchctl bootout and rm commands shown in the migration notes.

Constraints

  • Snug depends on undocumented macOS interfaces, so a major system update may break it.
  • Only portrait mode is implemented; a tablet in landscape falls back to the original UU Remote experience.
  • It is not affiliated with NetEase or UU Remote, and UU Remote updates may affect some features.
  • Apps with a minimum window width cannot shrink to phone width; Snug switches the virtual display to a resolution that just fits them, so text is smaller but the whole window stays visible.
  • On a Mac with no external display attached, you cannot switch back to the original screen; use "退出手机屏" in the App Library.
  • Occasionally the virtual display is not removed after a remote session ends; turning it off in settings restores things. Some window font sizes in VS Code and Cursor may be remembered when closed via shortcuts on the phone.
  • No data is collected; network access is only used to check for updates.

HotRepo's take

The project entered HotRepo's new-project board on 2026-11-16 with 129 stars gained in its first recorded window (roughly 22.5 hours from 2026-11-15 12:46 UTC), reaching 232 stars and 16 forks, with no GitHub all-language daily rank recorded. What stands out is the scope: instead of wrapping one AI assistant's remote control, it works at the window and virtual-display layer so any Mac app can be used. The documented limitations around private macOS APIs and the single portrait mode are the main things to weigh before adopting it.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. VallierDev/uu-remote-linuxAn unofficial Linux host that makes a Linux machine appear in NetEase UU Remote's official clients as a controllable device.Rust419
  2. wquguru/cicadaA macOS menubar app that adds live bilingual subtitles, interpreting and AI meeting notes to any call or stream.Swift244
  3. 0xCodez/iphone-mirror-windowsWindows tool that receives iPhone AirPlay mirroring and optionally adds USB mouse and keyboard control.Python101
  4. tw93/MoleA macOS CLI for deep cleaning, app uninstalling, disk analysis, system optimization and live monitoring, with Windows and Linux ports.Shell74,153
  5. kunkundi/crossdeskCross-platform remote desktop for controlling computers from desktop, browser, mobile, or terminal clients.C++4,771