{"id":28920661,"url":"https://github.com/ruanweiming/hevc-preview-fix","last_synced_at":"2026-04-30T20:32:22.498Z","repository":{"id":300346730,"uuid":"1005946986","full_name":"ruanweiming/HEVC-Preview-Fix","owner":"ruanweiming","description":"Fix Quick Look and Finder preview issues for HEVC/H.265 MP4 videos on macOS. 解决 macOS 中 HEVC/H.265 视频无法预览和播放的问题。","archived":false,"fork":false,"pushed_at":"2025-06-21T07:01:36.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-21T07:19:39.466Z","etag":null,"topics":["ffmpeg","fix","h265","hevc","hvc1","macos","mp4","preview","quicklook","thumbnail","video"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ruanweiming.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-21T06:28:57.000Z","updated_at":"2025-06-21T07:01:40.000Z","dependencies_parsed_at":"2025-06-21T07:19:42.875Z","dependency_job_id":"aeab6981-55bb-46ae-9317-56bf34966191","html_url":"https://github.com/ruanweiming/HEVC-Preview-Fix","commit_stats":null,"previous_names":["ruanweiming/hevc-preview-fix"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ruanweiming/HEVC-Preview-Fix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruanweiming%2FHEVC-Preview-Fix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruanweiming%2FHEVC-Preview-Fix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruanweiming%2FHEVC-Preview-Fix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruanweiming%2FHEVC-Preview-Fix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ruanweiming","download_url":"https://codeload.github.com/ruanweiming/HEVC-Preview-Fix/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruanweiming%2FHEVC-Preview-Fix/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261238879,"owners_count":23128875,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ffmpeg","fix","h265","hevc","hvc1","macos","mp4","preview","quicklook","thumbnail","video"],"created_at":"2025-06-22T05:00:33.181Z","updated_at":"2026-04-30T20:32:22.489Z","avatar_url":"https://github.com/ruanweiming.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎬 HEVC Quick Look \u0026 Preview Fix for macOS / macOS 视频预览修复工具\n\nA simple script + Quick Action workflow to fix `.mp4` files encoded in HEVC (H.265) that do not show thumbnails or QuickLook previews on macOS.\n\n一个用于修复 macOS 无法预览 HEVC（H.265）编码 `.mp4` 视频的小工具，支持终端脚本和 Finder 右键快速操作两种使用方式。\n\n---\n\n## ✅ What It Does / 功能说明\n\n- 🧩 Fixes missing video previews in Finder / 修复 Finder 无法显示视频缩略图\n- 🎞 Enables QuickLook playback for HEVC `.mp4` / 启用 QuickLook 播放\n\n\u003e 💡 Uses `-tag:v hvc1` to make macOS properly recognize HEVC content  \n\u003e 💡 利用 `-tag:v hvc1` 标签让 macOS 正确识别 HEVC 视频\n\n---\n\n## 📦 Requirements / 使用前提\n\n- macOS (10.13+ recommended)  \n- FFmpeg installed via Homebrew  \n  安装 FFmpeg（使用 Homebrew）:\n  ```bash\n  brew install ffmpeg\n  ```\n\n---\n\n## 🖥 Option 1: Terminal Script / 方式一：终端脚本\n\n### 📥 Setup / 设置方法\n\n```bash\n# 1. 下载脚本 Download the script\ncurl -O https://raw.githubusercontent.com/ruanweiming/HEVC-Preview-Fix/refs/heads/main/hevc-fix-preview.sh\n\n# 2. 赋予执行权限 Make it executable\nchmod +x hevc-fix-preview.sh\n```\n\n### ▶️ Usage / 使用方法\n\n```bash\n# 修复单个视频 Fix single file\n./hevc-fix-preview.sh /path/to/video.mp4\n\n# 批量修复 Fix multiple files\n./hevc-fix-preview.sh ~/Downloads/*.mp4\n```\n\n---\n\n## 🖱 Option 2: Finder Quick Action / 方式二：Finder 快捷操作\n\n### 🧰 Setup / 安装方式\n\n1. 双击 `HEVC Preview Fix.workflow`\n2. 它会在 Automator 中打开，请选择“安装”或手动保存到：\n   ```\n   ~/Library/Services/\n   ```\n\n### ✅ 使用方法\n\n- 在 Finder 中选中 `.mp4` 视频\n- 右键 → 快捷操作 → HEVC Preview Fix\n\n它会自动修复视频的预览信息，无需其他操作。\n\n---\n\n## 🛠 How It Works / 工作原理\n\nFor each `.mp4` file:\n- Creates a temporary `.tmp_filename.mp4`\n- Copies streams using `-c copy` and adds `-tag:v hvc1`\n- Replaces original file only if successful\n\n对每个 `.mp4` 文件：\n- 创建一个临时文件 `.tmp_文件名.mp4`\n- 用 `-c copy` 保留内容，仅添加 `hvc1` 标签\n- 成功后替换原文件，失败则不影响原文件\n\n---\n\n## 📁 File Overview / 文件说明\n\n| 文件 | 说明 |\n|------|------|\n| `hevc-fix-preview.sh` | 终端运行脚本，支持批量处理 |\n| `HEVC Preview Fix.workflow` | 可右键运行的 macOS 快捷操作 |\n| `README.md` | 使用说明（中英文）|\n\n---\n\n## 📄 License / 许可证\n\nMIT License — free to use, modify, and distribute.  \nMIT 协议，允许自由使用、修改和分发。\n\n欢迎 Star / Fork / PR！\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruanweiming%2Fhevc-preview-fix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fruanweiming%2Fhevc-preview-fix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruanweiming%2Fhevc-preview-fix/lists"}