flutter macos permissions

A simple Flutter plugin to request Camera, Microphone, Notification ,Location ,FullDiskAccess ,Bluetooth ,Calendar and Screen & system audio recording permissions on macOS.

This plugin provides an easy-to-use API using method channels to handle macOS permissions in your Flutter desktop apps.

Requirements

Flutter >= 3.27, Dart >= 3.6
macOS deployment target >= 10.15
Supports both CocoaPods and Swift Package Manager for macOS plugin integration

✨ Features

🎥 Request Camera permission

🎤 Request Microphone permission

🔔 Request Notification permission

🌍 Request Location permission

🅱 Request Bluetooth permission

📅 Request Calendar permission

🖥 Request Screen & system audio recording permission

💾 Check Full Disk Access permission

🔎 Check current permission status

📝 Works with Flutter macOS desktop apps

How to use it ?

1. Add dependency

Add this to your package's pubspec.yaml file:

dependencies:
 flutter_macos_permissions: <latest_version>

2. Install it You can install packages from the command line:

with pub :

$ pub get

with Flutter :

$ flutter pub get

3. Import it

Now in your Dart code, you can use :

import 'package:flutter_macos_permissions/flutter_macos_permissions.dart';

4.How to Use it ?

Sample app demonstrates how simple the usage of the library actually is.

Using flutter_macos_permissions in your project easy to intregate.

Build permission with FlutterMacosPermissions

🔹 Request permissions

You can request permissions for Camera, Microphone, Notifications ,Location ,Screen & system audio recording ,FullDiskAccess ,Bluetooth and Calendar :
Every request*() method returns a FlutterMacosPermissionStatus enum (see "Permission status" section below).

 String status = "Idle";

  /// Request Permission
   void request(String type) async {
    FlutterMacosPermissionStatus result = FlutterMacosPermissionStatus.unknown;
    try {
      switch (type) {
        case 'camera':
          result = await FlutterMacosPermissions.requestCamera();
          break;
        case 'microphone':
          result = await FlutterMacosPermissions.requestMicrophone();
          break;
        case 'notification':
          result = await FlutterMacosPermissions.requestNotification();
          break;
        case 'requestLocation':
          result = await FlutterMacosPermissions.requestLocation();
          break;
        case 'requestFullDiskAccess':
          result = await FlutterMacosPermissions.requestFullDiskAccess();
          break;
        case 'requestScreenRecording':
          result = await FlutterMacosPermissions.requestScreenRecording();
          break;
        case 'requestBluetooth':
          result = await FlutterMacosPermissions.requestBluetooth();
          break;
        case 'requestCalendar':
          result = await FlutterMacosPermissions.requestCalendar();
          break;
      }
      setState(() {
        status = 'Requested $type → ${result.isGranted ? "Granted" : "Denied"} (${result.name})';
      });
    } catch (e) {
      setState(() {
        status = 'Error: $e';
      });
    }
  }

Build UI buttons

@override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('MacOS Permissions')),
      body: SingleChildScrollView(
        child: Column(
          children: [
            const SizedBox(height: 20),

            /// Status Display
            Container(
              padding: const EdgeInsets.all(16),
              margin: const EdgeInsets.symmetric(horizontal: 20),
              decoration: BoxDecoration(
                color: Colors.transparent,
                borderRadius: BorderRadius.circular(12),
                border: Border.all(
                  color: Colors.grey.shade400,
                  width: 2, // Border width
                ),
              ),
              child: Text(status, style: const TextStyle(fontSize: 16)),
            ),
            const SizedBox(height: 20),

            /// camera permission and status
            permissionCard(
              'Camera',
              Icons.camera_alt,
              () => request('camera'),
              () => checkStatus('cameraStatus'),
            ),

            /// microphone permission and status
            permissionCard(
              'Microphone',
              Icons.mic,
              () => request('microphone'),
              () => checkStatus('microphoneStatus'),
            ),

            /// notification permission and status
            permissionCard(
              'Notifications',
              Icons.notifications,
              () => request('notification'),
              () => checkStatus('notificationStatus'),
            ),

            /// location permission and status
            permissionCard(
              'Location',
              Icons.location_on,
              () => request('requestLocation'),
              () => checkStatus('locationStatus'),
            ),

            /// screen recording permission and status
            permissionCard(
              'Screen & system audio recording',
              Icons.screen_share,
              () => request('requestScreenRecording'),
              () => checkStatus('screenRecordingStatus'),
            ),

            /// full disk access permission and status
            permissionCard(
              'Full Disk Access',
              Icons.folder,
              () => request('requestFullDiskAccess'),
              () => checkStatus('fullDiskAccessStatus'),
            ),

            /// bluetooth permission and status
            permissionCard(
              'Bluetooth',
              Icons.bluetooth,
              () => request('requestBluetooth'),
              () => checkStatus('bluetoothStatus'),
            ),

            /// calendar permission and status
            permissionCard(
              'Calendar',
              Icons.calendar_month,
              () => request('requestCalendar'),
              () => checkStatus('calendarStatus'),
            ),
          ],
        ),
      ),
    );
  }

