

以 Mac 自己的组件精雕细琢。
Liquid Glass
在 macOS Tahoe 上,播放控制栏、边栏与“正在播放”栏均悬浮于液态玻璃之上;在旧版系统或开启“降低透明度”时,会自动切换为稳重的不透明材质。
真正的 Mac 边栏
并非模仿外观的普通列表,而是系统原生的边栏组件,具备标准的材质、折叠收起与拖放交互。
贴合影片比例的窗口
2.39:1 的电影就用 2.39:1 的窗口呈现。即使在平铺分屏模式下,画面也会保持比例,不留上下黑边。
克制优雅的状态提示
音量、倍速、音轨与同步偏移的变化会通过小巧的玻璃胶囊确认——并支持旁白播报——不再粗暴地把大字叠在画面中央。
纹丝不动的计时数字
时间读数采用等宽数字,每秒跳动时绝不会左右晃动。
遵循 Apple 用语规范
设置…、保持在最前、拍摄快照、进入全屏幕:你所熟悉的原生菜单名称,没有多余杂项,也没有死胡同。
每一项设置都告诉你将会看到什么。
传统播放器的偏好设置往往是一面密密麻麻的复选框墙,外加一棵藏着上千个毫无解释选项的高级树形菜单。MacLC 只有一个窗口、一个边栏、一个搜索框——以及每个选项下方的一句直白解释。
MacLC 这样说“高光保留丰富细节,整体画面略微偏暗。”
而不是applies a BT.2390 EETF


八个清晰分区
通用、播放、视频、HDR 与色彩、音频、字幕、界面与快捷键。
语义搜索
搜索范围涵盖名称、描述与关键词,输入“亮度”就能精准找到你想要的设置。
有用的风险提示
可能影响播放流畅度的选项会附带警告,并用一句话说明开启后的具体表现。
绝无摆设
每个控件都与当前版本中真实存在的配置项绑定。若某项配置不存在,对应条目根本不会显示。
与你的 Mac 步调一致,因为它从未忽视系统设置。
MacLC 从不硬编码颜色、字号或动画时长,而是实时向系统查询。你在系统设置中的每一项偏好都会在全应用生效,无一例外。
强调色
按钮、选中态与开关均自动采用你在“系统设置”中挑选的强调色。
浅色与深色模式
每个窗口与面板都随系统外观自动切换,包括效果面板与媒体信息面板。
减弱动态效果
所有位移动画都会切换为柔和的交叉淡入淡出。
对比度与透明度
开启“增强对比度”或“降低透明度”后,玻璃材质会立即切换为高对比度的不透明表面。
旁白(VoiceOver)
所有控件均有清晰的语音标签,屏幕提示也会在操作完成时播报一次最终数值。
全键盘操作
每个控件都支持键盘访问,“按住对比”同样只需按住按键即可触发。
那些无人强求却依然打磨的细节。
遵循 Apple 图标网格绘制的石墨色超椭圆,而非普通的圆角矩形:当它在程序坞中缩放到 16 磅时,正是这道曲率让它显得天生就该在那里。
唯一的色彩来自播放三角背后那束温暖的光晕,使其看起来像一道透出的光,而非一笔颜料。整个图标由一段随源代码一同保存的小程序绘制而成,可以像代码一样被修改和版本对比。
写给喜欢探究技术细节的你。
设计系统MacLCDesign
- 设计令牌(Tokens)
- 单一设计层将所有颜色、字体样式、间距、圆角、材质、SF Symbol 配置与动画时长定义为类属性,并直接映射至 AppKit 语义(
labelColor、controlAccentColor、separatorColor等)。原 VLC 的 macOS 代码仅在一个分类中就散落了十一种硬编码颜色。 - 动态效果
- 快速、标准与强调三种弹簧曲线,配合空闲与驻留计时器;开启“减弱动态效果”时,出现与消失动画会自动切换为交叉淡变。
- 玻璃材质
- 在 macOS 26 上使用
NSGlassEffectView,旧系统则使用带细边框的 HUD 视觉效果视图;若“降低透明度”或“增强对比度”状态改变,界面会实时切换。 - 字体排版
- 全局采用系统文本样式;时间读数使用等宽数字。
六项尺寸调整对齐 8 点网格
| 度量项 | VLC | MacLC | 原因 |
|---|---|---|---|
| 小号列表行高 | 25 pt | 32 pt | 25 pt 低于舒适的点击热区标准。 |
| 中号列表行高 | 50 pt | 48 pt | 8 的整数倍。 |
| 大号列表行高 | 100 pt | 96 pt | 8 的整数倍。 |
| 视频列表行高 | 42 pt | 48 pt | 8 的整数倍,且为缩略图留出空间。 |
| 圆角半径 | 4 pt | 8 pt | 系统标准中号圆角。 |
| 控件淡出时长 | 0.4 s | 0.25 s | 系统标准动画时长。 |
设置窗口modules/gui/macosx/settings
- 结构
- 单一窗口、分类边栏以及按名称、描述和面板关键词过滤的搜索框;每个面板由带标题的卡片堆叠而成;高级选项统一收纳在可折叠区域内。
- 受保护的配置读取
- 全部 240 处配置读取均通过封装函数检查选项是否存在。此前在无 Lua 的构建中打开“界面”面板会直接调用
config_GetPsz("http-password")——触发 libvlccore 内部的assert()导致崩溃。 - 启动自检
MACLC_SELFTEST=1会在启动时实例化全部八个面板,并输出summary: 8 panes, 8 ok, 0 failed。- 完整保留
- 引擎原有的高级配置树完整保留,仍可通过折叠区访问。
独立身份名副其实的 Mac 应用
- Bundle ID
org.maclc.MacLC。此前与 VLC 共用标识符时,macOS 会在台前调度和程序坞中把 MacLC 的窗口显示为 VLC 图标,甚至导致 MacLC 读写 VLC 的设置与媒体库。- 配置迁移
- 首次启动时会复制 VLC 的偏好设置文件夹、Application Support 文件夹及默认域,仅做只读复制,绝不修改原文件。
- 名称替换
- 品牌名称在本地化翻译之后进行替换,从而完整保留
po/中各语言词库的可用性(如“隐藏 VLC” → “隐藏 MacLC”)。屏幕快照文件命名为maclcsnap-*。 - 应用图标
- 基于 1024 画布中 824 区域绘制的超椭圆(指数 5),由
extras/package/macosx/asset_sources/maclc_app_icon.swift生成,同时附带菜单栏模板图标。
稳定性开发过程中逐一攻克
- 崩溃修复
- 修复了播放结束关闭窗口时的释放后使用(use-after-free,在 VLC 中可稳定复现)、可从界面触发的断言崩溃、发现服务为空时的浏览崩溃,以及无活跃屏幕 Mac 上的进度条崩溃。
- 卡死修复
- 修复了资源释放时的死锁、播放冻结、全屏恢复在视频输出锁上的阻塞、进度对话框阻塞主线程,以及约五十分之一概率发生的退出卡死。
- 单元测试
- 为窗口尺寸自适应、续播规则、色调曲线、SDR 转 HDR、HDR 决策器、NEON 色度转换及 CoreVideo HDR 元数据编写了单元测试。