Bind a key to a specific program in Gnome Shell.
GPL-3.0 License
Bind keys to a specific program in Gnome Shell:
command
property.It is comparable to Guake and Compiz Put, except that gnome-magic-window works with Gnome Shell and the new Wayland display server. (It does not use xdotool and wmctrl, that worked with X11 but not with Wayland.)
The following commands assume that one of the elements in BINDINGS
has a
shortcut property of F12
, a title of Terminator
and a command of
/usr/bin/terminator
.
F12
with Pause
, <Super>a
or whichever key you prefer.Terminator
by the program to be brought to front when the key is/usr/bin/terminator
by the command to run if no window namedTerminator
is found. Make sure you use a absolute path.BINDINGS
that you don't require.BINDINGS
containingPATH
if not absolute.)Since Gnome 41, gnome-magic-window is shipped as a Gnome extension. To install this extension from the Git repository:
mkdir -p ~/.local/share/gnome-shell/extensions
cd ~/.local/share/gnome-shell/extensions
git clone https://github.com/adrienverge/gnome-magic-window gnome-magic-window@adrienverge
Edit extension.js
to set your favorite key, window name and command to
run, for example:
const BINDINGS = [
{
shortcut: 'F12',
title: 'Terminator',
command: 'terminator'
},
// more bindings can be added
];
After installing files and customizing, you probably need to close your session and log in again in order for Gnome to the extension.
Either run:
gnome-extensions enable gnome-magic-window@adrienverge
Or open Gnome "Extensions" utility to enable the extension.
You're set! Try pressing your magic key.
In case it doesn't work, you may need to add your gnome version in
metadata.json
and reload your session, or debug futher.
# Alt+F2↵ r↵
gdbus call --session --dest org.gnome.Shell --object-path /org/gnome/Shell/Extensions/GnomeMagicWindow --method org.gnome.Shell.Extensions.GnomeMagicWindow.magic_key_pressed Terminator terminator
Use this repo on commit b640974 or before, and read the README file from that version.
Use this repo on commit 26230da or before, and read the README file from that version.