{"id":28744432,"url":"https://github.com/diegoiprg/dilware-macos-spaces-tool","last_synced_at":"2025-06-16T12:02:50.743Z","repository":{"id":298183915,"uuid":"999136193","full_name":"diegoiprg/dilware-macos-spaces-tool","owner":"diegoiprg","description":"🎯 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.","archived":false,"fork":false,"pushed_at":"2025-06-09T21:12:32.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-09T21:27:02.810Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/diegoiprg.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-09T19:46:22.000Z","updated_at":"2025-06-09T21:12:37.000Z","dependencies_parsed_at":"2025-06-09T21:38:18.600Z","dependency_job_id":null,"html_url":"https://github.com/diegoiprg/dilware-macos-spaces-tool","commit_stats":null,"previous_names":["diegoiprg/dilware-macos-spaces-tool"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/diegoiprg/dilware-macos-spaces-tool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diegoiprg%2Fdilware-macos-spaces-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diegoiprg%2Fdilware-macos-spaces-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diegoiprg%2Fdilware-macos-spaces-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diegoiprg%2Fdilware-macos-spaces-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/diegoiprg","download_url":"https://codeload.github.com/diegoiprg/dilware-macos-spaces-tool/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diegoiprg%2Fdilware-macos-spaces-tool/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260156471,"owners_count":22967221,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","customization","desktop-enhancement","ethical-software","free-software","hammerspoon","lua","macos","multitasking","non-commercial","open-source","personal-productivity","productivity","spaces","window-management","workspace-automation"],"created_at":"2025-06-16T12:00:49.941Z","updated_at":"2025-06-16T12:02:50.734Z","avatar_url":"https://github.com/diegoiprg.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dilware-macos-spaces-tool\n\n![Banner del proyecto](https://img.shields.io/badge/Hammerspoon%20Space%20Manager-%F0%9F%8C%90%20macOS%20automation-blueviolet?style=for-the-badge)\n\n![Versión](https://img.shields.io/badge/version-1.0.0-green.svg)\n\nSistema personalizado para macOS que permite gestionar espacios virtuales (Spaces) con perfiles de uso como \"personal\" y \"work\", usando Hammerspoon.\n\nIncluye:\n\n- Creación de espacios por perfil\n- Lanzamiento automático de aplicaciones\n- Eliminación de espacios y cierre de apps\n- Icono en la barra de menú para acceso rápido\n- Notificaciones del sistema y logs detallados\n\n---\n\n## 📁 Estructura del repositorio\n\n```\n.\n├── init.lua                # Script principal para Hammerspoon\n├── README.md              # Instrucciones de instalación y uso\n└── .hammerspoon/\n    └── debug.log          # Archivo de log generado por el script\n```\n\n---\n\n## 🚀 Instalación paso a paso\n\n### 1. Instalar Hammerspoon\n\nDescarga e instala desde: [https://www.hammerspoon.org](https://www.hammerspoon.org)\n\n### 2. Configurar permisos en macOS\n\nIr a `Preferencias del Sistema \u003e Seguridad y privacidad \u003e Privacidad`, y otorgar a Hammerspoon:\n\n- Acceso total al disco\n- Accesibilidad\n- Automatización (para controlar otras apps)\n\n### 3. Clonar el repositorio\n\n```bash\ngit clone https://github.com/diegoiprg/dilware-macos-spaces-tool.git\ncp dilware-macos-spaces-tool/init.lua ~/.hammerspoon/init.lua\n```\n\n### 4. Ejecutar Hammerspoon\n\n1. Abre la app Hammerspoon.\n2. Presiona `Command + R` para recargar el script.\n3. Aparecerá el icono “Spaces 🧭” en la barra de menú.\n\n### Alternativa: Instalación automática\n\nTambién puedes usar el script `install.sh` incluido para automatizar la instalación:\n\n```bash\ncurl -sL https://raw.githubusercontent.com/diegoiprg/dilware-macos-spaces-tool/main/install.sh | bash\n```\n\nSi prefieres descargar el archivo manualmente:\n\n1. Asegúrate de que el archivo `install.sh` esté en la raíz del proyecto.\n2. Hazlo ejecutable con el siguiente comando:\n\n   ```bash\n   chmod +x install.sh\n   ```\n\n3. Luego ejecútalo:\n\n   ```bash\n   ./install.sh\n   ```\n\n---\n\n## 🖱 Opciones disponibles en la barra de menú\n\n- `🟢 Activar Perfil Personal`: Crea espacio y abre Safari\n- `🟢 Activar Perfil Work`: Crea espacio y abre Outlook, Teams y Chrome\n- `❌ Cerrar Perfil ...`: Cierra las apps y elimina el espacio\n- `📝 Ver Log`: Abre los eventos en TextEdit\n- `🔄 Recargar`: Recarga el script\n- `❌ Salir`: Finaliza Hammerspoon\n\n---\n\n## ✏️ Personalización\n\nEdita el archivo `init.lua` para:\n\n- Cambiar las apps de cada perfil (`profiles` table)\n- Agregar nuevos perfiles siguiendo la estructura\n\nEjemplo para agregar un perfil `estudio`:\n\n```lua\nestudio = {\n  name = \"Estudio\",\n  apps = { \"Xcode\", \"Simulator\" },\n  space_id = nil,\n}\n```\n\n---\n\n## 🐞 Depuración\n\nVerifica el archivo `~/.hammerspoon/debug.log` para revisar eventos, errores o advertencias generadas por el sistema.\n\n---\n\n## 🌍 Sobre el proyecto\n\nEste 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.  \nEs una herramienta pensada para usuarios que buscan optimizar su flujo de trabajo sin depender de aplicaciones comerciales.\n\nAunque 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.\n\n---\n\n## 📄 Licencia\n\nEste proyecto está licenciado bajo la **GNU General Public License v3.0**.\n\nPuedes usarlo, estudiarlo, modificarlo y compartirlo libremente, siempre que:\n\n- No sea utilizado con fines comerciales.\n- Se mantenga la misma licencia para cualquier derivado.\n- Se incluya atribución al autor original.\n\nEsto asegura que el proyecto siga siendo software libre y accesible para todos.\n\n---\n\n## 🏷️ Características clave\n\n![Libre y sin fines comerciales](https://img.shields.io/badge/uso-no%20comercial-blue.svg)\n![Sin seguimiento ni anuncios](https://img.shields.io/badge/sin%20tracking%20ni%20ads-✅-brightgreen.svg)\n![Hecho para macOS](https://img.shields.io/badge/plataforma-macOS-lightgrey.svg)\n![Licencia GPLv3](https://img.shields.io/badge/licencia-GPLv3-important.svg)\n\n## 🤖 Nota sobre la autoría\n\nEste proyecto fue desarrollado con la asistencia de herramientas de inteligencia artificial para generar código, bajo la supervisión directa del autor.  \nTodo el código ha sido revisado, probado y aprobado antes de su publicación.\n\nLa licencia GNU GPLv3 aplica íntegramente a todo el contenido de este repositorio.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdiegoiprg%2Fdilware-macos-spaces-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdiegoiprg%2Fdilware-macos-spaces-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdiegoiprg%2Fdilware-macos-spaces-tool/lists"}