Skip to content

Repository files navigation

MicStatusAI

Pull Request Build

Native macOS 15+ menu-bar utility showing default microphone mute state and input volume.

  • Green mic: CoreAudio input mute is disabled
  • Red muted mic: CoreAudio input mute is enabled and verified
  • Gray off mic: monitoring is stopped
  • Global hotkey: Control-Option-M by default; configurable in Settings
  • Device switching: current mute state follows newly selected default microphone

MicStatusAI reads and changes CoreAudio input-mute and input-volume properties. Mute writes are read back for verification. It does not capture or record audio and therefore does not request microphone-recording permission.

Screenshots

Status panel

MicStatusAI status panel showing microphone input level and controls

Menu-bar states

Microphone active Microphone muted
Green active microphone icon in the macOS menu bar Red muted microphone icon in the macOS menu bar

Status overlay

Microphone active Microphone muted
Status overlay showing microphone on at 80 percent Status overlay showing microphone muted

Settings

MicStatusAI settings for global hotkey and status overlay

Install

brew tap Disconnecter/tap
brew install --cask micstatusai

MicStatusAI supports Apple silicon Macs only.

If macOS blocks the app on first launch remove the quarantine attribute:

xattr -dr com.apple.quarantine /Applications/MicStatusAI.app
open /Applications/MicStatusAI.app

Direct download

Alternatively, download the app directly from the Releases page.

Build

Install project tools and generate Xcode project:

brew install xcodegen swiftlint disconnecter/l10n/l10n_xcstrings
Scripts/generate-l10n.sh
xcodegen generate

Open MicStatusAI.xcodeproj in Xcode and run the MicStatusAI scheme. SwiftLint runs automatically during builds.

project.yml is project source of truth. Generated MicStatusAI.xcodeproj is ignored by Git.

Localization

Add short keys and translations to MicStatusAI/Resources/Localizable.xcstrings, then run Scripts/generate-l10n.sh. L10nXcstrings generates MicStatusAI/Generated/L10n.swift; never edit generated code manually.

Contributing

See CONTRIBUTING.md for development setup and pull request workflow.

Some microphones, including certain digital or virtual devices, do not expose software input-mute or input-volume controls. MicStatusAI reports those devices as unavailable.

License

MicStatusAI is available under the MIT License.

About

Native macOS menu bar microphone status and volume utility

Topics

Resources

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages