Revoluciona tu experiencia con mouse y trackpad en macOS
Gestos avanzados, rendimiento optimizado, accesibilidad completa
📥 Descargar • 🚀 Características • 📖 Documentación • 🤝 Contribuir
BuenMouse transforma tu mouse y trackpad en herramientas de productividad avanzadas, añadiendo gestos intuitivos y funcionalidades que macOS debería tener por defecto. Con arquitectura de rendimiento optimizada y accesibilidad completa, es la solución perfecta para usuarios que buscan eficiencia sin sacrificar recursos del sistema.
- 🚄 Rendimiento Ultra-Rápido: Procesamiento de eventos en < 1ms con sistema de batching avanzado
- ♿ Accesibilidad Completa: Soporte total para VoiceOver y tecnologías asistivas
- ⚡ Ultra Liviano: < 15MB de memoria, < 0.1% CPU, cero impacto en batería
- 🎨 Interfaz Moderna: SwiftUI nativo con animaciones fluidas y tema dinámico
- ⌨️ Atajos de Teclado: Navegación completa por teclado (⌘+1/2/3, ⌘+Shift+M)
- 🔒 Privacidad Total: Cero telemetría, procesamiento 100% local
Convierte cualquier mouse en uno con scroll omnidireccional. Mantén Control + Click y arrastra para hacer scroll en cualquier dirección con precisión milimétrica.
Cambia entre espacios de trabajo con Click Derecho + Arrastre. Sistema adaptativo que aprende tu velocidad de navegación preferida.
Transforma los botones laterales de tu mouse en navegación universal. Funciona en navegadores, Finder, y aplicaciones compatibles.
Control + Scroll para zoom inteligente con aceleración adaptativa. Perfecto para diseño, desarrollo y navegación web.
- Barra de Estado Dinámica: Iconos que reflejan el estado actual con tooltips informativos
- Menú Contextual: Acceso rápido a configuraciones y controles
- Sensibilidad Adaptativa: Configuración granular de umbrales y timing
- Modo Oscuro: Seguimiento automático del sistema o configuración manual
# Descarga la versión más reciente
curl -L -o BuenMouse.dmg https://github.com/usuario/BuenMouse/releases/latest/download/BuenMouse.dmg
# Monta y copia a Aplicaciones
hdiutil attach BuenMouse.dmg
cp -R "/Volumes/BuenMouse/BuenMouse.app" "/Applications/"
hdiutil detach "/Volumes/BuenMouse"- Descarga: Ve a Releases y descarga la versión más reciente
- Instala: Arrastra
BuenMouse.appa tu carpetaAplicaciones - Permisos: Otorga permisos de accesibilidad cuando se solicite
- ¡Listo!: Busca el ícono de cursor en tu barra de menú
BuenMouse necesita permisos de Accesibilidad para funcionar:
- Abre Ajustes del Sistema → Privacidad y Seguridad → Accesibilidad
- Haz clic en + y selecciona BuenMouse
- Activa el interruptor junto a BuenMouse
- ¡Disfruta de tus nuevos gestos!
1. Mantén presionada la tecla Control ⌘
2. Haz clic izquierdo y mantén presionado
3. Arrastra en cualquier dirección para hacer scroll
4. Suelta para detener
1. Haz clic derecho y mantén presionado
2. Arrastra horizontalmente (izquierda ← → derecha)
3. Suelta cuando veas la animación de cambio
⌘ + 1: Ir a pestaña General⌘ + 2: Ir a pestaña Atajos⌘ + 3: Ir a pestaña Acerca de⌘ + Shift + M: Mover a barra de menú
Accede haciendo clic en el ícono de BuenMouse en la barra de menú:
- 🔘 Activar/Desactivar: Control global de todas las funciones
- 📏 Sensibilidad: Ajuste granular de umbrales (20-100px)
- 🔄 Dirección: Invertir comportamiento de navegación
- 🔍 Zoom: Configurar Control + Scroll
- 🚀 Inicio Automático: Lanzar con el sistema
- Tema Dinámico: Sigue automáticamente el modo oscuro del sistema
- Iconos de Estado: Cursor normal (activo) o cursor tachado (inactivo)
- Tooltips Informativos: Muestra estado actual al pasar el mouse
- Menú Contextual: Clic derecho en el ícono para acciones rápidas
# Clona el repositorio
git clone https://github.com/usuario/BuenMouse.git
cd BuenMouse
# Abre en Xcode
open BuenMouse.xcodeproj
# O compila desde la línea de comandos
xcodebuild -project BuenMouse.xcodeproj -scheme BuenMouse -configuration Release- Xcode 15.0+
- macOS 13.0+ SDK
- Swift 5.0+
- Developer ID (para distribución)
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ CGEventTap │────│ EventMonitor │────│ GestureHandler │
│ (Sistema) │ │ (Batching) │ │ (Estado) │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│
┌──────────────────┐ ┌─────────────────┐
│ SystemActions │────│ macOS APIs │
│ (Async) │ │ (AppleScript) │
└──────────────────┘ └─────────────────┘
- Latencia de Eventos: < 1ms promedio, < 5ms percentil 99
- Uso de Memoria: ~15MB residentes, ~5MB comprimidos
- Uso de CPU: < 0.1% promedio, < 2% durante uso intensivo
- Impacto en Batería: Despreciable (< 0.1% por hora)
¡Las contribuciones son bienvenidas! BuenMouse es un proyecto de código abierto que mejora con la comunidad.
- Fork el repositorio
- Crea una rama para tu feature (
git checkout -b feature/AmazingFeature) - Commit tus cambios (
git commit -m 'Add some AmazingFeature') - Push a la rama (
git push origin feature/AmazingFeature) - Abre un Pull Request
¿Encontraste un problema? Crea un issue con:
- 🖥️ Versión de macOS
- 🖱️ Tipo de mouse/trackpad
- 📝 Pasos para reproducir
- 📊 Logs del Console.app (si aplica)
¿Tienes una idea genial? Compártela en nuestro foro de discusiones.
- Documentación Técnica Completa: Arquitectura interna y patrones avanzados
- API Reference: Interfaces y protocolos públicos
- Performance Guide: Optimizaciones y benchmarks
- Accessibility Guide: Implementación de accesibilidad
# Monitor de rendimiento
./scripts/performance-monitor.sh
# Validador de accesibilidad
./scripts/accessibility-check.sh
# Construcción automática
./scripts/build-release.sh- ❌ Cero Telemetría: No recopilamos datos de uso
- 💻 Procesamiento Local: Todo se ejecuta en tu Mac
- 🔐 Permisos Mínimos: Solo acceso esencial al sistema
- 📖 Código Abierto: Transparencia total
- 🔏 Firmado con Developer ID: Verificación completa de Gatekeeper
- 🏗️ Runtime Hardening: Protecciones adicionales habilitadas
- 🔍 Validación de Entradas: Verificación exhaustiva de datos externos
- BetterTouchTool: Pionero en gestos avanzados para macOS
- Magnet: Excelencia en aplicaciones de productividad minimalistas
- Linear Mouse: Referencia en optimización de scroll
Gracias a todos los que han contribuido al proyecto:
- @steven - Creador y maintainer principal
- Lista completa de contribuidores
BuenMouse está licenciado bajo la Licencia MIT. Esto significa que puedes:
- ✅ Usar comercialmente
- ✅ Modificar
- ✅ Distribuir
- ✅ Usar en proyectos privados
Consulta el archivo LICENSE para más detalles.
- Machine Learning: Reconocimiento adaptativo de gestos
- Multi-Monitor: Soporte mejorado para múltiples pantallas
- Plugins: Arquitectura de extensiones
- Sincronización: Configuraciones en iCloud
- Gestos Personalizados: Editor visual de gestos
- Perfiles: Configuraciones por aplicación
- API Pública: SDK para desarrolladores
- Estadísticas: Panel de uso y productividad
¡Hecho con ❤️ para la comunidad de desarrolladores macOS!