Mi-Lanzador

🇪🇸 Leer en español

Mi Lanzador icon

Mi Lanzador

Automated shortcut creator for Linux Mint 22.3 (Cinnamon, X11 session).

Bash 4+ Linux Mint 22.3 Cinnamon GPLv3 License

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).

What’s new in version 2.1.0

Preview

Demo video

https://github.com/user-attachments/assets/adb98192-66cd-4f52-b696-88cb4aec8b03

Mi Lanzador - My shortcuts tab Mi Lanzador - New action tab with the Add step dialog Mi Lanzador - Settings tab

What each step type does

Examples of actions you can build

The steps can be chained freely within the same action, so the real limit is your imagination. A few examples to show the scope:

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.

Other features

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.

Language

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.

Requirements

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.

Compatibility with other distributions

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.

Installation

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:

  1. It copies itself to ~/.local/share/mi-lanzador/mi-lanzador.sh — that becomes the “installed” copy; the .sh you downloaded is no longer needed.
  2. It installs its icon, creates its launcher in the applications menu and leaves a copy on your Desktop.
  3. It checks dependencies and asks before installing anything that is missing.

After that, open it from the menu or Desktop icon like any other app.

Install and launch Mi Lanzador with Scriptya (optional)

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.

Where it stores things

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.

About Wayland

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)”.

Run an action without opening the window

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.

Under the hood

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.

Tests

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.

License

See the LICENSE.txt file in this repository.


Made by Filonux.