WearEars
INDEPENDENT WEARABLE AUDIOWEAR OS × TWS

WearEarsSound, on your wrist.

Check earbud battery and switch listening modes from a Wear OS watch. One place for everyday controls across brands.

PlatformWear OS
ApproachOpen-source drivers
Public releasev0.4.0 (opens in a new tab)

01 / PROJECT

Everyday controls within reach.

WearEars brings familiar earbud controls into one watch interface. The model and its driver determine which controls are available.

Find your model
  1. Battery awareness

    See left, right, case or aggregate battery as reported by the earbuds.

    Implemented
  2. Acoustic control

    Switch between noise cancellation, off and transparency on supported models.

    By model
  3. Cross-brand compatibility

    Find device capabilities, hardware records and protocol candidates by model.

    Public records
  4. Extensible drivers

    Add drivers through a shared interface and reuse the controls on the watch.

    Implemented

02 / SYSTEM DESIGN

One interface. Independent drivers.

Four layers give each step a clear role, from a tap on the watch to a state report from the earbuds.

Read the developer guide
  1. InteractionWatch app & tiles

    The watch app and tiles expose controls. The connection controller coordinates queries, requested modes and device reports.

    View source (opens in a new tab)
  2. Unified contractTwsClient

    TwsClient defines the interface for connection, battery queries and mode changes. Drivers declare available operations through capability flags.

    View source (opens in a new tab)
  3. Driver selectionDriverRegistry

    The registry selects a candidate driver from device information and keeps brand protocols separate from the interface.

    View source (opens in a new tab)
  4. CommunicationRFCOMM / GATT

    Drivers parse device frames and perform implemented protocol operations. The standard path reads aggregate battery when the system provides it.

    View source (opens in a new tab)

03 / EXPLORE

Find your starting point.

01 / LISTENERS

Find what works with your earbuds.

Check the record for your model, then get the watch app from GitHub.

Check compatibility

02 / DEVELOPERS

From protocol to driver.

Read the contract, matching rules and evidence workflow to contribute a driver.

Developer resources

03 / PARTNERS

Validate more devices together.

Explore joint validation and driver adaptation around specific models, firmware and capabilities.

Explore collaboration

04 / JOURNAL

Project journal

GitHub releases and notes from protocol development.

See the journal
  1. WearEars v0.4.0Release (opens in a new tab)
  2. WearEars v0.3.5Release (opens in a new tab)
  3. WearEars v0.3.0Release (opens in a new tab)