全部项目

iMirror

把 iPhone、iPad 的屏幕投到 Mac 上

iMirror 是免费开源的 macOS AirPlay 投屏接收器。它安静地待在菜单栏里;在 iPhone 控制中心点“屏幕镜像”,画面就出现在 Mac 上一个可以置顶的悬浮窗口里,声音也一起过来。

  • macOS 14 及以上
  • Apple Silicon 与 Intel 通用
  • 中文 / English 界面
  • GPLv3 开源,免费
iMirror 菜单:正在接收 iPhone 和 iPad 两台设备的投屏,每台都有“显示窗口”和“全屏”按钮

核心功能

用系统自带的“屏幕镜像”就能投,手机上不用装任何 App。

常驻菜单栏

没有 Dock 图标,不占地方。点菜单栏图标就能看到连接状态、投屏步骤和常用开关。

多台设备同时投屏

iPhone、iPad、另一台 Mac 可以同时投过来,每台一个独立窗口、独立解码,断开一台不影响其他。

悬浮窗口,默认置顶

无标题栏、可自由缩放;鼠标移上去才出现停止、置顶、全屏按钮。横竖屏切换和全屏时保持画面比例。

硬件解码,1080p60

VideoToolbox 硬件解码 H.264,Metal 直接显示,最高 1920×1080、60 帧,延迟低、占用少。

声音一起投

播放投屏设备的声音(AAC-ELD、AAC-LC、ALAC、PCM),音量跟随手机;不需要时可以在菜单里关掉。

验证码配对

新设备第一次连接时,Mac 上显示随机四位验证码,不保存固定密码;验证过的设备之后直接连,也可以一键全部遗忘。

开机即用

可设置登录时自动启动;Mac 睡眠时停止广播,唤醒后自动恢复。接收器名称带本机标记,多台 Mac 不会混淆。

中英双语,开源免费

界面跟随系统语言显示简体中文或英文。源码以 GPLv3 公开,没有广告、账号和联网统计。

截图

以下是应用的真实界面,会跟随系统的浅色 / 深色外观。点图片可查看原图。

下载与安装

需要 macOS 14 Sonoma 或更高版本,同一个安装包支持 Apple Silicon 和 Intel Mac。

安装

  1. 下载 dmg

    到 GitHub Releases 下载最新的 iMirror-<版本>-macOS-universal.dmg。

  2. 拖到“应用程序”

    双击打开 dmg,把 iMirror 图标拖到右边的“应用程序”文件夹,然后推出磁盘映像。

  3. 首次打开时放行

    发布版没有经过 Apple 公证,第一次打开会被拦截,按“首次打开被拦截怎么办”放行一次即可。

  4. 允许访问本地网络

    首次启动时 macOS 会询问,请点“允许”,否则 iPhone 找不到这台 Mac。

首次打开被拦截怎么办

iMirror 由 GitHub Actions 从公开源码自动构建,使用 ad-hoc 签名,未经 Apple 公证,所以 macOS 第一次会提示“无法验证开发者”。任选一种方式:

  • macOS 15 及以上:先双击打开一次,在提示里点“完成”;再打开“系统设置 → 隐私与安全性”,在底部点“仍要打开”,输入密码确认。
  • macOS 14:按住 Control 点按(或右键)iMirror,选“打开”,再点“打开”。
  • 终端(所有版本):提示“已损坏,无法打开”时也用这条命令。它只移除下载时附加的隔离标记,不修改应用本身。
    xattr -dr com.apple.quarantine /Applications/iMirror.app

想自己编译?装好 Xcode Command Line Tools 后,在源码目录运行 bash install.sh,详见 README。

开始投屏

  1. 打开 iMirror

    菜单栏出现一个小图标(手机和显示器)。iMirror 没有 Dock 图标,这是正常的。

  2. 在 iPhone / iPad 上打开“屏幕镜像”

    从屏幕右上角向下轻扫打开控制中心,轻点“屏幕镜像”。在 Mac 上则点菜单栏的控制中心。

  3. 选择带本机标记的名字

    例如 iMirror-A7K2。设备和 Mac 需要在同一个 Wi-Fi。

  4. 第一次输入验证码

    输入 Mac 上显示的四位数字。同一台设备以后不用再输。

小技巧

  • 鼠标移到投屏画面上,左上角出现停止、置顶和全屏按钮。
  • 窗口可以随意拖动缩放,画面始终保持比例,多余部分留黑边。
  • 想换个名字?在“设置 → 通用”里修改接收器名称。
  • 不想听手机的声音,在菜单里关掉“播放投屏设备的声音”。
  • 界面语言默认跟随系统,也可以在“系统设置 → 通用 → 语言与地区 → App”里单独为 iMirror 选择。

常见问题

iPhone 的“屏幕镜像”里找不到 iMirror
  1. 确认 iMirror 正在运行:菜单栏有它的图标,菜单里显示“等待设备投屏”。
  2. 确认 iPhone 和 Mac 连的是同一个 Wi-Fi,路由器没有开启“AP 隔离 / 访客网络隔离”。
  3. 打开“系统设置 → 隐私与安全性 → 本地网络”,确认 iMirror 已打开。
  4. 如果开了 macOS 防火墙,确认它允许 iMirror 的传入连接。
  5. 部分 macOS 版本需要在“系统设置 → 通用 → 隔空投送与接力”中保持“隔空播放接收器”开启,点对点(AWDL)连接才可用。
提示“iMirror 已损坏,无法打开”

这是下载隔离标记引起的,不是文件真的坏了。在终端运行 xattr -dr com.apple.quarantine /Applications/iMirror.app 后再打开。

安全吗?会上传我的画面吗?

投屏数据只在你的设备和 Mac 之间的局域网里传输。iMirror 不需要账号,没有广告和统计;新设备必须输入 Mac 上显示的验证码才能连上。全部源码在 GitHub 公开,可以自行审查和编译。

支持 HEVC、4K 或只投音频吗?

当前版本只接收 H.264 屏幕镜像,最高 1920×1080、60 帧,并播放镜像时的声音;暂不支持 HEVC 和 4K。需要的功能欢迎在 GitHub 提 Issue。

怎么卸载?
  1. 在设置里关闭“登录时启动”,然后从菜单退出 iMirror。
  2. 删除“应用程序”里的 iMirror。
  3. 如需同时清除配对记录和设置:删除 ~/Library/Application Support/iMirror,并在终端运行 defaults delete com.erniu.imirror。

遇到问题,或者有想法?

欢迎到 GitHub 提 Issue:附上 macOS 版本、Mac 机型、投屏设备型号和问题现象,会更快定位。也欢迎贡献代码和翻译。

iMirror 的协议层基于开源项目 UxPlay,整体按 GNU GPLv3 发布。AirPlay、iPhone、iPad、Mac 是 Apple Inc. 的商标;iMirror 与 Apple 没有关联。