https://github.com/mipmip/gnome-shell-extensions-useless-gaps
For aesthetic purposes adds useless gaps around tiled and maximized windows
https://github.com/mipmip/gnome-shell-extensions-useless-gaps
gnome-shell-extension
Last synced: 19 days ago
JSON representation
For aesthetic purposes adds useless gaps around tiled and maximized windows
- Host: GitHub
- URL: https://github.com/mipmip/gnome-shell-extensions-useless-gaps
- Owner: mipmip
- License: gpl-3.0
- Created: 2021-12-16T22:23:40.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-25T08:06:40.000Z (about 1 month ago)
- Last Synced: 2025-03-31T04:05:30.214Z (26 days ago)
- Topics: gnome-shell-extension
- Language: JavaScript
- Homepage:
- Size: 96.7 KB
- Stars: 72
- Watchers: 4
- Forks: 18
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- stars - mipmip/gnome-shell-extensions-useless-gaps
README
# Useless Gaps
https://user-images.githubusercontent.com/658612/199604411-f50fc915-ce67-432e-bdec-50d7eec8a9fb.mp4
Useless Gaps is a GNOME Shell Extension which for aesthetic purposes, adds
"useless gaps" around windows.
[
](https://extensions.gnome.org/extension/4684/useless-gaps/)
This extension is intended to be used with Gnome's original Grid functions.
These functions are simple but very useful for most users.
The gaps will appear when a window is Tiled Left Super +
Left, Tiled Right Super +
Right or Maximized Super +
Up.
Better not use this extension together with a specialized tiling extension like
[Forge](https://extensions.gnome.org/extension/4481/forge/),
[gTile](https://extensions.gnome.org/extension/28/gtile/) or
[Tactile](https://extensions.gnome.org/extension/4548/tactile/).
## Features
- Gaps size is configurable
- Create useless gaps around maximized windows
- Create useless gaps around left and right split windows
## Development and manual install
After upgrading gnome-shell often complains about incompatibility issues. This is caused by version requirements set in src/metadata.json.
You can install the extension manually by cloning the repo and then run
```
git clone https://github.com/mipmip/gnome-shell-extensions-useless-gaps.git
cd gnome-shell-extensions-useless-gaps
./install.sh local-install
```
The update the metadata.json with the Gnome version you are running.
## Troubleshooting
**Auto-maximization issue**:
Sometimes when opening large applications, the window will be fully maximized without gaps. This might be due to a setting in Gnome which is adjustable using the dconf editor:
`/org/gnome/mutter/auto-maximize` (defaults is `true`. If you're experiencing this issue, try setting this to `false`)
The description for the setting is `Auto maximize nearly monitor sized windows. If enabled, new windows that are initially the size of the monitor automatically get maximized.`
## Contributing
1. Fork it ( https://github.com/mipmip/gnome-shell-extensions-useless-gaps/fork )
1. Create your feature branch (git checkout -b my-new-feature)
1. Commit your changes (git commit -am 'Add some feature')
1. Push to the branch (git push origin my-new-feature)
1. Create a new Pull Request
## Credits
The idea of having useless gaps come from window managers like
[AwesomeWM](awesomewm.org) and
[DWM](https://dwm.suckless.org/patches/uselessgap/).
The extension
[maximize-to-empty-workspace](https://extensions.gnome.org/extension/3100/maximize-to-empty-workspace/)
served as a great example of how to listen to and act on maximized signals from
mutter.
### Install
You may need to restart GNOME (Alt + F2, r) before you see Shortcuts in your
list of extensions