sindresorhus/KeyboardShortcuts

어떤 프로젝트인가요?

핵심 기능

• 01단축키를 입력받는 SwiftUI Recorder 뷰와 Cocoa RecorderCocoa 뷰를 제공합니다.
• 02사용자가 선택한 단축키를 UserDefaults에 자동으로 저장합니다.
• 03시스템 단축키 및 앱의 메인 메뉴와 충돌하는 경우 사용자에게 알립니다.
• 04키를 누르거나 뗄 때 발생하는 이벤트를 감지합니다.
• 05녹화한 단축키를 NSMenuItem에 연결할 수 있습니다.
• 06Swift Package Manager로 설치합니다.

활용 사례

• 메뉴 막대 유틸리티에 사용자가 설정할 수 있는 전역 단축키를 추가합니다.
• macOS 앱의 환경설정 창에서 사용자가 단축키를 변경할 수 있도록 합니다.
• 사용자가 직접 녹화하고 앱 자체 저장소에 저장할 수 있는 앱 내 단축키를 추가합니다.

빠른 시작

1. 1

   저장소 URL을 사용해 Xcode의 Swift Package Manager 탭에서 패키지를 추가합니다

2. 2

   단축키 이름을 등록한 다음 설정 화면에 Recorder 뷰를 추가합니다

3. 3

   onKeyUp 또는 onKeyDown으로 단축키 입력을 감지합니다

사용 전 알아둘 점

• !macOS 10.15 이상에서만 작동하므로 다른 플랫폼에서는 사용할 수 없습니다.
• !전역 단축키는 Apple이 대체하지 않은 Carbon API를 사용하며, 샌드박스 앱에서는 미디어 키를 지원하지 않습니다.

포함된 컬렉션

토픽

자주 묻는 질문

KeyboardShortcuts은(는) 무엇인가요?

macOS 앱에 사용자가 직접 설정할 수 있는 전역 키보드 단축키와 바로 사용할 수 있는 녹화 UI를 추가하는 Swift 패키지입니다. KeyboardShortcuts는 사용자가 변경할 수 있는 전역 키보드 단축키가 필요한 macOS 앱을 위한 Swift 패키지입니다. 이름이 지정된 단축키를 한 번 정의하고, 설정 화면에 SwiftUI 또는 Cocoa 녹화 뷰를 추가한 뒤, 키를 누르거나 뗄 때 실행할 핸들러를 등록하면 됩니다. 패키지는 선택한 단축키를 UserDefaults에 저장하고, 시스템이나 앱의 메인 메뉴에서 이미 사용하는 조합이면 사용자에게 알립니다.

KeyboardShortcuts은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

KeyboardShortcuts은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

KeyboardShortcuts은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. KeyboardShortcuts의 마지막 커밋은 2026년 9월 11일입니다.

KeyboardShortcuts은(는) 어디에 사용할 수 있나요?

메뉴 막대 유틸리티에 사용자가 설정할 수 있는 전역 단축키를 추가합니다. macOS 앱의 환경설정 창에서 사용자가 단축키를 변경할 수 있도록 합니다. 사용자가 직접 녹화하고 앱 자체 저장소에 저장할 수 있는 앱 내 단축키를 추가합니다.

KeyboardShortcuts는 어떻게 설치하나요?

저장소 URL을 사용해 Xcode의 Swift Package Manager 탭에서 패키지를 추가합니다 단축키 이름을 등록한 다음 설정 화면에 Recorder 뷰를 추가합니다 onKeyUp 또는 onKeyDown으로 단축키 입력을 감지합니다

KeyboardShortcuts은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/sindresorhus/KeyboardShortcuts