Keyboard Shortcuts
Description
All GNOME applications have several shortcuts but not all of them contain a Keyboard Shortcuts Page (aka KSP).
Due to missing Shortcuts information, not all KSP cover all shortcuts. Also, many applications have missing but essential shortcuts.
Goals
To fix several usability problems and make (F1) Help shortcut and Keyboard Shortcuts solid.
- F1 key must work and open Help page.
- F10 must open Main Menu.
- Main Menu must contain "Help" entry.
- Main Menu must contain "Keyboard Shortcuts" entry.
- Application must contain KSP.
- KSP must be open with Ctrl+question
Also, KSP must cover these shortcuts
- F1 : Show help
- F10 : Open menu
- Ctrl+W : Close window (optional)
- Ctrl+Q : Quit
- Ctrl+? : Keyboard shortcuts
- Ensure all shortcuts are listed in KSP.
Scope
- All core apps should ship with "F1: Show help" functionality.
People on charge & contact
Sabri Unal (@libreajans)
Contact me via:
- Email: libreajans at gmail dot com
- Twitter: @libreajans (https://twitter.com/libreajans)
Text for the Initiative issue in projects
We are trying to provide better (F1) Help shortcut and Keyboard Shortcuts Page for users.
For that, would be awesome that all Gnome applications to have a KSP and some common shortcuts.
We believe that all GNOME applications deserve to have a Main Menu (MM) and to have some entries on it.
* [ ] Does F1 key open Help?
* [ ] Does F10 key open Main Menu?
* [ ] Does MM have "Help" entry?
* [ ] Does MM have "Keyboard Shortcuts" entry?
* [ ] Does Application have KSP?
* [ ] Does "Ctrl+question" shortcut open KSP?
* [ ] Does KSP contain "F1" entry? : "F1 : Show help"
* [ ] Does KSP contain "F10" entry? : "F10 : Open menu"
* [ ] Does KSP contain "Ctrl+W" entry? : "Ctrl+W : Close window"
* [ ] Does KSP contain "Ctrl+Q" entry? : "Ctrl+Q : Quit"
* [ ] Does KSP contain "Ctrl+question" entry? : "Ctrl+? : Keyboard shortcuts"
* [ ] Ensure all shortcuts are listed in KSP.
Read more about this at the [initiative](https://gitlab.gnome.org/GNOME/Initiatives/issues/14),
@libreajans will help with the implementation of it.
Let us know if you have any questions & thoughts.
/label ~"9. Initiatives: Keyboard Shortcuts"
# Quick answers about my suggestions
- Why I select Ctrl+question for Keyboard Shortcuts?
Check [GTK automatic help overlay support](https://gitlab.gnome.org/GNOME/gtk/blob/master/gtk/gtkapplication.c)
- Why I select F10 for the primary menu?
It was on [standart navigations keys](https://developer.gnome.org/hig/stable/keyboard-input.html.en)
- Why I remove Ctrl+F1 shortcut
It used to work but, due to a conflict, it was removed (https://gitlab.gnome.org/GNOME/gtk/issues/626)
How can I help
- Report issues for apps with Help page and Keyboard Shortcuts Page.
- Help fix issues
- Test apps that have been fixed.
How can I build an Application
I usually use these commands
meson --prefix $PWD/_install _build && \
LC_ALL=C ninja -C _build all install && \
LC_ALL=C LD_LIBRARY_PATH=./_install/lib:$LD_LIBRARY_PATH \
XDG_DATA_DIRS=./_install/share:$XDG_DATA_DIRS \
./_install/bin/application-name
Quick answers about my suggestions
- Why I select Ctrl+question for Keyboard Shortcuts? Check GTK automatic help overlay support
- Why I select F10 for the primary menu? It was on standart navigations keys
- Why I remove Ctrl+F1 shortcut It used to work but, due to a conflict, it was removed (gtk#626 (closed))
Core Applications
- gnome-control-center
-
Open a checklist (gnome-control-center#839 (closed)) -
Open a MR (gnome-control-center!676 (closed))
-
Development Tools
- devhelp
-
Open a checklist (devhelp#17 (closed)) -
Open a MR (devhelp!12 (closed)) -
Open a MR (devhelp!15 (closed)) -
Open a MR (devhelp!14 (closed))
-
- gitg
-
Open a checklist (gitg#267 (closed)) -
Open a MR (gitg!125 (merged)) -
Open a MR (gitg!124 (closed)) (unrelated) -
Open a MR (gitg!119 (closed)) (rejected) -
Open a MR (gitg!120 (closed)) (closed by me, unnecessery) -
Issue (gitg#266 (closed)) (closed by me, unnecessery)
-
- glade
-
Open a checklist (glade#401 (closed)) -
Open a MR (glade!81 (closed)) -
Issue 1 (glade#398 (closed)) -
Issue 2 (glade#399 (closed))
-
- gnome-builder
-
Open a checklist (gnome-builder#1119 (closed)) -
Open a MR (gnome-builder!240 (merged)) -
Issue, Ctrl+Q (gnome-builder#1130 (closed))
-
Utils Extra
- baobab
-
Open a checklist (baobab#34 (closed)) -
Open a MR (baobab!15 (merged))
-
- Eye of GNOME
-
Open a checklist (eog#102 (closed)) -
Open a MR (eog!38 (merged)) -
Issue 1 (eog#101 (closed)) (I sent a MR) -
Issue 2 (eog#103 (closed)) (My Miskake) -
Issue 3 eog#105 (closed)) (Closed due GTK changes)
-
- evince
-
Open a checklist (evince#1327 (closed)) -
Open a MR (evince!208 (merged)) -
Issue (evince#1328 (closed))
-
- file-roller
-
Open a checklist (file-roller#64 (closed)) -
Open a MR (file-roller!27 (merged)) -
Issue (file-roller#62 (closed))
-
- yelp
-
Open a checklist (yelp#151 (closed)) -
Open a MR (yelp!19 (closed)) -
Issue (yelp#149 (closed))
-
Utils
- gnome-calculator
-
Open a checklist (gnome-calculator#148 (closed)) -
Open a MR (gnome-calculator!39 (merged))
-
- gnome-clocks
-
Open a checklist (gnome-clocks#56 (closed)) -
Open a MR (gnome-clocks!46 (merged))
-
- gnome-color-manager
- part of GCM. Unnecessary.
- gnome-contacts
-
Open a checklist (gnome-contacts#156 (closed)) -
Open a MR (gnome-contacts!98 (merged)) -
Open a MR (gnome-contacts!103 (merged)) -
Open a MR (gnome-contacts!104 (merged))
-
- gnome-dictionary
- gnome-disk-utility
-
Open a checklist (gnome-disk-utility#162 (closed)) -
Open a MR (gnome-disk-utility!29 (closed))
-
- gnome-font-viewer
- It only has "alt+left" shortcut for Back.
- gnome-initial-setup
- Does not need.
- gnome-logs
-
Open a checklist (gnome-logs#47 (closed)) -
Open a MR (gnome-logs!19 (merged))
-
- gnome-maps
-
Open a checklist (gnome-maps#244 (closed)) -
Issue (gnome-maps#269 (closed))
-
- gnome-music
-
Open a checklist (gnome-music#361 (closed)) -
Issue (gnome-music#361 (closed))
-
- gnome-photos
-
Open a checklist (gnome-photos#138 (closed)) -
Open a MR (gnome-photos!119 (merged)) -
Open a MR (gnome-photos!121 (merged)) -
Open a MR (gnome-photos!120 (merged))
-
- gnome-screenshot
- Does not need.
- gnome-system-monitor
-
Open a checklist (gnome-system-monitor#136 (closed)) -
Open a MR (gnome-system-monitor!15 (merged)) -
Issue, MR (gnome-system-monitor!14 (merged))
-
- gnome-terminal
- It has changeable shortcut support
- gnome-user-share
- Does not need
Apps
- gnome-books
-
Open a checklist (https://gitlab.gnome.org/GNOME/gnome-books/issues/42) -
Open a MR (https://gitlab.gnome.org/GNOME/gnome-books/merge_requests/46)
-
- gnome-boxes
-
Open a checklist (gnome-boxes#458 (closed)) -
Issue, fixed (gnome-boxes#459 (closed)) -
Issue, fixed (gnome-boxes#460 (closed)) -
Issue, fixed (gnome-boxes!261 (merged)) -
MR, (gnome-boxes!273 (merged))
-
- gnome-calendar
-
Open a checklist (gnome-calendar#518 (closed)) -
Open a MR (gnome-calendar!112 (closed)) -
Open a MR (gnome-calendar!113 (closed)) -
Issue (gnome-calendar#520 (closed)) -
Issue (gnome-calendar#521 (closed))
-
- gnome-characters
- Does not have either help or keyboard shortcuts page. And only two shortcuts works - (ctrl+f and ctrl+q).
- gnome-documents
-
Open a checklist (https://gitlab.gnome.org/GNOME/gnome-documents/issues/42) -
Open a MR (https://gitlab.gnome.org/GNOME/gnome-documents/merge_requests/30)
-
- gnome-nettool
- GTK2 style app. Does not need any check.
- gnome-notes
-
Open a checklist (gnome-notes#140 (closed)) -
Open a MR (gnome-notes!43 (merged)) -
Issue (gnome-notes#141 (closed)) -
Issue (gnome-notes#142 (closed))
-
- gnome-software
- It has only two shortcuts (alt+left: go back; ctrl+f: find)
-
Issue (gnome-software#906 (closed)) (dublicate) -
Follow the first issue ((gnome-software#850 (closed))
-
- gnome-sound-recorder
- It has only one shortcut: Ctrl+Q: Quit
- gnome-todo
-
Build error (https://gitlab.gnome.org/GNOME/gnome-todo/issues/306) -
Open a checklist -
Open a MR
-
- gnome-tweaks
- There is only one shortcut. Ctrl+f: Search. Does not have a KSP or Help page.
-
MR (gnome-tweaks!49 (closed)) - Issue: MR, Ctrl+Q: Quit action isn't working.
- gnome-weather
- Does not need.
-
Issue, Redundant Shortcut (gnome-weather#78 (closed))
Apps Extra
- brasero
- GTK2 style app. Does not have any KSP.
- cheese
-
Open a checklist (cheese#58) -
Open a MR (needs rework) (cheese!23 (closed))
-
- epiphany
-
Open a checklist (epiphany#1078 (closed)) -
Open MR (epiphany!556 (merged)) -
MR : Add webapp shortcuts (epiphany!560 (merged)) -
Issue (epiphany#1079 (closed)) -
Issue (epiphany#1082 (closed))
-
- evolution
-
Open a checklist -
Open a MR
-
- gedit
-
Open a checklist (gedit#265 (closed)) -
Open a MR (gedit!71 (closed)) -
Issue (gedit#270 (closed)) -
Issue (gedit#269 (closed)) -
Issue (gedit#268 (closed))
-
- nautilus
-
Open a checklist (nautilus#1373 (closed)) -
Open a MR (nautilus!521 (merged)) -
Issue (nautilus!511 (merged))
-
- nautilus-sendto
- Part of Nautilus. Unnecessary.
- polari
-
Open a checklist (polari#127 (closed)) -
Open a MR (polari!144 (merged))
-
- rygel
- Unnecessary.
- seahorse
-
Open a checklist (seahorse#258 (closed)) -
Open a MR (seahorse!118 (merged))
-
- simple-scan
-
Open a checklist (simple-scan#153 (closed)) -
Open a MR (simple-scan!63 (merged))
-
- totem
-
Open a checklist (totem#396 (closed)) -
Open a MR (totem!135 (merged))
-
- vinagre
- GTK2 style app. Does not have any KSP.
Games
- gnome-chess
-
Open a checklist (gnome-chess#40 (closed)) -
Open a MR (gnome-chess!14 (merged))
-
- gnome-klotski
-
Open a checklist -
Open a MR
-
- gnome-mahjongg
-
Open a checklist (gnome-mahjongg#19 (closed)) -
Open a MR (gnome-mahjongg!17 (merged))
-
- gnome-mines
-
Open a checklist (gnome-mines#44 (closed)) -
Open a MR (gnome-mines!18 (merged))
-
- gnome-nibbles
- Does not have a KSP.
- It has four shortcuts: new-game: n, quit: q, back: Escape, help: F1
- gnome-robots
- Does not have a KSP.
- It has four shortcuts: new-game: n, quit: q, help: F1
- gnome-sudoku
-
Open a checklist (gnome-sudoku#35 (closed)) -
Open a MR
-
- gnome-taquin
-
Open a checklist (gnome-taquin#8 (closed)) -
Open a MR (gnome-taquin!8 (closed)) -
Issue (gnome-taquin#9 (closed))
-
- gnome-tetravex
-
Open a checklist (gnome-tetravex#24 (closed)) -
Open a MR (gnome-tetravex!13 (merged))
-
Games Extra
- aisleriot
-
Open a checklist -
Open a MR
-
- five-or-more
- Does not have a KSP.
- It has four shortcuts: new-game: n, quit: q, help: F1
- four-in-a-row
-
Open a checklist (four-in-a-row#17 (closed)) -
Open a MR (four-in-a-row!16 (merged))
-
- hitori
-
Open a checklist (hitori#14 (closed)) -
Open a MR (hitori!26 (merged))
-
- iagno
-
Open a checklist (iagno#13 (closed)) -
Open a MR (iagno!8 (merged))
-
- quadrapassel
- Does not have a KSP.
- It has five shortcuts: new-game: n, quit: q, help: F1, menu: f10, pause: pause
- swell-foop
-
Open a checklist (swell-foop#15 (closed))
-
- tali
-
Open a checklist -
Open a MR
-
Edited by Ghost User