Skip to content

Earlo 0.6.0: stereo sound in every app (turn off the earbuds' microphone) - #2

Merged
kylianxdev merged 1 commit into
mainfrom
wiwa-cl/sleepy-meitner-2t2epy
Oct 22, 2026
Merged

kylianxdev merged 1 commit into
mainfrom
wiwa-cl/sleepy-meitner-2t2epy

Conversation

@kylianxdev

Copy link
Copy Markdown
Owner

The problem

As soon as an app opens the earbuds' microphone (Teams, Discord, Zoom, a browser), Windows switches AirPods and other earbuds from stereo music (A2DP) to the Hands-Free profile. That profile is mono and muffled, like a phone call. This is the most common AirPods complaint on Windows. The only real fix is to turn off the earbuds' Hands-Free service: the "Handsfree Telephony" checkbox under Services in the classic Bluetooth device properties.

What this adds

Settings > Sound quality > "Turn off the earbuds' microphone for the best sound" (Dutch: "Microfoon van de oortjes uitzetten voor het beste geluid").

  • Warning: a hint under the switch explains the trade-off. Turning it on asks for confirmation first: the earbuds' microphone stops working, and calls use the PC's microphone instead.
  • Reversible: turning the switch off restores the microphone.
  • Shows the real state: the switch reads the earbuds' actual Bluetooth services, not a stored setting. It applies to the connected earbuds, or the first paired ones.
  • Feedback: a tray notice confirms the change. If it fails, the notice explains how to do it by hand in Control Panel.

How

  • Services/HandsFree.cs turns the Hands-Free service (0x111E, plus Headset 0x1108 where present) on or off with BluetoothSetServiceState, and reads the state with BluetoothEnumerateInstalledServices.
  • Admin rights: if Windows refuses because admin rights are needed, Earlo starts an elevated copy of itself with --hands-free on|off <address>. That is the same pattern as the driver installer.
  • PairedDeviceInfo.Address: a new field with the Bluetooth address, which these APIs need.
  • README: a feature bullet and a question "Why do my AirPods sound bad on Windows?".
  • Store listing: a bullet in the description and the search term "earbuds sound quality".
  • Version 0.6.0.

Testing

  • Locally: the solution builds with the .NET 10 SDK on Linux (-p:EnableWindowsTargeting=true) with 0 warnings, and 43/43 tests pass.
  • Struct layout: BLUETOOTH_DEVICE_INFO marshals to 560 bytes, with Address at offset 8 and szName at offset 64. That matches the Windows SDK layout.
  • Not tested: the Bluetooth calls themselves could not be run here, because there is no Windows or Bluetooth in this environment.

Generated by Claude Code

As soon as an app opens the earbuds' microphone (Teams, Discord, a
browser), Windows switches AirPods and other earbuds from stereo to the
Hands-Free profile, which is mono and sounds like a phone call.

Settings > Sound quality gets a switch that turns the earbuds' Hands-Free
service off (the "Handsfree Telephony" box in the classic Bluetooth device
properties), so Windows can only use stereo. A warning explains first that
the earbuds' microphone then no longer works and calls use the PC's
microphone; the switch turns it back on at any time. It uses
BluetoothSetServiceState and, when Windows wants admin rights, an elevated
copy of Earlo (--hands-free), like the driver installer.

PairedDeviceInfo now carries the Bluetooth address for this.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019mCkM1Z4yuWf75ZuoVrk8o
@kylianxdev
kylianxdev merged commit 46e3b4f into main Oct 22, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants