Useful links for gnome extension development

• gnome shell ui imports: https://github.com/GNOME/gnome-shell/tree/main/js
• gnome shell ui simplified reference: https://github.com/julio641742/gnome-shell-extension-reference/blob/master/REFERENCE.md
• extension api docs (so far useless!!!): https://gjs-docs.gnome.org
• writing extension guide: https://gjs.guide/extensions/development/creating.html
• general gnome extensions page: https://wiki.gnome.org/Projects/GnomeShell/Extensions

GNOME Shell Extension Alt+Tab Scroll Workaround

Quick fix to the bug where scrolling in one application is repeated in another when switching between them using Alt+Tab (e.g., VS Code and Chrome)

As an example, after scrolling VS Code and switching to Chrome using Alt+Tab, Super+Tab, Alt+Esc, or overview (hot corner or Super) + mouse click, the VS Code scroll would be repeated in Chrome. Installing the extension should avoid this.

GNOME 45 supported!

This bug is described in several open issues:

• microsoft/vscode#28795 (most commented VS Code bug!)
• pop-os/pop#2331
• atom/atom#15482
• GitLab: GNOME/mutter#401
• Chromium: chromium#608246
• Chromium: chromium#807187

Usage

Installation from GNOME Extensions

The extension can be found at the GNOME Extensions website: Alt+Tab Scroll Workaround. Just open the page, turn the extension on, and you're ready to go.

Installation from GitHub

If, instead, you prefer to install it from this repository, follow the next steps.

Clone and enter the repository:

git clone https://github.com/lucasresck/gnome-shell-extension-alt-tab-scroll-workaround.git
cd gnome-shell-extension-alt-tab-scroll-workaround

Install the extension:

make install

Restart the GNOME Shell:

• Press Alt+F2;
• Type r and press Enter.

At this point, the extension should be enabled. If not:

make enable

GNOME may also crashes if there are opened windows. Make sure they are closed.

License

GPLv3