/AutoRaise-UI

Primary LanguageObjective-C++GNU General Public License v3.0GPL-3.0

AutoRaise & Launcher

This project consists of two components: AutoRaise and Launcher.

The AutoRaise binary is written and maintained by Stefan Post at https://github.com/sbmpost/AutoRaise. From the readme:

When you hover a window it will be raised to the front (with a delay of your choosing) and gets the focus. There is also an option to warp the mouse to the center of the activated window when using the cmd-tab key combination.

See also: https://stackoverflow.com/questions/98310/focus-follows-mouse-plus-auto-raise-on-mac-os-x

While AutoRaise is concerned with GUI window and mouse behaviour, as a command line application it lacks a GUI itself.

Here's where the Launcher app bundle comes into play: a menubar application that allows to control and configure the AutoRaise binary. A mouse click on it's menubar icon will start/stop AutoRaise, preferences can be configured from it's context menu and will be saved between sessions.

alt text alt text

Please note that this project does not alter the upstream AutoRaise code, it merely wraps an app bundle around it for convenience.

Installing

There is no installer or pre-built binary being distributed via Github but AutoRaise & Launcher binaries can be installed via MacPorts:

sudo port install AutoRaise

This installs the menubar app bundle (which includes a copy of the upstream AutoRaise cli binary) into your Applications folder and symlinks the cli into the Path, usually into /opt/local/bin

Building from source

# Get ruby
port install ruby32

# Install ruby gem and get cocoapods
curl -L -O https://github.com/rubygems/rubygems/archive/refs/tags/v3.4.1.zip
unzip v3.4.1.zip
ruby-3.2 rubygems-3.4.1/setup.rb --prefix=$HOME/opt/rubygems
~/opt/rubygems/bin/gem install cocoapods --user
~/.gem/ruby/3.2.0/bin/pod install

# Build
xcodebuild -scheme AutoRaise -workspace AutoRaise.xcworkspace

# Install
cp -rp $HOME/Library/Developer/Xcode/DerivedData/AutoRaise-bipxafeozuclxaamwveyrwjaypux/Build/Products/Release/AutoRaise.app /Applications/AutoRaise.app

Running & Configuring

Open AutoRaise.app and click on the menubar icon to enable/disable AutoRaise with default settings. Preferences are saved between sessions in the default ~/Library/Preferences folder. On first launch you should be prompted to grant access for AutoRaise in System Preferences > Security & Privacy > Privacy > Accessibility.

More options to run and configure AutoRaise are explained in the upstream project's Readme.