{"id":51215887,"url":"https://github.com/superuser-fank/boring-notch-cn","last_synced_at":"2026-06-28T04:01:06.397Z","repository":{"id":362666808,"uuid":"1260232507","full_name":"Superuser-fank/boring-notch-cn","owner":"Superuser-fank","description":"Boring Notch CN: unofficial GPLv3 fork for Chinese macOS users","archived":false,"fork":false,"pushed_at":"2026-06-27T15:58:22.000Z","size":5074,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-27T17:22:57.456Z","etag":null,"topics":["boring-notch","chinese-localization","gplv3","macos","macos-app","media-controller","notch","swift","swiftui"],"latest_commit_sha":null,"homepage":"https://github.com/Superuser-fank/boring-notch-cn/releases/latest","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Superuser-fank.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["Alexander5015","iamharshdev"],"ko-fi":"alexander5015"}},"created_at":"2026-06-05T09:27:43.000Z","updated_at":"2026-06-27T15:58:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Superuser-fank/boring-notch-cn","commit_stats":null,"previous_names":["superuser-fank/boringnotch-netease","superuser-fank/boring-notch-cn"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/Superuser-fank/boring-notch-cn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Superuser-fank%2Fboring-notch-cn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Superuser-fank%2Fboring-notch-cn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Superuser-fank%2Fboring-notch-cn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Superuser-fank%2Fboring-notch-cn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Superuser-fank","download_url":"https://codeload.github.com/Superuser-fank/boring-notch-cn/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Superuser-fank%2Fboring-notch-cn/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34876271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-28T02:00:05.809Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["boring-notch","chinese-localization","gplv3","macos","macos-app","media-controller","notch","swift","swiftui"],"created_at":"2026-06-28T04:01:05.444Z","updated_at":"2026-06-28T04:01:06.387Z","avatar_url":"https://github.com/Superuser-fank.png","language":"Swift","funding_links":["https://github.com/sponsors/Alexander5015","https://github.com/sponsors/iamharshdev","alexander5015"],"categories":[],"sub_categories":[],"readme":"# Boring Notch CN\n\n[![Build Boring Notch CN](https://github.com/Superuser-fank/boring-notch-cn/actions/workflows/cicd.yml/badge.svg)](https://github.com/Superuser-fank/boring-notch-cn/actions/workflows/cicd.yml)\n[![Release](https://img.shields.io/github/v/release/Superuser-fank/boring-notch-cn?display_name=tag\u0026sort=semver)](https://github.com/Superuser-fank/boring-notch-cn/releases)\n[![License: GPLv3](https://img.shields.io/badge/License-GPLv3-blue.svg)](./LICENSE)\n\nBoring Notch CN 是 [Boring Notch](https://github.com/TheBoredTeam/boring.notch) 的公开源码 fork，面向中文用户做了设置页汉化，并增加了网易云音乐、QQ 音乐、中国日历信息、国内常用聊天应用快捷投递等本地体验优化。\n\n本项目不是 TheBoredTeam 官方发布，也不是任何音乐或聊天服务的官方客户端、插件或合作项目。`网易云音乐`、`QQ 音乐`、`Apple Music`、`Spotify`、`YouTube Music`、`微信`、`QQ`、`钉钉`、`飞书` 等名称仅用于说明兼容的媒体来源或可投递目标；本项目与这些第三方服务没有从属、授权、背书或赞助关系。\n\n## 下载\n\n最新版本请到 [GitHub Release](https://github.com/Superuser-fank/boring-notch-cn/releases) 下载。\n\n当前公开构建使用 Apple Development 证书签名，但未进行 Developer ID notarization。首次打开如果被 macOS Gatekeeper 拦截，安装后可以执行：\n\n```bash\nxattr -dr com.apple.quarantine \"/Applications/Boring Notch CN.app\"\n```\n\n## 主要变化\n\n- 设置页简体中文本地化。\n- 媒体来源增加网易云音乐和 QQ 音乐。\n- 首次选择音乐来源和设置页音乐来源按中文用户常用顺序展示；在系统通用“正在播放”不可用时，会优先选择本机已安装的网易云音乐或 QQ 音乐。\n- 音乐来源选择会显示“推荐”“已安装”“未检测到”“通用”等中文状态，方便判断本机适合选择哪个播放器。\n- 媒体设置页增加诊断卡片、“复制诊断信息”和中文建议处理步骤，帮助检查播放器运行状态、正在播放数据、控制能力和关键权限状态。\n- 通用设置页增加中文“权限与安装自检”，可查看辅助功能、日历、提醒事项、相机权限状态，并处理 Gatekeeper 拦截。\n- 关于页增加“下载与安装”入口，可打开 GitHub Release 下载页并复制解除 macOS 拦截命令。\n- 状态栏菜单增加 Release 下载页、GitHub 项目和解除拦截命令入口；设置窗口标题改为中文。\n- 首次欢迎页显示中文非官方 fork 说明，避免误认为 TheBoredTeam 官方发布或付费 Pro 版本。\n- 日历增加中文月份/星期、农历、常见中国节日、2026 年中国法定休假和补班提示，可在设置页关闭。\n- 文件架快速分享增加微信、QQ、钉钉、飞书快捷投递，并补充隔空投送、系统分享菜单的中文显示和操作提示；聊天应用投递会复制到剪贴板并打开对应应用，需要手动选择联系人和发送。\n- 首次启动引导、更新弹窗、提示卡、菜单栏、刘海快捷菜单、权限授权说明、软件更新、媒体控制布局、媒体来源选项、电池/HUD/下载提示、文件架空状态、文件架操作菜单和图片处理弹窗改为中文。\n- 保留原版 Boring Notch 的刘海交互、媒体控制、日历、提醒事项、电池、HUD、文件架等能力。\n- Release 包和 App 显示名使用 `Boring Notch CN`，主品牌名不包含第三方服务名称。\n\n## 反馈问题\n\n- 普通问题或功能建议：请到 [Issues](https://github.com/Superuser-fank/boring-notch-cn/issues) 按模板提交。\n- 使用前先看 [SUPPORT.md](./SUPPORT.md)，其中列出了安装拦截、权限和媒体来源的常见处理方式。\n- 安全问题请看 [SECURITY.md](./SECURITY.md)，不要在公开 Issue 中直接贴可利用细节。\n\n## 系统要求\n\n- macOS 14 Sonoma 或更新版本。\n- Apple Silicon 或 Intel Mac。\n- 需要按功能授予辅助功能、日历、提醒事项等系统权限。\n\n## 安装\n\n1. 从 Release 页面下载 `BoringNotchCN-2.7.3-unnotarized.dmg`。\n2. 打开 DMG。\n3. 将 `Boring Notch CN.app` 拖入 `/Applications`。\n4. 如果 macOS 阻止启动，执行上面的 `xattr` 命令后重新打开。\n\n## 从源码构建\n\n准备环境：\n\n- Xcode 16 或更新版本。\n- macOS 14 或更新版本。\n\n构建未 notarize 的 DMG：\n\n```bash\nDEVELOPMENT_TEAM=YOURTEAMID UNNOTARIZED=1 ./scripts/build_release.sh\n```\n\n构建产物会输出到 `dist/`。\n\n如果你有付费 Apple Developer Program 和 Developer ID Application 证书，可以参考 [RELEASE.md](./RELEASE.md) 进行 Developer ID 签名和 notarization。\n\n## 开源许可证\n\n本项目基于 Boring Notch 修改，继续遵循 GPLv3 发布。\n\n- GPLv3 许可证全文：[LICENSE](./LICENSE)\n- 对应源码：\u003chttps://github.com/Superuser-fank/boring-notch-cn/tree/v2.7.3-cn.23\u003e\n- 第三方声明：[THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md)\n- 第三方许可证原文：[THIRD_PARTY_LICENSES](./THIRD_PARTY_LICENSES)\n\n如果你分发二进制包，需要同时提供对应源码、保留 GPLv3 许可声明，并保留第三方项目的许可和署名。\n\n## 第三方项目\n\n本项目直接或间接使用了多个开源项目，包括但不限于：\n\n- Boring Notch：上游项目。\n- MediaRemoteAdapter：用于 macOS 15.4+ 的 Now Playing 媒体信息适配。\n- NotchDrop：原版 Shelf 功能的重要参考项目。\n- Sparkle、Lottie、Defaults、KeyboardShortcuts、LaunchAtLogin、AsyncXPCConnection、Swift Collections、Swift Syntax、SwiftUI Introspect、SkyLightWindow、Pow、MacroVisionKit 等 Swift Package 依赖。\n\n完整说明见 [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md)。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperuser-fank%2Fboring-notch-cn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuperuser-fank%2Fboring-notch-cn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperuser-fank%2Fboring-notch-cn/lists"}