inzone-mac

Control a Sony INZONE H9 / H7 headset from macOS. macOS에서 Sony INZONE H9 / H7 헤드셋을 조작합니다.

Please read first

  • This is an unofficial, independent project. It is not affiliated with, endorsed by, sponsored by or supported by Sony Group Corporation or any of its subsidiaries. Do not contact Sony about it.
  • "INZONE", "Sony" and "PlayStation" are trademarks of their respective owners. They appear here only to identify the hardware this software communicates with, which is nominative use, not a claim of any right in them.
  • No Sony software, source code, binary, firmware, artwork or configuration file is included or redistributed here, in this package or in the repository. The protocol description was written independently for this project, for the sole purpose of making this software interoperate with hardware the user already owns.
  • This software does not modify, patch, replace or circumvent any Sony software, nor does it bypass any technological protection measure. It only sends commands the headset already accepts from Sony's own application.
  • The package is not signed or notarized by Apple, and it is provided free of charge with no warranty of any kind, express or implied, including fitness for a particular purpose. You install and run it at your own risk, and no liability is accepted for damage to hardware, loss of data, or voided warranty.
  • Nothing on this page is legal advice. Local law governs what you may do with it, and complying with it is your responsibility.
  • If you hold a right you believe this project infringes, contact the repository owner through github.com/devinjeon. The material in question will be taken down while it is examined.

먼저 읽어 주십시오

  • 본 프로젝트는 비공식 개인 프로젝트입니다. Sony Group Corporation 및 그 계열사와 어떠한 제휴, 보증, 후원, 지원 관계도 없습니다. 본 소프트웨어에 관하여 Sony에 문의하지 마십시오.
  • "INZONE", "Sony", "PlayStation"은 각 권리자의 상표입니다. 본 페이지에서는 이 소프트웨어가 통신하는 하드웨어를 지시하기 위한 용도로만 사용하며, 해당 상표에 대한 권리를 주장하지 않습니다.
  • Sony의 소프트웨어, 소스 코드, 바이너리, 펌웨어, 이미지, 설정 파일은 본 패키지와 저장소에 포함되어 있지 않으며 재배포하지도 않습니다. 프로토콜 설명은 이용자가 이미 보유한 하드웨어와의 호환을 확보할 목적으로만 본 프로젝트에서 독자적으로 작성한 것입니다.
  • 본 소프트웨어는 Sony의 소프트웨어를 변경, 대체, 우회하지 않으며, 기술적 보호조치를 무력화하지 않습니다. Sony의 자체 응용 프로그램이 보내는 것과 동일하게, 헤드셋이 이미 수용하는 명령만 전송합니다.
  • 본 패키지는 Apple의 서명 및 notarization을 받지 않았습니다. 또한 무상으로 제공되며, 특정 목적 적합성을 포함하여 명시적이든 묵시적이든 어떠한 보증도 하지 않습니다. 설치와 실행의 책임은 이용자에게 있고, 하드웨어 손상, 데이터 손실, 제조사 보증 상실에 대하여 책임을 지지 않습니다.
  • 본 페이지의 내용은 법률 자문이 아닙니다. 허용되는 범위는 이용자가 속한 국가의 법률에 따르며, 이를 준수할 책임은 이용자에게 있습니다.
  • 본 프로젝트가 귀하의 권리를 침해한다고 판단되는 경우 github.com/devinjeon을 통하여 알려 주십시오. 확인하는 동안 해당 자료를 내리겠습니다.

Sony ships INZONE Hub for Windows only. This project talks to the headset's USB transceiver directly, as a menu bar app and a command line tool. Sony는 INZONE Hub를 Windows용으로만 제공합니다. 본 프로젝트는 헤드셋의 USB transceiver와 직접 통신하며, 메뉴 바 앱과 명령행 도구로 구성됩니다.

Install설치

One line한 줄 설치

curl -fsSL https://inzone-mac.pages.dev/install.sh | bash

The script reads the release manifest, verifies the package against its published SHA-256, and hands it to the macOS installer. It asks for sudo once, at the install step. 스크립트는 릴리스 manifest를 읽고, 공개된 SHA-256과 패키지를 대조한 뒤 macOS 설치 프로그램에 넘깁니다. sudo는 설치 단계에서 한 번만 요구합니다.

Piping a script into a shell means trusting whoever controls that URL. Reading it first is reasonable: 스크립트를 shell로 바로 넘기는 것은 해당 URL을 관리하는 주체를 신뢰한다는 뜻입니다. 먼저 내용을 확인하셔도 됩니다. 

curl -fsSL https://inzone-mac.pages.dev/install.sh | less

By hand직접 설치

Download inzone-mac-0.0.1.pkg and open it. inzone-mac-0.0.1.pkg를 내려받아 실행하십시오.

The package is not signed or notarized, so macOS blocks it on the first attempt. Right-click the package and choose Open, or allow it afterwards under System Settings → Privacy & Security. 패키지에 서명과 notarization이 되어 있지 않으므로 macOS가 첫 실행을 차단합니다. 패키지를 우클릭하여 열기를 선택하거나, 차단된 뒤 시스템 설정 → 개인정보 보호 및 보안에서 허용하십시오.

Requirements요구 사항

What it installs설치되는 항목

Path경로 What it is설명
/Applications/INZONE Bar.app Menu bar app메뉴 바 앱
/usr/local/bin/inzone Command line tool명령행 도구

Updates업데이트

The app and the install script both read latest.json, which carries the current version, the package URL and its SHA-256. The app checks it on a schedule you pick and never installs anything on its own: a check reports what it found, and downloading happens when the button is pressed. 앱과 설치 스크립트는 모두 latest.json을 읽습니다. 여기에 현재 버전, 패키지 URL, SHA-256이 들어 있습니다. 앱은 지정한 주기로 이 파일을 확인하지만 스스로 설치하지는 않습니다. 확인 결과만 표시하고, 내려받기는 버튼을 눌렀을 때 시작됩니다.

Limitations한계

Some things are out of reach: the equalizer and spatial sound are a Windows-side software DSP rather than headset settings, nothing can be controlled over Bluetooth, and the microphone mute belongs to the boom's physical position. Other things are implemented but were never tried on hardware, among them the H7 and three of the Bluetooth settings. What is verified sets out all of it, including what was measured and what was only reasoned about. 할 수 없는 일이 있습니다. 이퀄라이저와 입체 음향은 헤드셋 설정이 아니라 Windows 측 소프트웨어 DSP이고, Bluetooth로는 무엇도 조작할 수 없으며, 마이크 음소거는 붐 마이크의 물리적 위치가 결정합니다. 구현했으나 실제 하드웨어에서 시험하지 못한 것도 있습니다. H7과 Bluetooth 설정 세 가지가 그렇습니다. 검증 범위에 측정한 것과 추론에 그친 것을 구분하여 모두 적었습니다.

Uninstall제거

sudo rm -rf "/Applications/INZONE Bar.app"
sudo rm -f /usr/local/bin/inzone
defaults delete local.inzone.bar