Skip to content

Repository files navigation

📱 Windows Bluetooth PhoneLink Doctor

Diagnose • Repair • Restore Windows Bluetooth, Audio, and Microsoft Phone Link

Windows Bluetooth PhoneLink Doctor

Technology Cards

Windows PowerShell Batch License


Overview

Windows Bluetooth PhoneLink Doctor is a Windows diagnostic and repair utility that automates many of the most common Bluetooth, audio, and Microsoft Phone Link troubleshooting steps.

Instead of manually restarting services, navigating multiple settings pages, or guessing which microphone or speakers Windows is using, the tool performs automated checks, attempts safe repairs, records diagnostic logs, and guides you through selecting the correct devices when needed.


Features

  • Automated Bluetooth diagnostics and repair
  • Microsoft Phone Link diagnostics
  • Windows audio service verification
  • Simple RUN / RESET workflow
  • Progress window during repairs
  • Diagnostic log generation
  • Opens the Windows Sound Control Panel (mmsys.cpl) for manual audio selection
  • Smart restart recommendations (only when appropriate)

Quick Fix

If audio still isn't working after repairs:

  1. Press Win + R
  2. Type:
mmsys.cpl
  1. Open the Recording tab.
  2. Speak into each microphone and watch for the green activity meter.
  3. Right-click the correct microphone.
  4. Select Set as Default Device.
  5. Select Set as Default Communication Device.
  6. Click Apply then OK.

To change speakers:

  1. Open the Playback tab.
  2. Right-click the correct speakers or headset.
  3. Choose Set as Default Device.
  4. Click Apply then OK.

Architecture

flowchart TD
A[RUN_PHONE_LINK_DOCTOR.bat] --> B[PhoneLink-Bluetooth-Doctor.ps1]
B --> C[Bluetooth Checks]
B --> D[Phone Link Checks]
B --> E[Audio Service Checks]
C --> F[Repair Engine]
D --> F
E --> F
F --> G[Progress Window]
G --> H[Logs]
H --> I[Open mmsys.cpl if needed]
Loading

Execution Pipeline

Launch
 ↓
Verify Administrator
 ↓
Bluetooth Checks
 ↓
Phone Link Checks
 ↓
Audio Service Checks
 ↓
Run Repairs
 ↓
Generate Logs
 ↓
Complete

Project Tree

Windows-Bluetooth-PhoneLink-Doctor/
├── .gitignore
├── LICENSE
├── README.md
├── RUN_PHONE_LINK_DOCTOR.bat
├── config/
├── images/
├── logs/
└── scripts/
    ├── PhoneLink-Bluetooth-Doctor.ps1
    └── PhoneLink-Progress.ps1

Installation

git clone https://github.com/tcdoverlord/Windows-Bluetooth-PhoneLink-Doctor.git
cd Windows-Bluetooth-PhoneLink-Doctor

Quick Start

Double-click:

RUN_PHONE_LINK_DOCTOR.bat

Menu options:

  • RUN — Performs diagnostics and repairs.
  • RESET — Clears saved audio/device selections so the next RUN starts fresh.
  • EXIT — Closes the application.

Logs

Diagnostic logs are written to:

logs/

Include the latest log when reporting issues.

Roadmap

  • Simplified RUN / RESET workflow
  • Smart restart detection
  • Enhanced Bluetooth diagnostics
  • Additional driver repair options
  • Optional graphical interface

Version History

v1.1.1

  • Simplified menu to RUN / RESET / EXIT
  • Added smart restart recommendations
  • Integrated Windows Sound Control Panel guidance
  • Improved audio device recovery workflow

License

This project is licensed under the TCDOVERLORD Personal Learning License (TPLL) v1.0.

This project is intended to support:

  • 📚 Personal learning
  • 🎓 Educational use
  • 🧪 Research and experimentation
  • 💻 Private, non-commercial projects

You are welcome to study, modify, and experiment with the source code for your own personal or educational purposes.

Commercial use—including resale, redistribution, business integration, SaaS offerings, consulting use, enterprise deployment, or inclusion in commercial products—is not permitted without prior written permission from the copyright owner.

For commercial licensing inquiries, please contact:

TCDOVERLORD

GitHub: https://github.com/tcdoverlord

See the LICENSE file for the complete license terms.

Author

TCDOVERLORD

Building practical Windows utilities, automation tools, diagnostic scripts, and open-source learning projects.

Support

When opening an issue, include:

  • Windows version
  • Bluetooth device
  • Phone model
  • Latest log from logs/
  • Steps already attempted

⭐ Star History

Star History

Star History Chart

Golden Rule

Build
 ↓
Test
 ↓
Document
 ↓
git status
 ↓
git add .
 ↓
git status
 ↓
git commit
 ↓
git push
 ↓
Verify
 ↓
Release

About

PowerShell toolkit to diagnose and repair Windows Bluetooth and Microsoft Phone Link issues with automated troubleshooting and repair utilities.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages