Troubleshooting CrankWheel Screen Sharing on Chrome: Common Fixes

Troubleshooting CrankWheel Screen Sharing on Chrome: Common Fixes

1. Confirm Chrome and CrankWheel versions

• Update Chrome: Go to chrome://settings/help and install any available updates, then relaunch Chrome.
• Update CrankWheel extension: Open chrome://extensions/, enable Developer mode, click “Update” to ensure the extension is current.

2. Check extension permissions

• Allow screen capture: Open chrome://extensions/, find CrankWheel, click “Details,” and ensure it has permission to “Read and change all your data” and any screen capture-related permissions.
• Site access: If sharing from a specific site, set the extension’s site access to “On all sites.”

3. Verify Chrome’s screen-sharing settings

• Media permissions: In the address bar, click the padlock when on the CrankWheel page and confirm “Screen” or “Share your screen” is allowed.
• Use proper capture tab/window: When prompted to share, choose the right tab, window, or screen. For tab-specific sharing, select the tab and check “Share audio” if needed.

4. Resolve conflicts with other extensions

• Disable suspect extensions: Temporarily disable other screen-capture or privacy extensions (e.g., ad blockers, VPN extensions, other screen-share tools) via chrome://extensions/ and retry.
• Test in Incognito: Enable CrankWheel for Incognito (Details → “Allow in incognito”) and test to see if conflicts disappear.

5. Address OS-level permissions

• macOS:
  • Screen Recording permission: Open System Settings → Privacy & Security → Screen Recording and ensure Chrome is checked. Restart Chrome after enabling.
• Windows:
  • Graphics and privacy settings: In Settings → Privacy & security → Screen capture (or Graphics settings), confirm Chrome isn’t blocked by OS privacy controls.
• Linux:
  • Wayland vs X11: If using Wayland, try an X11 session or use Chrome’s experimental screen capture flags if necessary.

6. Fix black screen or blank sharing

• Disable hardware acceleration: chrome://settings/system → toggle off Use hardware acceleration when available, then relaunch Chrome.
• Use window instead of tab: If a tab shows black, try sharing the entire window or full screen instead.
• Restart Chrome and extension: Close all Chrome windows, reopen, and try again.

7. Improve performance and latency

• Close heavy apps/tabs: Reduce CPU/GPU load by closing unused tabs and apps.
• Check network: Test internet speed and switch to a wired connection or a better Wi‑Fi channel.
• Lower capture resolution: Within CrankWheel settings (if available), choose a lower resolution or bitrate.

8. Handle audio issues

• Select correct audio source: When prompted, ensure “Share audio” is checked and the proper playback device is selected.
• Check system audio settings: Verify Chrome isn’t muted in the OS mixer and that output devices are correct.

9. Test with a clean profile

• Create a new Chrome profile: Settings → You and Google → Add profile. Install CrankWheel and test to rule out profile corruption.

10. Reinstall as a last resort

• Remove and reinstall: Remove the CrankWheel extension, restart Chrome, then reinstall from the Chrome Web Store.
• Clear cache: chrome://settings/clearBrowserData — clear cached images and files (keep passwords/bookmarks).

11. Contact support & collect diagnostics

• Collect logs/screenshots: Note Chrome version, OS version, and extension version; take screenshots of errors.
• Contact CrankWheel support: Provide the collected diagnostics and steps to reproduce the issue.

If you want, I can produce a short checklist you can copy for quick troubleshooting steps.