Skip to content
This repository was archived by the owner on Oct 22, 2025. It is now read-only.

MiPoNianYou/macOS-Enhancer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Hammerspoon Logo

Config For Hammerspoon
Made By MiPoNianYou
Inspiration From twricu

Stargazers Issues Contributors

当前语言-简体中文 切換到繁體中文 Switch To English

⚙️ 为 macOS 注入更高效的工作流与个性化体验 ⚙️
让每一次操作都如丝般顺滑 让每一次切换都且恰到好处

✨ 功能全景

🪄 核心特性概览

  • 💡 大写键超级进化 - 将不常用的 Caps Lock 键转变为强大的功能修饰键 重映射为 F13 释放无限快捷可能
  • 🚀 应用快速启动器 - 使用 ⇪ + 特定字母 快速启动或聚焦常用应用程序
  • ⌨️ 循环切换输入法 - 告别复杂的组合键 只需轻点 Shift ⇧ 键 即可轻松在输入法间流畅循环切换 且不影响长按或其他组合快捷键
  • ☕️ 系统防休眠守护 - 通过 ⇪ + ⌃ + P 快捷键 一键切换系统休眠状态 菜单栏将同步显示 ☕️ 图标作为提示
  • 🔊 输出设备切换器 - 通过 ⇪ + ⌃ + A 快捷键 在已连接的音频输出设备间即时循环切换 无论是内置输出 / 蓝牙耳机还是外接音响 一键流转
  • 📑 软件标签页导航 - 在支持上下页的软件中 使用 ⇪ + ←⇪ + → 在软件内标签页间自如穿梭
  • ✍️ Markdown模式 - 组合 ⇪ + ⌥ + 特定按键 让 Markdown 书写行云流水 无需再为中英文切换所扰 无论是 强调重点 / 轻盈斜体 / 划去旧痕 / 抑或嵌入代码片段与构建链接锚点 皆能轻松实现 一切尽在指尖 一气呵成
  • 🎵 菜单栏乐曲随行 - 在菜单栏即时捕获并显示 Spotify/Apple Music 正在播放的曲目与艺人信息 通过 ⇪ + ⌃ + S 快捷键 随心控制其显隐
  • 🔄 配置档自动更新 - 配置启动时及每隔24小时 脚本将自动静默检查云端上的最新版本 若有更新将通过通知提醒 亦可通过 ⌘ + ⌥ + ⌃ 手动触发检查 时刻保持最新体验
  • 🔃 配置即时热重载 - 使用 ⌘ + ⌥ + ⌃ + R 快捷键 无需手动点击 Hammerspoon 即可即时应用配置更改
  • 🧰 个性化功能定制 - 随心定制专属体验 无论是快捷键绑定 还是各项增强功能 均可轻松调整或禁用 打造最适合个人的工作流

⌨️ 快捷按键指南

⌨️ 按键组合 ⚡️ 功能描述
Shift ⇧ 循环切换 输入法
⇪ + I 启动/聚焦 系统设置
⇪ + F 启动/聚焦 访达
⇪ + T 启动/聚焦 终端
⇪ + A 启动/聚焦 Arc 浏览器
⇪ + S 启动/聚焦 Spotify
⇪ + V 启动/聚焦 VS Code
⇪ + G 启动/聚焦 Telegram
⇪ + ⌃ + P 开启/关闭 系统防休眠 模式
⇪ + ⌃ + A 循环切换 音频输出设备
⇪ + ← 切换到 上一个 标签页(需软件支持)
⇪ + → 切换到 下一个 标签页(需软件支持)
⇪ + ⌥ + Q Markdown 格式化 - 套引用块
⇪ + ⌥ + B Markdown 格式化 - 加粗文本
⇪ + ⌥ + I Markdown 格式化 - 斜体文本
⇪ + ⌥ + S Markdown 格式化 - 删除文本
⇪ + ⌥ + K Markdown 格式化 - 代码语法
⇪ + ⌥ + L Markdown 格式化 - 链接语法
⇪ + ⌃ + S 开启/关闭 菜单栏乐曲随行
⌘ + ⌥ + ⌃ + U 手动检查 配置更新
⌘ + ⌥ + ⌃ + R 重载 Hammerspoon 配置

📖 使用教程

  1. 使用配置
  • 前往 Hammerspoon 官方网站 下载并安装
  • 安装后 Hammerspoon 🔨 图标会出现在菜单栏中 标志着一切准备就绪

  1. 导入配置

选择任一方式以运用配置文件

  • 通过菜单

    • 点按菜单栏中的 🔨 图标
    • 选择 「Open Config」
    • 将提供的 init.lua 内容拷贝粘贴到打开的配置文件中并存储
  • 通过访达

    • 打开 Finder
    • 选择「前往」菜单中的「前往文件夹」/ 或使用快捷键 Command + Shift + G
    • 输入路径 ~/.hammerspoon/ 并点击前往
    • 将下载的 init.lua 文件直接拖入此文件夹内

  1. 激活配置
  • 完成配置后 再次点按菜单栏中的 🔨 图标 并选择 「Reload Config」
  • Hammerspoon 会弹出配置加载成功通知 各种增强功能随之生效

  1. 修改配置
  • 定制启动

    • 在配置文件中查找 CAPSLOCK_APP_SHORTCUTS 配置表 即可自定个人偏爱的快捷键与应用程式 打造专属于自己的个性化捷径
    • key - 定义按下 后 希望激活应用的快捷键
    • appName - 指定个人所需的应用程式名称
  • 调整功能

    • 导航至 配置初始化与快捷键绑定 模块 各项功能均有清晰的功能标注
    • 通过在相应调用代码行前添加/移除 -- > 即可便携地禁用或重新启用特定功能

📮 投递反馈

😡 脚本寄了飞到Issues开骂

🌠 功能许愿飞到Discussions祈祷

Footer Line

Copyright © 2025 念柚

License-AGPL3.0

About

Supercharge Your macOS - Config For Hammerspoon

Topics

Resources

License

Stars

Watchers

Forks

Languages