Keyhac

Keyhac이란?

Keyhac은 Python 스크립트를 사용하여 키보드 동작을 완전히 제어할 수 있는 키보드 커스터마이징 도구입니다. 시스템 전체에서 키 입력을 감시하여, 사용자가 원하는 대로 키를 재할당하거나 특정 기능을 실행하도록 설정할 수 있습니다. Windows와 macOS에서 동일한 설정 파일을 사용할 수 있어, 두 운영체제를 오가는 사용자에게 편리합니다.

주요 기능

• 키 리매핑: 원하는 키를 다른 키로 변경하거나, 특정 키 조합을 새로운 동작으로 정의할 수 있습니다.
• Python 함수 바인딩: 키 입력을 Python 함수에 연결하여 복잡한 작업을 자동화할 수 있습니다.
• 시스템 전체 후킹: 모든 응용 프로그램에서 키 입력을 감지하고 처리합니다.
• 클립보드 및 창 제어: 키보드만으로 클립보드 내용을 관리하거나 창을 전환하는 등의 작업을 수행할 수 있습니다.
• AI 지원 (선택 사항): AI 어시스턴트를 연결하면 화면을 읽고 실제 UI에 대한 Python 액션을 생성하고 테스트하여 자동화 스크립트 작성을 도와줍니다.

지원 환경

Windows 10/11 (x64) 및 macOS 15 이상을 지원합니다. Windows에서는 Microsoft Store 또는 winget 명령어로 설치하거나, GitHub Releases에서 zip 파일을 다운로드하여 실행할 수 있습니다. macOS에서는 dmg 파일을 다운로드하여 설치하고, 키보드 후킹을 위해 접근성 권한을 부여해야 합니다.

기본 사용법

1. Keyhac을 설치하고 실행합니다.
2. 설정 파일 ~/.keyhac/config.py를 생성합니다.
3. Python 코드로 키 리매핑이나 함수 바인딩을 정의합니다.
4. Keyhac을 재시작하거나 설정을 다시 로드하여 변경 사항을 적용합니다.

예를 들어, Caps Lock을 한/영 전환 키로 사용하거나, 특정 단축키로 자주 사용하는 프로그램을 실행하는 스크립트를 작성할 수 있습니다.

제한 사항 및 주의사항

• Python 스크립트 작성이 필요하므로, 프로그래밍에 익숙하지 않은 사용자에게는 다소 어려울 수 있습니다.
• 시스템 전체 키보드 후킹은 관리자 권한이 필요할 수 있으며, 일부 보안 소프트웨어와 충돌할 가능성이 있습니다.
• macOS에서는 접근성 권한을 반드시 허용해야 정상 동작합니다.
• AI 지원 기능은 선택 사항이며, 사용하려면 별도의 AI 어시스턴트 연결이 필요합니다.

자주 묻는 질문

Q: Keyhac은 무료인가요?

네, Keyhac은 무료로 제공됩니다. Microsoft Store에서 무료로 다운로드할 수 있으며, GitHub에서 소스 코드도 공개되어 있습니다.

Q: Windows와 macOS에서 동일한 설정을 사용할 수 있나요?

네, 설정 파일 config.py는 두 운영체제에서 동일하게 동작하도록 설계되었습니다.

Q: 키보드 리매핑 외에 어떤 작업을 할 수 있나요?

Python 함수를 바인딩하여 클립보드 관리, 창 전환, 응용 프로그램 실행 등 다양한 작업을 자동화할 수 있습니다.

Q: 설치 후 키 입력이 반응하지 않으면 어떻게 하나요?

먼저 설정 파일에 오류가 없는지 확인하고, Keyhac을 재시작해 보세요. macOS에서는 접근성 권한이 허용되었는지 확인하세요.