libzune 0.2.0

libzune 0.2.0

Prerelease, October 14, 2026. The source archive and verification manifest
identify the exact library revision and completed software checks.

New device APIs

• Podcast show inventory, creation and exact-feed reuse; prepared MP3 episode
  upload and lookup using stable source identity.
• Native podcast episode and audiobook part inventories, with explicit complete
  success or failure and matching ownership/free functions.
• Experimental audiobook part lookup and upload on Classic Zune 30 (Keel) and
  Zune HD (Pavo), plus Zune 80/120 (Draco). Applications prepare MP3 parts and
  supply stable book identity.
• Podcast firmware bookmark/marked-played reads and bulk exact feed/source
  identity maps. These read-only APIs support application retention policies;
  unknown state never means played and reading state never authorizes deletion.
• Draco podcast readback accepts observed native schema-0x10 filename and
  redundant-field normalization while retaining exact identity/size checks.
• Podcast listening-state reads now require Classic v2 for Keel and Draco,
  and HD v5 for Pavo; unsupported or mismatched snapshots fail closed.
• Podcast cleanup outcomes distinguish confirmed deletion of a newly failed
  object from uncertain device state. Title-derived firmware filenames now
  accept the observed Classic punctuation behavior without loosening outgoing
  filename or identity checks.

The API reference covers all 105 public functions. The
integration guide explains identities, artwork placement,
return values, ownership and serialized device access. The
source index maps declarations to implementations. The new
buildable C examples demonstrate standalone read-only
inventory and prepared podcast/audiobook uploads using the public API. They do
not require the Zuuned application and keep conversion, feeds and playback
policy outside the device library.

Evidence and limitations

Classic podcast audio and covers have user acceptance. Native two-part MP3
and cover readback passed on Classic and HD; Classic audiobook presentation was
accepted by the user. Firmware played-state evidence exists for Keel and Pavo.
Draco passed an
isolated two-part audiobook audio/art roundtrip and exact cleanup, plus a
read-only 15-episode podcast state snapshot matched against independent live
inventory/source identities. Every Draco bookmark/played flag in that baseline
was zero; it does not prove a completed-playback transition or cleanup.
The research record separates these observations
from software fixtures and records the real Classic podcast batch following the
filename correction.

Corrected Draco podcast transfer/playback/artwork acceptance and a completed
episode followed by cleanup remain hardware gates. The Draco audiobook roundtrip
does not establish device-screen playback or resume.

This is not certification of all models, HD podcast playback/artwork, audiobook
resume, long-book chapter transitions, or every cleanup policy. RSS, downloads,
chapter extraction, conversion and user-facing retention remain application
responsibilities. DRM-protected books and video podcast sending are unsupported.
HD artist backgrounds remain deferred.

The shared-library build still lacks a versioned SONAME and pkg-config file;
this prerelease does not introduce a stable packaged ABI. Calls remain
synchronous and require serialized device ownership. Existing music, video,
photo and playlist APIs remain available.

Build and authentication

See the README and authentication guide.
Public source omits embedded authentication values and accepts an external
~/.mtpz-data file or a locally supplied header. Official Zuuned downloads
supply authentication as part of their separate trusted build process.
Original library code remains GPL-3.0-or-later, with separate third-party notices.