README.md
1# GNOME Shell Extensions
2
3GNOME Shell Extensions is a collection of extensions providing additional
4and optional functionality to GNOME Shell.
5
6Since GNOME Shell is not API stable, extensions work only against a very
7specific version of the shell, usually the same as this package (see
8"configure --version"). The extensions in this package are supported by GNOME
9and will be updated to reflect future API changes in GNOME Shell.
10
11The GNOME wiki has more information about [GNOME Shell Extensions][project-page],
12as well as some general information about [GNOME Shell][shell-page].
13
14Bugs should be reported to the GNOME [bug tracking system][bug-tracker].
15
16## Extensions
17
18 * alternate-tab (**OBSOLETE**)
19
20 Lets you use classic Alt+Tab (window-based instead of app-based) in GNOME Shell.
21 This extension is obsolete since GNOME 3.30, see [this blogpost][alternatetab-post]
22 for further details.
23
24 * apps-menu
25
26 Lets you reach an application using gnome 2.x style menu on the panel.
27
28 * auto-move-windows
29
30 Lets you manage your workspaces more easily, assigning a specific workspace to
31each application as soon as it creates a window, in a manner configurable with a
32GSettings key.
33
34 * drive-menu
35
36 Shows a status menu for rapid unmount and power off of external storage devices
37 (i.e. pendrives)
38
39 * launch-new-instance
40
41 Changes application icons to always launch a new instance when activated.
42
43 * native-window-placement
44
45 An alternative algorithm for layouting the thumbnails in the windows overview, that
46 more closely reflects the actual positions and sizes.
47
48 * places-menu
49
50 Shows a status Indicator for navigating to Places.
51
52 * screenshot-window-sizer
53
54 Adds a shortcut for resizing the focus window to a size that is suitable for GNOME Software screenshots
55
56 * user-theme
57
58 Loads a shell theme from ~/.themes/<name>/gnome-shell.
59
60 * window-list
61
62 Adds a bottom panel with a traditional window list.
63
64 * windowsNavigator
65
66 Allow keyboard selection of windows and workspaces in overlay mode.
67
68 * workspace-indicator
69
70 Adds a simple workspace switcher to the top bar.
71
72## Default branch
73
74The default development branch is `main`. If you still have a local
75checkout under the old name, use:
76```sh
77git checkout master
78git branch -m master main
79git fetch
80git branch --unset-upstream
81git branch -u origin/master
82git symbolic-ref refs/remotes/origin/HEAD refs/remotes/origin/main
83```
84
85## License
86
87GNOME Shell Extensions are distributed under the terms of the GNU General
88Public License, version 2 or later. See the [COPYING file][license] for details.
89Individual extensions may be licensed under different terms, see each source
90file for details.
91
92[project-page]: https://wiki.gnome.org/Projects/GnomeShell/Extensions
93[shell-page]: https://wiki.gnome.org/Projects/GnomeShell
94[bug-tracker]: https://gitlab.gnome.org/GNOME/gnome-shell-extensions/issues
95[license]: COPYING
96[alternatetab-post]: https://blogs.gnome.org/fmuellner/2018/10/11/the-future-of-alternatetab-and-why-you-need-not-worry/
97