Skip to content

ldnvnbl/micover

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MicOver

macOS Swift License Release

MicOver 是一款 macOS 语音输入工具,采用 Push-to-Talk 模式,让您可以在任何应用中快速进行语音输入。按住快捷键说话,松开即自动将识别结果输入到当前光标位置。


✨ 功能特性

核心功能

  • Push-to-Talk 语音输入 - 按住快捷键说话,松开即自动输入文字
  • 全局快捷键 - 支持 Fn 键和自定义组合键,在任何应用中都可使用
  • 实时语音识别 - 基于 WebSocket 的流式语音识别,响应迅速
  • 自动粘贴 - 识别结果自动粘贴到当前光标位置

智能功能

  • 智能短语 - 设置触发词自动执行操作(打开应用、输入预设文本)
  • Over 命令 - 说 "over" 结尾自动发送回车键
  • 历史记录 - 查看所有语音输入历史和统计数据

界面功能

  • 悬浮窗口 - 实时显示录音状态和识别结果
  • 今日统计 - 录音次数、使用时长、转写字数等数据统计
  • 深色模式 - 完美支持 macOS 深色模式

📥 安装

下载安装(推荐)

  1. 前往 Releases 页面
  2. 下载最新版本的 MicOver_x.x.dmg
  3. 打开 DMG 文件,将 MicOver 拖入 Applications 文件夹
  4. 首次启动时,按提示授权麦克风和辅助功能权限

从源码构建

系统要求

  • macOS 14.0 (Sonoma) 或更高版本
  • Xcode 16.0 或更高版本
  • Swift 6.1

构建步骤

# 克隆仓库
git clone https://github.com/ldnvnbl/micover.git
cd micover

# 构建 Debug 版本
xcodebuild -workspace MicOver.xcworkspace -scheme macOS -configuration Debug build

# 或使用快捷脚本构建并运行
./run.sh

🔧 配置

权限设置

首次启动 MicOver 时,需要授权以下权限:

权限 用途
麦克风 录制语音进行识别
辅助功能 全局快捷键监听和自动粘贴文字

🔑 API Key 配置

重要:MicOver 使用 火山引擎 的语音识别服务,您需要自行申请 API Key 才能使用语音识别功能。

获取 API Key

  1. 访问 火山引擎控制台
  2. 注册或登录您的账号
  3. 开通「语音技术」-「语音识别」服务
  4. 创建应用并获取 App IDAccess Token

详细教程请参考 火山引擎语音识别文档

配置到 MicOver

  1. 打开 MicOver
  2. 进入「设置」页面
  3. 在「API 配置」区域填入您的 API Key
  4. 保存后即可使用语音输入功能

🚀 使用方法

基本使用

  1. 启动 MicOver,确保状态显示「已就绪」
  2. 将光标放在任意文本输入位置
  3. 按住 Fn 键(或您设置的快捷键)
  4. 开始说话
  5. 松开 快捷键,识别结果将自动输入

快捷键设置

  • 默认快捷键为 Fn
  • 可在「设置」→「快捷键」中修改为其他组合键(如 Option + Q)

智能短语

设置触发词实现快速操作:

触发词示例 操作
"打开浏览器" 启动 Safari
"我的邮箱" 输入预设的邮箱地址

Over 命令

在语音结尾说 "over",MicOver 会自动:

  1. 去掉 "over" 文字
  2. 发送回车键

适合在聊天应用中快速发送消息。


🛠️ 开发

项目结构

MicOver/
├── Shared/                    # 跨平台 SPM 库
│   └── Sources/Shared/
│       ├── Audio/             # 音频录制和转换
│       ├── Core/Storage/      # Keychain 和存储
│       └── SpeechRecognition/ # 语音识别服务
├── macOS/macOS/               # macOS 应用
│   ├── App/                   # 应用入口
│   ├── Services/              # 核心服务
│   ├── Views/                 # SwiftUI 视图
│   └── ViewModels/            # 视图模型
└── MicOver.xcworkspace        # Xcode 工作区

依赖项

版本 用途
KeychainAccess 4.2.2 安全存储 API Key
HotKey 0.2.1 全局快捷键监听
Alamofire 5.10.2 HTTP 网络请求

📄 开源协议

本项目采用 MIT License 开源协议。


🙏 致谢


📮 反馈

如有问题或建议,欢迎 提交 Issue

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •