Guake/guake

Add first-time configuration guide for global hotkey on wayland

Open

#2,011 创建于 2022年1月18日

在 GitHub 查看
 (1 评论) (11 反应) (0 负责人)Python (619 fork)batch import
Type: Feature Requestgood first issue

仓库指标

Star
 (4,281 star)
PR 合并指标
 (平均合并 4天 6小时) (30 天内合并 2 个 PR)

描述

Wayland prevents global hotkey registration as part of its anti-keylogger crusade, which means that Guake's global toggle needs to be done by adding guake-toggle to the window manager's global keyboard shortfcuts. Currently this is not mentioned in the program, so I'd like to propose the following flow for the program:

  1. Detect wayland by catching global hotkey binding failure
  2. Pop a dialog to explain the situation and provide instructions on how to set the hotkey in keyboard settings.
  3. Offer to unbind the global hotkey so that further messages do not appear.

贡献者指南

研究方向
首先，了解 Guake 中当前的全局热键实现，可能在 `guake/terminal.py` 或 `guake/gtkegl.py` 等文件中。要检测 Wayland，请检查环境变量 `XDG SESSION TYPE` 或使用 `os.environ.get('XDG SESSION TYPE')`。如果是 Wayland，则显示一个 Gtk 对话框说明情况，并提供在窗口管理器的键盘快捷键中绑定 `guake toggle` 的说明。同时提供解除全局热键绑定的选项，以避免重复弹出对话框。考虑使用 `Gtk.MessageDialog` 和 `Gtk.LinkButton` 来创建可点击的设置链接。应查看维护者的评论（如果有）以获取指导。
技术栈
python
领域
desktop
议题类型
功能
难度面向新贡献者的预计实现难度，1 表示很小改动，5 表示专家级工作。
2
预计时间有经验贡献者完成调查、实现、测试并准备 pull request 的粗略时间范围。
半天
活动状态议题当前的可参与程度：新鲜、活跃、陈旧、阻塞或等待维护者输入。
活跃
清晰度议题是否清楚说明期望改动、验收标准和下一步。
清晰
前置要求
PythonGNOME development
新手友好度1-100 的估计分数，表示该议题对首次贡献者的友好程度。
60