系统要求运行所需环境
- 操作系统
- macOS 27.2 或更高版本。内置依赖库需要 macOS 26;界面代码支持在 macOS 13 及以上系统编译。
- 芯片
- Apple Silicon(M1 或更新芯片)。不支持也未在 Intel Mac 上测试。
- HDR 显示
- 任何屏幕均可播放 HDR 视频。完整 HDR 峰值亮度与 SDR 转 HDR 需要具备高动态范围的显示屏:Liquid Retina XDR、Pro Display XDR 或外接 HDR 显示器。
- AV1 硬件解码
- M3 及更新芯片(通过 VideoToolbox,需 macOS 14 或更高版本,运行时自动检测);其余机型使用 dav1d 软件解码。
- 可选组件
- yt-dlp 用于播放网页视频与 YouTube(
brew install yt-dlp);SVP 4 Mac 与 VapourSynth 用于 SmoothVideo Project 插帧引擎。 - 测试基准机
- 在搭载 macOS 26.2 的 M3 Max(Mac15,9)上开发并完成性能实测。
下载信息版本 1.9
- 安装包
- maclc-1.9.dmg,58.1 MB,发布于 2026年11月19日
- SHA-256
bcad431f7b0d8886d0bd5fe348c2b946174ee325e86ef3dc8a654ed0d0146ddb- 代码签名
- 采用临时签名(ad hoc),未经公证:macOS 首次打开时会提示点击“仍要打开”。也可在终端运行
xattr -dr com.apple.quarantine /Applications/MacLC.app。 - 应用包
org.maclc.MacLC。完全独立封装:143 个库位于Contents/Frameworks,所有引用均已重写为@loader_path;对应许可证位于Contents/Resources/Licenses。- 源代码
- github.com/OZBM/MacLC — GPL 2 或更高版本;libVLC 遵循 LGPL 2.1 或更高版本。
媒体播放基于 VLC 4 的 libVLC 引擎
- 播放引擎
- 基于 VLC 4 开源播放引擎(
libvlccore)及其解复用器、解码器、滤镜与协议栈,内置 FFmpeg。 - 封装容器
- MKV 与 WebM(libmatroska)、MP4、MOV、AVI、MPEG-TS、Ogg、FLV 以及 libVLC 支持的所有其他容器。
- 视频编码
- H.264、HEVC(8、10 与 12 bit;高于 10 bit 解码至 16 bit 缓冲)、AV1(dav1d;M3 及更新芯片支持 VideoToolbox)、VP9、ProRes、MPEG-2 等。通过 VideoToolbox 进行硬件解码,默认输出 10 bit P010。
- 音频编码
- AAC、ALAC、FLAC、MP3、Opus、Vorbis、AC-3 与 E-AC-3、PCM 等;支持音频效果面板、均衡器与音轨同步调节。
- 字幕支持
- 任意字符编码的文本字幕(SRT 等),通过 libass 渲染 ASS/SSA 特效字幕;在 HDR 视频上保持舒适的 SDR 白色亮度。
- 媒体来源
- 本地文件、文件夹、访达“打开方式”、拖放打开、HTTP(S) 串流、“浏览”中的网络服务、基于 yt-dlp 的网页视频、.torrent 文件与磁力链接。
- 已移除项
- 播客与广播电台目录(自 1.1 起移除)。RSS 订阅源仍可作为播放列表打开。
HDR 管线支持格式与呈现方式
- 支持格式
- Dolby Vision Profile 5、7(基础层与 RPU)、8.1、8.4;HDR10+(ST 2094-40);HDR10(ST 2084、ST 2086、CTA-861.3);HLG。
- 呈现方式
- 支持按文件自动或手动指定 Dolby Vision、HDR10+、HDR10、HLG 或 SDR,由 HDR 决策器挑选并显示在格式卡片中;
--maclc-hdr-presentation可设定默认选项。 - 画面风格
- 准确(峰值 90% 以内精确还原,PQ 域肩部滚降)、均衡(ITU-R BT.2390 EETF)、明亮(最高 1.6× 提亮);当母带亮度完全落在屏幕能力范围内时保持恒等映射。
- 播放模式
- 自动、始终使用 HDR、将 HDR 转换为 SDR、关闭 HDR(
--macosx-hdr-mode0–3)。 - 参考白基准
- PQ 曲线将 SDR 白色锚定在 100 cd/m²;HLG 采用 BT.2100 OOTF,适配 1,000 尼特参考显示器或按当前屏幕动态调整。
- 亮度余量
- 每当屏幕、窗口位置或色彩描述文件变化时,实时重读潜在/当前/参考 EDR 余量;可通过
--macosx-edr-headroom手动覆盖。 - 渲染后端
- 原生路径(AVSampleBufferDisplayLayer,EDR);基于 OpenGL 4.1 Core 与 64 位浮点色彩的 libplacebo;MacLC 自研 Metal 引擎,支持 Dolby Vision RPU 解码、HDR10+ 曲线、色调曲线、色域映射、超分辨率与降采样滤镜、360° 全景视频及 .cube LUT。
SDR 转 HDR原生路径上的逆色调映射
- 映射规则
- 在线性光域内相对 SDR 白色进行计算。驱动能量 = 亮度与最大通道值 85% 中的较大者;整个像素按同一比例缩放(完整保留色相)。快速档:½ 以下恒等,以上按值与斜率连续的二次曲线上升,
f(1)达到峰值;均衡档:仅提升漫反射白以上的区域,且大面积明亮时自动收敛。 - 输出格式
- 64 位半精度线性浮点,BT.2020 色域,1.0 = SDR 白色;峰值 = min(设定值, 当前屏幕余量)。自动跳过 PQ 与 HLG 片源。
- 画质档位
- 自动、快速、均衡、高、极高。高档与极高档通过 MPSGraph 运行小型神经网络,从 256×256 缩略图预测双边增益网格,各通道增益与亮度增益的对数差控制在 0.2 以内(在 M3 Max 上每帧耗时 0.45 与 0.53 ms)。
- 控制入口
- 播放控制栏开关与弹出面板(按住 ⌥ 点击快速切换)、视频 › SDR 转 HDR、设置 › HDR 与色彩;支持“按住对比”按钮或长按 M 键。
- 命令行参数
--macosx-sdr-to-hdr、-quality、-boost(1–16,默认 4)、-midtones、-saturation、-deband、-protect。
超分辨率基于 Metal 的九种 GPU 算法
- 算法列表
- 自动(小尺寸视频优先 Apple 超分,其余使用 MetalFX);Apple 神经引擎 4x(一次性从 Apple 下载;性能不足时退回 2×);动漫(ArtCNN)与 Anime4K;FSRCNNX(仅在同意 LGPL-3.0 许可证后下载);锐利(AMD FSR 1)与 NIS(NVIDIA Image Scaling);高效(MetalFX 空间放大);经典(EWA Lanczos)。
- 适用片源
- Apple 神经引擎、动漫、Anime4K 与 FSRCNNX 适用于 8-bit SDR 视频。对于 HDR 与 10-bit 视频,或在开启 SDR 转 HDR 时,MacLC 会自动使用其他算法。
- 触发时机
- 在 MacLC 的 Metal 视频输出中,当窗口尺寸至少达到视频原尺寸的 1.2 倍时启用。使用电池、开启低电量模式、机身发热或单帧耗时超过预算 60% 时,神经引擎算法会自动让步。
- 实测耗时(M3 Max)
- MetalFX 空间放大每帧 0.4–0.84 ms;FSR 1(720p → 1440p)约 0.5 ms;NIS(720p → 4K)1.19 ms;ArtCNN(540p → 1080p)约 2.1 ms。
- 着色器支持
- 内置转译器可直接运行 mpv 风格的 hook 着色器,使 Anime4K 与 FSRCNNX 原生运行在 Metal 之上。
- 效果对比
- “前后效果对比”从画面正中分屏:左半边关闭 SDR 转 HDR、超分辨率与插帧,右半边开启。
- 命令行参数
--maclc-upscale、--maclc-upscale-method。
动态插帧maclc_frc 视频滤镜
- 插帧引擎
- 自动(选择可实时匹配屏幕刷新率的算法;绝不自动启用光流“画质”档、RIFE 或 SVP,需手动选择;使用电池或机身发热时退回 CADisplayLink 步调校准);Apple 光流(VTFrameRateConversion:均衡、画质);低延迟(VTLowLatencyFrameInterpolation,最高 720p);运动补偿(VTMotionEstimationSession 在 960×540 分辨率下搜索真实运动矢量,并在 Metal 中进行带遮挡检测的重叠块补偿);帧混合(blend);Core ML 上的 RIFE v4.25(内置,MIT);基于 VapourSynth 的 SmoothVideo Project。
- 目标帧率
- 匹配显示器、60 fps、120 fps、源帧率两倍;默认最高 5× 倍频(
--maclc-frc-max-factor2–8)。 - 时间预算
- 每轮渲染均对照单帧时间预算实时计时;连续超时半秒后自动降档,必要时停止插帧以保流畅。
- 实测数据(M3 Max,24 fps 片源)
- 1080p 插入四帧:运动补偿 7–11 ms,帧混合 2 ms,光流 58 ms。RIFE 在 960×576 分辨率下每轮 12.9–14.8 ms(相对真实中间帧峰值信噪比达 28.9 dB,传统帧混合为 21.6 dB)。
- 命令行参数
--maclc-frc-engine、-target、-overrun、-rife、-rife-model、-rife-scale、-rife-compute、-me-scale、-svp-path;或--video-filter=maclc_frc。
音频处理声音模式、均衡器与人声增强
- 声音模式
- 九种采用 Apple 风格设计的预设模式:人声增强、夜间、影院、音乐、低音增强、有声读物、耳机、小型扬声器与自定义,每种均配有强度滑块。
- 均衡器
- 基于 ISO 中心频点(32 Hz 至 16 kHz)的 10 段均衡器,可通过“音频 › 均衡器…”(⌥⌘E)或播放控制栏打开。
- 人声增强
- 自研
maclc_dialogue滤镜。5.1 声道:向中置声道重新平衡(+7.4 dB 对白优势);立体声:通过 Apple vDSP 进行短时傅里叶变换提取中央对白(1024 点,16 ms 延迟)并提升 1–4 kHz 人声频段(+4.8 dB)。 - 限幅器
- 位于均衡器、压缩器与对白增强之后的 -1.5 dB 砖墙峰值限幅器,彻底杜绝削波爆音。
无线投屏AirPlay 与 Chromecast(测试版)
- AirPlay
- 全新
airplay流输出模块:MacLC 在局域网内将视频封装为 HLS(分片 MP4,音频作为EXT-X-MEDIA轨),再由 AVPlayer 通过 AirPlay 推送到接收端。 - Chromecast
- 使用 VLC 的 Chromecast 流输出模块;通过 Bonjour 自动发现局域网接收设备。
- 当前状态
- 测试版。点击工具栏或“正在播放”栏中的“播放到”按钮;支持在 MacLC 内或用电视遥控器控制播放。
- 上游修复
- 传递时钟(
set_pcr)以确保 HLS 稳定切分片段;修复 Chromecast 解复用器在文件末尾提前截断的问题;分片 MP4 复用器现能正确刷新已移除的轨道。
网页视频、YouTube 与种子文件 › 打开网页视频 (⌘U)
- 网页视频
- 通过绝对路径调用 yt-dlp(从访达启动的应用不会继承 Homebrew 的 PATH),在后台线程带超时执行。优先选择包含音频的单一格式,否则选取最佳视频配第二音轨;同等体积下优先选择本机硬件支持解码的编码。针对 YouTube 限制 HTTP 分块请求为 1 MiB。本地保留最近 10 条链接历史。
- YouTube 专区
- 边栏独立分区,提供首页、订阅内容、历史记录、稍后观看、赞过的视频、播放列表、频道与搜索。通过
--cookies <file>(文件权限 0600)或--cookies-from-browser调用 yt-dlp;所有参数均置于--之前,避免 URL 被误解析为命令行选项。可通过内嵌私有 Google 网页视图或已有浏览器会话可选登录。 - BitTorrent
- 基于 libtorrent-rasterbar 2.x。BitTorrent 启动门限先等待 20 秒媒体数据以测算节点群速度,再依据下载/码率比设定 10–90 秒缓冲,最长两分钟强制开播。自适应缓冲始终维持提前播放位置两分钟(至少 48 MiB)的窗口。播放器预读(PTS 延迟)随初始缓冲调整,上限 10 秒。内置默认 Tracker。界面约每秒两次读取 JSON 状态快照,无需 libtorrent 往返查询。DHT 路由表跨启动保存,数秒即可重连节点。多文件种子自动组织为播放列表(自动匹配字幕,剧集连播)。
- 系统集成
- 支持从打开面板、“浏览”与访达直接打开 .torrent 文件,或在“打开网页视频”中粘贴磁力链接。MacLC 不会接管系统
magnet:协议。种子条目不主动生成缩略图,以免意外触发下载。
媒体库首页、分类与待播清单
- 底层引擎
- 静态链接 VideoLAN 的 libmedialibrary 与 TagLib;后台线程异步查询、批量合并更新、封面降采样、本地生成缩略图。
- 浏览视图
- 首页(大横幅、继续观看、最近添加、最近播放、专辑)、视频、剧集、艺人、专辑、歌曲、类型、收藏、播放列表、支持播放与随机播放的详情页,以及浏览。
- 播放队列
- 带章节与拖放排序的“待播清单”检查器;带实时画面的浮动“正在播放”胶囊;对 3 分钟以上的媒体自动提供断点续播(避开首尾各 1 分钟或 5%)。
- 画质徽章
- 索引时读取色彩元数据,自动标注 Dolby Vision、HDR10、HLG 与 4K 徽章。
- 界面实现
- 基于 Liquid Glass 的原生 AppKit(边栏、工具栏、检查器、正在播放),工具栏上的每一项操作均可在菜单栏中找到对应入口。
扩展插件与 WatchStremio 协议与片库浏览
- 兼容协议
- 完整实现 Stremio 扩展协议:manifest、catalog(支持搜索、类型与 skip 分页)、meta、stream 与 addon_catalog。
- 内置基础
- 内置 Cinemeta 提供海报、简介、演职员表与搜索功能,并集成官方与社区扩展目录。
- 安装管理
- 在“设置 › 扩展插件”中一键安装、配置或移除,或通过“从地址安装…”粘贴 URL 与
stremio://链接。 - 内容发现
- 流媒体服务筛选器可将首页限定为你订阅的服务(Netflix、Apple TV+、Disney+、Prime Video、HBO Max、Hulu、Paramount+、Peacock、Crunchyroll、MUBI、Criterion Channel、Canal+、SkyShowtime、BBC iPlayer、Starz、Shudder 等),读取一键安装的社区扩展公开片库。支持类型磁贴,以及每两周更新一次、自动匹配已安装片库(默认 Cinemeta)的“The Edit”编辑精选。货架支持无滚动条的弹性横向滚动。
- 选择版本
- 将每个播放源解析为清晰的参数:分辨率、HDR、Dolby Vision、音轨(如 5.1 或 Atmos)、语言、体积与节点数,并支持筛选。内置交互式提示气泡解释 HDR、Dolby Vision、做种与节点概念。
- 历史与续播
- 边栏 Watch 下提供收藏与历史记录,首页提供“继续观看”。跨启动记忆播放进度,支持“标记为已看”徽章。数据原子写入本地
~/Library/Application Support/org.maclc.MacLC/Watch/library.json。播放至 92% 记为已看;不足 15 秒视为误触。 - 播放源选择
- 清晰度徽章(4K、HDR、Dolby Vision、1080p)。自动将播放源路由至磁力链接(libtorrent 2.1)、网页视频(yt-dlp)或 HTTP 直链。
- Watch 界面
- 原生 AppKit 构建的边栏 Watch 专区:首页轮播、内容货架、Top 10 榜单、电影与剧集网格、含演职员表与分集剧照的详情页。
- 内容声明
- MacLC 本身不提供任何电影、剧集或视频流,全部片库均由第三方扩展提供。
原生界面全程 AppKit 构建
- 视觉材质
- macOS 26 上使用 NSGlassEffectView;旧系统或开启“降低透明度”“增强对比度”时切换为带细边框的 HUD 材质。
- 播放控件
- 采用 SF Symbols 的 Liquid Glass 胶囊控制栏、格式与帧率徽章、悬停加粗的进度条、等宽时间数字;玻璃胶囊屏幕提示(MacLCOSDView)支持旁白播报。
- 窗口行为
- 视频窗口自动匹配视频原生尺寸,在分屏或放大模式下保持显示纵横比;缩放时锁定画面比例。
- 设置系统
- 单窗口八分区,支持按标题、描述与关键词搜索;240 处受保护的配置读取;启动自检;引擎高级配置树仍可通过折叠区完整访问。
- 退出保护
- 退出种子任务限时 3 秒;启动器内置看门狗在发起退出 12 秒后将线程采样写入
~/Library/Logs/MacLC/quit-hang-*.txt并强制退出。 - 设计令牌
- MacLCDesign:将颜色、字体、间距、圆角、材质、图标与动效统一映射为 AppKit 语义;六项关键尺寸对齐 8 点网格(如小行高 25 → 32 pt)。
- 无障碍支持
- 跟随系统强调色、浅色/深色模式、减弱动态效果、降低透明度、增强对比度、旁白(VoiceOver)与全键盘导航。
隐私保护哪些数据会离开你的 Mac
- 遥测统计
- 完全没有。无访问统计、无用户追踪、不发送崩溃报告。
- 自动更新
- 已禁用上游更新源,确保应用绝不会在未经许可的情况下被替换。
- 网络访问
- 仅连接你主动打开的内容:网络串流、粘贴的网页链接(通过 yt-dlp)以及种子(P2P 通信,与任何 BT 客户端一致)。
- 媒体库与 Watch
- 索引目录、缩略图、Watch 历史与续播位置(
~/Library/Application Support/org.maclc.MacLC/Watch/library.json)均留在本地用户目录。YouTube 会话 Cookie 本地保存(权限 0600),退出登录即删除,绝不发送给 Hazen Studio。
组件与许可应用内集成组件
- 核心引擎
- 源自 VLC 4.0 的代码(libVLC 为 LGPL 2.1+;MacLC 为 GPL 2+),以及 FFmpeg、dav1d、libass、FreeType、libmatroska、libplacebo、libtorrent-rasterbar 等内置库。由于部分依赖库的许可条款,分发后的整包应用实质上遵循 GPL 3.0。
- 静态链接库
- libmedialibrary 与 libdvbpsi(LGPL 2.1+)以及 TagLib(LGPL 2.1 或 MPL 1.1),均通过
build-medialibrary.sh与build-taglib.sh从经验证源码编译。 - AI 模型
- RIFE v4.25(MIT,Practical-RIFE);Hazen Studio 基于 Poly Haven CC0 摄影素材训练的 SDR 转 HDR 网络(LGPL)。
- 超分辨率
- NIS 与 FSR 1(MIT,完整保留 NVIDIA 与 AMD 版权声明)、Anime4K 与 ArtCNN(MIT)、FSRCNNX(LGPL-3.0,仅在用户同意许可证后下载)、MetalFX 与 VideoToolbox 超分辨率(Apple 系统框架)。
当前状态公开测试版
- 已验证
- 已在基准机上完成编译与运行;日志已验证 HDR10、HLG 与 SDR 标签、HDR 模式及余量覆盖;308 项单元测试全部通过;最终镜像基于 tag 1.6 移除 C 断言后构建。
- 待完善
- 在更广泛的影片库上评估 SDR 转 HDR 视觉表现,以及在大规模真实片库下测试媒体库的 VoiceOver 与鼠标拖放体验。
- 已知限制
- macOS 上暂无 Vulkan 后端(缺少 CAMetalLayer 窗口模块);dovi-rpu-wip 分支中的 Dolby Vision RPU 解析器在分片字段处存在失步。
- 问题反馈
- GitHub Issues:请附上你的 Mac 型号、macOS 版本、显示器型号,以及“设置 › HDR 与色彩”中“当前状态”面板的内容。