logi-notificationHapticPlugin

KO | EN

gitlite — search

#python #react #ai #go #golang #deep-learning #linux #docker #macos #java #windows #kubernetes #awesome-list #openai

logi-notificationHapticPlugin

(★ 10)

No description available.

logi-notificationHapticPlugin Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# NotificationHaptic Plugin

A Logi Options+ plugin that provides haptic feedback to Logitech mice (such as MX Master 4) when macOS system notifications are triggered.

## ✨ Features

- Automatically detects all macOS system notifications
- Delivers haptic vibration to Logitech devices when notifications occur
- Supports custom haptic waveforms for different devices
- Prevents duplicate notifications with 1.5-second debouncing

## 📦 Installation

### Requirements

- **macOS** (This plugin is macOS-only)
- **Logi Options+** ([Download](https://www.logitech.com/software/logi-options-plus.html))
- **Haptic-enabled Logitech device** (e.g., MX Master 4, MX Master 4S)

### Installation Steps

1. Download the `NotificationHaptic.lplug4` file.
2. **Double-click** the file.
3. Logi Options+ will open.
4. **Important**: You must finalize the installation manually:
   - Go to your device settings (e.g., MX Master 4).
   - Click on **"Smart Actions"** or **"Plugins"** in the sidebar.
   - Click **"INSTALL AND UNINSTALL PLUGINS"** (or Manage Plugins).
   - You should see a confirmation message that "NotificationHaptic" is installed.
5. The plugin is now active!

Or install manually:

```bash
cp NotificationHaptic.lplug4 ~/Library/Application\ Support/Logi/LogiPluginService/Plugins/
```

## 🚀 Usage

1. **Launch Logi Options+**
2. Navigate to your device's button settings
3. Assign the **"Notification Haptic"** action to any button (optional)
4. Now haptic feedback will automatically trigger whenever a macOS notification appears!

> **Note**: Button assignment is optional. Once the plugin is loaded, notification detection starts automatically.

## 🖱️ Notification Click Feature

This plugin project includes a companion app, `ClickNotification.app`, which allows you to programmatically "click" the most recent notification banner by pressing a button on your mouse **(without moving your cursor)**.

### Setup Instructions

1. **Locate the App**: Find `ClickNotification.app` in the project root directory.
2. **Grant Permissions (One-time)**:
    - Double-click `ClickNotification.app` to run it manually.
    - macOS will ask for **Accessibility (System Events)** permissions.
    - Click **Allow/Grant** (or Open System Settings > Privacy & Security > Accessibility and enable it).
3. **Dismiss Debug Alert** (If applicable): If a debug alert appears saying "No windows found", that is normal if no notification is showing. Just dismiss it.

### Assigning to Mouse Button

1. Open **Logi Options+**.
2. Select your mouse and choose the button you want to use (e.g., Forward button).
3. Select **"Open Application"** from the action list.
4. Browse and select `ClickNotification.app`.

Now, whenever a notification banner appears, pressing that button will instantly trigger the notification action **without modifying your mouse position**!

## 🔧 How It Works

1. The plugin monitors the NotificationCenter process using macOS's `log stream` command
2. Filters for "Queuing action present" logs of type `com.apple.unc:application`
3. Triggers a haptic event when filtered logs are detected
4. Logi Options+ sends the haptic signal to the connected device

## 🎵 Haptic Waveforms

- **Default**: `knock` (repetitive knock pattern)
- **MX Master 4**: `ringing` (continuous vibration pattern)

## 📝 Viewing Logs

Plugin logs can be found at:

```
~/Library/Application Support/Logi/LogiPluginService/Logs/
```

## 🛠️ Development

### Building

```bash
cd NotificationHapticPlugin
dotnet build -c Release
```

### Packaging

```bash
logiplugintool pack ./bin/Release ./NotificationHaptic.lplug4
```

### Verification

```bash
logiplugintool verify ./NotificationHaptic.lplug4
```

## 📄 License

## 🐛 Troubleshooting

### When Haptics Don't Work

1. Verify that Logi Options+ is running
2. Check that your device is properly connected
3. Confirm that your device supports haptics
4. Restart Logi Options+

### When Notifications Aren't Detected

1. Verify that macOS system notifications are enabled
2. Check logs: `~/Library/Application Support/Logi/LogiPluginService/Logs/`

## 💡 Detected Notifications

- Messages (iMessage, SMS)
- Focus mode changes
- Third-party app notifications (Slack, Discord, etc.)
- System app notifications (Calendar, Reminders, etc.)

---

**Enjoy!** 🎉

logi-notificationHapticPlugin

logi-notificationHapticPlugin Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

logi-notificationHapticPlugin

logi-notificationHapticPlugin Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README