Theia: source code for the LGPL libraries ========================================== Theia is made by Lupo Software LLC. Its video engine is libmpv and FFmpeg, which are licensed under the GNU LGPL. This folder has the source code for the exact builds that ship with Theia, for the other copyleft libraries built into them, and the recipes and settings used to build them. Questions: support@theiaplayer.com Checksums for every file: SHA256SUMS Download address: https://downloads.theiaplayer.com/source/ WINDOWS ------- Theia for Windows 0.2.2 through 0.4.0 ship this libmpv-2.dll, next to theia.exe: size 100,022,784 bytes SHA-256 dfbec9a5511749374bf7e2261c1040bc65dbfa35c9825c5425a202c4a9c2eccd It is the LGPL build published by zhongfly/mpv-winbuild as release 2026-09-13-13a4bfbc1a, file mpv-dev-lgpl-x86_64-20260913-git-13a4bfbc1a.7z (SHA-256 152188dd100c7206917ca5e4d43d5b548170ad91046cdb0415dfde0e168fb640), built by https://github.com/zhongfly/mpv-winbuild/actions/runs/34761447731 FFmpeg and the libraries below are linked statically into that one DLL. FFmpeg was configured with --enable-version3, so the DLL as a whole is distributed under the GNU LGPL version 3 or later. windows/libmpv/mpv-13a4bfbc1a18.tar.gz mpv at commit 13a4bfbc1a184c0576ca69c2de486a972aeb2407, which the DLL reports as v0.41.0-1048-g13a4bfbc1. Built unmodified with -Dgpl=false, which makes it LGPL 2.1 or later. windows/ffmpeg/ffmpeg-7523428c26bd.tar.gz FFmpeg at commit 7523428c26bdb0b2302303534be591fe73178ab6, which the DLL reports as N-126537-g7523428c2. Built unmodified. Its configure output ends with "License: LGPL version 3 or later". windows/libs/ The other libraries in the DLL whose licenses ask for source: fribidi-c928e4c77549.tar.gz FriBidi 1.0.16 LGPL 2.1+ libplacebo-3330a515d621.tar.gz libplacebo 7.371.0 LGPL 2.1+ openal-soft-adf57df6fcd1.tar.gz OpenAL Soft LGPL 2+ libbluray-a24f4fad4d62.tar.gz libbluray 1.5.1 LGPL 2.1+ libudfread-b0bc6957e7e0.tar.gz libudfread 1.2.0 LGPL 2.1+ soxr-945b592b7047.tar.gz SoX Resampler LGPL 2.1+ lame-9a5b35c430a2.tar.gz LAME 3.100 (Debian 3.100-6 tree; the recipe applies debian/patches) LGPL 2+ libssh-10ad060693be.tar.gz libssh 0.12.0 LGPL 2.1 uchardet-06029ec3340c.tar.gz uchardet 0.0.8 MPL 1.1, GPL 2+ or LGPL 2.1+ subrandr-a4b5e7b21790.tar.gz subrandr MPL 2.0 libiconv-1.18.tar.gz GNU libiconv 1.18 LGPL 2.1+ The file names carry the first 12 characters of each commit. The upstream build does not write these commits to its logs. Each one is the head of the branch the recipe follows at the moment the build updated its sources (14:03 UTC on 13 September 2026), checked against the project's push history, and the versions above match what the build log or the DLL reports. libiconv is the release tarball the recipe pins by hash. Everything else in the DLL is under a permissive license (BSD, MIT, ISC, zlib, Apache 2.0, FreeType and similar). The recipe says where each one comes from. windows/build/ mpv-winbuild-cmake-cd1edc11dc68.tar.gz The recipe: shinchiro/mpv-winbuild-cmake at commit cd1edc11dc6887a50f705717619d879f5a93a488, as the build checked it out. mpv-winbuild-6b1bb015c46e.tar.gz zhongfly/mpv-winbuild at commit 6b1bb015c46e96f99b41f96264083519c9009b0e: the workflow and build.sh that ran, and the patches applied to the recipe (patch/*.patch, then compile-lgpl-libmpv.patch, which removes --enable-gpl and the GPL-only libraries and sets -Dgpl=false). mpv-winbuild-cmake-cd1edc11dc68-as-built.tar.gz The recipe with those five patches already applied. This is the tree the build ran. build-logs-x86_64-lgpl.7z The build's own logs, taken from the workflow run above: the configure and build output of every library, including FFmpeg's full configuration summary. To build it yourself, follow build.sh in mpv-winbuild on Arch Linux (it cross-compiles with clang and mingw-w64). Its "ninja update" step moves every library to its newest commit, so to reproduce this exact DLL, check out the commits listed here instead. To use your own libmpv-2.dll, close Theia and replace the file next to theia.exe. The installer puts it in %LOCALAPPDATA%\Programs\Theia unless you chose another folder, and the portable zip keeps it in the Theia folder. It has to be a 64-bit build with the libmpv 2.x client API. Settings > About shows the mpv and FFmpeg versions Theia loaded. MACOS ----- The macOS build puts these frameworks in Theia.app/Contents/Frameworks: Mpv, Avcodec, Avfilter, Avformat, Avutil, Swresample, Swscale, Ass, Dav1d, Freetype, Fribidi, Harfbuzz, Mbedcrypto, Mbedtls, Mbedx509, Png16, Uchardet and Xml2. They come from media-kit/libmpv-darwin-build v0.6.0, file libmpv-xcframeworks_v0.6.0_macos-universal-video-default.tar.gz (SHA-256 84d2ad98e046e82c6dc34d8547d76c2afeaee89c0f53032773be8985c95536d6), through the media_kit_libs_macos_video 1.1.4 package. macos/libmpv/mpv-0.36.0.tar.gz mpv 0.36.0. Built with -Dgpl=false: LGPL 2.1 or later. The recipe applies patches/mpv-fix-missing-objc.patch before building. macos/ffmpeg/ffmpeg-6.0.tar.xz FFmpeg 6.0. The recipe applies the four patches/ffmpeg-*.patch files and configures with --enable-mbedtls --enable-version3, so these libraries are under the LGPL version 3 or later. Each FFmpeg framework reports "LGPL version 3 or later" and carries its configure line. macos/libs/fribidi-1.0.13.tar.xz FriBidi 1.0.13 LGPL 2.1+ macos/libs/uchardet-0.0.8.tar.xz uchardet 0.0.8 MPL 1.1, GPL 2+ or LGPL 2.1+ uchardet was taken from Debian's archive because freedesktop.org refused the download. It is the same file: its SHA-256 matches the one in the recipe's downloads.lock. macos/build/libmpv-darwin-build-v0.6.0.tar.gz The recipe: build scripts, every patch, downloads.lock with each source address and SHA-256, and scripts/ffmpeg/meson.build with the full FFmpeg configure options. The mpv, FFmpeg, FriBidi and uchardet archives match the SHA-256 values in downloads.lock. The recipe is GitHub's archive of the v0.6.0 tag. The frameworks are dynamic libraries, so you can replace any of them with your own build of the same name. Changing files inside Theia.app breaks its signature, so sign it again afterwards, for example: codesign --force --deep --sign - Theia.app IPHONE AND IPAD --------------- Theia for iPhone and iPad (1.9.0 and later) puts the same frameworks in the app's Frameworks folder as the Mac build: Mpv, Avcodec, Avfilter, Avformat, Avutil, Swresample, Swscale, Ass, Dav1d, Freetype, Fribidi, Harfbuzz, Mbedcrypto, Mbedtls, Mbedx509, Png16, Uchardet and Xml2. They come from media-kit/libmpv-darwin-build v0.6.0, file libmpv-xcframeworks_v0.6.0_ios-universal-video-default.tar.gz (SHA-256 a95bc18508af26136b8a408341c05b5585d644ec013f00ac07db09d2e28d36ae), through the media_kit_libs_ios_video 1.1.4 package, which checks that sum before the frameworks go into the app. A copy of that exact file is here: ios/build/libmpv-xcframeworks_v0.6.0_ios-universal-video-default.tar.gz 19,817,325 bytes. The binary frameworks as built from the recipe below. It is the same release, built from the same recipe and the same source archives, as the macOS frameworks above. The versions and licenses are the same: mpv 0.36.0 built with -Dgpl=false (LGPL 2.1 or later), FFmpeg 6.0 configured with --enable-version3 (LGPL 3 or later), FriBidi 1.0.13 (LGPL 2.1+) and uchardet 0.0.8 (MPL 1.1, GPL 2+ or LGPL 2.1+). The source for those four is in the macos/ folder, and the iOS frameworks were built from exactly those files: macos/libmpv/mpv-0.36.0.tar.gz macos/ffmpeg/ffmpeg-6.0.tar.xz macos/libs/fribidi-1.0.13.tar.xz macos/libs/uchardet-0.0.8.tar.xz macos/build/libmpv-darwin-build-v0.6.0.tar.gz The recipe. For iOS it uses scripts/frameworks/ios/build-ios.sh, scripts/xcframeworks/build-ios.sh and the cross-files/ios-arm64.ini and iossimulator-*.ini files, with the same patches/ and the same downloads.lock (source addresses and SHA-256 sums) as macOS. The FFmpeg patches it applies, all four on every platform, include ffmpeg-fix-ios-hdr-texture.patch. The other libraries in the set (Mbed TLS, libass, dav1d, FreeType, HarfBuzz, libxml2, libpng) are under permissive licenses and are fetched by the same scripts. An installed iPhone app is signed and cannot be changed in place, so to use your own build of one of these frameworks, build the app again from its source with your framework in place of the bundled one. The app's source and Xcode project are not published; if you want to relink the app with a modified library, write to support@theiaplayer.com and we will give you what you need to do that, as the LGPL requires. ANDROID ------- Theia for Android TV (in testing, not yet released) plays video through libmpv.so, one per processor type under lib/ in the APK. It is the build media_kit_libs_android_video 1.3.8 downloads from media-kit/libmpv-android-video-build release v1.1.7, the "default" flavor: default-arm64-v8a.jar SHA-256 4363dfa5d3d415b91c1f16f6fb90c3fe59a77dfd3f9b824d2b24b492d6b09df9 default-armeabi-v7a.jar SHA-256 8ead114fc5a43348d89dc0eb8f41823e549b15115c29f73ee26973f973620995 default-x86_64.jar SHA-256 90268cd15f0766e07fb8e427388c621161177c9eb343c544f327bd63232bb236 FFmpeg is linked statically into libmpv.so. It was configured with --disable-gpl --enable-version3, so libmpv.so as a whole is distributed under the GNU LGPL version 3 or later. android/libmpv/mpv-78d43740f52d.tar.gz mpv at commit 78d43740f52db817d98bcf24fb30a76ab6fa13ff (v0.36.0-549-g78d43740f5), LGPL 2.1+ with -Dgpl=false. The build applies patches/mpv/mpv_lavc_set_java_vm.patch from the recipe, which is why the library reports the version with "-dirty". android/ffmpeg/ffmpeg-n6.0.tar.gz FFmpeg tag n6.0, LGPL 3+ as configured. The build applies the two patches in patches/ffmpeg/ from the recipe. android/libs/fribidi-1.0.12.tar.gz FriBidi 1.0.12 LGPL 2.1+ android/build/libmpv-android-video-build-v1.1.7.tar.gz The recipe: build scripts, every patch, and include/depinfo.sh with each library's version. The other libraries linked in (Mbed TLS, libass, HarfBuzz, FreeType, dav1d, libxml2) are under permissive licenses and are fetched by the same scripts. Each source archive is GitHub's archive of the exact tag or commit the recipe's include/download-deps.sh clones. To use your own build, replace libmpv.so for your processor in the APK and sign the APK again with your own key. Android then treats it as a different app, so remove Theia first. HOW THESE WERE CHECKED (23 and 24 September 2026; iPhone and iPad line added 19 October 2026) ------------------------------------------ - The DLL inside the 0.2.2 through 0.4.0 portable zips has the SHA-256 above. - The upstream release archive is byte for byte the one the app vendors. - The mpv and FFmpeg commits are the ones built into the DLL's version strings and named in the build's artifact names. - The macOS framework archive has the SHA-256 media_kit pins. - The 0.4.0 portable zip has the same libmpv-2.dll, by SHA-256. - The Android jars match the MD5 sums media_kit_libs_android_video 1.3.8 pins, and libmpv.so in them reports mpv v0.36.0-549-g78d43740f5 and FFmpeg n6.0 configured with --disable-gpl --enable-version3. - The iPhone and iPad framework archive has the SHA-256 media_kit_libs_ios_video 1.1.4 pins (a95bc18508af...), and its recipe is the macOS one above.