Mi-Lanzador

🇬🇧 Read this README in English

Icono de Mi Lanzador

Mi Lanzador

Creador de accesos directos automatizados para Linux Mint 22.3 (Cinnamon, sesión X11).

Bash 4+ Linux Mint 22.3 Cinnamon Licencia GPLv3

Es una interfaz gráfica para armar “acciones”: secuencias de pasos que abren programas, documentos, páginas web o comandos, colocan ventanas, simulan clics y pulsan teclas, encadenados y en orden — como una macro de AutoHotkey, pero con xdotool/wmctrl por debajo. Cualquier acción se convierte en un acceso directo de un clic (Escritorio y/o menú de aplicaciones) que ejecuta todos sus pasos sin abrir la ventana de la app.

En la práctica, cualquier rutina que hoy hagas a mano —abrir tus apps de trabajo y colocarlas en su sitio, dejar todo listo para grabar, rellenar el mismo formulario de siempre— se queda guardada como un solo icono que la repite exactamente igual, todas las veces.

Todo — interfaz y lógica — vive en un único archivo .sh; tus datos (acciones, ajustes, iconos) se guardan aparte, en tu carpeta de configuración (ver «Dónde guarda las cosas» más abajo).

Novedades de la versión 2.1.0

Vista previa

Vídeo de demostración

https://github.com/user-attachments/assets/39f252bd-b087-494a-becf-dae433429457

Mi Lanzador - pestaña Mis accesos Mi Lanzador - pestaña Nueva acción con el diálogo Añadir paso Mi Lanzador - pestaña Ajustes

Qué hace cada tipo de paso

Ejemplos de acciones que puedes armar

Los pasos se encadenan libremente dentro de una misma acción, así que el límite real lo pone tu imaginación. Algunos ejemplos para que veas el alcance:

Y como cada acción guardada tiene su propio icono, la siguiente vez ni siquiera hace falta abrir Mi Lanzador: con un doble clic en el Escritorio (o el atajo de teclado que le asignes — ver «Ejecutar una acción sin abrir la ventana» más abajo) ya está todo en marcha.

Otras funciones

Al crear un acceso directo eliges Escritorio, menú de aplicaciones, o ambos. Si al hacer doble clic Cinnamon te pide “confiar” o “permitir ejecución” la primera vez, es normal — acéptalo una vez y no se vuelve a preguntar.

Idioma

Mi Lanzador usa el idioma del sistema solo como valor inicial. Si guardas una elección en ~/.config/mi-lanzador/idioma, esa elección tiene prioridad, así que cambiar después el idioma del escritorio no cambia la interfaz por sorpresa. El botón L de la barra superior (o la tecla L cuando el foco no está en un campo de texto ni en una lista) intercambia es y en y guarda la elección.

Para diagnóstico o pruebas automatizadas, mi-lanzador.sh --print-language muestra el idioma que se va a usar. Las variables de entorno MI_LANZADOR_LANG=es o MI_LANZADOR_LANG=en permiten forzar un idioma en un solo lanzamiento sin cambiar la preferencia guardada.

Requisitos

El script detecta si faltan las dos últimas (GTK3 y xdotool/wmctrl) y se ofrece a instalarlas con pkexec, pidiendo confirmación explícita antes de tocar nada. Si dices que no, o no hay pkexec disponible, te deja el comando exacto para hacerlo tú mismo. Para xdotool/wmctrl puedes además reintentarlo cuando quieras desde Ajustes → «Instalar ahora»; GTK3 no tiene ese botón — sin él la interfaz no llega a abrirse, así que tampoco hay Ajustes al que entrar — basta con volver a ejecutar el script una vez lo hayas instalado a mano. Python 3 es el único requisito que el script no ofrece instalar por ti: si llegara a faltar (no debería, en una instalación normal de Mint), directamente te muestra el comando.

Compatibilidad con otras distribuciones

Mi Lanzador se desarrolla y se prueba sobre Linux Mint 22.3 (Cinnamon, X11), y es la única combinación totalmente soportada. Dicho esto, el script no impone ningún candado por distribución: no comprueba en ningún punto qué sistema es, así que en cualquier sesión Linux/X11 con GTK3 debería comportarse igual. De hecho, varias partes ya son genéricas por diseño — detecta terminales instaladas (gnome-terminal, mate-terminal, xfce4-terminal, tilix, terminator, konsole, xterm…), navegadores (Firefox/Chrome/Chromium/Brave, con sus variantes de nombre de paquete), y coloca ventanas usando propiedades EWMH estándar que implementan la mayoría de gestores de ventanas X11 (Xfwm4 de XFCE, Marco de MATE, KWin en X11, Mutter en Xorg…), aunque solo se ha ajustado y probado a fondo contra Muffin, el de Cinnamon.

La única pieza realmente atada a Mint/Ubuntu/Debian es la instalación automática de dependencias, que usa apt. En una distribución con otro gestor de paquetes esa instalación automática no va a funcionar, pero si instalas tú mismo los paquetes equivalentes antes de lanzarlo, el resto de la aplicación debería arrancar sin más:

