# fn-music

**Repository Path**: doublez99/fn-music

## Basic Information

- **Project Name**: fn-music
- **Description**: No description available
- **Primary Language**: Swift
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-15
- **Last Updated**: 2026-08-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Fn Music Hold

按住 Mac 的 `Fn/🌐` 键时暂停音乐，松开 2.5 秒后继续播放。

Fn 事件采用 HID 层旁路监听，不会阻止豆包等其他应用继续使用 Fn。

## 下载

- [Fn-Music-Hold-Universal.dmg](./Fn-Music-Hold-Universal.dmg)（推荐）
- [Fn-Music-Hold-Universal.zip](./Fn-Music-Hold-Universal.zip)

应用包含 `arm64` 与 `x86_64` 两种架构，支持 Apple 芯片和 Intel Mac。

## 安装

1. 打开 DMG。
2. 将 `Fn Music Hold.app` 拖入 `Applications`。
3. 首次运行时右键应用并选择“打开”。
4. 在“系统设置 → 隐私与安全性”中开启：
   - 输入监控
   - 辅助功能
5. 重新打开应用，菜单栏出现 `Fn♫` 即表示正在运行。

## 行为

- 音乐正在播放：按下 Fn 时暂停，松开 2.5 秒后恢复。
- 音乐原本暂停：按下和松开 Fn 都不会触发播放。
- 延迟期间再次按 Fn：取消待执行的恢复。
- 菜单栏可开启或关闭“开机自动运行”。

## 重新打包

双击 `一键打包.command`，可重新生成：

- Universal `.app`
- ZIP
- 拖拽安装 DMG

打包需要 Xcode Command Line Tools：

```bash
xcode-select --install
```