Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/plutoberth/sonyheadphonesclient

A {Windows, macOS, Linux} client recreating the functionality of the Sony Headphones app
https://github.com/plutoberth/sonyheadphonesclient

bluetooth cpp dear-imgui gui imgui linux macos reverse-engineering windows

Last synced: about 13 hours ago
JSON representation

A {Windows, macOS, Linux} client recreating the functionality of the Sony Headphones app

Host: GitHub
URL: https://github.com/plutoberth/sonyheadphonesclient
Owner: Plutoberth
License: mit
Created: 2020-08-03T12:10:43.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2024-05-24T18:14:49.000Z (7 months ago)
Last Synced: 2024-12-22T15:08:00.883Z (about 13 hours ago)
Topics: bluetooth, cpp, dear-imgui, gui, imgui, linux, macos, reverse-engineering, windows
Language: C++
Homepage:
Size: 2.74 MB
Stars: 1,113
Watchers: 25
Forks: 86
Open Issues: 27
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        


  

    

  

  
Sony Headphones Client


  This project features a PC alternative for the mobile-only Sony Headphones app.

  



  
 


  [![macOS](https://github.com/plutoberth/sonyheadphonesclient/actions/workflows/xcodebuild.yml/badge.svg)](https://github.com/Plutoberth/SonyHeadphonesClient/actions/workflows/xcodebuild.yml)

  [![Linux & Windows](https://github.com/plutoberth/sonyheadphonesclient/actions/workflows/cmake.yml/badge.svg)](https://github.com/Plutoberth/SonyHeadphonesClient/actions/workflows/cmake.yml)

  [![Github all releases](https://img.shields.io/github/downloads/Plutoberth/SonyHeadphonesClient/total.svg)](https://GitHub.com/Plutoberth/SonyHeadphonesClient/releases/)

  [![Donate](static/badge.svg)](https://paypal.me/plutoberth)

  




## Table of Contents

* [Disclaimer](#disclaimer)

* [Download](#download)

* [Motivation](#motivation)

* [Features](#features)

* [Supported Platforms](#supported-platforms-and-headsets)

* [For Developers](#for-developers)

* [Contributors](#contributors)

* [License](#license)

## Disclaimer

### THIS PROGRAM IS NOT AFFILIATED WITH SONY. YOU ARE RESPONSIBLE FOR ANY DAMAGE THAT MAY OCCUR WHILE USING THIS PROGRAM.

## Download

You can download compiled versions of the client from the [releases page](https://github.com/Plutoberth/SonyHeadphonesClient/releases).

**Note:** If you're getting an error like `VCRUNTIME140_1.dll was not found`, you need to install the `Microsoft VC++ Redistributable`.

## Motivation

I recently bought the WH-1000-XM3s, and I was annoyed by the fact that I couldn't change their settings while using my PC.

So I reverse-engineered the application (for intercompatibility purposes, of course), defined the protocol, and created with an alternative application with [Mr-M33533K5](https://github.com/Mr-M33533K5).

## Features

- [x] Ambient Sound Control

- [x] Disabling noise cancelling

- [x] Virtual Sound - VPT and Sound Position

- [ ] Display battery life and fetch existing settings from device

- [ ] Equalizer

## Supported Platforms And Headsets

* WH-1000-XM3: Fully works and supported

* [WH-1000-XM4](https://github.com/Plutoberth/SonyHeadphonesClient/issues/29#issuecomment-792459162): Partially works, more work is needed

* [MDR-XB950BT](https://github.com/Plutoberth/SonyHeadphonesClient/issues/29#issuecomment-804292227): Fully works

* And more! Check out [Headset Reports](https://github.com/Plutoberth/SonyHeadphonesClient/issues/29)

#### **Please report about your experiences using other Sony headsets in the [Headset Reports](https://github.com/Plutoberth/SonyHeadphonesClient/issues/29) issue.**

- [x] Windows

- [x] Linux

- [x] macOS

- [ ] ~~TempleOS~~

## For Developers

```git clone --recurse-submodules https://github.com/Plutoberth/SonyHeadphonesClient.git```

Issue this incantation to fix submodule issues:

```sh

git submodule sync

git submodule update

```

### Protocol Information

Some enums and data are present in the code. The rest has to be obtained either statically or dynamically.

Sniffing messages - See [this helpful comment](https://github.com/Plutoberth/SonyHeadphonesClient/pull/36#issuecomment-795633877) by @guilhermealbm.

### Compiling

#### Windows

Install [cmake](https://cmake.org/download/) (3.29.3 works) and install [Visual Studio Community 2022](https://visualstudio.microsoft.com/vs/) the C++ components:

* MSVC - VS 2022 C++ x64/x86 build tools

* Windows SDK

From within Visual Studio Run the `Tools --> Command Line --> Developer Command Prompt` and then:

```

cd Client

mkdir build

cd build

cmake ..

cmake --build .

```

#### Linux

Debian / Ubuntu:

```bash

sudo apt install libbluetooth-dev libglew-dev libglfw3-dev libdbus-1-dev

```

Fedora:

```bash

sudo dnf install bluez-libs-devel glew-devel glfw-devel dbus-devel

```

#### macOS

Use the provided xcodeproj file.

## Contributors

* [Plutoberth](https://github.com/Plutoberth) - Initial Work and Windows Version

* [Mr-M33533K5](https://github.com/Mr-M33533K5) - BT Interface and Other Help

* [semvis123](https://github.com/semvis123) - macOS Version

* [jimzrt](https://github.com/jimzrt) - Linux Version

* [guilhermealbm](https://github.com/guilhermealbm) - Noise Cancelling Switch

## License

Distributed under the [MIT License](https://github.com/Plutoberth/SonyHeadphonesClient/blob/master/LICENSE). See LICENSE for more information.