Skip to content

fyrosofttech/mac-permession-check

Repository files navigation

PermissionAI - macOS & Windows Permission Manager

🤖 Intelligent desktop permissions management for creators and professionals

PermissionAI is a cross-platform Electron application that demonstrates and manages system permissions for microphone, camera, and screen recording on macOS and Windows. Perfect for developers building AI-powered applications that need robust permission handling.

🚀 Features

  • 🎤 Microphone Permission Management - Request and monitor microphone access
  • 📹 Camera Permission Management - Handle camera permissions with proper descriptions
  • 📺 Screen Recording Permission - Complete screen capture permission workflow
  • 🔄 Real-time Permission Monitoring - Live status updates and change detection
  • ⚙️ Direct Settings Integration - One-click access to system privacy settings
  • 🌍 Cross-Platform Support - macOS (Intel + Apple Silicon) and Windows
  • 🔧 Developer Tools - Permission troubleshooting and TCC database inspection

📦 Downloads

macOS

  • Universal Binary (recommended): PermissionAI-1.0.0-universal.dmg
    • Works on Intel Macs, M1, M2, M3, M4
  • Apple Silicon Only: PermissionAI-1.0.0-arm64.dmg
  • Intel Only: PermissionAI-1.0.0.dmg

Windows

  • All Windows Systems: PermissionAI Setup 1.0.0.exe
    • Auto-detects 32-bit/64-bit architecture

🛠️ Development Setup

# Clone repository
git clone https://github.com/fyrosofttech/mac-permession-check.git
cd mac-permession-check

# Install dependencies
npm install

# Start development server
npm start

# Build for all platforms
npm run build

🏗️ Build Commands

# macOS builds
npm run build:mac      # All architectures (universal + separate)

# Windows build
npm run build:win      # 32-bit and 64-bit versions

# Development
npm run dev           # Development mode with devtools
npm test              # Run test suite

📱 Platform-Specific Features

macOS

  • TCC Integration: Proper macOS Transparency, Consent, Control database handling
  • Permission Descriptions: Professional permission request dialogs
  • System Settings: Direct links to specific privacy sections
  • Bundle ID Management: Proper app registration with macOS security system

Windows

  • Privacy Settings: Integration with Windows 10/11 privacy controls
  • Application-Level Permissions: Handles Windows permission model
  • Registry Integration: Proper Windows app registration

🔐 Permission Types

Permission macOS Windows Description
Microphone ✅ System ✅ App-level Audio recording and transcription
Camera ✅ System ✅ App-level Video recording and analysis
Screen Recording ✅ System ✅ Available Screen capture and monitoring

🧪 Testing & Debugging

Permission Status Scripts

# Check current permission status (macOS)
./check-app-permissions.sh

# Reset permissions for testing
./trigger-permissions.sh

🏗️ Technical Architecture

Core Components

  • Main Process: Permission management and system integration
  • Renderer Process: UI and user interaction handling
  • Preload Script: Secure IPC bridge between processes
  • Permission Manager: Cross-platform permission abstraction

Key Technologies

  • Electron 28.x: Cross-platform desktop framework
  • electron-builder: Multi-platform build system
  • systemPreferences API: macOS permission management
  • desktopCapturer: Screen recording capabilities

🔧 Troubleshooting

Common Issues

App Not Appearing in System Settings

  • Ensure NSScreenCaptureUsageDescription is properly set
  • Trigger permission requests through app UI
  • Check code signing status

Permission Always Denied

  • Verify bundle ID matches across all configurations
  • Check entitlements.plist is properly configured
  • Reset TCC database for testing

📄 License

MIT License - see LICENSE file for details.

🏢 About

Created by the PermissionAI Team for developers building AI-powered desktop applications that require robust permission management.

Perfect for:

  • AI interview assistants
  • Screen recording applications
  • Voice transcription tools
  • Video conferencing apps
  • Privacy-conscious productivity tools

🎯 Keywords: electron, permissions, macos, windows, tcc, privacy, microphone, camera, screen-recording, cross-platform, ai, desktop-app

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors