{"id":13598662,"url":"https://github.com/Plutoberth/SonyHeadphonesClient","last_synced_at":"2025-04-10T09:31:49.467Z","repository":{"id":37527786,"uuid":"284690389","full_name":"Plutoberth/SonyHeadphonesClient","owner":"Plutoberth","description":"A {Windows, macOS, Linux} client recreating the functionality of the Sony Headphones app","archived":false,"fork":false,"pushed_at":"2024-12-27T13:21:47.000Z","size":2876,"stargazers_count":1185,"open_issues_count":26,"forks_count":92,"subscribers_count":27,"default_branch":"master","last_synced_at":"2025-04-07T15:01:32.100Z","etag":null,"topics":["bluetooth","cpp","dear-imgui","gui","imgui","linux","macos","reverse-engineering","windows"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Plutoberth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-03T12:10:43.000Z","updated_at":"2025-04-07T04:43:14.000Z","dependencies_parsed_at":"2024-01-14T04:41:01.093Z","dependency_job_id":"51ec2e8e-4e05-4075-a265-2371789c4f78","html_url":"https://github.com/Plutoberth/SonyHeadphonesClient","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Plutoberth%2FSonyHeadphonesClient","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Plutoberth%2FSonyHeadphonesClient/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Plutoberth%2FSonyHeadphonesClient/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Plutoberth%2FSonyHeadphonesClient/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Plutoberth","download_url":"https://codeload.github.com/Plutoberth/SonyHeadphonesClient/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248191758,"owners_count":21062565,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bluetooth","cpp","dear-imgui","gui","imgui","linux","macos","reverse-engineering","windows"],"created_at":"2024-08-01T17:00:54.774Z","updated_at":"2025-04-10T09:31:49.432Z","avatar_url":"https://github.com/Plutoberth.png","language":"C++","funding_links":["https://paypal.me/plutoberth"],"categories":["C++"],"sub_categories":[],"readme":"\u003cp class=\"aligncenter\"\u003e\n  \u003ca href=\"https://github.com/Plutoberth/SonyHeadphonesClient\"\u003e\n    \u003c!-- img src=\"\" alt=\"Logo\" width=\"80\" height=\"80\"--\u003e\n  \u003c/a\u003e\n\n  \u003ch1 align=\"center\"\u003eSony Headphones Client\u003c/h1\u003e\n\n  This project features a PC alternative for the mobile-only Sony Headphones app.\n  \u003cbr/\u003e\u003cbr/\u003e\n  \u003cimg width=\"556\" src=\"static/showcase.gif\" alt=\"Program Showcase\"\u003e\u003cp\u003e \u003cbr/\u003e\n\n  [![macOS](https://github.com/plutoberth/sonyheadphonesclient/actions/workflows/xcodebuild.yml/badge.svg)](https://github.com/Plutoberth/SonyHeadphonesClient/actions/workflows/xcodebuild.yml)\n  [![Linux \u0026 Windows](https://github.com/plutoberth/sonyheadphonesclient/actions/workflows/cmake.yml/badge.svg)](https://github.com/Plutoberth/SonyHeadphonesClient/actions/workflows/cmake.yml)\n  [![Github all releases](https://img.shields.io/github/downloads/Plutoberth/SonyHeadphonesClient/total.svg)](https://GitHub.com/Plutoberth/SonyHeadphonesClient/releases/)\n  [![Donate](static/badge.svg)](https://paypal.me/plutoberth)\n  \u003cbr/\u003e\n\u003c/p\u003e\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n## Table of Contents\n\n* [Disclaimer](#disclaimer)\n* [Download](#download)\n* [Motivation](#motivation)\n* [Features](#features)\n* [Supported Platforms](#supported-platforms-and-headsets)\n* [For Developers](#for-developers)\n* [Contributors](#contributors)\n* [License](#license)\n\n\u003c!-- disclaimer --\u003e\n## Disclaimer\n\n### THIS PROGRAM IS NOT AFFILIATED WITH SONY. YOU ARE RESPONSIBLE FOR ANY DAMAGE THAT MAY OCCUR WHILE USING THIS PROGRAM.\n\n## Download\n\nYou can download compiled versions of the client from the [releases page](https://github.com/Plutoberth/SonyHeadphonesClient/releases).\n\n**Note:** If you're getting an error like `VCRUNTIME140_1.dll was not found`, you need to install the `Microsoft VC++ Redistributable`.\n\n## Motivation\n\nI recently bought the WH-1000-XM3s, and I was annoyed by the fact that I couldn't change their settings while using my PC.\nSo 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).\n\n## Features\n\n- [x] Ambient Sound Control\n- [x] Disabling noise cancelling\n- [x] Virtual Sound - VPT and Sound Position\n- [ ] Display battery life and fetch existing settings from device\n- [ ] Equalizer\n\n## Supported Platforms And Headsets\n\n* WH-1000-XM3: Fully works and supported\n* [WH-1000-XM4](https://github.com/Plutoberth/SonyHeadphonesClient/issues/29#issuecomment-792459162): Partially works, more work is needed\n* [MDR-XB950BT](https://github.com/Plutoberth/SonyHeadphonesClient/issues/29#issuecomment-804292227): Fully works\n* And more! Check out [Headset Reports](https://github.com/Plutoberth/SonyHeadphonesClient/issues/29)\n\n#### **Please report about your experiences using other Sony headsets in the [Headset Reports](https://github.com/Plutoberth/SonyHeadphonesClient/issues/29) issue.**\n\n- [x] Windows\n- [x] Linux\n- [x] macOS\n- [ ] ~~TempleOS~~\n\n## For Developers\n\n```git clone --recurse-submodules https://github.com/Plutoberth/SonyHeadphonesClient.git```\n\nIssue this incantation to fix submodule issues:\n```sh\ngit submodule sync\ngit submodule update\n```\n\n### Protocol Information\n\nSome enums and data are present in the code. The rest has to be obtained either statically or dynamically.\n\nSniffing messages - See [this helpful comment](https://github.com/Plutoberth/SonyHeadphonesClient/pull/36#issuecomment-795633877) by @guilhermealbm.\n\n### Compiling\n\n#### Windows\nInstall [cmake](https://cmake.org/download/) (3.29.3 works) and install [Visual Studio Community 2022](https://visualstudio.microsoft.com/vs/) the C++ components:\n* MSVC - VS 2022 C++ x64/x86 build tools\n* Windows SDK\n\nFrom within Visual Studio Run the `Tools --\u003e Command Line --\u003e Developer Command Prompt` and then:\n```\ncd Client\nmkdir build\ncd build\ncmake ..\ncmake --build .\n```\n\n#### Linux\n\nDebian / Ubuntu:\n\n```bash\nsudo apt install libbluetooth-dev libglew-dev libglfw3-dev libdbus-1-dev\n```\n\nFedora:\n```bash\nsudo dnf install bluez-libs-devel glew-devel glfw-devel dbus-devel\n```\n\n#### macOS\n\nUse the provided xcodeproj file.\n\n## Contributors\n\n* [Plutoberth](https://github.com/Plutoberth) - Initial Work and Windows Version\n* [Mr-M33533K5](https://github.com/Mr-M33533K5) - BT Interface and Other Help\n* [semvis123](https://github.com/semvis123) - macOS Version\n* [jimzrt](https://github.com/jimzrt) - Linux Version\n* [guilhermealbm](https://github.com/guilhermealbm) - Noise Cancelling Switch\n\n\u003c!-- LICENSE --\u003e\n## License\n\nDistributed under the [MIT License](https://github.com/Plutoberth/SonyHeadphonesClient/blob/master/LICENSE). See LICENSE for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPlutoberth%2FSonyHeadphonesClient","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPlutoberth%2FSonyHeadphonesClient","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPlutoberth%2FSonyHeadphonesClient/lists"}