Skip to content

SpatialInject 0.9.0

Choose a tag to compare

View all tags
@manobit manobit released this 24 Jun 10:54
v0.9.0
37ba237

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 참조.

Assets 3
Loading