https://github.com/dtinth/focushighlight.spoon

A hammerspoon script that briefly highlights the active window when focused.
https://github.com/dtinth/focushighlight.spoon

hammerspoon lua

Last synced: about 2 months ago
JSON representation

A hammerspoon script that briefly highlights the active window when focused.

• Host: GitHub
• URL: https://github.com/dtinth/focushighlight.spoon
• Owner: dtinth
• Created: 2021-06-30T11:20:01.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2023-08-02T20:43:43.000Z (over 1 year ago)
• Last Synced: 2024-05-02T06:07:08.459Z (8 months ago)
• Topics: hammerspoon, lua
• Language: Lua
• Homepage:
• Size: 1.12 MB
• Stars: 24
• Watchers: 2
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# FocusHighlight.spoon

A macOS utility that briefly highlights the active window when focused. Useful when switching apps on multiple displays, so you know which monitor ends up being focused.

![Example](example.gif)

It is implemented as [a Spoon for Hammerspoon](https://github.com/Hammerspoon/hammerspoon/blob/master/SPOONS.md). You can [customize](#customize) the color of the highlight.

## How to use

1. [Install Hammerspoon](https://www.hammerspoon.org/go/)

2. Install FocusHighlight.spoon using Git:

    ```sh

    git clone https://github.com/dtinth/FocusHighlight.spoon.git ~/.hammerspoon/Spoons/FocusHighlight.spoon

    ```

3. Update Hammerspoon configuration file:

    ```lua

    hs.loadSpoon("FocusHighlight")

    spoon.FocusHighlight:start()

    ```

## Customization

Put these in your configuration file.

```lua

spoon.FocusHighlight.color = "#ffffff"

spoon.FocusHighlight.windowFilter = hs.window.filter.default

spoon.FocusHighlight.arrowSize = 256

spoon.FocusHighlight.arrowFadeOutDuration = 1

spoon.FocusHighlight.highlightFadeOutDuration = 1

spoon.FocusHighlight.highlightFillAlpha = 0.1

```