QuickHotkeys

GTK4 / Libadwaita app to configure GNOME global keyboard shortcuts for common system actions on Ubuntu and other GNOME-based desktops.

Features

• GUI to assign shortcuts for preset actions
• Syncs to GNOME Custom Shortcuts via Gio.Settings
• Does not touch shortcuts from other apps (e.g. Ulauncher)
• CLI to run actions or re-sync config

Preset actions

ID	Action
shutdown	Instant power off (no confirmation)
restart	Reboot
suspend	Suspend
hibernate	Hibernate
lock	Lock screen
logout	Log out
mute	Toggle mute
screenshot	Interactive screenshot

Requirements

• Ubuntu 22.04+ / Debian 12+ (or similar GNOME desktop)
• python3-gi, gir1.2-gtk-4.0, gir1.2-adw-1
• GNOME on Wayland or X11

Install

git clone https://github.com/nakama/quickhotkeys.git
cd quickhotkeys
bash install.sh

Then launch QuickHotkeys from the app menu, or run:

quickhotkeys

Usage

quickhotkeys              # open GUI
quickhotkeys sync         # sync ~/.config/quickhotkeys/config.json to GNOME
quickhotkeys run lock     # run a preset action
quickhotkeys --help

1. Open the app
2. Click Gán next to an action and press your key combo
3. Click Áp dụng to save and register shortcuts

Config file: ~/.config/quickhotkeys/config.json

Language

• Default: English ("language": "en")
• Also supports Vietnamese ("language": "vi")
• Change in the app via Language dropdown, then click Apply
• If language is unset, the app uses English unless LANG starts with vi

Example config

{
  "language": "en",
  "shortcuts": {
    "lock": "<Primary><Alt>l",
    "mute": "<Primary><Alt>m"
  }
}

Safety

shutdown and restart run immediately without a confirmation dialog. Use hard-to-mistype combos (e.g. Ctrl+Alt+Shift+S).

Uninstall

rm -f ~/.local/bin/quickhotkeys
rm -f ~/.local/share/applications/io.github.nakama.quickhotkeys.desktop
rm -rf ~/.local/share/io.github.nakama.quickhotkeys
rm -rf ~/.config/quickhotkeys

Remove quickhotkeys-* entries from Settings → Keyboard → Custom Shortcuts if any remain.

Project layout

quickhotkeys/           # git repo root (GitHub: nakama/quickhotkeys)
├── quickhotkeys/       # Python package
├── bin/quickhotkeys    # launcher script
├── data/               # .desktop file
├── install.sh
├── LICENSE
└── pyproject.toml

License

MIT — Copyright (c) 2026 nakama

Tiếng Việt

Ứng dụng cấu hình phím tắt GNOME cho các tác vụ hệ thống. Mặc định tiếng Anh; chọn Tiếng Việt trong mục Language. Cài đặt: clone repo và chạy bash install.sh. Shutdown/Restart thực thi ngay, không hỏi xác nhận — hãy gán phím cẩn thận.