Skip to content

Releases

Wrapper v2 1.0.0

Choose a tag to compare

@glomatico glomatico released this 19 Nov 17:53

Wrapper v2 1.0.0 is a ground-up rewrite of the original Wrapper v2, built for
clients such as Gamdl that perform media
decryption locally using Temari.
This release is not backward-compatible with earlier Wrapper APIs.

API and architecture

  • Replace the previous server implementation with a Rust HTTP supervisor and
    isolated native C++ Apple Music worker. Communication uses a versioned internal
    IPC protocol; the external HTTP API is unversioned for 1.0.0.
  • Replace the legacy server-side /decrypt API with Temari-compatible decryption
    contexts via /context and /key. Clients decrypt samples themselves.
  • Provide authenticated playback information, session state and credential export
    through /playback, /session, and /session/credentials.
  • Report supported features, architecture, profile and protocol through /info
    so clients can reject incompatible servers before attempting authentication.
  • Support native x86-64 and ARM64 workers, each with verified
    architecture-specific runtime and Apple Music library profiles.

Authentication and lifecycle

  • Support Apple Music login, two-factor challenges, cached session restoration,
    and optional environment-based automatic login.
  • Preserve active two-factor challenges without imposing a short fixed wait
    timeout, and return bounded, privacy-conscious authentication diagnostics.
  • Supervise workers in isolated mount/PID namespaces. Reap child processes,
    recover from worker failures, serialize native requests, and restore authenticated
    sessions following worker recycling.
  • Add safe retry behavior for eligible read-only requests after worker recycling.
    Preserve operation-count limits even for charged failures.
  • Use structured, privacy-conscious JSON logging.

Docker installation

  • Use a multi-stage Docker build for the Rust server, native worker, Linux
    launcher, and full Android runtime. Host-installed Rust and Android NDK are
    not required.
  • Bundle verified Google Android system image components for both supported
    architectures, together with their third-party notices.
  • Accept an authorized, pinned Apple Music 3.6.0-beta (build 1109) standalone
    .apk or .apkm bundle directly as an argument to
    tools/build-docker.sh. Verify the expected manifests and native libraries
    before staging.
  • Pass the private package through an isolated Docker BuildKit build context
    rather than copying the raw package into an image layer.
  • Start Docker Compose without a .env file. Generate a persistent device
    identity on first startup and retain it with account/session data in a named
    volume. Optional .env settings and existing explicit device identities
    remain supported.
  • Bind the Docker HTTP port to localhost by default, and keep account state
    outside the image.

Compatibility and important notices

  • Breaking change: Existing clients using the former /decrypt endpoint
    must migrate to the 1.0.0 session, playback, and Temari context APIs.
  • No APK is distributed with the source code. Users must supply their own
    authorized copy of the pinned Apple Music version.
  • Do not publish or redistribute locally built Docker images. Those images
    include Apple's extracted proprietary libraries even though the Git repository
    does not.
  • Saved sessions depend on their original device identity. Preserve the
    persistent Docker volume and retain existing explicit identity settings when
    upgrading an older deployment.
  • This rewrite has received substantial AI coding assistance. See the
    README acknowledgements and AI disclosure.

0.0.2

Choose a tag to compare

@glomatico glomatico released this 09 Jul 15:30

What's Changed

  • Replaced the public C++ HTTP supervisor with a Rust supervisor.
  • Moved Apple/FPS runtime work into a restartable Android/NDK IPC worker.
  • Replaced HTTP decrypt with WV2D batch TCP decrypt on port 10020.
  • Added worker timeout/restart handling, improved /health, and safer worker cleanup.
  • Updated docs, CI, environment configuration, and FPS terminology.

0.0.1

Choose a tag to compare

@glomatico glomatico released this 09 Jul 15:28

What's Changed

  • Initial wrapper-v2 release with the C++ supervisor and Android/NDK Apple runtime worker.
  • Added HTTP account, playback, health, login, and decrypt endpoints.
  • Added Apple Music Android library staging, Docker build support, and session restore support.