Giter VIP home page Giter VIP logo

alt-tab-macos's Introduction

"scriptable" branch of lwouis/alt-tab-macos

Made for use with DockAltTab (adds window previews to the MacOS dock)... it does so by sending AppleScript commands to AltTab.

basic commands

  • hide: Hide Overlay/UI.
  • show: Show all app windows. (Regular AltTab shortcut)
  • showApp: Show specific app's windows. (ignores blacklist)
    • appBID: The bundle identifier of the app whose windows you want to show.
    • x: X-coordinate (optional)
    • y: Y-coordinate (optional)
    • dockPos: (optional) Helps AltTab know where previews will be positioned / clip, (especially for docks on the right (preview 'panel' width is relevant))
  • trigger: Goes to the next window, without showing Overlay/UI.
Miscellaneous / DockAltTab commands

Miscellaneous / DockAltTab commands

  • appSetting: Read settings applied on showApp previews.
    • named: Name of the setting. (appsToShow, showHiddenWindows, showFullscreenWindows, showMinimizedWindows, spacesToShow, screensToShow, showTabsAsWindows)
  • countMinimizedWindowsCurrentSpace: The number of (minimized) windows for an app (FROM the current space, especially useful for keeping minimized windows contained in the space they were originally minimized in).
    • appBID
  • countWindows: The number of windows for an app (in all spaces).
    • appBID
  • countWindowsCurrentSpace: The number of windows for an app (in the current space, especially useful for counting hidden windows (otherwise especially hard to do for the current space)).
    • appBID
  • deminimizeFirstMinimizedWindowFromCurrentSpace: Deminimize app's first minimized window originally minimized on the current space.
    • appBID
  • keyState: Whether a certain key is being pressed (see if AltTab overlay is absorbing modifier keys)
    • key: Name of the key you want to check the state of.

example usages:

tell application "AltTab" to showApp appBID "com.apple.Safari"

tell application "AltTab" to showApp appBID "com.apple.Safari" x 0 y 0

tell application "AltTab" to hide

Other Differences

Some other changes I made out of personal preference / hesitation to submit a pull request:

  • ignore some app's windows
  • Preview button order: Exit is 1st, Quit is last (opposed to vice-versa)
  • faster fading (if fading enabled): 111ms for DockAltTab previews, 333ms for regular previews
  • auto reopen controls after closing window (allows click spam to repeat close window quickly)

Contributing

How to build AltTab on Xcode --this youtube video shows how to build the official AltTab from lwouis (but this branch has been normalized to be able to build on m-series/apple silicon, so this may not be necessary)

alt-tab-macos's People

Contributors

adamnemecek avatar afzalive avatar akx avatar ayroblu avatar calinou avatar damonpam avatar decodism avatar gcbw avatar gingerr avatar grzegorzkazana avatar hughlilly avatar i0ntempest avatar karbassi avatar l1cardo avatar lwouis avatar metacodes avatar mnin avatar mrpaschenko avatar nella17 avatar notlmn avatar phungtuanhoang1996 avatar rbnis avatar rjevski avatar samdenty avatar semantic-release-bot avatar skolj avatar steventheworker avatar xanathar avatar xconverge avatar zacharee avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.