Platform-Specific Troubleshooting

Resolve platform-specific issues with GhostBro on Windows and macOS systems.

Platform Overview

GhostBro works seamlessly across different operating systems, but occasionally you may encounter platform-specific issues. This guide provides detailed troubleshooting steps for Windows and macOS users to resolve common problems quickly.

🪟 Windows Support
🍎 macOS Support

Windows Troubleshooting

🔊 Microphone not working?

Check Windows Privacy Settings → Microphone → Allow apps to access your microphone. Ensure GhostBro has microphone permissions and no other app is using it.

⚙️ Permissions denied?

Go to Settings → Privacy → Microphone and ensure "Allow desktop apps to access your microphone" is enabled. Restart GhostBro after changing permissions.

🎧 Audio quality poor?

Update your audio drivers, check Windows Sound Settings, and ensure your microphone is set as the default recording device. Use a high-quality external microphone if possible.

🔐 Firewall blocking?

Windows Firewall may block GhostBro's connections. Add GhostBro to allowed apps in Windows Defender Firewall settings or temporarily disable firewall to test.

🌐 Connection unstable?

Check your network adapter settings, disable VPN if enabled, and ensure you have a stable internet connection. Try using a wired connection instead of Wi-Fi.

📹 Screen recording not working?

Ensure GhostBro has screen recording permissions. Check Windows Display Settings and verify multiple monitors are configured correctly if using extended display.

💾 Data not saving?

Check GhostBro app storage permissions, clear app cache, and ensure GhostBro has sufficient storage space. Verify you're logged into your account.

⚡ Performance slow?

Close unnecessary applications, check Windows Task Manager for high resource usage, and ensure GhostBro is updated to the latest version.

macOS Troubleshooting

⚠️

Critical: Screen & System Audio Recording Permissions Required

GhostBro requires Screen Recording and System Audio Recording permissions to function properly on macOS. These permissions enable the app to:

  • 🎤 Transcribe audio from your system and meetings
  • 📸 Take screenshots for analysis
  • 🔍 Analyze visual content and provide insights
  • 💡 Deliver intelligent solutions and suggestions

🎥 Screen Recording Permission Required

Essential for GhostBro functionality:
Go to System Settings → Privacy & Security → Screen Recording and enable access for GhostBro.

Why this is needed: GhostBro needs screen recording permission to capture screenshots, analyze visual content during meetings, and provide context-aware insights based on what's displayed on your screen.

🔊 System Audio Recording Permission Required

Essential for GhostBro functionality:
Go to System Settings → Privacy & Security → Accessibility or System Settings → Privacy & Security → Microphone and ensure GhostBro has access.

Why this is needed: GhostBro needs system audio access to transcribe meetings, capture audio from applications, and provide real-time transcription and analysis.

🔊 Microphone not detected?

Go to System Settings → Privacy & Security → Microphone and ensure GhostBro has permission. Check that no other app is using the microphone.

⚙️ Privacy settings blocking?

Open System Settings → Privacy & Security and review all privacy permissions. Ensure GhostBro has access to Microphone, Screen Recording, and Accessibility. Restart GhostBro after changing permissions.

🎧 Audio issues?

Check System Settings → Sound → Input and verify correct microphone is selected. Ensure input volume is adequate and microphone isn't muted in System Settings.

🔐 Gatekeeper blocking?

macOS Gatekeeper may block GhostBro. Right-click GhostBro and select "Open" or go to System Settings → Privacy & Security and allow the app.

💾 Data not saving?

Check GhostBro app storage permissions, clear app cache, and ensure GhostBro has sufficient storage space. Verify you're logged into your account.

⚡ Battery drain?

Check Activity Monitor for high resource usage, reduce suggestion frequency in settings, and ensure your Mac isn't running unnecessary background processes.

Common Solutions

1

Clear App Cache

Clearing GhostBro's cache often resolves many performance and storage issues.

💡 How to Clear:

  • Open GhostBro Settings → Data & Storage
  • Click "Clear Cache" to remove temporary files
  • Restart GhostBro after clearing cache
  • Check available storage space
2

Update GhostBro

Ensure you're using the latest version of GhostBro for best compatibility and performance.

💡 Update Steps:

  • Check for updates in GhostBro Settings
  • Download and install the latest version
  • Restart GhostBro after updating
  • Clear cache after updating
3

Check Permissions

Incorrect permissions can prevent GhostBro from functioning properly.

💡 Permission Checks:

  • Windows: Check Privacy Settings → Microphone
  • macOS: Check System Settings → Privacy & Security
  • Ensure GhostBro has necessary permissions
  • Restart GhostBro after changing permissions
4

Check Network

Network issues can cause various problems with GhostBro's features.

💡 Network Checks:

  • Test internet connection speed
  • Disable VPN or proxy temporarily
  • Try different network (Wi-Fi vs wired)
  • Restart your router if needed

Advanced Solutions

🔧

System Reboot

A simple restart can resolve many temporary system issues and clear memory.

📋

Check Logs

Review GhostBro logs for error messages and warnings in the app settings.

🔄

Reinstall GhostBro

If all else fails, uninstall and reinstall GhostBro for a fresh start.

📧

Contact Support

Reach out to our support team for personalized assistance with your issue.

Prevention Tips

1

Keep System Updated

Regular system updates prevent many compatibility and security issues.

💡 Best Practices:

  • Enable automatic system updates
  • Keep GhostBro updated to latest version
  • Update audio drivers regularly
  • Restart after major updates
2

Maintain Hardware

Well-maintained hardware ensures optimal GhostBro performance.

💡 Maintenance Tips:

  • Clean microphone regularly
  • Check audio connections
  • Monitor system resources
  • Replace aging hardware
3

Manage Permissions

Proper permissions are essential for GhostBro to function correctly.

💡 Permission Management:

  • Windows: Review Privacy Settings regularly
  • macOS: Check System Settings → Privacy & Security
  • Ensure GhostBro has necessary permissions
  • Restart GhostBro after permission changes

What's Next?

🚀

Quick Start Guide

Get up and running with GhostBro in just 5 minutes with our quick start guide.

Start Now →
🛠️

App Configurations

Customize AI models, transcription providers, and privacy settings.

Configure Now →
⌨️

Keyboard Shortcuts

Master GhostBro's keyboard shortcuts for lightning-fast productivity.

View Shortcuts →
📖

Full Documentation

Explore our comprehensive documentation to learn about advanced features.

View Docs →

Need Help?

Our support team is here to help you resolve any platform-specific issues. Don't hesitate to reach out if you need personalized assistance.