https://github.com/diegoiprg/dilware-macos-spaces-tool
🎯 Script Lua para Hammerspoon que permite crear y eliminar espacios personalizados en macOS, pensado para mejorar la productividad sin depender de apps comerciales. 100% libre, personalizable y ético.
https://github.com/diegoiprg/dilware-macos-spaces-tool
automation customization desktop-enhancement ethical-software free-software hammerspoon lua macos multitasking non-commercial open-source personal-productivity productivity spaces window-management workspace-automation
Last synced: 12 months ago
JSON representation
🎯 Script Lua para Hammerspoon que permite crear y eliminar espacios personalizados en macOS, pensado para mejorar la productividad sin depender de apps comerciales. 100% libre, personalizable y ético.
- Host: GitHub
- URL: https://github.com/diegoiprg/dilware-macos-spaces-tool
- Owner: diegoiprg
- License: gpl-3.0
- Created: 2025-06-09T19:46:22.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-09T21:12:32.000Z (about 1 year ago)
- Last Synced: 2025-06-09T21:27:02.810Z (about 1 year ago)
- Topics: automation, customization, desktop-enhancement, ethical-software, free-software, hammerspoon, lua, macos, multitasking, non-commercial, open-source, personal-productivity, productivity, spaces, window-management, workspace-automation
- Language: Lua
- Homepage:
- Size: 19.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# dilware-macos-spaces-tool
Sistema personalizado para macOS que permite gestionar espacios virtuales (Spaces) con perfiles de uso como "personal" y "work", usando Hammerspoon.
Incluye:
- Creación de espacios por perfil
- Lanzamiento automático de aplicaciones
- Eliminación de espacios y cierre de apps
- Icono en la barra de menú para acceso rápido
- Notificaciones del sistema y logs detallados
---
## 📁 Estructura del repositorio
```
.
├── init.lua # Script principal para Hammerspoon
├── README.md # Instrucciones de instalación y uso
└── .hammerspoon/
└── debug.log # Archivo de log generado por el script
```
---
## 🚀 Instalación paso a paso
### 1. Instalar Hammerspoon
Descarga e instala desde: [https://www.hammerspoon.org](https://www.hammerspoon.org)
### 2. Configurar permisos en macOS
Ir a `Preferencias del Sistema > Seguridad y privacidad > Privacidad`, y otorgar a Hammerspoon:
- Acceso total al disco
- Accesibilidad
- Automatización (para controlar otras apps)
### 3. Clonar el repositorio
```bash
git clone https://github.com/diegoiprg/dilware-macos-spaces-tool.git
cp dilware-macos-spaces-tool/init.lua ~/.hammerspoon/init.lua
```
### 4. Ejecutar Hammerspoon
1. Abre la app Hammerspoon.
2. Presiona `Command + R` para recargar el script.
3. Aparecerá el icono “Spaces 🧭” en la barra de menú.
### Alternativa: Instalación automática
También puedes usar el script `install.sh` incluido para automatizar la instalación:
```bash
curl -sL https://raw.githubusercontent.com/diegoiprg/dilware-macos-spaces-tool/main/install.sh | bash
```
Si prefieres descargar el archivo manualmente:
1. Asegúrate de que el archivo `install.sh` esté en la raíz del proyecto.
2. Hazlo ejecutable con el siguiente comando:
```bash
chmod +x install.sh
```
3. Luego ejecútalo:
```bash
./install.sh
```
---
## 🖱 Opciones disponibles en la barra de menú
- `🟢 Activar Perfil Personal`: Crea espacio y abre Safari
- `🟢 Activar Perfil Work`: Crea espacio y abre Outlook, Teams y Chrome
- `❌ Cerrar Perfil ...`: Cierra las apps y elimina el espacio
- `📝 Ver Log`: Abre los eventos en TextEdit
- `🔄 Recargar`: Recarga el script
- `❌ Salir`: Finaliza Hammerspoon
---
## ✏️ Personalización
Edita el archivo `init.lua` para:
- Cambiar las apps de cada perfil (`profiles` table)
- Agregar nuevos perfiles siguiendo la estructura
Ejemplo para agregar un perfil `estudio`:
```lua
estudio = {
name = "Estudio",
apps = { "Xcode", "Simulator" },
space_id = nil,
}
```
---
## 🐞 Depuración
Verifica el archivo `~/.hammerspoon/debug.log` para revisar eventos, errores o advertencias generadas por el sistema.
---
## 🌍 Sobre el proyecto
Este script fue creado con el objetivo de mejorar la experiencia de uso en macOS, ofreciendo una forma práctica y automatizada de gestionar espacios personalizados (Spaces) según distintos perfiles de usuario.
Es una herramienta pensada para usuarios que buscan optimizar su flujo de trabajo sin depender de aplicaciones comerciales.
Aunque parte del código fue generado con ayuda de IA, el desarrollo, pruebas y publicación fueron realizados por el autor de forma supervisada y consciente, con el deseo de aportar una solución útil y gratuita a la comunidad.
---
## 📄 Licencia
Este proyecto está licenciado bajo la **GNU General Public License v3.0**.
Puedes usarlo, estudiarlo, modificarlo y compartirlo libremente, siempre que:
- No sea utilizado con fines comerciales.
- Se mantenga la misma licencia para cualquier derivado.
- Se incluya atribución al autor original.
Esto asegura que el proyecto siga siendo software libre y accesible para todos.
---
## 🏷️ Características clave
## 🤖 Nota sobre la autoría
Este proyecto fue desarrollado con la asistencia de herramientas de inteligencia artificial para generar código, bajo la supervisión directa del autor.
Todo el código ha sido revisado, probado y aprobado antes de su publicación.
La licencia GNU GPLv3 aplica íntegramente a todo el contenido de este repositorio.