Distro Gestor Paquetes aproximados
Fedora / RHEL dnf python3-gobject gtk3 python3-cairo libnotify xdotool wmctrl
openSUSE zypper python3-gobject typelib-1_0-Gtk-3_0 typelib-1_0-Notify-0_7 xdotool wmctrl
Arch / Manjaro pacman python-gobject gtk3 python-cairo libnotify xdotool wmctrl

(Nombres orientativos — compruébalos con el buscador de paquetes de tu distro, pueden variar entre versiones.)

Como en Wayland (ver más abajo) la colocación de ventana, el clic y el teclado no funcionan en ningún escritorio, esa limitación aplica igual sin importar la distribución.

Instalación

Descarga script/mi-lanzador.sh (con el botón de descarga de GitHub) y, desde la carpeta donde lo guardes, ejecuta:

chmod +x mi-lanzador.sh
./mi-lanzador.sh

Con eso basta. La primera vez:

  1. Se copia a ~/.local/share/mi-lanzador/mi-lanzador.sh — esa pasa a ser la copia “instalada”; el .sh que descargaste ya no hace falta.
  2. Instala su icono, crea su lanzador en el menú de aplicaciones y deja una copia en tu Escritorio.
  3. Comprueba dependencias y pregunta antes de instalar nada que falte.

Después de eso, ábrelo desde el menú o el icono del Escritorio, como cualquier otra app.

Instalar y lanzar Mi Lanzador con Scriptya (opcional)

Scriptya es un lanzador de scripts: organiza los tuyos en un menú con búsqueda y puede convertir cualquiera de ellos en una app de escritorio con su propio icono, sin escribir un .desktop a mano. Puedes añadir unos metadatos opcionales desde Scriptya para tenerlo organizado con el nombre, descripción, cambiar su icono, etc.

Dónde guarda las cosas

Qué Dónde
Acciones ~/.config/mi-lanzador/acciones.json
Ajustes ~/.config/mi-lanzador/ajustes.json
Iconos personalizados ~/.config/mi-lanzador/iconos/
Preferencia de idioma ~/.config/mi-lanzador/idioma
Registro de la última ejecución ~/.config/mi-lanzador/ultima_ejecucion.log
Log de errores ~/.config/mi-lanzador/error.log
Script instalado ~/.local/share/mi-lanzador/mi-lanzador.sh
Icono del lanzador ~/.local/share/icons/hicolor/scalable/apps/mi-lanzador.svg

Cualquier error inesperado se registra en el log de errores y además se muestra en un aviso: no falla en silencio, porque normalmente se abre con doble clic, sin terminal donde ver nada. El registro de la última ejecución, en cambio, es la salida de la última acción que has lanzado (avisos incluidos) — útil para ver por qué un paso concreto no hizo lo que esperabas.

Si acciones.json o ajustes.json no se pueden leer, se conservan en la misma carpeta como <nombre>.corrupt-<fecha>, la app abre con datos vacíos y te lo avisa. El log de errores se rota a error.log.1 cuando pasa de 256 KB.

Sobre Wayland

Si tu sesión de Cinnamon es Wayland nativo, abrir programas/webs/comandos funciona igual, pero colocar ventanas, hacer clic, enviar teclas y escribir texto no van a funcionar, aunque tengas xdotool y wmctrl instalados — es una limitación de esas herramientas, no del script. Se detecta sola y avisa una vez al día. Para tener todo, elige la sesión “Cinnamon” (X11) en la pantalla de inicio de sesión, no la que dice “Cinnamon (Wayland)”.

Ejecutar una acción sin abrir la ventana

mi-lanzador.sh --ejecutar <id_de_la_accion>

Corre esa acción de principio a fin sin mostrar ninguna ventana. Es lo que usan por dentro los accesos directos .desktop que genera la app, y sirve igual de bien para asignarle un atajo de teclado propio desde Cinnamon. El id es el campo id de la acción en acciones.json; también aparece al final de la línea Exec= de su acceso directo.

Por dentro

Un único .sh: la parte de bash hace la auto-instalación, comprueba/instala dependencias y avisa de Wayland; al final hace exec python3 sobre un heredoc con toda la interfaz en PyGObject (GTK3). Sin build, sin paquetes propios que instalar — el archivo es el programa.

Pruebas

bash tests/test_project.sh comprueba la sintaxis del script y ejecuta más de 450 pruebas que arrancan la interfaz GTK3 real sobre un Xvfb virtual con Openbox; las dependencias que necesita están en CONTRIBUTING.md. GitHub Actions ejecuta el mismo comando en cada pull request y en cada push a la rama por defecto, junto con ShellCheck y pyflakes sobre el Python embebido.

Licencia

Consulta el archivo LICENSE.txt de este repositorio.


Hecho por Filonux.