📸 Example

without Any Permission	with Camera Permission

with Notification Permission	with Location Permission

with Bluetooth Permission	with FullDiskAccess Permission

with Microphone Permission	Screen & system audio recording Permission

🔹 Check permission status

You can also check the current status without requesting and with requesting.
Every *Status() method returns a FlutterMacosPermissionStatus enum value (see "Permission status" section below).
*Status() only reads the current OS state — it never shows a system prompt. If it returns notDetermined, that means the permission was never requested yet; call the matching request*() method to trigger the actual dialog.

/// Check Permission Status
 void checkStatus(String type) async {
    FlutterMacosPermissionStatus result = FlutterMacosPermissionStatus.unknown;
    try {
      switch (type) {
        case 'cameraStatus':
          result = await FlutterMacosPermissions.cameraStatus();
          break;
        case 'microphoneStatus':
          result = await FlutterMacosPermissions.microphoneStatus();
          break;
        case 'notificationStatus':
          result = await FlutterMacosPermissions.notificationStatus();
          break;
        case 'locationStatus':
          result = await FlutterMacosPermissions.locationStatus();
          break;
        case 'fullDiskAccessStatus':
          result = await FlutterMacosPermissions.fullDiskAccessStatus();
          break;
        case 'screenRecordingStatus':
          result = await FlutterMacosPermissions.screenRecordingStatus();
          break;
        case 'bluetoothStatus':
          result = await FlutterMacosPermissions.bluetoothStatus();
          break;
        case 'calendarStatus':
          result = await FlutterMacosPermissions.calendarStatus();
          break;
      }
      setState(() {
        status = 'Status $type → ${result.name}';
      });
    } catch (e) {
      setState(() => status = 'Error: $e');
    }
  }

Build UI buttons

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('MacOS Permissions')),
      body: SingleChildScrollView(
        child: Column(
          children: [
            const SizedBox(height: 20),

            /// Status Display
            Container(
              padding: const EdgeInsets.all(16),
              margin: const EdgeInsets.symmetric(horizontal: 20),
              decoration: BoxDecoration(
                color: Colors.transparent,
                borderRadius: BorderRadius.circular(12),
                border: Border.all(
                  color: Colors.grey.shade400,
                  width: 2, // Border width
                ),
              ),
              child: Text(status, style: const TextStyle(fontSize: 16)),
            ),
            const SizedBox(height: 20),

            /// camera permission and status
            permissionCard(
              'Camera',
              Icons.camera_alt,
              () => request('camera'),
              () => checkStatus('cameraStatus'),
            ),

            /// microphone permission and status
            permissionCard(
              'Microphone',
              Icons.mic,
              () => request('microphone'),
              () => checkStatus('microphoneStatus'),
            ),

            /// notification permission and status
            permissionCard(
              'Notifications',
              Icons.notifications,
              () => request('notification'),
              () => checkStatus('notificationStatus'),
            ),

            /// location permission and status
            permissionCard(
              'Location',
              Icons.location_on,
              () => request('requestLocation'),
              () => checkStatus('locationStatus'),
            ),

            /// screen recording permission and status
            permissionCard(
              'Screen & system audio recording',
              Icons.screen_share,
              () => request('requestScreenRecording'),
              () => checkStatus('screenRecordingStatus'),
            ),

            /// full disk access permission and status
            permissionCard(
              'Full Disk Access',
              Icons.folder,
              () => request('requestFullDiskAccess'),
              () => checkStatus('fullDiskAccessStatus'),
            ),

            /// bluetooth permission and status
            permissionCard(
              'Bluetooth',
              Icons.bluetooth,
              () => request('requestBluetooth'),
              () => checkStatus('bluetoothStatus'),
            ),

            /// calendar permission and status
            permissionCard(
              'Calendar',
              Icons.calendar_month,
              () => request('requestCalendar'),
              () => checkStatus('calendarStatus'),
            ),
          ],
        ),
      ),
    );
  }

📸 Example

Camera Status	Microphone Status	Screen & system audio recording Status

Notification Status	Location Status

Bluetooth Status	FullDiskAccess Status

📑 Permission Properties

The table below shows the available permissions, their method calls, possible enum values, and the System Preferences location that can be opened if the user has denied access.

