sindresorhus/KeyboardShortcuts

O que é?

Recursos principais

• 01Oferece uma view Recorder em SwiftUI e uma view Cocoa RecorderCocoa para capturar atalhos.
• 02Armazena automaticamente em UserDefaults os atalhos escolhidos pelos usuários.
• 03Avisa sobre conflitos com atalhos do sistema e com o menu principal do app.
• 04Permite monitorar eventos de pressionamento e soltura de tecla.
• 05Permite associar um atalho gravado a um NSMenuItem.
• 06É instalado pelo Swift Package Manager.

Casos de uso

• Adicionar um atalho global configurável pelo usuário a um utilitário da barra de menus.
• Permitir que usuários personalizem atalhos na janela de preferências de um app para macOS.
• Adicionar atalhos no app que os usuários possam gravar e armazenar usando seu próprio mecanismo de armazenamento.

Início rápido

1. 1

   Adicione o pacote no Xcode pela aba Swift Package Manager usando a URL do repositório

2. 2

   Registre um nome para o atalho e depois adicione uma visualização Recorder à tela de ajustes

3. 3

   Detecte o atalho com onKeyUp ou onKeyDown

Antes de usar

• !Funciona apenas no macOS 10.15 ou posterior, portanto não está disponível para outras plataformas.
• !Os atalhos globais usam APIs Carbon, que a Apple não substituiu, e teclas de mídia não são compatíveis com apps em sandbox.

Em coleções

Tópicos

Perguntas frequentes

O que é KeyboardShortcuts?

Um pacote Swift que permite a apps para macOS adicionar atalhos de teclado globais personalizáveis, com uma interface pronta para gravá-los. KeyboardShortcuts é um pacote Swift para apps para macOS que precisam de atalhos de teclado globais que o usuário possa alterar. Você define um atalho nomeado uma vez, adiciona uma interface de gravação em SwiftUI ou Cocoa à tela de ajustes e registra um handler para eventos de pressionamento ou soltura de tecla. O pacote armazena o atalho escolhido em UserDefaults e avisa o usuário quando uma combinação já está em uso pelo sistema ou pelo menu principal do app.

KeyboardShortcuts é gratuito? Qual é a licença?

KeyboardShortcuts é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

KeyboardShortcuts ainda é mantido?

Atualizado nos últimos 6 meses. O último commit de KeyboardShortcuts foi em 11 de set. de 2026.

Para que posso usar KeyboardShortcuts?

Adicionar um atalho global configurável pelo usuário a um utilitário da barra de menus. Permitir que usuários personalizem atalhos na janela de preferências de um app para macOS. Adicionar atalhos no app que os usuários possam gravar e armazenar usando seu próprio mecanismo de armazenamento.

Como instalar KeyboardShortcuts?

Adicione o pacote no Xcode pela aba Swift Package Manager usando a URL do repositório Registre um nome para o atalho e depois adicione uma visualização Recorder à tela de ajustes Detecte o atalho com onKeyUp ou onKeyDown

Onde consigo KeyboardShortcuts?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/sindresorhus/KeyboardShortcuts