https://github.com/daniellandau/switcher
Gnome Shell extension to switch windows quickly by typing
https://github.com/daniellandau/switcher
gnome hacktoberfest
Last synced: 11 months ago
JSON representation
Gnome Shell extension to switch windows quickly by typing
- Host: GitHub
- URL: https://github.com/daniellandau/switcher
- Owner: daniellandau
- License: gpl-3.0
- Created: 2015-08-09T16:49:13.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-12-23T16:37:03.000Z (about 1 year ago)
- Last Synced: 2025-04-01T09:36:12.846Z (11 months ago)
- Topics: gnome, hacktoberfest
- Language: JavaScript
- Homepage:
- Size: 7.77 MB
- Stars: 363
- Watchers: 10
- Forks: 44
- Open Issues: 36
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- stars - daniellandau/switcher
README
# Switcher
Switcher is a [Gnome Shell extension](https://extensions.gnome.org) for quickly
switching windows by typing.
### Installation
Download from https://extensions.gnome.org/extension/973/switcher/ or
checkout to the correct place as
```
mkdir -p ~/.local/share/gnome-shell/extensions # only needed if this is the first extension you install
cd ~/.local/share/gnome-shell/extensions
git clone https://github.com/daniellandau/switcher.git switcher@landau.fi
```
Log out and back in of GNOME Shell, and you can then enable the extension with Gnome Tweaks.
### How to use
Use the configured hot key (Super+wby default) to open the switcher and start
typing a part of the name or current title of the window you want. Hit the Esc
key to cancel and the Return key to activate the window at the top of the list.
## Contributing
Contributions are welcome and I will try my best to answer quickly to all
suggestions. If you start working on something mentioned in [TODO.md](TODO.md), let me
know so I don't scoop you.
## License
This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.
## Aknowledgements
As there is no really good central place to find documentation on writing Gnome
Shell Extensions I'll list here where I got information from.
* The source code of [Project Hamster Extension](https://github.com/projecthamster/shell-extension)
* The source code of [Window List Extension](http://git.gnome.org/gnome-shell-extensions)
* The source code of [Todo.txt Extension](https://extensions.gnome.org/extension/570/todotxt/)
* The source code of [Gnome Shell itself](https://git.gnome.org/browse/gnome-shell/) (especially the file js/ui/switcherPopup.js)
* The documentation listed in this [Stackoverflow answer](https://stackoverflow.com/questions/13107743/documentation-for-writing-gnome-shell-extensions)
* The [Shell Toolkit documentation](https://developer.gnome.org/st/stable/),
which is written for the C library, but can be used for JS too, using e.g.
`new St.Label()` to make a an StLabel.
The icon is based on the "Restore Window" icon by Lloyd Humphreys from the Noun Project, used under a CC-BY version 3.0 license.
I thank my employer [Futurice](https://github.com/futurice/) for providing
monetary sponsorship for this work through the
[Spice Program](http://spiceprogram.org/oss-sponsorship/)