Boring Notch
<h1 align="center"><br><a href="http://thebored.name"><img src="https://framerusercontent.com/images/RFK4vs0kn8pRMuOO58JeyoemXA.png?scale-down-to=256" alt="Boring Notch" width="150"></a><br>Boring Notch<br></h1>
<p align="center"><a title="Crowdin" target="_blank" href="https://crowdin.com/project/boring-notch"><img src="https://badges.crowdin.net/boring-notch/localized.svg"></a><img src="https://github.com/TheBoredTeam/boring.notch/actions/workflows/cicd.yml/badge.svg" alt="TheBoringNotch Build & Test" style="margin-right: 10px;" /><a href="https://discord.gg/c8JXA7qrPm"><img src="https://dcbadge.limes.pink/api/server/https://discord.gg/c8JXA7qrPm?style=flat" alt="Discord Badge" /></a></p>
让 MacBook 的刘海屏成为视觉焦点！告别单调的状态栏，Boring Notch 将其转变为动态的音乐控制中心，配备炫酷的可视化频谱和完整的音乐控制功能。但这仅仅是个开始，它还集成了日历、支持 AirDrop 的文件架等更多实用功能！
<p align="center"><img src="https://github.com/user-attachments/assets/2d5f69c1-6e7b-4bc2-a6f1-bb9e27cf88a8" alt="Demo GIF" /></p>
功能特性
动态音乐控制中心：将刘海屏区域变为集播放、暂停、切歌等功能于一体的控制面板。
音频可视化：在刘海屏处实时显示正在播放音乐的动态频谱效果。
媒体信息显示：展示当前播放歌曲的标题、艺术家等元数据。
日历集成：在状态栏区域便捷查看日程安排。
文件架功能：提供快速文件访问入口，并支持 AirDrop。
媒体远程控制适配：提供底层的媒体控制接口，支持获取播放状态、发送控制命令（如播放、暂停）、设置播放速度、随机/循环模式等。
国际化支持：通过 Crowdin 进行多语言本地化。
安装指南
项目采用持续集成/持续部署（CI/CD）流程，具体安装方法建议参考 GitHub Actions 工作流或项目发布的版本。
依赖项与系统要求
使用说明
项目包含一个名为 mediaremote-adapter.pl 的 Perl 脚本，作为与 macOS MediaRemote 框架交互的适配器测试工具。
适配器脚本基本用法
运行脚本时不带参数或使用错误参数会显示帮助信息：
脚本参数说明：
FRAMEWORK_PATH: MediaRemoteAdapter.framework 目录的绝对路径（必需）。
TEST_CLIENT_PATH: MediaRemoteAdapterTestClient 可执行文件的绝对路径（仅 test 功能需要）。
FUNCTION: 要执行的功能。
PARAMS / OPTIONS: 功能所需的参数或选项。
功能与命令示例
测试适配器权限 (test):检查适配器是否有权使用 MediaRemote 框架。返回非零退出码表示功能异常。
./mediaremote-adapter.pl /path/to/framework /path/to/testclient test
复制代码
获取当前播放信息 (get):一次性打印所有可用的播放元数据。
./mediaremote-adapter.pl /path/to/framework get
复制代码
* **选项 `--now`**: 添加一个 `elapsedTimeNow` 键，估算当前已播放时间（可能有最多1秒误差）。* **选项 `--micros`**: 将时间相关的键值（如 `elapsedTime`, `duration`）以微秒为单位输出，而不是默认的秒。
复制代码
流式输出播放信息 (stream):持续监听并输出播放信息的变化（默认显示差异）。
./mediaremote-adapter.pl /path/to/framework stream
复制代码
* **选项 `--no-diff`**: 禁用差异对比，每次都完整输出所有元数据。* **选项 `--debounce=N`**: 设置防抖延迟（毫秒），防止输出过于频繁（默认为0）。
复制代码
发送控制命令 (send):向正在播放的应用发送命令（如播放、暂停）。
./mediaremote-adapter.pl /path/to/framework send 0 # 例如，发送播放命令 (kMRPlay = 0)
复制代码
控制播放状态:
跳转到指定位置 (seek):
./mediaremote-adapter.pl /path/to/framework seek 30000000 # 跳转到30秒（30000000微秒）处
复制代码
* **设置随机播放模式** (`shuffle`):
复制代码
./mediaremote-adapter.pl /path/to/framework shuffle off
复制代码
./mediaremote-adapter.pl /path/to/framework repeat one
复制代码
./mediaremote-adapter.pl /path/to/framework speed 1.5 # 设置为1.5倍速
复制代码
核心代码
以下为项目中的媒体远程适配器核心脚本，用于与 macOS 媒体框架交互。
mediaremote-adapter.pl 脚本核心部分
#!/usr/bin/perl# Copyright (c) 2025 Jonas van den Berg# 本文件遵循 BSD 3-Clause 许可证。# 使用信息请阅读下方说明或无参数运行本脚本。
use strict;use warnings;use DynaLoader;use File::Spec;use File::Basename;
# 打印帮助信息函数sub print_help() { print <<'HELP';Usage: mediaremote-adapter.pl FRAMEWORK_PATH [TEST_CLIENT_PATH] [FUNCTION [PARAMS|OPTIONS...]]
FRAMEWORK_PATH: Absolute path to the MediaRemoteAdapter.framework directory
TEST_CLIENT_PATH: (optional) Absolute path to the MediaRemoteAdapterTestClient executable. Only for "test"
FUNCTION: stream Streams now playing information (as diff by default) get Prints now playing information once with all available metadata send Sends a command to the now playing application seek Seeks to a specific timeline position shuffle Sets the shuffle mode repeat Sets the repeat mode speed Sets the playback speed test Tests if the adapter is entitled to use the MediaRemote framework. An exit code other than 0 indicates the adapter is non-functional
PARAMS: send(command) command: The MRCommand ID as a number (e.g. kMRPlay = 0) seek(position) position: The timeline position in microseconds shuffle(mode) mode: The shuffle mode repeat(mode) mode: The repeat mode speed(speed) speed: The playback speed
OPTIONS: get --now: Adds an "elapsedTimeNow" key with an estimation of the current elapsed playback time. This estimation may be off by up to a second. To determine a more accurate time without polling "get" continuously, calculate it using the "elapsedTime" and "timestamp" keys. "elapsedTime" contains the elapsed time at the time that is stored in "timestamp". stream --no-diff: Disable diffing and always dump all metadata --debounce=N: Delay in milliseconds to prevent spam (0 by default) get, stream --micros: Replaces the following time-related keys' unit from seconds to microseconds: elapsedTime, elapsedTimeNow, durationHELP}
# 脚本主逻辑从这里开始...# (此处应包含参数解析、功能分发以及与框架交互的具体实现代码)
复制代码
安全策略
Bored Team 及社区高度重视 Boring Notch 中的安全漏洞。我们感谢您负责任地披露发现的问题，并将尽力认可您的贡献。
报告漏洞：请使用 GitHub 安全公告中的 "报告漏洞" 选项卡。
团队会回复您并说明处理报告的后续步骤。在初步回复后，我们将向您通报修复进度和完整公告，并可能要求提供更多信息或指导。
第三方依赖漏洞：请将第三方依赖包中发现的安全漏洞报告给维护该包或依赖的个人或团队。更多精彩内容 请关注我的个人公众号 公众号（办公 AI 智能小助手）对网络安全、黑客技术感兴趣的朋友可以关注我的安全公众号（网络安全技术点滴分享）
公众号二维码
办公AI智能小助手
公众号二维码
网络安全技术点滴分享
评论