Skip to content

Latest commit

 

History

History
138 lines (84 loc) · 6.08 KB

README.md

File metadata and controls

138 lines (84 loc) · 6.08 KB
Raw

Focus Window

focus-window

Do you want a pulldown mode on your terminal without having to switch to tilda or guake? Do you want to focus your Spotify app or email client with a single shortcut key? Then this extension is for you!

This extension allows one to create various shortcuts for applications, enabling the ability to have one shortcut that triggers both the launch and focus of an application window.

focus-window

Installation

Website

  1. Make sure to download the appropriate browser extension and connector according to the GNOME Shell browser integration Installation Guide
  2. Navigate to the GNOME Extensions Website
  3. Install the latest version of Focus Window

Desktop App

  1. Make sure that the gnome-shell-extension-manager application is installed
  2. Search for Focus Window and install the latest version

Manual

  1. Clone the repository:
git clone [email protected]:pcbowers/focus-window.git $HOME/.local/share/gnome-shell/extensions/[email protected]
  1. Restart GNOME:
  • in an X11 session, press Alt+F2 and then run restart
  • in Wayland, log out and log back in
  1. Enable the extension:
gnome-extensions enable [email protected]

Preferences

To open the prefrences after installation, either navigate to the extension on the website or desktop app and click the preferences icon or run the following command:

gnome-extensions prefs [email protected]

Application to Focus

Use this setting to choose the application that should be focused (or launched) when the keyboard shortcut is pressed. This is required for the extension to bind the keyboard shortcut.

Title to Match

An optional title that will filter any open windows of the application by its title. If the title of the window matches this, it will focus it. If this is left empty, then no windows will be filtered.

Exact Title Match

By default, the specified title does not need to be an exact match. Toggling this on will ensure that the windows will be filtered by an exact match to the specified title.

Launch Application

By default, a new window will be launched if there are no windows that already exist (or no windows that match the title). Toggling this off will ensure that no new windows will be launched.

Keyboard Shortcut

This is the keyboard shortcut that focuses (and potentially launches) the application. If multiple windows are found, repeat presses of the keyboard shortcut will cycle through the various windows. If only one window is found, repeate presses of the keyboard shortcut when the window is already focused will minimize it.

Click on the row to set the keyboard shortcut. After clicking, press your shortcut and it will be automatically saved. Press the Escape key to cancel entry. Press Backspace to unbind the shortcut.

FAQ

Can I create multiple shortcuts to launch the same application?

Sure! Just add the application twice!

My keyboard shortcut isn't working. What do I do?

The shortcut may already be bound by the system. Make sure you don't already have a system shortcut that is bound by it!

Also, if there are no existing windows for your application (or no windows that match the desired title) and the Launch Application setting is toggled off, nothing will happen. Try editing your settings by allowing the shortcut to launch an application or changing your title.

If I add a new application but don't configure it, will this break the extension?

It shouldn't! The extension requires an application and keyboard shortcut to be set before binding. Using the Delete Application button exists simply for a better user experience. If the application is not set and/or there is no shortcut, nothing will happen.

How can I contribute?

Create issues and create pull requests. I'm always happy to receive feedback.

If you're planning on submitting a pull request, here are some helpful tips when debugging:

  • View the log for the preferences window with the following command:
journalctl -f -o cat /usr/bin/gjs
  • View the extension debug log with the following command:
journalctl -f -o cat [email protected]
  • View the extension settings with the following command:
dconf dump /org/gnome/shell/extensions/focus-window/
  • Clear the extension settings with the following command:
dconf reset -f /org/gnome/shell/extensions/focus-window/
  • If you make edits to the schema, use this command to compile it before testing or it won't work (and this gives the added benefit of ensuring the schema is formatted properly):
glib-compile-schemas $HOME/.local/share/gnome-shell/extensions/[email protected]/schemas/
  • For some reason, when the preferences are launched from the extension application, the preferences don't update after closing the window and reopening it. To get around this, don't launch the preferences using the extension manager. Instead, use the command:
gnome-extensions prefs [email protected]
  • The preferences panel won't update after closing the window and reopening it if you saved your changes before closing. Make sure to save something in the file after closing to make sure reopening it will show the changes.