# HoiPlayer Windows: replacing the LGPL native library

This addendum covers HoiPlayer Windows 0.5.34 (build 88). The separate Runtime archive contains the original application payload, including the official libmpv-2.dll; it does not contain our modified test library. Its SHA256 and all 97 application-file hashes accompany the delivery record.

[Matching original Runtime archive](https://hoiplayer.com/releases/windows/0.5.34-88/HoiPlayer-Windows-v0.5.34-build88-Runtime.tar.gz) — SHA256 `fdf35fc93b8a0ca23fac203f95efb8f48937269a58cc13f3ede20e521ff5ca6f`; 47,239,742 bytes.

## Matching native sources

The official library SHA256 is 7a69a8f9a6c5d3db5bc038326f9de22c1593e88d005d4055b8b3445473bfec59. Matching libmpv/FFmpeg and dependency sources, build/relink material and original notices are available here:

- [Source archive](https://hoiplayer.com/releases/windows/hoiplayer-windows-native-source-0.5.15-build69-7a69a8f9.tar.gz), 442,587,323bytes; SHA256 79c116080ac9298b5abcfa20c3d605f98dc9b54e8c92f21def9cf6e713c4035c.
- [Build and relink instructions](https://hoiplayer.com/sources/windows/0.5.15-69-7a69a8f9/RELINKING.md).
- [Original notices and licences](https://hoiplayer.com/sources/windows/0.5.15-69-7a69a8f9/NOTICE.txt).

The source export retains its historical build 69 name because the native library bytes are unchanged. It covers the native library and linked dependencies, rather than the separate proprietary application, Flutter, ANGLE or Windows components. Applicable licences permit library modification and reverse engineering needed to debug those modifications; HoiPlayer does not impose a library-signature check that prevents that use.

## Separate ordinary desktop copy

1. Obtain the matching original HoiPlayer Runtime archive supplied alongside these instructions. Check its published SHA256. Preserve your original Store installation and extract the archive into a NEW writable folder of your choice, keeping all files and subfolders together. This copy does not require test registration, Developer Mode or adding a certificate to Windows trust.
2. Close HoiPlayer normally before using the separate copy; an already running instance can otherwise receive the launch. Do not alter WindowsApps or overwrite an installed application's files.
3. Rebuild an interface-compatible x64 libmpv DLL using the matching sources and instructions. Preserve its required API, dependency licences and notices. Keep the original extracted DLL as a backup outside the active runtime folder.
4. Replace ONLY libmpv-2.dll in the new extracted folder with your compatible rebuilt DLL, retaining that filename. Keep the EXE, data directory, other DLLs and notices unchanged. Do not copy a Windows System32 library into the folder.
5. Run HoiPlayer.exe from that folder as an ordinary desktop application. No HoiPlayer or Microsoft private signing key is required to run a compatible modified library in this separate copy. Normal Windows policy, antivirus and SmartScreen decisions still apply; do not disable those controls.
6. Use your own authorised media/source. Application startup, network access and source ownership/activation checks still apply. An unpackaged copy has a different publisher/package context; your Store device code, source authorisation or settings are not promised to migrate automatically. Do not copy private credential files between identities or reset existing ownership to work around that distinction.

The ordinary desktop-copy replacement route was previously exercised on build 79 with a source-modified native library, owned synthetic media, seeking and subtitles. Build 88 retains the same native library and loader components; this archive is hash-matched to the build 88 MSIX payload. A new modified-library playback test on build 88 is not claimed. This does not guarantee all hardware, codecs, physical audio outputs or environments. Keep modifications separately because future official updates can restore official files.

A user-modified copy is not an official Store update and does not replace the Store installation silently. The ordinary runtime remains on the microsoft-store distribution channel and does not enable the website EXE updater. Any separately repackaged MSIX must follow Windows' normal package identity, signing and trust rules; this ordinary-copy procedure does not require repackaging or installing one.

Source or missing-source support: support@hoiplayer.com. These modification instructions do not grant rights to third-party media, trademarks or codec patents and do not promise marketplace approval.
