# CLI Integration
Source: https://docs.badgeify.app/automation/cli-integration
Control and monitor Badgeify programmatically using the command-line interface
**Version Requirement**: CLI automation is only available in Badgeify version 1.9.2 and later.
Please update to the latest version if you're running an older release.
# Badgeify Command-Line Interface
Badgeify bundles a lightweight CLI inside the desktop binary so automations can inspect notification badges without launching the UI. Run the `badgeify` executable with one of the supported subcommands to query state and exit immediately.
```bash theme={null}
badgeify [options]
```
The process prints a JSON payload to stdout and terminates with exit code `0` on success and `1` on error. Errors are emitted on stderr.
## Installation & Setup
### Locating the CLI Executable
After installing Badgeify via the dmg, the CLI executable is bundled inside the application package at:
```bash theme={null}
/Applications/Badgeify.app/Contents/MacOS/Badgeify
```
### Making the CLI Accessible
You have several options to use the CLI conveniently:
**Option 1: Create an alias (Recommended)**
Add this line to your shell configuration file (`~/.zshrc` for zsh or `~/.bashrc` for bash):
```bash theme={null}
alias badgeify="/Applications/Badgeify.app/Contents/MacOS/Badgeify"
```
Then reload your shell configuration:
```bash theme={null}
source ~/.zshrc # or source ~/.bashrc
```
**Option 2: Create a symbolic link**
```bash theme={null}
sudo ln -s /Applications/Badgeify.app/Contents/MacOS/Badgeify /usr/local/bin/badgeify
```
**Option 3: Use the full path**
You can always invoke the CLI using the complete path without any setup:
```bash theme={null}
/Applications/Badgeify.app/Contents/MacOS/Badgeify list
```
### Verify Installation
Test that the CLI is accessible by running:
```bash theme={null}
badgeify --help # if using alias or symlink
# or
/Applications/Badgeify.app/Contents/MacOS/Badgeify --help
```
## Prerequisites
* Badgeify must already be configured with the apps or groups you want to monitor.
* macOS accessibility permissions are required. If the CLI fails with a `NO_PERMISSIONS` error, grant access via **System Settings → Privacy & Security → Accessibility** and relaunch Badgeify once to register the permission.
## Discover Available IDs
Use `list` to retrieve the apps and groups that can be queried. Each entry exposes an `id`, `type`, `name`, and whether it is currently enabled.
The following examples use `badgeify` as the command. If you haven't set up an alias or symlink, replace `badgeify` with the full path `/Applications/Badgeify.app/Contents/MacOS/Badgeify`.
```bash theme={null}
$ badgeify list
{"success":true,"data":[{"id":"com.apple.Mail","type":"app","name":"Mail"}]}
```
The `id` field becomes the argument for other subcommands.
> **Free tier note:** Without an active license, only the first three configured items are returned.
## Query Unread Status
Fetch the current menubar badge for a specific app or group with `status` and the `--id` flag.
```bash theme={null}
$ badgeify status --id com.apple.Mail
{"success":true,"data":{"type":"app","id":"com.apple.Mail","name":"Mail","enabled":true,"isRunning":true,"shown":true,"unread":5,"statusLabel":"5"}}
```
Important fields:
* `unread` – integer badge count (0 when cleared).
* `statusLabel` – raw menubar badge text (mirrors what macOS reports).
* `shown` – whether the item is currently visible in the Badgeify tray.
* `isRunning` – whether the underlying app is running right now.
If the requested ID is unknown, the CLI returns a `NOT_FOUND` error:
```bash theme={null}
$ badgeify status --id unknown
{"success":false,"error":{"code":"NOT_FOUND","message":"No app or group found with ID: unknown","details":{"requestedId":"unknown"}}}
```
> **Free tier note:** For unlicensed users, `status` is limited to the first three configured items and returns a `FORBIDDEN` error for others.
## Exit Codes
* `0` – Command succeeded and JSON was printed to stdout.
* `1` – Validation, permission, or runtime error; JSON error payload printed to stderr.
## Automation Tips
* The CLI sets the `BADGEIFY_CLI_MODE=1` environment variable while running. You can detect this flag inside scripts if needed.
* Poll `badgeify status --id ` on an interval to react to badge changes from tools like Hammerspoon.
* Parse stdout as JSON to inspect `unread`. For shell scripting, tools such as `jq` make it easy:
```bash theme={null}
badgeify status --id com.apple.Mail | jq '.data.unread'
```
## Troubleshooting
| Symptom | Likely Cause | Resolution |
| ----------------------------------- | ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| `NO_PERMISSIONS` error | Accessibility access not granted | Open System Settings, add Badgeify to Accessibility, relaunch the app |
| CLI exits without printing JSON | Command failed before reaching the handler | Re-run with `badgeify --help` to verify syntax; check stderr for the error payload |
| Badge count differs from macOS dock | The monitored app may suppress menubar badges or accessibility APIs | Confirm the badge appears in the macOS menu bar. Badgeify reports exactly what macOS exposes |
## Getting Help
If the CLI output looks incorrect or you encounter issues not covered here, please capture the command output and email [support@badgeify.app](mailto:support@badgeify.app) so we can investigate.
# Organize with App Groups
Source: https://docs.badgeify.app/features/app-groups
Badgeify's App Groups feature allows you to organize multiple apps under a single icon in your macOS menu bar, reducing clutter and streamlining your workflow.
## What are App Groups?
App Groups let you combine several related applications added via Badgeify into one consolidated menu bar item. Instead of having individual icons for each app, you'll have a single group icon that represents them all.
## Key Features
* **Consolidated Apps**: Group multiple apps (e.g., all messaging apps, all work apps) under one icon.
* **Custom Group Icons**: Assign a unique icon to each App Group for easy identification. You can even use custom SVG icons.
* **Aggregated Notifications**: The group icon displays the total unread notification count for all apps within that group.
* **Easy Management**: Add or remove apps from groups easyily.
## How to Create and Use App Groups
There are two main ways to create an App Group:
**Method 1: Create Group First**
1. **Start Creation**: In the Badgeify app list (Preferences window), click the folder icon (``).
2. **Select Apps**: Choose the apps you want to include in the new group from the list presented.
3. **Confirm**: Badgeify creates the group with your selected apps.
**Method 2: Select Apps First**
1. **Select Existing Apps**: In the Badgeify app list, hold down the `Shift` key and click to select multiple existing app items you want to group.
2. **Click Folder Icon**: With the apps selected, click the folder icon (``).
3. **Group Created**: Badgeify moves the selected apps into a newly created group.
**After Creating the Group:**
4. **Choose an Icon**: Pick a suitable icon for your new group from the available options or upload your own custom SVG icon.
5. **Customize Settings**: Adjust display options and notification settings for the group as needed.
6. **Organized Menu Bar**: Your new App Group will appear as a single, designated icon in the menu bar.
## Benefits of Using App Groups
* **Cleaner Menu Bar**: Significantly reduces the number of icons in your menu bar.
* **Improved Efficiency**: Access related apps and view their combined notification status quickly.
* **Personalized Organization**: Structure your menu bar apps according to your specific workflow (e.g., by project, communication type).
* **Better Overview**: Get an immediate sense of total notifications across related apps.
App Groups work seamlessly with other Badgeify features like custom icon support and drag-and-drop rearrangement.
# Choose Badge Styles
Source: https://docs.badgeify.app/features/badge-styles
Badgeify offers three distinct badge styles to display notification counts in your macOS menu bar, each designed for different privacy and visual preferences.
## Available Badge Styles
Badgeify provides three notification badge styles to match your workflow and aesthetic preferences:
* **Text Style**: Displays exact notification counts as numbers next to app icons
* **Dot Style**: Shows a simple dot indicator for notification presence without revealing counts
* **Circle Style**: iOS-style red circular badges with optional count display
### Text Style
The Text style shows precise notification numbers next to your app icons, providing the most detailed information at a glance.
* **Clear Information**: Displays actual notification numbers (e.g., "5", "12", "99+")
* **Smart Positioning**: Numbers appear to the right of the app icon
* **Theme Adaptive**: Automatically adapts to light and dark menu bar themes
* **Privacy Control**: Can be completely hidden using the "Show Notification Count" setting
### Dot Style
The Dot style offers a minimalist approach, showing notification presence without revealing specific counts.
* **Simple Indicator**: Displays a single dot (•) when notifications are present
* **Always Visible**: Remains visible when notifications exist, regardless of count display settings
* **Theme Aware**: Color adapts to your menu bar theme
* **Privacy First**: No count information displayed
### Circle Style
The Circle style mimics familiar iOS notification badges with distinctive red circles for maximum visual prominence.
* **iOS Familiar**: Red circular badge positioned at the top-right of the icon
* **Flexible Display**: Shows counts inside when "Show Notification Count" is enabled, or empty circles when disabled
* **Customizable**: Supports custom highlight colors
* **Count Limit**: Numbers capped at "99" for large counts
## Show Notification Count Setting
The "Show Notification Count" setting behaves differently based on your chosen badge style:
* **Text Style**: Enables/disables number display entirely
* **Dot Style**: Setting is automatically disabled - dots always appear when notifications exist
* **Circle Style**: Controls whether counts appear inside circles or shows empty circles
## How to Configure Badge Styles
**For Individual Apps:**
1. Right-click any app icon in your menu bar
2. Choose **Settings** from the context menu
3. Select your preferred **Badge Style** from the dropdown
4. Toggle **"Show Notification Count"** as needed
**For App Groups:**
1. Right-click any group icon in your menu bar
2. Choose **Settings** from the context menu
3. Configure badge style and count settings for the entire group
**Global Settings:**
Navigate to **Settings > Advanced > Appearance** to set default badge styles for new apps and configure global notification preferences.
## Customization Options
* **Highlight Colors**: Customize badge colors to match your menu bar aesthetic (all styles supported)
* **App-Specific Behaviors**: Some apps like Slack and Discord offer additional dot indicator controls
* **Mixed Approach**: Use different badge styles for different apps based on importance
Badge styles work seamlessly with Badgeify's [Icon Visibility](./icon-visibility.mdx) settings to create a personalized menu bar experience.
# Customize Menu Bar Icons
Source: https://docs.badgeify.app/features/customize-icon
Badgeify allows you to personalize your macOS menu bar by using your own custom icons for the apps you add.
## Adding Custom SVG Icons
You can replace the default app icons displayed by Badgeify in the menu bar with your own designs using the SVG (Scalable Vector Graphics) format.
### Key Features
* **Use Your Own Designs**: Upload SVG icons you've created or downloaded.
* **High-Quality Display**: SVGs ensure your icons look sharp at any resolution.
* **Flexibility**: Easily change icons whenever you want a new look.
### Intelligent Icon Adaptation
Badgeify intelligently handles your custom icons:
* **Monochrome Icons**: If you upload a single-color SVG icon, Badgeify automatically converts it into a macOS template icon. This means the icon will adapt to light mode, dark mode, and different menu bar background colors, ensuring visibility.
* **Multicolor Icons**: If your SVG icon uses multiple colors, Badgeify preserves the original design, allowing vibrant icons to stand out in the menu bar.
## How to Add a Custom Icon
1. **Get an SVG Icon**: Create your own SVG icon or download one. Ensure it's in the SVG format.
2. **Select the App in Badgeify**: Open Badgeify's preferences and select the app whose icon you want to change.
3. **Upload the Icon**: Look for the option to add a custom icon and upload your `.svg` file.
4. **See the Change**: Your custom icon will immediately appear in the menu bar.
## Finding SVG Icons
If you need icons, here are some resources for free SVG icons mentioned in our blog post:
* [SVG Repo](https://www.svgrepo.com/): Large collection of free SVG icons.
* [Iconify](https://iconify.design/): Access to various open-source icon sets.
## Benefits
* **Personal Expression**: Make your menu bar uniquely yours.
* **Improved Workflow**: Use icons that are instantly recognizable to you.
* **Accessibility**: Design or choose icons that are easier for you to see.
# Customize Notification Colors
Source: https://docs.badgeify.app/features/highlight-color
Enhance your menu bar's clarity by assigning unique highlight colors to the notification badges of your apps and groups in Badgeify. This feature helps you instantly distinguish which app has new updates.
## Why Customize Notification Colors?
* **Improved Visibility**: Quickly identify which app or group has notifications just by the color.
* **Personalization**: Choose colors that fit your workflow or aesthetic preferences.
* **Better Organization**: Visually separate different types of apps (e.g., work vs. personal) in your menu bar.
## How to Set Custom Notification Colors
Setting up custom colors is straightforward:
1. **Open Badgeify Preferences**: Launch Badgeify and open its Preferences window.
2. **Select an App or Group**: In the list on the left, click on the specific app or App Group you wish to customize.
3. **Choose Highlight Color**: Find the "Highlight Color" setting. Click the color swatch to open the color picker.
4. **Pick Your Color**: Select the desired color for the notification badge when there are unread counts.
5. **Apply**: The change takes effect immediately. The selected app or group's icon in the menu bar will now use this color for its notification badge background when notifications are present.
You can set distinct colors for individual applications or apply a single color to an entire App Group for consistent visual grouping. This flexibility allows you to tailor your menu bar notifications precisely to your needs.
# Control Icon Visibility
Source: https://docs.badgeify.app/features/icon-visibility
Badgeify offers several options to control when and how app icons appear in your macOS menu bar, helping you reduce clutter and focus on what's important.
## Hiding Icons Based on Status
You can configure icons to automatically hide or become transparent based on the app's notification status or whether it's running.
* **Hide Icon When No Notifications**: Found in the app's settings (often under an "Advanced" or display section), this option completely hides the app's icon from the menu bar when it has zero unread notifications. This is great for minimizing visual noise.
* **Show Transparent Icon When No Notifications**: As an alternative to hiding completely, this option makes the icon semi-transparent when there are no notifications. This keeps the app accessible in the menu bar but visually de-emphasizes it.
* **Show Transparent Icon When App Isn't Running**: For certain apps, you might only want to see the icon when the application is active. This setting makes the icon transparent if Badgeify detects the underlying application isn't running.
## Pinning Icons
The "Pin to menu bar" option allows you to designate specific app or group icons to *always* be visible in the menu bar. Pinned icons ignore global or individual hiding rules (like "Hide when no notifications"), ensuring your most important apps are always accessible at a glance.
## App-Specific Toggles
Some apps might have unique integration features with their own visibility controls.
* **Slack Dot Indicator**: For Slack, Badgeify supports showing the red dot indicator for unread messages. You can toggle the visibility of this specific dot indicator in Slack's app settings within Badgeify.
By combining these options, you can fine-tune your menu bar to display exactly the icons you need, exactly when you need them.
# null
Source: https://docs.badgeify.app/introduction
# Welcome to Badgeify
Transform your Mac's menu bar into a powerful notification and app launching hub! 🚀
## What is Badgeify?
Badgeify is your ultimate menu bar companion for macOS that helps you:
* Stay updated with notifications from all your apps
* Launch applications quickly
* Keep your workspace clean and organized
## Features
### 🔔 Timely Notifications
* Never miss important messages, even with your Dock hidden
* Get instant updates from emails, messages, and calendar reminders
* Support for both system and third-party applications
### 🎨 Customizable Experience
* Choose custom icons for your menu bar apps
* Automatic light/dark mode adaptation
* Personalize notification highlight colors
* Group related apps under a single icon
### ⚡ Productivity Boost
* Quick access to your frequently used applications
* Smart auto-hide for clutter-free menu bar
* Efficient app grouping for better organization
## Getting Started
1. Download Badgeify
2. Grant necessary permissions (only requires macOS Accessibility API)
3. Start adding your favorite apps to the menu bar
## System Requirements
* macOS 10.15 Catalina or newer
* Compatible with latest macOS versions
* Works alongside other menu bar management tools
## Privacy First
We take your privacy seriously. Badgeify:
* Doesn't collect personal data
* Doesn't share any information
* Only requires essential system permissions
## Ready to Transform Your Menu Bar?
[Download Badgeify](https://badgeify.app/download/) today and experience a more organized and productive Mac workflow!
# null
Source: https://docs.badgeify.app/quickstart
Get up and running with Badgeify in just a few minutes! This guide will help you set up Badgeify and start managing your notifications effectively.
## System Requirements
Before you begin, make sure you have:
* macOS 10.15 (Catalina) or later
* The apps you want to manage installed on your Mac
* A few minutes to complete the setup
## Installation Steps
### 1. Download and Install Badgeify
1. Download Badgeify from our [official website](https://badgeify.app/download/)
2. Open the downloaded file
3. Drag Badgeify to your Applications folder
### 2. Initial Setup
1. Launch Badgeify from your Applications folder
2. When prompted, grant Accessibility permissions:
* Click "Open System Settings"
* Navigate to Privacy & Security > Accessibility
* Toggle on Badgeify
### 3. Adding Your First App
1. Click the Badgeify icon in your menu bar
2. Click the "+" button to add a new app
3. Select an app from the list (e.g., Slack, Messages, Mail)
4. Click "Add" to complete
## Common Questions
### How do I remove an app?
1. Click the Badgeify icon in your menu bar
2. Select the app you want to remove from the app list
3. Click the "-" button to remove it
### Can I reorder icons?
Yes! Drag apps in the settings list to reorder them. The menu bar icons will automatically update to match your new arrangement.
### How do I update Badgeify?
Badgeify will automatically notify you when updates are available
# Compatibility with Hidden Bar
Source: https://docs.badgeify.app/troubleshooting/compatibility-hidden-bar
Some users have reported an issue when using Badgeify alongside the popular menu bar management app, Hidden Bar.
## The Issue
When Badgeify starts, or when it adds a new application icon to the menu bar, Hidden Bar might automatically move this new icon into its hidden section. This requires you to manually drag the Badgeify icon back into the always-visible section of the menu bar each time.
## Cause
This behaviour stems from how Hidden Bar handles newly added menu bar items. By default, Hidden Bar places any icon that appears *after* Hidden Bar has started into its hidden area. Since Badgeify icons are added dynamically, Hidden Bar treats them as "new" and hides them.
This is a known interaction described in the Hidden Bar issue tracker:
[https://github.com/dwarvesf/hidden/issues/156](https://github.com/dwarvesf/hidden/issues/156)
## Resolution
Currently, there is no setting within Badgeify to prevent this interaction.
The optimal solution requires an update to the Hidden Bar application itself. Ideally, Hidden Bar would provide an option to *not* automatically hide newly appearing menu bar icons, similar to functionality found in other menu bar management tools like Bartender.
## Workaround
The only current workaround is to manually drag the Badgeify-managed icons from the hidden section to the visible section after they appear.
We recommend users experiencing this issue monitor the linked GitHub issue in the Hidden Bar repository for updates or consider reaching out to the Hidden Bar developers to request the feature described above.
## Alternatives
If the automatic hiding behaviour of Hidden Bar is disruptive to your workflow with Badgeify, you might consider using alternative menu bar management tools that offer more control over how new items are handled:
* **[Bartender](https://www.macbartender.com/):** A long-standing and feature-rich menu bar manager known for its robust customization options, including how new items are treated.
* ~~**[Ice](https://github.com/jordanbaird/Ice):** A powerful open-source alternative that also provides extensive control over menu bar items.~~ *(Note: Ice currently has [similar compatibility issues](/troubleshooting/compatibility-ice) with dynamic menu bar items)*
These applications may provide a smoother experience when used alongside Badgeify.
# Compatibility with Ice
Source: https://docs.badgeify.app/troubleshooting/compatibility-ice
Some users have reported an issue when using Badgeify alongside the Ice menu bar manager.
## The Issue
When using Ice to manage menu bar items, Badgeify icons may be automatically moved to the "Always Hidden" or "Hidden" section after:
* System restart
* Application restart
* Adding new icons dynamically
This behavior is particularly noticeable with dynamically appearing menu bar items, such as when Badgeify adds new notification badges or updates existing ones.
## Cause
This is a known issue with Ice's menu bar item management system, as documented in their [https://github.com/jordanbaird/Ice/issues/344](https://github.com/jordanbaird/Ice/issues/344). The issue appears to stem from how Ice handles menu bar items that:
1. Appear after Ice has already started
2. Disappear and reappear dynamically
3. Update their state or appearance
Since Badgeify actively manages notification badges and updates icons based on application states, it can trigger this behavior in Ice.
## Current Status
This is a known limitation in Ice's current implementation, affecting not just Badgeify but also other applications with dynamic menu bar items, including:
* Discord voice channel controls
* Calendar apps with dynamic updates
* Applications with changing status indicators
## Workarounds
While there isn't a permanent solution yet, you have several options:
1. **Manual Repositioning:**
* Manually drag Badgeify icons back to your preferred section after they move
* Note that you may need to repeat this after system or application restarts
2. **Use Alternative Menu Bar Managers:**
* Consider using [Bartender](https://www.macbartender.com/) instead, which has better handling of dynamic menu bar items
* Bartender remembers icon positions and handles dynamic updates more reliably
## Future Resolution
The Ice development team is aware of this issue and it may be addressed in future updates. You can:
* Follow the [GitHub issue](https://github.com/jordanbaird/Ice/issues/344) for updates
* Consider contributing to the discussion with your specific use case
* Watch for new Ice releases that might improve dynamic item handling
# Deactivate a Device
Source: https://docs.badgeify.app/troubleshooting/deactivate-device
If you need to free up your Badgeify license activation slot (for example, if you've reached your device limit or are replacing a computer), you can deactivate a device using one of the following methods.
## Method 1: Deactivate from Within the App
If you still have access to the Mac where Badgeify is currently activated:
1. Open the Badgeify **Preferences** window.
2. Navigate to the **About** tab.
3. Look for a button labeled "Deactivate".
4. Click this button and confirm the deactivation.
This will remove the license activation from the current Mac.
## Method 2: Deactivate via License Management Portal
If you no longer have access to the activated Mac (e.g., it was lost, stolen, broken, or reformatted before you could deactivate):
1. Go to the online **License Management portal**: [https://badgeify.app/license/](https://badgeify.app/license/)
2. Enter the **Email** address associated with your purchase and your **License Key**.
3. Click **Continue**.
4. You should see a list of your currently activated devices.
5. Find the device you want to remove and click the corresponding "Deactivate" button.
This allows you to manage your activations remotely.
## Using the License Key Again
Once a device has been successfully deactivated using either method, its activation slot is freed up. You can then use the same license key to activate Badgeify on a new Mac.
# Missing Notification Counts
Source: https://docs.badgeify.app/troubleshooting/missing-notification-counts
If an app icon added via Badgeify isn't displaying the notification count (badge) when you expect it to, follow these steps to troubleshoot the issue.
## 1. Check macOS Permissions
Badgeify relies on the macOS Accessibility API to read notification counts from other applications. Ensure Badgeify still has the necessary permissions.
1. Open **System Settings**.
2. Navigate to **Privacy & Security** > **Accessibility**.
3. Find **Badgeify** in the list.
4. Make sure the toggle next to Badgeify is **ON**.
5. If it was already on, try toggling it OFF and then ON again. You might be prompted to enter your password.
## 2. Check Source App's Notification Settings
Ensure the application itself (e.g., Mail, Slack, Messages) is configured to show badges on its Dock icon.
1. Open the **Settings/Preferences** within the source application (e.g., Slack Preferences).
2. Look for **Notification** settings.
3. Make sure options like "Show badge count" or "Badge Dock icon" are enabled.
*Note: The exact location and wording of these settings vary between applications.*
## 3. Check Badgeify's App Settings
Review the settings for the specific app within Badgeify:
1. Open **Badgeify Settings**.
2. Ensure no settings are preventing the badge from showing, for example:
* Check if **"Hide Icon When No Notifications"** is enabled. While this shouldn't affect counts *when they exist*, double-check its status.
## 5. Check macOS Notification Settings
Ensure macOS isn't suppressing notifications for the app.
1. Open **System Settings**.
2. Go to **Notifications**.
3. Select the source application (e.g., Mail, Slack) from the list.
4. Make sure **"Allow Notifications"** is turned ON.
5. Verify that **"Badge app icon"** is also turned ON.
## 6. Restart Applications
Sometimes a simple restart can resolve temporary glitches.
1. Quit the source application (e.g., fully quit Slack).
2. Quit Badgeify (Right-click the Badgeify icon in the menu bar -> Quit).
3. Relaunch the source application.
4. Relaunch Badgeify.
## 6. Test with Another App
Try adding a different standard app (like Mail or Messages) to Badgeify. Does the badge count work correctly for that app? This helps determine if the issue is specific to one source app or a general Badgeify problem.
## Still Not Working?
If you've tried all the above steps and the notification count still isn't displaying correctly, please reach out for support:
* Use the **Feedback** link in the Badgeify app or documentation.
* Email support directly via the link in the documentation navbar.
# Re-granting Accessibility Permissions
Source: https://docs.badgeify.app/troubleshooting/regrant-accessibility-permissions
If Badgeify loses its Accessibility permissions (for example, after a macOS update or system changes), you may need to manually re-grant these permissions. Follow these steps to restore Badgeify's access.
Starting with **v1.9.4**, Badgeify's code signing certificate was updated from an individual Apple Developer account to an organization account. This change means:
* macOS treats the updated app as a different application
* All previously granted permissions (including Accessibility) need to be re-authorized
* This is a one-time process required only when upgrading from versions prior to v1.9.4
## Why Accessibility Permissions Are Needed
Badgeify requires Accessibility permissions to:
* Read notification counts from other applications
* Monitor app badge changes in real-time
Without these permissions, Badgeify cannot function properly.
## How to Re-grant Accessibility Permissions
### Step 1: Open System Settings
1. Click the **Apple menu** () in the top-left corner of your screen
2. Select **System Settings**
### Step 2: Navigate to Accessibility Settings
1. In System Settings, click on **Privacy & Security** in the sidebar
2. Scroll down and click on **Accessibility**
### Step 3: Remove Badgeify from the List
1. Find **Badgeify** in the list of apps
2. Click on Badgeify to select it
3. Click the **minus (−)** button below the list to remove it
4. Confirm the removal if prompted
### Step 4: Quit Badgeify Completely
1. Right-click the Badgeify icon in your menu bar
2. Select **Quit Badgeify**
3. Make sure the app is completely closed
### Step 5: Relaunch Badgeify
1. Open **Badgeify** from your Applications folder or Launchpad
2. You should see a system prompt asking for Accessibility permissions
3. Click **Open System Settings** in the prompt
### Step 6: Grant Accessibility Permissions
1. In the Accessibility settings window, find **Badgeify** in the list
2. Toggle the switch next to Badgeify to **ON**
3. You may be prompted to enter your Mac password or use Touch ID
4. Confirm the action
### Step 7: Verify Permissions
1. The toggle next to Badgeify should now be **ON** (blue)
2. Return to Badgeify and check if notification counts are displaying correctly
## Troubleshooting
### Permission Dialog Doesn't Appear
If Badgeify doesn't show the permission prompt when launched:
1. Manually open **System Settings** > **Privacy & Security** > **Accessibility**
2. Click the **plus (+)** button below the app list
3. Navigate to your **Applications** folder
4. Select **Badgeify** and click **Open**
5. Toggle the switch next to Badgeify to **ON**
## Still Having Issues?
If you've followed these steps and Badgeify still isn't working properly:
* Use the **Feedback** link in the Badgeify app
* Email support at [support@badgeify.app](mailto:support@badgeify.app)