Automated shortcut creator for Linux Mint 22.3 (Cinnamon, X11 session).
Mi Lanzador is a graphical interface for building “actions”: sequences of steps that open programs, documents, websites or commands, place windows, simulate clicks and press keys, chained and executed in order — like an AutoHotkey macro, but using xdotool/wmctrl underneath. Any action can be turned into a one-click shortcut (Desktop and/or applications menu) that executes every step without opening the app window.
In practice, any routine you currently do by hand — opening your work apps and putting them where they belong, getting everything ready to record, filling in the same form every time — can be saved as a single icon that repeats it exactly the same way, every time.
Everything — interface and logic — lives in a single .sh file; your data (actions, settings, icons) is stored separately in your configuration folder (see “Where it stores things” below).
L button). It used to be Spanish-only. See “Language”.acciones.json or ajustes.json is damaged, it is set aside as <name>.corrupt-<date> (never overwritten) and the app opens with empty data, telling you so.https://github.com/user-attachments/assets/adb98192-66cd-4f52-b696-88cb4aec8b03

Alt+F10); both steps can target the last window opened by the action, a previous step by its alias, or a window found by title search.The steps can be chained freely within the same action, so the real limit is your imagination. A few examples to show the scope:
localhost, each in its place.And because each saved action has its own icon, the next time you do not even need to open Mi Lanzador: a double click on the Desktop (or the keyboard shortcut you assign to it — see “Run an action without opening the window” below) starts everything.
When creating a shortcut you choose Desktop, applications menu, or both. If Cinnamon asks you to “trust” or “allow execution” when you double-click it for the first time, that is normal — accept it once and it will not ask again.
Mi Lanzador uses the system language only as the initial default. A saved choice in ~/.config/mi-lanzador/idioma takes priority, so changing the desktop locale later does not unexpectedly change the interface. The L button (or the L key when the focus is not in a text field or a list) switches between es and en and saves the choice.
For diagnostics or automated tests, mi-lanzador.sh --print-language prints the language that will be used. The MI_LANZADOR_LANG=es or MI_LANZADOR_LANG=en environment variable can be used to force a language for a single launch without changing the saved preference.
python3-gi gir1.2-gtk-3.0 python3-gi-cairo gir1.2-notify-0.7xdotool and wmctrl, only if you are going to place windows, click, send keys or type text (including integrated placement inside open program/document/web/command).The script detects whether GTK3 and xdotool/wmctrl are missing and offers to install them with pkexec, asking for explicit confirmation before touching anything. If you say no, or pkexec is unavailable, it gives you the exact command so you can do it yourself. For xdotool/wmctrl you can also retry whenever you like from Settings → “Install now”; GTK3 has no such button — without it the interface cannot start, so there is no Settings screen to enter — simply run the script again after installing it manually. Python 3 is the only requirement the script does not offer to install for you: if it were missing (which should not happen on a normal Mint installation), it shows the command directly.
Mi Lanzador is developed and tested on Linux Mint 22.3 (Cinnamon, X11), and that is the only fully supported combination. That said, the script does not impose a distribution lock: it never checks which distribution you are running, so on any Linux/X11 session with GTK3 it should behave the same. Several parts are intentionally generic — it detects installed terminals (gnome-terminal, mate-terminal, xfce4-terminal, tilix, terminator, konsole, xterm…), browsers (Firefox/Chrome/Chromium/Brave, with package-name variants), and places windows using standard EWMH properties implemented by most X11 window managers (XFCE Xfwm4, MATE Marco, KWin on X11, Mutter on Xorg…), although it has only been tuned and tested thoroughly against Muffin, the Cinnamon window manager.
The only part tied to Mint/Ubuntu/Debian is automatic dependency installation, which uses apt. On a distribution with a different package manager that automatic installation will not work, but if you install the equivalent packages yourself before launching it, the rest of the application should start normally:
| Distro | Package manager | Approximate packages |
|---|---|---|
| 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 |
(Package names are indicative — check your distribution’s package search; they can vary between versions.)
As with Wayland (see below), window placement, clicks and keyboard input do not work there on any desktop, so that limitation is independent of the distribution.
Download script/mi-lanzador.sh (with GitHub’s download button) and, from the folder where you saved it, run:
chmod +x mi-lanzador.sh
./mi-lanzador.sh
That is all. The first time:
~/.local/share/mi-lanzador/mi-lanzador.sh — that becomes the “installed” copy; the .sh you downloaded is no longer needed.After that, open it from the menu or Desktop icon like any other app.
Scriptya is a script launcher: it organizes your scripts in a searchable menu and can turn any of them into a desktop app with its own icon, without writing a .desktop file by hand. You can add optional metadata from Scriptya to keep it organized with a name and description, change its icon, etc.
| What | Where |
|---|---|
| Actions | ~/.config/mi-lanzador/acciones.json |
| Settings | ~/.config/mi-lanzador/ajustes.json |
| Custom icons | ~/.config/mi-lanzador/iconos/ |
| Language preference | ~/.config/mi-lanzador/idioma |
| Last-run log | ~/.config/mi-lanzador/ultima_ejecucion.log |
| Error log | ~/.config/mi-lanzador/error.log |
| Installed script | ~/.local/share/mi-lanzador/mi-lanzador.sh |
| Launcher icon | ~/.local/share/icons/hicolor/scalable/apps/mi-lanzador.svg |
Any unexpected error is recorded in the error log and also shown in a notification: it does not fail silently, because the app is normally opened with a double click, with no terminal where you can see anything. The last-run log, by contrast, is the output of the last action you launched (warnings included) — useful to see why a particular step did not do what you expected.
If acciones.json or ajustes.json cannot be read, it is kept in the same folder as <name>.corrupt-<date>, the app opens with empty data and tells you so. The error log is rotated to error.log.1 once it exceeds 256 KB.
If your Cinnamon session is native Wayland, opening programs/websites/commands works normally, but window placement, clicking, sending keys and typing text will not work, even if xdotool and wmctrl are installed — this is a limitation of those tools, not of the script. It detects this automatically and warns once a day. To have all features, choose the “Cinnamon” (X11) session on the login screen, not the one labelled “Cinnamon (Wayland)”.
mi-lanzador.sh --ejecutar <action_id>
It runs that action from start to finish without showing any window. This is what the .desktop shortcuts generated by the app use internally, and it works just as well for assigning a keyboard shortcut to it from Cinnamon. The id is the action’s id field in acciones.json; it also appears at the end of the Exec= line of its shortcut.
A single .sh: the bash part handles self-installation, checks/installs dependencies and warns about Wayland; at the end it uses exec python3 on a heredoc containing the whole PyGObject (GTK3) interface. No build step, no custom packages to install — the file is the program.
bash tests/test_project.sh checks the script’s syntax and runs over 450 tests that start the real GTK3 interface on a virtual Xvfb with Openbox; the dependencies it needs are listed in CONTRIBUTING.md. GitHub Actions runs the same command on every pull request and on every push to the default branch, together with ShellCheck and pyflakes on the embedded Python.
See the LICENSE.txt file in this repository.
Made by Filonux.