SpatialInject 0.9.1

SpatialInject 0.9.1

A patch release fixing a Windows-only crash. macOS and Linux are unaffected — if
you are on macOS, 0.9.0 already works correctly and 0.9.1 is functionally identical for you.

Fixed

• Windows: stack overflow in the MP4 rewrite path. The file-copy buffer was allocated
  on the stack, overflowing Windows' 1 MiB default thread stack and crashing (SegFault)
  on any inject. The buffer is now heap-allocated. Surfaced by the Windows CI job.
  (macOS/Linux have an 8 MiB stack and were never affected.)

The macOS app below is the same unsigned Apple Silicon build as 0.9.0 — see the
README for how to open an unsigned app.

---

SpatialInject 0.9.1 (한국어)

Windows 전용 크래시를 고친 패치 릴리즈입니다. macOS·Linux는 영향이 없습니다 — macOS
사용자라면 0.9.0이 이미 정상 동작하며, 0.9.1은 기능상 동일합니다.

수정됨

• Windows: MP4 재기록 경로의 스택 오버플로. 파일 복사 버퍼를 스택에 잡는 바람에 Windows 기본
  스레드 스택(1 MiB)을 넘겨 inject 때마다 크래시(SegFault)했습니다. 이제 힙에 할당합니다.
  Windows CI에서 발견했습니다. (macOS·Linux는 스택이 8 MiB라 애초에 영향이 없었습니다.)

아래 macOS 앱은 0.9.0과 동일한 미서명 Apple Silicon 빌드입니다 — 미서명 앱 여는 법은
README를 참고하세요.

SpatialInject 0.9.0

SpatialInject 0.9.0 — first public release

English below · 한국어는 아래쪽

A clean-room, cross-platform spatial-media metadata toolkit for MP4/MOV — inspect,
verify, and inject 360°/spatial metadata. A modern replacement for Google's Spatial
Media Metadata Injector, and more (inspection and verification are first-class too).

Highlights

• dump / verify / inject — Google Spherical V1 (uuid+XML) and V2 (st3d/sv3d)
• Stereo: mono / side-by-side / over-under (+ swap eyes)
• Spatial audio: SA3D ambiX (ambisonic order auto-detected from channel count)
• wxWidgets desktop GUI (Analyze → Inject → Verify) + a dependency-free CLI
• Never re-encodes, never overwrites the original; mandatory post-inject re-verify
  (metadata round-trip + every stco/co64 chunk offset in bounds)
• Validated end-to-end: Insta360 X4 → encoder → SpatialInject → recognized as 360° by
  YouTube, media stream byte-identical to the input

Download — macOS (Apple Silicon)

Grab SpatialInject-0.9.0-macos-arm64.zip below, unzip, and move SpatialInject.app
to Applications.

The app is not yet code-signed or notarized, so macOS will warn on first launch.
To open it: right-click → Open → Open, or System Settings → Privacy & Security →
Open Anyway, or run xattr -dr com.apple.quarantine /path/to/SpatialInject.app.

Intel / Linux / Windows: build from source (CLI/core have no dependencies).

Not yet included (planned)

• 180° / VR180 projection (Phase 1.5)
• Apple Projected Media Profile — APMP vexu injection (Phase 3)

Implemented clean-room from ISO/IEC 14496-12 and public Spherical/SA3D specs; no
third-party MP4 library and no code from any existing injector. See README and NOTICE.

---

SpatialInject 0.9.0 — 첫 공개 릴리즈

MP4/MOV의 360°·공간 메타데이터를 확인·검증·주입하는 크로스플랫폼 클린룸 툴킷입니다.
Google의 Spatial Media Metadata Injector를 대신하는 현대적 구현이자, 그 이상입니다(검사·검증도 주입과
똑같이 중요하게 다룹니다).

주요 기능

• dump / verify / inject — Google Spherical V1(uuid+XML)과 V2(st3d/sv3d)
• 스테레오: mono / side-by-side / over-under (+ swap eyes)
• 공간 오디오: SA3D ambiX (앰비소닉 차수는 채널 수로 자동 판단)
• wxWidgets 데스크톱 GUI(Analyze → Inject → Verify) + 의존성 없는 CLI
• 재인코딩하지 않고 원본을 덮어쓰지 않음 + 주입 후 필수 재검증
  (메타데이터 재독 + 모든 stco/co64 청크 오프셋 범위 확인)
• 실제 워크플로 검증: Insta360 X4 → 인코더 → SpatialInject → YouTube에서 360° 인식,
  영상 데이터는 입력과 바이트 동일

다운로드 — macOS (Apple Silicon)

아래 SpatialInject-0.9.0-macos-arm64.zip을 받아 압축을 풀고 SpatialInject.app을 응용 프로그램으로
옮기세요.

이 앱은 아직 코드 서명·notarization이 안 되어 있어, 처음 실행 시 macOS가 경고합니다. 여는 법:
우클릭 → 열기 → 열기, 또는 시스템 설정 → 개인정보 보호 및 보안 → 확인 없이 열기, 또는
터미널 xattr -dr com.apple.quarantine /경로/SpatialInject.app.

Intel / Linux / Windows: 소스에서 빌드하세요 (CLI/코어는 의존성 없음).

아직 미포함 (예정)

• 180° / VR180 투영 (Phase 1.5)
• Apple Projected Media Profile — APMP vexu 주입 (Phase 3)

ISO/IEC 14496-12와 공개된 Spherical/SA3D 사양만으로 만든 클린룸 구현이며, 서드파티 MP4 라이브러리도,
기존 인젝터의 코드도 사용하지 않았습니다. 자세한 내용은 README와 NOTICE 참조.