x74353 / KeyJerk-Reactions

An app to trigger macOS Sonoma video reactions using hot keys.
Other
19 stars 1 forks source link

alt text

KeyJerk Reactions

KeyJerk Reactions speeds up choosing a Reaction and makes it so you don't have to perform any gestures in front of the camera. By assigning a system-wide hot key to each macOS Reaction, you can trigger any Reaction immediately, right there in the moment. You can also trigger a Reaction through AppleScript, Shortcuts, or by calling up a HUD with a system-wide hot key where you can quickly choose your desired Reaction.

Installation

Download the latest version here.

alt text

How does it work?

KeyJerk Reactions uses macOS Accessibility APIs to control your Mac. When you trigger a Reaction with a system-wide hot key or another method such as AppleScript, Shortcuts, etc., KeyJerk Reactions will quickly click all of the buttons and menus needed to apply the Reaction in the current app that is accessing your Mac's camera.

What's New in KeyJerk Reactions 2?

Requirements

Known Issues/Incompatibilities

More Information

Why Use KeyJerk Reactions?

Available in macOS Sonoma and later, Reactions are video effects such as floating hearts or fireworks that can be applied to the camera feed of most, if not all, apps. This includes FaceTime, Zoom, Slack, and many other apps.

To trigger a Reaction, you typically need to perform a gesture with your hand(s) in front of your Mac's camera, such as a peace sign ✌🏼 or a thumbs-up πŸ‘πŸΌ. Most of the time this works well, though you look kind of silly while doing it. When it doesn't work, others might wonder what the heck you're doing flashing double peace signs at everyone. To trigger a Reaction without a gesture, you have to click a series of buttons and menus which is a slow and tedious process. By the time you've manually chosen your Reaction, it's too late - the effect is lost. KeyJerk Reactions solves this problem by making triggering a Reaction as quick and simple as pressing a system-wide hot key.

KeyJerk Reactions can also integrate with other workflows and automations since it supports AppleScript and Shortcuts. With a simple AppleScript, osascript, or Shortcut you can trigger a Reaction from another app, workflow, or hardware device such as a Stream Deck.

How to Trigger a Reaction with AppleScript?

When KeyJerk Reactions is running, you can trigger a Reaction using AppleScript with the following command:

tell application "KeyJerk Reactions" to react with "Thumbs-up"

Reaction titles:

❀️ Hearts
πŸ‘ Thumbs-up
πŸ‘Ž Thumbs-down
🎈 Balloons
🌧 Rain
πŸŽ‰ Confetti
🚨 Lasers
πŸŽ† Fireworks


Why is it named KeyJerk Reactions?

It's a play on words with the phrase "knee jerk reaction." A knee jerk reaction is a quick, unthinking, reaction you have to something. "Knee" was changed to "Key" because you can use the keyboard to initiate a macOS Reaction using the app. Clever, right? πŸ˜‘

Is KeyJerk Reactions Free & Safe to Use?

Yes, it's 100% free. You can download and install KeyJerk Reactions on any compatible Mac for personal use. You may not redistribute for profit or otherwise sell KeyJerk Reactions in any form. There are no advertisements or in-app purchases in KeyJerk Reactions, nor are there any analytics or other 'spyware' type functions. KeyJerk Reactions.app is code-signed with a valid Apple Developer ID and is notarized by Apple.

If you want to show your appreciation and give a financial gift to support its development, you can do so here.

License

All Rights Reserved

Copyright Β© 2024 William Gustafson

THE CONTENTS OF THIS PROJECT ARE PROPRIETARY AND CONFIDENTIAL.
UNAUTHORIZED COPYING, TRANSFERRING OR REPRODUCTION OF THE CONTENTS OF THIS PROJECT,
VIA ANY MEDIUM IS STRICTLY PROHIBITED.

The receipt or possession of the source code and/or any parts thereof does not
convey or imply any right to usethem for any purpose other than the purpose for
which they were provided to you.

The software is provided "AS IS", without warranty of any kind, express or implied,
including but not limited to the warranties of merchantability, fitness for a
particular purpose and non infringement. In no event shall theauthors or copyright
holders be liable for any claim, damages or other liability, whether in an action of
contract, tort or otherwise, arising from, out of or in connection with the software
or the use or other dealings in thesoftware.

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the software.