Hammerspoon window switcher full#
Hammerspoon window switcher windows#

The desktop window has no id, a role of AXScrollArea and no subrole.

The desktop belongs to Finder.app: when Finder is the active application, you can focus the desktop by cycling.

An hs.window object representing the desktop.

Hammerspoon window switcher full#

things that are on different Spaces, or things that are Full Screen

Hammerspoon window switcher windows#

Some windows will not be reported by OSX - e.g.The default windowfilter ( hs.) which filters out known cases of not-actual-windows In order to avoid such surprises you can use the hs.window.filter module, and more specifically

Status bar therefore you might get unexpected results - in the Chrome example, calling hs.window.focusWindowSouth()įrom a Chrome window would end up 'focusing' its status bar, and therefore the proper window itself, seemingly resulting 'windows' that one wouldn't expect: for example, every Google Chrome (actual) window has a companion window for its Beside the limitations discussed above, this function will return all windows as reported by OSX, including some.Hs.application.get'Finder':allWindows() will include the desktop in the returned list) This function filters out the desktop 'window' use hs.sktop() to address it.minimized windows and hidden windows (i.e.if Displays have separate Spaces is on (in System Preferences>Mission Control) the current Space is definedĪs the union of all currently visible Spaces.This function can only return windows in the current Mission Control Space if you need to address windows acrossĭifferent Spaces you can use the hs.window.filter module.Performance is not acceptable consider using the hs.window.filter module This function queries all applications for their windows every time it is invoked if you need to call it a lot and.Modules make use of this function, so it is important to understand its limitations visibleWindows(), orderedWindows(), get(), find(), and several more functions and methods in this and other.A list of hs.window objects representing all open windows.Hs.window.allWindows() -> list of hs.window objects

Incorrect results in :setFrame() or downstream modules and don't mind the the wiggling. The default value is false, in order to avoid the possibly annoying or distracting window wiggling set to true if you see However, as a side effect the window might appear to jump around briefly before setting toward its destinationįrame, and, in some cases, the move/resize animation (if requested) might be skipped entirely - these tradeoffs are Setting this variable to true will make :setFrame() perform additional checks and workarounds for these potential When using :setFrame() directly or in downstream uses, such as hs.window:move() and the hs.grid and hs.window.layout modules. Both these OSX issues can cause incorrect behavior Is Terminal windows, which only resize to whole rows and columns. Their placement on screen) only allow being resized at 'discrete' steps of several screen points the typical example Might erroneously end up partially on the adjacent screen after a move/resize. Result in no change at all (you can verify this by trying to resize such a window with the mouse: at first it won't budge,Īnd, as you drag further away, suddenly snap to the new size) and similarly in some cases windows along screen edges Using hs.window:setFrame() in some cases does not work as expected: namely, the bottom (or Dock) edge, and edges between screens, mightĮxhibit some 'stickiness' consequently, trying to make a window abutting one of those edges just slightly smaller could Hs.window.animationDuration = 3 - if you have time on your hands Usage: hs.window.animationDuration = 0 - disable animations Initial value is 0.2 set to 0 to disable animations. The default duration for animations, in seconds. Methods - API calls which can only be made on an object returned by a constructorĪPI Documentation Variables animationDuration Signature.Constructors - API calls which return an object, typically one that offers API methods.Functions - API calls offered directly by the extension.See hs.screen and hs.geometry for more information on how Hammerspoon uses window/screen frames and coordinates.

Hammerspoon docs: hs.window docs » hs.window