Guake/guake

Add first-time configuration guide for global hotkey on wayland

Open

#2,011 opened on 2022年1月18日

GitHub で見る
 (1 comment) (11 reactions) (0 assignees)Python (619 forks)batch import
Type: Feature Requestgood first issue

Repository metrics

Stars
 (4,281 stars)
PR merge metrics
 (平均マージ 4d 6h) (30d で 2 merged PRs)

説明

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
Issue 種別
機能
難度新しい貢献者にとっての実装難度です。1 は非常に小さな変更、5 は専門的な作業です。
2
推定時間経験ある貢献者が調査、実装、テスト、pull request 準備にかけるおおよその時間範囲です。
半日
活動状況Issue が今どれだけ取り組みやすいかを示します。新しい、活発、古い、ブロック中、またはメンテナー入力待ちなどです。
アクティブ
明確さ期待される変更、受け入れ条件、次の手順がどれだけ明確かを示します。
明確
前提条件
PythonGNOME development
初心者向け度初回貢献者にどれだけ取り組みやすいかを 1-100 で推定したスコアです。
60