## porter.md

媒体, 已就位.
深植于你的设备。

一款原生 macOS 应用,把你的视频库自动转码并直接同步到 iOS / iPadOS 的内置 TV 应用。不绕 iCloud,不用网页上传器,不再「只能在笔记本上看」。

# 需 macOS 14+ · iOS / iPadOS 15+

// film → handoff → device

拖拽 ~/Movies/Anime → "iPad Pro"  # → 24 集、海报、排序、音轨切换器全部就绪
## features

围绕 TV 应用的真实行为打造。

这里的每一个功能,都是因为我们发现 iPad 的 TV 应用在喂任意视频时会以某种特定方式翻车。完整记录见 更新日志

transcode

聪明,不死板

只转码设备播不了的部分。HEVC 保持 HEVC。AAC 与 EAC3 直通。AC3 → AAC,因为 iPad 的 TV 应用会悄悄把 AC3 从音轨切换器里删掉。

metadata

海报、季、排序标题

从 TMDb 拉取元数据,写满 TV 应用所需的全部字段(sort titles、episode_sort_id、Airlock 海报)。剧集正确分组,没有「0.」前缀 bug。

anime

懂动漫

识别连续集数,处理画面里烧入的集数,按设备已有内容去重。兼容粉丝字幕组的发布。

sync

流水线同步,不再苦等 30 分钟

文件上传完成的那一刻就出现在 TV 应用里——而不是在长长的「最后处理」之后。同步过程中实时检测磁盘空间。同步时拦截误关。

native

原生 macOS

Swift 打造。默认深色。正常退出。停在 Dock 里,不去抢菜单栏——除非你要求。

private

零遥测

不收集数据。不匿名、不汇总、不「为了改进产品」。应用只与你的设备和 TMDb(取海报用)通信。

## 流程

一次拖拽,三个阶段。

MediaPorter 观察你的库,规划要做的事,在第一字节流出前展示「清单」。控制权在你。

  1. 01

    分析

    探测编码、音轨、字幕。把片名匹配到 TMDb。识别动漫集数。跳过设备上已有的文件。

  2. 02

    规划

    逐文件:保留、重封装或转码。音频:直通或转换。磁盘空间检查。你确认后才会开始。

  3. 03

    投递

    并行转码。通过 USB 或 Wi-Fi 上传。每个文件到位时就注册到 TV 应用——不再等 30 分钟。

## 设置

需要两个免费的 API 密钥。

MediaPorter 不内置共享密钥 —— 那样几天内就会被从二进制中提取并触发限流,所有人都会受影响。你需要自己申请:TMDb(海报与元数据)和 OpenSubtitles(字幕)。五分钟,无需信用卡。

## 教程

如何把动漫导入 iPhone 和 iPad

一步步教你:把任何动漫资源——单集、整季、字幕组发布——导入内置 TV 应用,集数、海报、字幕全部正确。无需越狱。

## 更多教程

从这里开始

## faq

常见问题

怎么把动漫导入 iPhone 或 iPad?

在 Mac 上安装 MediaPorter,连接 iPhone 或 iPad(USB 或 Wi-Fi 配对),把动漫文件夹拖入应用,点击同步。剧集会出现在内置 TV 应用的 Library → TV Shows 下,带海报与正确集数。支持 .mkv、.mp4、.m4v、.avi,含字幕或配音版本均可。

不用 iTunes 和 iCloud 也能用吗?

可以。MediaPorter 通过 Apple 的设备同步协议(ATC)直接与设备通信。文件不会上传到 iCloud,也不依赖 iTunes / Apple Music。

电影和剧集也能同步吗?

可以。MediaPorter 会自动区分电影、剧集与动漫。电影进 Library → Movies;剧集和动漫进 TV Shows,按季和集数排好。

它会把我整个库都转码一遍吗?

只转码设备无法直接播放的部分。HEVC 视频原样保留。AAC 与 E-AC-3 音频直通。AC-3(杜比数字)会被转成 AAC,因为 iPad 的 TV 应用会把 AC-3 从音轨切换器里隐藏掉。

支持 .mkv 吗?

支持。包含 H.264、HEVC、AAC、AC-3、E-AC-3 或 DTS 的 MKV 都能处理。视频尽量重封装而不重新编码,音频只在必要时才转换。

字幕能带过去吗?

软字幕(SRT、ASS/SSA、mov_text、PGS)会被重封装到输出文件中,前提是 TV 应用能渲染。硬字幕本就在画面里。

需要越狱吗?

不需要。MediaPorter 在原版系统上通过 Apple 公开的同步协议工作。要求 macOS 14+,iOS / iPadOS 15+。

MediaPorter 会收集遥测吗?

应用内没有分析、没有崩溃信标、没有使用统计。macOS 应用只与你的设备和 TMDb(取海报)通信。

需要 API 密钥吗?

MediaPorter 使用两个免费的第三方服务 —— TMDb 用于海报与元数据,OpenSubtitles 用于下载缺失语言的字幕。两者都需要你自己的免费账号(5 分钟,无需信用卡)。把共享密钥打包进应用并不可行:很快会被从二进制中提取,进而触发限流。具体步骤见「设置」页面。不填密钥也能工作 —— 只是会得到回退海报,且仅使用文件中已内嵌的字幕。

## 下载

获取 MediaPorter。

// v0.6.1 · 2026-05-14

已由 Apple 签名并公证。两种构建里跑的是同一个应用——区别只在于 ffmpeg 是否打包在应用内。

## with-ffmpeg 推荐

MediaPorter + ffmpeg

开箱即用。ffmpeg 已打包在应用里——无需 Homebrew,无需命令行。不确定就选这个。

下载 .dmg
## minimal

MediaPorter

体积更小。自行通过 `brew install ffmpeg` 或任何兼容的 ffmpeg 二进制(位于 $PATH 中)。

下载 .dmg

# 需要 macOS 14+ · Apple Silicon · 对比两种构建 → · 在 GitHub 查看源码