产品简介
osxmetadata 这是一款命令行与 Python API 结合的工具，专门用于查看和修改 macOS 系统中文件的扩展属性。它能解决 Finder 标签、评论等信息无法通过标准 API 便捷设置的痛点，适合需要精细管理文件元数据的 macOS 用户、开发者和内容创作者。
核心功能
- 支持读写多种 macOS 文件元数据属性（如标签、Finder 评论、作者、日期等）
- 提供 Python API 和命令行工具 (`osxmetadata`) 两种使用方式
- 支持为 Finder 标签设置颜色
- 支持通过命令行快速查看和修改文件的元数据
- 兼容 macOS 10.15 及以上版本
快速开始
- 通过 Homebrew 安装 pipx，然后运行 `pipx install osxmetadata` 进行安装。
- 在 Python 脚本中导入 `from osxmetadata import *`，然后创建 `md = OSXMetaData("文件名")` 对象。
- 使用 `md.get(kMDItemAuthors)` 或 `md.authors` 读取元数据，使用 `md.set(kMDItemAuthors, [...])` 或 `md.authors = [...]` 写入元数据。
- 在终端中使用 `osxmetadata` 命令行工具直接读写文件元数据。
界面预览
与其他方案对比
| 对比项 | osxmetadata | 同类方案 |
|---|---|---|
| 元数据读写能力 | 提供统一接口，可读写包括 Finder 标签、评论、作者在内的多种元数据 | 系统工具 `mdls` 只能查看；设置 Finder 评论需通过 AppleScript 等间接方式 |
| 使用方式 | 提供 Python API 便于编程集成，并附带命令行工具方便直接操作 | 依赖系统命令或手动操作 |
适合谁用
- 需要为文件添加学术标签或管理研究数据的研究人员
- 希望系统化整理照片、文档等数字资产的内容创作者
- 需要通过脚本批量管理文件属性的 macOS 开发者或运维人员
- 习惯使用命令行操作系统的高级用户
下载与版本
当前最新版本为 v1.4.1，发布于 2026-02-16。支持 Linux。点击页面「下载软件」按钮即可下载打包好的版本，根据你的电脑/手机系统来选择对应的软件。
注意事项
- 本工具仅供学习和研究使用，请遵守相关法律法规。
- 请尊重内容创作者版权，勿将下载内容用于商业或非法传播。
- 项目源码地址：https://github.com/RhetTbull/osxmetadata