Una biblioteca de Swift que envuelve Core Data de Apple con una API segura en cuanto a tipos y concurrencia para apps de iOS, macOS, watchOS y tvOS.
4 mil257SwiftMITActualizado el mes pasado
sindresorhus/KeyboardShortcuts
Paquete de Swift para añadir atajos de teclado globales personalizables por el usuario a apps de macOS, con una interfaz de grabación lista para usar.
- Estrellas
- 2,734
- Forks
- 253
- Issues abiertos
- 3
- Último commit
- hace 2 meses
¿Qué es?
KeyboardShortcuts es un paquete de Swift para apps de macOS que necesitan atajos de teclado globales que el usuario pueda cambiar. Define un atajo con nombre una sola vez, añade una vista de grabación de SwiftUI o Cocoa a la pantalla de ajustes y registra un controlador para los eventos de pulsación o liberación de tecla. El paquete guarda el atajo elegido en UserDefaults y avisa al usuario si la combinación ya está en uso por el sistema o por el menú principal de la app.
El paquete está aislado y es compatible con la Mac App Store; además, no muestra diálogos de permisos. También incluye utilidades para mostrar un atajo grabado en un NSMenuItem, convertir los indicadores de modificadores en símbolos, escuchar atajos definidos de forma fija y repetir acciones mientras se mantiene pulsada una tecla en macOS 13 o posterior.
Es compatible con macOS 10.15 y versiones posteriores y se instala mediante Swift Package Manager. Entre sus limitaciones, no admite teclas multimedia en apps aisladas ni permite escuchar la tecla Caps Lock mediante la API estándar.
Funciones clave
- 01Incluye una vista Recorder de SwiftUI y una vista RecorderCocoa de Cocoa para capturar atajos.
- 02Guarda automáticamente en UserDefaults los atajos elegidos por el usuario.
- 03Avisa sobre conflictos con los atajos del sistema y el menú principal de la app.
- 04Permite escuchar eventos de pulsación y liberación de tecla.
- 05Permite asociar un atajo grabado a un NSMenuItem.
- 06Se instala mediante Swift Package Manager.
Casos de uso
- Añadir una tecla de acceso rápido global configurable por el usuario a una utilidad de la barra de menús.
- Permitir que los usuarios personalicen los atajos en la ventana de preferencias de una app de macOS.
- Añadir atajos dentro de la app que los usuarios puedan grabar y guardar con su propio sistema de almacenamiento.
Inicio rápido
- 1
Añade el paquete en Xcode, desde la pestaña Swift Package Manager, usando la URL del repositorio
- 2
Registra un nombre para el atajo y luego añade una vista Recorder a la pantalla de ajustes
- 3
Detecta el atajo con onKeyUp o onKeyDown
Antes de usarlo
- Solo funciona en macOS 10.15 y versiones posteriores, así que no está disponible para otras plataformas.
- Los atajos globales usan las API de Carbon, que Apple no ha sustituido, y las teclas multimedia no son compatibles con las apps en sandbox.
En colecciones
Temas
#macos#swift#keyboard-shortcuts#hotkey#swiftui#swift-package-manager#carthage#cocoapods#swift-package#swiftui-components
Preguntas frecuentes
- ¿Qué es KeyboardShortcuts?
- Paquete de Swift para añadir atajos de teclado globales personalizables por el usuario a apps de macOS, con una interfaz de grabación lista para usar. KeyboardShortcuts es un paquete de Swift para apps de macOS que necesitan atajos de teclado globales que el usuario pueda cambiar. Define un atajo con nombre una sola vez, añade una vista de grabación de SwiftUI o Cocoa a la pantalla de ajustes y registra un controlador para los eventos de pulsación o liberación de tecla. El paquete guarda el atajo elegido en UserDefaults y avisa al usuario si la combinación ya está en uso por el sistema o por el menú principal de la app.
- ¿KeyboardShortcuts es gratuito? ¿Qué licencia tiene?
- KeyboardShortcuts es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿KeyboardShortcuts sigue mantenido?
- Actualizado en los últimos 6 meses. El último commit de KeyboardShortcuts fue el 11 sept 2026.
- ¿Para qué puedo usar KeyboardShortcuts?
- Añadir una tecla de acceso rápido global configurable por el usuario a una utilidad de la barra de menús. Permitir que los usuarios personalicen los atajos en la ventana de preferencias de una app de macOS. Añadir atajos dentro de la app que los usuarios puedan grabar y guardar con su propio sistema de almacenamiento.
- ¿Cómo se instala KeyboardShortcuts?
- Añade el paquete en Xcode, desde la pestaña Swift Package Manager, usando la URL del repositorio Registra un nombre para el atajo y luego añade una vista Recorder a la pantalla de ajustes Detecta el atajo con onKeyUp o onKeyDown
- ¿Dónde consigo KeyboardShortcuts?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/sindresorhus/KeyboardShortcuts
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Framework de logging para plataformas Apple (macOS, iOS, tvOS, watchOS y visionOS) que envía mensajes a varios loggers, como la consola, archivos y backends personalizados.
13,3 mil+2 esta semana2,3 milObjective-CBSD-3-ClauseActualizado hace 24 horas
Elegante biblioteca de networking HTTP para Swift, basada en URLSession, con solicitudes encadenables, codificación, cargas, descargas y validación de respuestas.
42,4 mil+1 esta semana7,6 milSwiftMITActualizado hace 5 días
Colección de más de 500 extensiones nativas de Swift que añaden métodos prácticos a tipos de la biblioteca estándar, Foundation y UIKit/AppKit.
15,2 mil1,7 milSwiftMITActualizado hace 3 días
Biblioteca de Swift que simplifica el análisis y la creación de datos JSON al envolver objetos JSON sin procesar en una API segura en cuanto a tipos y sin opcionales.
22,9 mil3,4 milSwiftMITActualizado hace 3 meses
Un contenedor de cuadrícula para SwiftUI inspirado en CSS Grid, con pistas flexibles, fijas o ajustadas al contenido, elementos que abarcan varias pistas y posicionamiento explícito.
2,1 mil+1 esta semana100SwiftMITActualizado hace 2 meses