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: 4 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 (about 3 years ago)
• Default Branch: main
• Last Pushed: 2024-10-09T09:20:32.000Z (3 months ago)
• Last Synced: 2024-12-31T10:12:15.576Z (11 days ago)
• Topics: gnome-shell-extension
• Language: JavaScript
• Homepage:
• Size: 94.7 KB
• Stars: 66
• Watchers: 3
• Forks: 17
• Open Issues: 7
• 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.

## 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