react-native-is-muted

Detect whether the device is muted (iOS silent switch / Android ringer mode).

Built with the Expo Modules API. Works in any Expo or bare React Native project with autolinking.

⚠️ Breaking change in 1.0.0

Version 1.0.0 rewrites the package on top of the Expo Modules API. The public JS API has changed:

• The default export IsMuted has been removed.
• Use the named export isMuted (lowercase) instead.

- import IsMuted from 'react-native-is-muted';
- const muted = await IsMuted();
+ import { isMuted } from 'react-native-is-muted';
+ const muted = await isMuted();

The manual iOS step of adding MuteChecker.caf to "Copy Bundle Resources" is no longer required — the podspec bundles it automatically.

Installation

npm install react-native-is-muted

Then rebuild the native app:

npx expo prebuild   # if using a managed Expo project
npx expo run:ios
npx expo run:android

No manual native setup is required — the iOS MuteChecker.caf resource is bundled via the podspec and Android autolinking handles the rest.

Usage

import { isMuted } from 'react-native-is-muted';

const muted = await isMuted();
console.log('Muted:', muted);

Notes

• iOS: returns true when the hardware silent switch is on. Does not work in the iOS Simulator (the call rejects with ERR_SIMULATOR_UNSUPPORTED).
• Android: returns true when the ringer mode is silent or vibrate.
• Web: not supported. Browsers do not expose system mute state.