8 stable releases
2.2.0 | Mar 20, 2025 |
---|---|
2.1.1 | Mar 2, 2025 |
2.1.0 | Feb 28, 2025 |
2.0.4 | Nov 23, 2024 |
1.0.0 |
|
#6 in Accessibility
1,455 downloads per month
70KB
252 lines
tauri-plugin-macos-permissions
This plugin only works on tauri v2, if you need the v1 plugin, feel free to submit a PR!
Support for checking and requesting macos system permissions.
https://github.com/user-attachments/assets/acb63744-9773-420a-8a96-6a485c94f5d6
Install
cargo add tauri-plugin-macos-permissions
You can install the JavaScript Guest bindings using your preferred JavaScript package manager:
pnpm add tauri-plugin-macos-permissions-api
Usage
src-tauri/src/lib.rs
pub fn run() {
tauri::Builder::default()
+ .plugin(tauri_plugin_macos_permissions::init())
.run(tauri::generate_context!())
.expect("error while running tauri application");
}
src-tauri/capabilities/default.json
{
...
"permissions": [
...
+ "macos-permissions:default"
]
}
If you need to access the microphone or camera permissions, please update src-tauri/Info.plist
:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
...
+ <key>NSMicrophoneUsageDescription</key>
+ <string>Describe why your app needs to use microphone permission</string>
+ <key>NSCameraUsageDescription</key>
+ <string>Describe why your app needs to use camera permissions</string>
</dict>
</plist>
Afterwards all the plugin's APIs are available through the JavaScript guest bindings:
import { checkAccessibilityPermission } from "tauri-plugin-macos-permissions-api";
const authorized = await checkAccessibilityPermission();
console.log(authorized); // true
Methods
Method | Description |
---|---|
checkAccessibilityPermission |
Check accessibility permission. |
requestAccessibilityPermission |
Request accessibility permission. |
checkFullDiskAccessPermission |
Check full disk access permission. |
requestFullDiskAccessPermission |
Request full disk access permission. |
checkScreenRecordingPermission |
Check screen recording permission. |
requestScreenRecordingPermission |
Request screen recording permission. |
checkMicrophonePermission |
Check microphone permission. |
requestMicrophonePermission |
Request microphone permission. |
checkCameraPermission |
Check camera permission. |
requestCameraPermission |
Request camera permission. |
Example
git clone https://github.com/ayangweb/tauri-plugin-macos-permissions.git
pnpm install
pnpm build
cd examples/tauri-app
pnpm install
pnpm tauri dev
Thanks
-
Use macos-accessibility-client to check and request accessibility permission.
-
Use FullDiskAccess to check full disk access permission.
-
Use core-graphics to check and request screen recording permission.
-
Use objc2 to check and request microphone or camera permissions.
Who's Use It
Dependencies
~18–58MB
~872K SLoC