Permission	Request Permission	Status Permission	Possible `FlutterMacosPermissionStatus` Values	Opens in System Preferences → Privacy & Security
Camera	`FlutterMacosPermissions.requestCamera()`	`FlutterMacosPermissions.cameraStatus()`	`authorized`, `denied`, `restricted`, `notDetermined`	Camera
Microphone	`FlutterMacosPermissions.requestMicrophone()`	`FlutterMacosPermissions.microphoneStatus()`	`authorized`, `denied`, `restricted`, `notDetermined`	Microphone
Notifications	`FlutterMacosPermissions.requestNotification()`	`FlutterMacosPermissions.notificationStatus()`	`authorized`, `denied`, `notDetermined`, `provisional`, `ephemeral`	Notifications
Location	`FlutterMacosPermissions.requestLocation()`	`FlutterMacosPermissions.locationStatus()`	`authorizedAlways`, `authorizedWhenInUse`, `denied`, `restricted`, `notDetermined`	Location Services
Screen & system audio recording	`FlutterMacosPermissions.requestScreenRecording()`	`FlutterMacosPermissions.screenRecordingStatus()`	`authorized`, `denied`	Screen & system audio recording
Bluetooth	`FlutterMacosPermissions.requestBluetooth()`	`FlutterMacosPermissions.bluetoothStatus()`	`authorized`, `denied`, `notDetermined`, `unsupported`, `unknown`	Bluetooth
FullDiskAccess	`FlutterMacosPermissions.requestFullDiskAccess()`	`FlutterMacosPermissions.fullDiskAccessStatus()`	`authorized`, `denied`, `notDetermined`, `unknown`	Full Disk Access
Calendar	`FlutterMacosPermissions.requestCalendar()`	`FlutterMacosPermissions.calendarStatus()`	`authorized`, `denied`, `restricted`, `notDetermined`, `writeOnly`	Calendars

Calendar requires Info.plist keys. Add NSCalendarsUsageDescription (pre-macOS 14) and, for macOS 14+, NSCalendarsFullAccessUsageDescription / NSCalendarsWriteOnlyAccessUsageDescription to your app's macos/Runner/Info.plist, or the permission prompt won't appear and the request silently fails.

Sandboxed app? If com.apple.security.app-sandbox is true in your macos/Runner/*.entitlements files (the default Flutter macOS template), you also need com.apple.security.personal-information.calendars set to true there — without it the sandbox blocks EventKit outright and the status stays notDetermined forever, even after you add the Info.plist keys above.

🔹 Permission status: `FlutterMacosPermissionStatus`

All request*()/*Status() methods return this enum instead of a raw bool/String, so callers get exhaustive switch support and no magic-string comparisons.
Values: authorized, authorizedAlways, authorizedWhenInUse, denied, restricted, notDetermined, provisional, ephemeral, writeOnly, unsupported, unknown.
isGranted is true for authorized, authorizedAlways, authorizedWhenInUse, provisional, and writeOnly.
writeOnly is Calendar-specific: on macOS 14+, an app can be granted write-only calendar access (can create events but not read existing ones) without a full-access prompt.

final status = await FlutterMacosPermissions.fullDiskAccessStatus();
if (status.isGranted) {
  // proceed
} else if (status == FlutterMacosPermissionStatus.notDetermined) {
  await FlutterMacosPermissions.requestFullDiskAccess();
}

⚠️ Migrating to typed status

Every request*() and *Status() method now returns Future<FlutterMacosPermissionStatus> instead of Future<bool> / Future<String>.

// Before
final bool granted = await FlutterMacosPermissions.requestCamera();
final String status = await FlutterMacosPermissions.cameraStatus();
if (status == 'authorized') { ... }

// After
final FlutterMacosPermissionStatus granted = await FlutterMacosPermissions.requestCamera();
final FlutterMacosPermissionStatus status = await FlutterMacosPermissions.cameraStatus();
if (status.isGranted) { ... }

Bugs and Feedback

We welcome and appreciate any suggestions you may have for improvement. For bugs, questions, and discussions please use the GitHub Issues.

Acknowledgments

flutter_macos_permissions wraps macOS's native permission APIs (AVFoundation, UserNotifications, CoreLocation, CoreBluetooth, EventKit, and the Screen Recording/Full Disk Access privacy checks) behind a single, simple Dart API so you don't have to write platform channel code by hand.

Contribution

The DashStack team enthusiastically welcomes contributions and project participation! There are a bunch of things you can do if you want to contribute! The Contributor Guide has all the information you need for everything from reporting bugs to contributing new features.

Credits

flutter_macos_permissions is owned and maintained by the Dashstack Infotech,Surat. Follow us for updates and new releases 🚀.

flutter macos permissions

Requirements

✨ Features

How to use it ?

1. Add dependency

2. Install it You can install packages from the command line:

3. Import it

4.How to Use it ?

Build permission with FlutterMacosPermissions

🔹 Request permissions

Build UI buttons

📸 Example

🔹 Check permission status

Build UI buttons

📸 Example

📑 Permission Properties

🔹 Permission status: `FlutterMacosPermissionStatus`

⚠️ Migrating to typed status

Bugs and Feedback

Acknowledgments

Contribution

Credits

Libraries

flutter_macos_permissions package

flutter macos permissions

Requirements

✨ Features

How to use it ?

1. Add dependency

2. Install it You can install packages from the command line:

3. Import it

4.How to Use it ?

Build permission with FlutterMacosPermissions

🔹 Request permissions

Build UI buttons

📸 Example

🔹 Check permission status

Build UI buttons

📸 Example

📑 Permission Properties

🔹 Permission status: FlutterMacosPermissionStatus

⚠️ Migrating to typed status

Bugs and Feedback

Acknowledgments

Contribution

Credits

Libraries

flutter_macos_permissions package

🔹 Permission status: `FlutterMacosPermissionStatus`