expo-mpv 0.1.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lonzzi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,33 +1,164 @@
 # expo-mpv
 
-# API documentation
+An Expo module wrapping [libmpv](https://mpv.io/) for video playback on iOS, powered by [MPVKit](https://github.com/mpvkit/MPVKit).
 
-- [Documentation for the latest stable release](https://docs.expo.dev/versions/latest/sdk/mpv/)
-- [Documentation for the main branch](https://docs.expo.dev/versions/unversioned/sdk/mpv/)
+> **Note:** Currently only **iOS** is supported. Android support is planned.
 
-# Installation in managed Expo projects
+## Features
 
-For [managed](https://docs.expo.dev/archive/managed-vs-bare/) Expo projects, please follow the installation instructions in the [API documentation for the latest stable release](#api-documentation). If you follow the link and there is no documentation available then this library is not yet usable within managed projects — it is likely to be included in an upcoming Expo SDK release.
+- Hardware-accelerated video playback via libmpv + VideoToolbox
+- Metal rendering via MoltenVK (Vulkan → Metal)
+- Play/pause, seek, speed, volume, mute, loop
+- Subtitle track selection (embedded + external)
+- Audio track selection
+- External subtitle loading (`sub-add`)
+- Progress, buffering, error, and playback state events
+- CJK subtitle support with bundled Noto Sans CJK SC font
 
-# Installation in bare React Native projects
+## Installation
 
-For bare React Native projects, you must ensure that you have [installed and configured the `expo` package](https://docs.expo.dev/bare/installing-expo-modules/) before continuing.
+```bash
+npx expo install expo-mpv
+```
+
+This package requires `expo-build-properties` to set the iOS deployment target to 16.0:
+
+```bash
+npx expo install expo-build-properties
+```
+
+Add to your `app.json`:
+
+```json
+{
+  "plugins": [
+    [
+      "expo-build-properties",
+      {
+        "ios": {
+          "deploymentTarget": "16.0"
+        }
+      }
+    ]
+  ]
+}
+```
+
+### MPVKit XCFrameworks
 
-### Add the package to your npm dependencies
+Before building, download the pre-built MPVKit xcframeworks:
 
+```bash
+cd node_modules/expo-mpv/ios
+bash download-mpvkit.sh
 ```
-npm install expo-mpv
+
+This downloads ~28 xcframeworks (libmpv, FFmpeg, MoltenVK, libass, etc.) from the [MPVKit releases](https://github.com/mpvkit/MPVKit/releases).
+
+## Usage
+
+```tsx
+import { ExpoMpvView } from "expo-mpv";
+import type { ExpoMpvViewRef } from "expo-mpv";
+import { useRef } from "react";
+
+export default function Player() {
+  const playerRef = useRef<ExpoMpvViewRef>(null);
+
+  return (
+    <ExpoMpvView
+      ref={playerRef}
+      source="https://example.com/video.mp4"
+      style={{ width: "100%", aspectRatio: 16 / 9 }}
+      onLoad={({ nativeEvent }) => {
+        console.log("Duration:", nativeEvent.duration);
+      }}
+      onProgress={({ nativeEvent }) => {
+        console.log("Position:", nativeEvent.position);
+      }}
+      onError={({ nativeEvent }) => {
+        console.error("Error:", nativeEvent.error);
+      }}
+    />
+  );
+}
+```
+
+### Imperative API (via ref)
+
+```ts
+playerRef.current?.play();
+playerRef.current?.pause();
+playerRef.current?.togglePlay();
+playerRef.current?.seekTo(120); // seconds
+playerRef.current?.seekBy(-10); // relative seconds
+playerRef.current?.setSpeed(1.5);
+playerRef.current?.setVolume(80); // 0-100
+playerRef.current?.setMuted(true);
+playerRef.current?.setSubtitleTrack(2);
+playerRef.current?.setAudioTrack(1);
+playerRef.current?.addSubtitle("https://example.com/subs.srt");
+playerRef.current?.setSubtitleDelay(-0.5); // seconds
+
+const info = await playerRef.current?.getPlaybackInfo();
+const tracks = await playerRef.current?.getTrackList();
 ```
 
-### Configure for Android
+### Props
 
+| Prop | Type | Description |
+|------|------|-------------|
+| `source` | `string` | Media URL or local file path |
+| `paused` | `boolean` | Pause/resume playback |
+| `speed` | `number` | Playback speed (default: 1.0) |
+| `volume` | `number` | Volume 0-100 (default: 100) |
+| `muted` | `boolean` | Mute audio |
+| `loop` | `boolean` | Loop current file |
 
+### Events
 
+| Event | Payload | Description |
+|-------|---------|-------------|
+| `onPlaybackStateChange` | `{ state, isPlaying }` | Play/pause state changed |
+| `onProgress` | `{ position, duration, bufferedDuration }` | Periodic progress update |
+| `onLoad` | `{ duration, width, height }` | Media loaded and ready |
+| `onError` | `{ error }` | Error occurred |
+| `onEnd` | `{ reason }` | Playback ended |
+| `onBuffer` | `{ isBuffering }` | Buffering state changed |
+| `onSeek` | `{}` | Seek completed |
+| `onVolumeChange` | `{ volume, muted }` | Volume/mute changed |
 
-### Configure for iOS
+## CJK Subtitle Rendering
+
+This module bundles [Noto Sans CJK SC](https://github.com/notofonts/noto-cjk) (SIL Open Font License) for Chinese/Japanese/Korean subtitle rendering.
+
+**Why a bundled font is necessary:**
+
+Starting with iOS 18, Apple changed system fonts (PingFang, Heiti, etc.) to a proprietary HVGL variable font format. FreeType — the font rasterizer used by libass (mpv's subtitle renderer) — cannot parse HVGL fonts. This means system CJK fonts are invisible to libass, causing Chinese characters to render as empty boxes (tofu).
+
+This is a known issue across the ecosystem:
+- [libass/libass#912](https://github.com/libass/libass/issues/912) — FreeType HVGL support tracking
+- [mpv-player/mpv#14878](https://github.com/mpv-player/mpv/issues/14878) — PingFang broken on macOS 15
+- [iina/iina#5176](https://github.com/iina/iina/issues/5176) — IINA Chinese subtitle garbling
+- [arthenica/ffmpeg-kit#1001](https://github.com/arthenica/ffmpeg-kit/issues/1001) — ffmpeg-kit iOS 18 subtitle issue
+
+The bundled Noto Sans CJK SC Regular (~16MB) covers Simplified Chinese, Traditional Chinese, Japanese, and Korean. It uses the [SIL Open Font License](https://openfontlicense.org/), which permits free use, embedding, and redistribution.
+
+## Architecture
+
+```
+React Native (JS)
+  └─ ExpoMpvView (native view)
+       └─ mpv (libmpv C API)
+            ├─ FFmpeg (demuxing, decoding)
+            ├─ VideoToolbox (hardware decoding)
+            ├─ libplacebo → Vulkan → MoltenVK → Metal (rendering, device only)
+            ├─ gpu → Vulkan → MoltenVK → Metal (rendering, simulator)
+            └─ libass + FreeType + Noto Sans CJK (subtitle rendering)
+```
 
-Run `npx pod-install` after installing the npm package.
+On simulator, `vo=gpu` is used instead of `vo=gpu-next` to avoid a crash in `MTLSimDriver` caused by XPC shared memory size limits when libplacebo uploads video frame textures.
 
-# Contributing
+## License
 
-Contributions are very welcome! Please refer to guidelines described in the [contributing guide]( https://github.com/expo/expo#contributing).
+[MIT](./LICENSE)

package/build/ExpoMpv.types.d.ts

@@ -35,6 +35,26 @@ export type PlaybackInfo = {
     volume: number;
     muted: boolean;
 };
+export type TrackInfo = {
+    id: number;
+    type: 'video' | 'audio' | 'sub' | string;
+    title: string;
+    lang: string;
+    codec: string;
+    selected: boolean;
+    isDefault: boolean;
+    isExternal: boolean;
+    channelCount?: number;
+    sampleRate?: number;
+    width?: number;
+    height?: number;
+    fps?: number;
+};
+export type CurrentTrackIds = {
+    vid: number;
+    aid: number;
+    sid: number;
+};
 export type ExpoMpvModuleEvents = {};
 export type ExpoMpvViewProps = {
     /**
@@ -123,6 +143,16 @@ export type ExpoMpvViewRef = {
     setMuted: (muted: boolean) => Promise<void>;
     setSubtitleTrack: (trackId: number) => Promise<void>;
     setAudioTrack: (trackId: number) => Promise<void>;
+    /** Load an external subtitle file (local path or URL). */
+    addSubtitle: (path: string, flag?: string, title?: string, lang?: string) => Promise<void>;
+    /** Remove a subtitle track by ID. */
+    removeSubtitle: (trackId: number) => Promise<void>;
+    /** Reload current subtitles. */
+    reloadSubtitles: () => Promise<void>;
+    /** Set subtitle delay in seconds (positive = later, negative = earlier). */
+    setSubtitleDelay: (seconds: number) => Promise<void>;
     getPlaybackInfo: () => Promise<PlaybackInfo>;
+    getTrackList: () => Promise<TrackInfo[]>;
+    getCurrentTrackIds: () => Promise<CurrentTrackIds>;
 };
 //# sourceMappingURL=ExpoMpv.types.d.ts.map

package/build/ExpoMpv.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoMpv.types.d.ts","sourceRoot":"","sources":["../src/ExpoMpv.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ExpoMpv.types.d.ts","sourceRoot":"","sources":["../src/ExpoMpv.types.ts"],"names":[],"mappings":"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"}

package/build/ExpoMpv.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoMpv.types.js","sourceRoot":"","sources":["../src/ExpoMpv.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { StyleProp, ViewStyle } from 'react-native';\n\n// MARK: - Event Payloads\n\nexport type PlaybackStateChangeEvent = {\n  state: 'playing' | 'paused' | 'stopped';\n  isPlaying: boolean;\n};\n\nexport type ProgressEvent = {\n  position: number;\n  duration: number;\n  bufferedDuration: number;\n};\n\nexport type LoadEvent = {\n  duration: number;\n  width: number;\n  height: number;\n};\n\nexport type ErrorEvent = {\n  error: string;\n};\n\nexport type EndEvent = {\n  reason: 'ended' | 'error' | 'stopped' | 'unknown';\n};\n\nexport type BufferEvent = {\n  isBuffering: boolean;\n};\n\nexport type SeekEvent = {};\n\nexport type VolumeChangeEvent = {\n  volume: number;\n  muted: boolean;\n};\n\nexport type PlaybackInfo = {\n  position: number;\n  duration: number;\n  isPlaying: boolean;\n  speed: number;\n  volume: number;\n  muted: boolean;\n};\n\n// MARK: - Module Events (non-view)\n\nexport type ExpoMpvModuleEvents = {};\n\n// MARK: - View Props\n\nexport type ExpoMpvViewProps = {\n  /**\n   * Media source URL to play. Can be a remote URL or a local file path.\n   */\n  source?: string;\n\n  /**\n   * Whether playback is paused.\n   */\n  paused?: boolean;\n\n  /**\n   * Playback speed multiplier. Default is 1.0.\n   */\n  speed?: number;\n\n  /**\n   * Volume level (0-100). Default is 100.\n   */\n  volume?: number;\n\n  /**\n   * Whether audio is muted.\n   */\n  muted?: boolean;\n\n  /**\n   * Whether to loop the current file.\n   */\n  loop?: boolean;\n\n  /**\n   * Called when playback state changes (play/pause).\n   */\n  onPlaybackStateChange?: (event: { nativeEvent: PlaybackStateChangeEvent }) => void;\n\n  /**\n   * Called periodically with current playback progress.\n   */\n  onProgress?: (event: { nativeEvent: ProgressEvent }) => void;\n\n  /**\n   * Called when a media file has been loaded and is ready to play.\n   */\n  onLoad?: (event: { nativeEvent: LoadEvent }) => void;\n\n  /**\n   * Called when an error occurs.\n   */\n  onError?: (event: { nativeEvent: ErrorEvent }) => void;\n\n  /**\n   * Called when playback reaches the end.\n   */\n  onEnd?: (event: { nativeEvent: EndEvent }) => void;\n\n  /**\n   * Called when buffering state changes.\n   */\n  onBuffer?: (event: { nativeEvent: BufferEvent }) => void;\n\n  /**\n   * Called when a seek operation completes.\n   */\n  onSeek?: (event: { nativeEvent: SeekEvent }) => void;\n\n  /**\n   * Called when volume or mute state changes.\n   */\n  onVolumeChange?: (event: { nativeEvent: VolumeChangeEvent }) => void;\n\n  style?: StyleProp<ViewStyle>;\n};\n\n// MARK: - View Ref Methods\n\nexport type ExpoMpvViewRef = {\n  play: () => Promise<void>;\n  pause: () => Promise<void>;\n  togglePlay: () => Promise<void>;\n  stop: () => Promise<void>;\n  seekTo: (position: number) => Promise<void>;\n  seekBy: (offset: number) => Promise<void>;\n  setSpeed: (speed: number) => Promise<void>;\n  setVolume: (volume: number) => Promise<void>;\n  setMuted: (muted: boolean) => Promise<void>;\n  setSubtitleTrack: (trackId: number) => Promise<void>;\n  setAudioTrack: (trackId: number) => Promise<void>;\n  getPlaybackInfo: () => Promise<PlaybackInfo>;\n};\n"]}
+{"version":3,"file":"ExpoMpv.types.js","sourceRoot":"","sources":["../src/ExpoMpv.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { StyleProp, ViewStyle } from 'react-native';\n\n// MARK: - Event Payloads\n\nexport type PlaybackStateChangeEvent = {\n  state: 'playing' | 'paused' | 'stopped';\n  isPlaying: boolean;\n};\n\nexport type ProgressEvent = {\n  position: number;\n  duration: number;\n  bufferedDuration: number;\n};\n\nexport type LoadEvent = {\n  duration: number;\n  width: number;\n  height: number;\n};\n\nexport type ErrorEvent = {\n  error: string;\n};\n\nexport type EndEvent = {\n  reason: 'ended' | 'error' | 'stopped' | 'unknown';\n};\n\nexport type BufferEvent = {\n  isBuffering: boolean;\n};\n\nexport type SeekEvent = {};\n\nexport type VolumeChangeEvent = {\n  volume: number;\n  muted: boolean;\n};\n\nexport type PlaybackInfo = {\n  position: number;\n  duration: number;\n  isPlaying: boolean;\n  speed: number;\n  volume: number;\n  muted: boolean;\n};\n\nexport type TrackInfo = {\n  id: number;\n  type: 'video' | 'audio' | 'sub' | string;\n  title: string;\n  lang: string;\n  codec: string;\n  selected: boolean;\n  isDefault: boolean;\n  isExternal: boolean;\n  // audio-specific\n  channelCount?: number;\n  sampleRate?: number;\n  // video-specific\n  width?: number;\n  height?: number;\n  fps?: number;\n};\n\nexport type CurrentTrackIds = {\n  vid: number;\n  aid: number;\n  sid: number;\n};\n\n// MARK: - Module Events (non-view)\n\nexport type ExpoMpvModuleEvents = {};\n\n// MARK: - View Props\n\nexport type ExpoMpvViewProps = {\n  /**\n   * Media source URL to play. Can be a remote URL or a local file path.\n   */\n  source?: string;\n\n  /**\n   * Whether playback is paused.\n   */\n  paused?: boolean;\n\n  /**\n   * Playback speed multiplier. Default is 1.0.\n   */\n  speed?: number;\n\n  /**\n   * Volume level (0-100). Default is 100.\n   */\n  volume?: number;\n\n  /**\n   * Whether audio is muted.\n   */\n  muted?: boolean;\n\n  /**\n   * Whether to loop the current file.\n   */\n  loop?: boolean;\n\n  /**\n   * Called when playback state changes (play/pause).\n   */\n  onPlaybackStateChange?: (event: { nativeEvent: PlaybackStateChangeEvent }) => void;\n\n  /**\n   * Called periodically with current playback progress.\n   */\n  onProgress?: (event: { nativeEvent: ProgressEvent }) => void;\n\n  /**\n   * Called when a media file has been loaded and is ready to play.\n   */\n  onLoad?: (event: { nativeEvent: LoadEvent }) => void;\n\n  /**\n   * Called when an error occurs.\n   */\n  onError?: (event: { nativeEvent: ErrorEvent }) => void;\n\n  /**\n   * Called when playback reaches the end.\n   */\n  onEnd?: (event: { nativeEvent: EndEvent }) => void;\n\n  /**\n   * Called when buffering state changes.\n   */\n  onBuffer?: (event: { nativeEvent: BufferEvent }) => void;\n\n  /**\n   * Called when a seek operation completes.\n   */\n  onSeek?: (event: { nativeEvent: SeekEvent }) => void;\n\n  /**\n   * Called when volume or mute state changes.\n   */\n  onVolumeChange?: (event: { nativeEvent: VolumeChangeEvent }) => void;\n\n  style?: StyleProp<ViewStyle>;\n};\n\n// MARK: - View Ref Methods\n\nexport type ExpoMpvViewRef = {\n  play: () => Promise<void>;\n  pause: () => Promise<void>;\n  togglePlay: () => Promise<void>;\n  stop: () => Promise<void>;\n  seekTo: (position: number) => Promise<void>;\n  seekBy: (offset: number) => Promise<void>;\n  setSpeed: (speed: number) => Promise<void>;\n  setVolume: (volume: number) => Promise<void>;\n  setMuted: (muted: boolean) => Promise<void>;\n  setSubtitleTrack: (trackId: number) => Promise<void>;\n  setAudioTrack: (trackId: number) => Promise<void>;\n  /** Load an external subtitle file (local path or URL). */\n  addSubtitle: (path: string, flag?: string, title?: string, lang?: string) => Promise<void>;\n  /** Remove a subtitle track by ID. */\n  removeSubtitle: (trackId: number) => Promise<void>;\n  /** Reload current subtitles. */\n  reloadSubtitles: () => Promise<void>;\n  /** Set subtitle delay in seconds (positive = later, negative = earlier). */\n  setSubtitleDelay: (seconds: number) => Promise<void>;\n  getPlaybackInfo: () => Promise<PlaybackInfo>;\n  getTrackList: () => Promise<TrackInfo[]>;\n  getCurrentTrackIds: () => Promise<CurrentTrackIds>;\n};\n"]}

package/build/ExpoMpvView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoMpvView.d.ts","sourceRoot":"","sources":["../src/ExpoMpvView.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKnE,QAAA,MAAM,WAAW,yFAmBf,CAAC;AAIH,eAAe,WAAW,CAAC"}
+{"version":3,"file":"ExpoMpvView.d.ts","sourceRoot":"","sources":["../src/ExpoMpvView.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKnE,QAAA,MAAM,WAAW,yFA0Bf,CAAC;AAIH,eAAe,WAAW,CAAC"}

package/build/ExpoMpvView.js

@@ -16,7 +16,13 @@ const ExpoMpvView = forwardRef((props, ref) => {
         setMuted: (muted) => nativeRef.current?.setMuted(muted),
         setSubtitleTrack: (trackId) => nativeRef.current?.setSubtitleTrack(trackId),
         setAudioTrack: (trackId) => nativeRef.current?.setAudioTrack(trackId),
+        addSubtitle: (path, flag, title, lang) => nativeRef.current?.addSubtitle(path, flag, title, lang),
+        removeSubtitle: (trackId) => nativeRef.current?.removeSubtitle(trackId),
+        reloadSubtitles: () => nativeRef.current?.reloadSubtitles(),
+        setSubtitleDelay: (seconds) => nativeRef.current?.setSubtitleDelay(seconds),
         getPlaybackInfo: () => nativeRef.current?.getPlaybackInfo(),
+        getTrackList: () => nativeRef.current?.getTrackList(),
+        getCurrentTrackIds: () => nativeRef.current?.getCurrentTrackIds(),
     }));
     return <NativeView ref={nativeRef} {...props}/>;
 });

package/build/ExpoMpvView.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoMpvView.js","sourceRoot":"","sources":["../src/ExpoMpvView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAIhE,MAAM,UAAU,GACd,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAE/B,MAAM,WAAW,GAAG,UAAU,CAAmC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAC9E,MAAM,SAAS,GAAG,MAAM,CAAM,IAAI,CAAC,CAAC;IAEpC,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE;QACrC,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE;QACvC,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE;QACjD,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE;QACrC,MAAM,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC;QACjE,MAAM,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QAC7D,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC;QAC/D,SAAS,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC;QACnE,QAAQ,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC;QAChE,gBAAgB,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC;QACnF,aAAa,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC;QAC7E,eAAe,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE;KAC5D,CAAC,CAAC,CAAC;IAEJ,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,KAAK,CAAC,EAAG,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,WAAW,CAAC,WAAW,GAAG,aAAa,CAAC;AAExC,eAAe,WAAW,CAAC","sourcesContent":["import { requireNativeView } from 'expo';\nimport * as React from 'react';\nimport { forwardRef, useImperativeHandle, useRef } from 'react';\n\nimport { ExpoMpvViewProps, ExpoMpvViewRef } from './ExpoMpv.types';\n\nconst NativeView: React.ComponentType<ExpoMpvViewProps & { ref?: React.Ref<any> }> =\n  requireNativeView('ExpoMpv');\n\nconst ExpoMpvView = forwardRef<ExpoMpvViewRef, ExpoMpvViewProps>((props, ref) => {\n  const nativeRef = useRef<any>(null);\n\n  useImperativeHandle(ref, () => ({\n    play: () => nativeRef.current?.play(),\n    pause: () => nativeRef.current?.pause(),\n    togglePlay: () => nativeRef.current?.togglePlay(),\n    stop: () => nativeRef.current?.stop(),\n    seekTo: (position: number) => nativeRef.current?.seekTo(position),\n    seekBy: (offset: number) => nativeRef.current?.seekBy(offset),\n    setSpeed: (speed: number) => nativeRef.current?.setSpeed(speed),\n    setVolume: (volume: number) => nativeRef.current?.setVolume(volume),\n    setMuted: (muted: boolean) => nativeRef.current?.setMuted(muted),\n    setSubtitleTrack: (trackId: number) => nativeRef.current?.setSubtitleTrack(trackId),\n    setAudioTrack: (trackId: number) => nativeRef.current?.setAudioTrack(trackId),\n    getPlaybackInfo: () => nativeRef.current?.getPlaybackInfo(),\n  }));\n\n  return <NativeView ref={nativeRef} {...props} />;\n});\n\nExpoMpvView.displayName = 'ExpoMpvView';\n\nexport default ExpoMpvView;\n"]}
+{"version":3,"file":"ExpoMpvView.js","sourceRoot":"","sources":["../src/ExpoMpvView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAIhE,MAAM,UAAU,GACd,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAE/B,MAAM,WAAW,GAAG,UAAU,CAAmC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAC9E,MAAM,SAAS,GAAG,MAAM,CAAM,IAAI,CAAC,CAAC;IAEpC,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE;QACrC,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE;QACvC,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE;QACjD,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE;QACrC,MAAM,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC;QACjE,MAAM,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QAC7D,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC;QAC/D,SAAS,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC;QACnE,QAAQ,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC;QAChE,gBAAgB,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC;QACnF,aAAa,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC;QAC7E,WAAW,EAAE,CAAC,IAAY,EAAE,IAAa,EAAE,KAAc,EAAE,IAAa,EAAE,EAAE,CAC1E,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC;QACzD,cAAc,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC;QAC/E,eAAe,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE;QAC3D,gBAAgB,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC;QACnF,eAAe,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE;QAC3D,YAAY,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE;QACrD,kBAAkB,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,kBAAkB,EAAE;KAClE,CAAC,CAAC,CAAC;IAEJ,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,KAAK,CAAC,EAAG,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,WAAW,CAAC,WAAW,GAAG,aAAa,CAAC;AAExC,eAAe,WAAW,CAAC","sourcesContent":["import { requireNativeView } from 'expo';\nimport * as React from 'react';\nimport { forwardRef, useImperativeHandle, useRef } from 'react';\n\nimport { ExpoMpvViewProps, ExpoMpvViewRef } from './ExpoMpv.types';\n\nconst NativeView: React.ComponentType<ExpoMpvViewProps & { ref?: React.Ref<any> }> =\n  requireNativeView('ExpoMpv');\n\nconst ExpoMpvView = forwardRef<ExpoMpvViewRef, ExpoMpvViewProps>((props, ref) => {\n  const nativeRef = useRef<any>(null);\n\n  useImperativeHandle(ref, () => ({\n    play: () => nativeRef.current?.play(),\n    pause: () => nativeRef.current?.pause(),\n    togglePlay: () => nativeRef.current?.togglePlay(),\n    stop: () => nativeRef.current?.stop(),\n    seekTo: (position: number) => nativeRef.current?.seekTo(position),\n    seekBy: (offset: number) => nativeRef.current?.seekBy(offset),\n    setSpeed: (speed: number) => nativeRef.current?.setSpeed(speed),\n    setVolume: (volume: number) => nativeRef.current?.setVolume(volume),\n    setMuted: (muted: boolean) => nativeRef.current?.setMuted(muted),\n    setSubtitleTrack: (trackId: number) => nativeRef.current?.setSubtitleTrack(trackId),\n    setAudioTrack: (trackId: number) => nativeRef.current?.setAudioTrack(trackId),\n    addSubtitle: (path: string, flag?: string, title?: string, lang?: string) =>\n      nativeRef.current?.addSubtitle(path, flag, title, lang),\n    removeSubtitle: (trackId: number) => nativeRef.current?.removeSubtitle(trackId),\n    reloadSubtitles: () => nativeRef.current?.reloadSubtitles(),\n    setSubtitleDelay: (seconds: number) => nativeRef.current?.setSubtitleDelay(seconds),\n    getPlaybackInfo: () => nativeRef.current?.getPlaybackInfo(),\n    getTrackList: () => nativeRef.current?.getTrackList(),\n    getCurrentTrackIds: () => nativeRef.current?.getCurrentTrackIds(),\n  }));\n\n  return <NativeView ref={nativeRef} {...props} />;\n});\n\nExpoMpvView.displayName = 'ExpoMpvView';\n\nexport default ExpoMpvView;\n"]}

package/bun.lock

@@ -1,5 +1,6 @@
 {
   "lockfileVersion": 1,
+  "configVersion": 0,
   "workspaces": {
     "": {
       "name": "expo-mpv",

package/ios/ExpoMpv.podspec

@@ -53,4 +53,8 @@ Pod::Spec.new do |s|
   }
 
   s.source_files = "*.{h,m,mm,swift,hpp,cpp}"
+
+  # Bundle the CJK font for subtitle rendering
+  # iOS 18+ system fonts use HVGL format which FreeType/libass cannot parse
+  s.resources = ['Fonts/*.otf', 'Fonts/*.ttf']
 end

package/ios/ExpoMpvModule.swift

@@ -97,9 +97,33 @@ public class ExpoMpvModule: Module {
         view.setAudioTrack(trackId)
       }.runOnQueue(.main)
 
+      AsyncFunction("addSubtitle") { (view: ExpoMpvView, path: String, flag: String?, title: String?, lang: String?) in
+        view.addSubtitle(path, flag: flag ?? "auto", title: title, lang: lang)
+      }.runOnQueue(.main)
+
+      AsyncFunction("removeSubtitle") { (view: ExpoMpvView, trackId: Int) in
+        view.removeSubtitle(trackId)
+      }.runOnQueue(.main)
+
+      AsyncFunction("reloadSubtitles") { (view: ExpoMpvView) in
+        view.reloadSubtitles()
+      }.runOnQueue(.main)
+
+      AsyncFunction("setSubtitleDelay") { (view: ExpoMpvView, seconds: Double) in
+        view.setSubtitleDelay(seconds)
+      }.runOnQueue(.main)
+
       AsyncFunction("getPlaybackInfo") { (view: ExpoMpvView) -> [String: Any] in
         return view.getPlaybackInfo()
       }.runOnQueue(.main)
+
+      AsyncFunction("getTrackList") { (view: ExpoMpvView) -> [[String: Any]] in
+        return view.getTrackList()
+      }.runOnQueue(.main)
+
+      AsyncFunction("getCurrentTrackIds") { (view: ExpoMpvView) -> [String: Int] in
+        return view.getCurrentTrackIds()
+      }.runOnQueue(.main)
     }
   }
 }

package/ios/ExpoMpvView.swift

@@ -1,5 +1,6 @@
 import ExpoModulesCore
 import Libmpv
+import CoreText
 
 class ExpoMpvView: ExpoView {
   // MARK: - Metal Layer
@@ -93,11 +94,22 @@ class ExpoMpvView: ExpoView {
     var wid = unsafeBitCast(metalLayer, to: Int64.self)
     checkError(mpv_set_option(mpv, "wid", MPV_FORMAT_INT64, &wid), label: "set wid")
 
-    // Rendering configuration: gpu-next + vulkan + moltenvk → Metal
-    setOptionString("vo", "gpu-next")
+    // Rendering configuration
+    // On simulator: use vo=gpu (old pipeline, avoids libplacebo's pl_tex_upload_pbo
+    // which crashes on simulator due to MTLSimDriver XPC shared memory size limits)
+    // On device: use vo=gpu-next (libplacebo pipeline, better quality)
+    #if targetEnvironment(simulator)
+    log("Running on SIMULATOR — using vo=gpu to avoid MTLSimDriver crash")
+    setOptionString("vo", "gpu")
     setOptionString("gpu-api", "vulkan")
     setOptionString("gpu-context", "moltenvk")
     setOptionString("hwdec", "videotoolbox-copy")
+    #else
+    setOptionString("vo", "gpu-next")
+    setOptionString("gpu-api", "vulkan")
+    setOptionString("gpu-context", "moltenvk")
+    setOptionString("hwdec", "videotoolbox")
+    #endif
 
     // General options
     setOptionString("keep-open", "yes")
@@ -105,6 +117,11 @@ class ExpoMpvView: ExpoView {
     setOptionString("input-default-bindings", "no")
     setOptionString("input-vo-keyboard", "no")
 
+    // Subtitle font configuration
+    // iOS has no fontconfig, so libass can't discover system fonts.
+    // We use CoreText to find a CJK font file and point libass to it.
+    configureFonts(mpv)
+
     // Initialize mpv
     log("Initializing mpv...")
     let initResult = mpv_initialize(mpv)
@@ -415,6 +432,34 @@ class ExpoMpvView: ExpoView {
     setInt("aid", Int64(trackId))
   }
 
+  /// Load an external subtitle file (local path or URL).
+  func addSubtitle(_ path: String, flag: String = "auto", title: String? = nil, lang: String? = nil) {
+    guard mpv != nil else { return }
+    // sub-add <url> [<flags> [<title> [<lang>]]]
+    var args = [path, flag]
+    if let title = title { args.append(title) }
+    if let lang = lang {
+      if args.count == 2 { args.append("") } // placeholder for title
+      args.append(lang)
+    }
+    log("addSubtitle: \(path) flags=\(flag)")
+    commandAsync("sub-add", args: args)
+  }
+
+  /// Remove a subtitle track by id.
+  func removeSubtitle(_ trackId: Int) {
+    commandAsync("sub-remove", args: [String(trackId)])
+  }
+
+  /// Reload current subtitles (useful after font changes).
+  func reloadSubtitles() {
+    commandAsync("sub-reload")
+  }
+
+  func setSubtitleDelay(_ seconds: Double) {
+    setDouble("sub-delay", seconds)
+  }
+
   func getPlaybackInfo() -> [String: Any] {
     let position = getDouble("time-pos")
     let duration = getDouble("duration")
@@ -433,6 +478,52 @@ class ExpoMpvView: ExpoView {
     ]
   }
 
+  func getTrackList() -> [[String: Any]] {
+    guard mpv != nil else { return [] }
+
+    let count = getInt("track-list/count")
+    var tracks: [[String: Any]] = []
+
+    for i in 0..<count {
+      let prefix = "track-list/\(i)"
+      var track: [String: Any] = [:]
+
+      track["id"] = Int(getInt("\(prefix)/id"))
+      track["type"] = getString("\(prefix)/type") ?? "unknown"
+      track["title"] = getString("\(prefix)/title") ?? ""
+      track["lang"] = getString("\(prefix)/lang") ?? ""
+      track["codec"] = getString("\(prefix)/codec") ?? ""
+      track["selected"] = getFlag("\(prefix)/selected")
+      track["isDefault"] = getFlag("\(prefix)/default")
+      track["isExternal"] = getFlag("\(prefix)/external")
+
+      // Extra info based on track type
+      let trackType = track["type"] as? String ?? ""
+      if trackType == "audio" {
+        track["channelCount"] = Int(getInt("\(prefix)/demux-channel-count"))
+        track["sampleRate"] = Int(getInt("\(prefix)/demux-samplerate"))
+      } else if trackType == "video" {
+        track["width"] = Int(getInt("\(prefix)/demux-w"))
+        track["height"] = Int(getInt("\(prefix)/demux-h"))
+        track["fps"] = getDouble("\(prefix)/demux-fps")
+      }
+
+      tracks.append(track)
+    }
+
+    log("getTrackList: \(tracks.count) tracks found")
+    return tracks
+  }
+
+  func getCurrentTrackIds() -> [String: Int] {
+    guard mpv != nil else { return [:] }
+    return [
+      "vid": Int(getInt("vid")),
+      "aid": Int(getInt("aid")),
+      "sid": Int(getInt("sid")),
+    ]
+  }
+
   func destroy() {
     stopProgressTimer()
     if let mpv = mpv {
@@ -443,6 +534,79 @@ class ExpoMpvView: ExpoView {
     }
   }
 
+  // MARK: - Font Configuration
+
+  /// Configure fonts for subtitle rendering.
+  ///
+  /// iOS 18+ changed system fonts (PingFang etc.) to Apple's HVGL variable font format,
+  /// which FreeType (used by libass) cannot parse. This means system CJK fonts are
+  /// unusable by libass even if CoreText can find them.
+  ///
+  /// Solution: bundle a standard OTF/TTF CJK font (Noto Sans CJK SC) that FreeType
+  /// can read, and point libass to it via sub-fonts-dir.
+  /// See: https://github.com/libass/libass/issues/912
+  ///      https://github.com/mpv-player/mpv/issues/14878
+  private func configureFonts(_ mpv: OpaquePointer) {
+    // Locate the bundled Noto Sans CJK SC font in the module's bundle
+    let fontFileName = "NotoSansCJKsc-Regular"
+    let fontFileExt = "otf"
+
+    // Search in all bundles (the font is in the ExpoMpv pod bundle)
+    var fontPath: String?
+    for bundle in Bundle.allBundles {
+      if let path = bundle.path(forResource: fontFileName, ofType: fontFileExt) {
+        fontPath = path
+        break
+      }
+    }
+
+    // Also check the main bundle's Frameworks
+    if fontPath == nil {
+      let frameworksPath = Bundle.main.bundlePath + "/Frameworks"
+      if let contents = try? FileManager.default.contentsOfDirectory(atPath: frameworksPath) {
+        for item in contents where item.hasSuffix(".framework") {
+          let bundlePath = frameworksPath + "/" + item
+          if let bundle = Bundle(path: bundlePath),
+             let path = bundle.path(forResource: fontFileName, ofType: fontFileExt) {
+            fontPath = path
+            break
+          }
+        }
+      }
+    }
+
+    guard let resolvedFontPath = fontPath else {
+      log("WARNING: Bundled font \(fontFileName).\(fontFileExt) not found in any bundle")
+      // Fallback: try auto font provider without bundled font
+      setOptionString("sub-font-provider", "auto")
+      setOptionString("sub-font", "sans-serif")
+      return
+    }
+
+    let fontsDir = (resolvedFontPath as NSString).deletingLastPathComponent
+    log("Font: \(resolvedFontPath)")
+
+    // Point libass to the directory containing our bundled font
+    setOptionString("sub-fonts-dir", fontsDir)
+
+    // auto = CoreText on Apple platforms (handles font name matching + fallback)
+    setOptionString("sub-font-provider", "auto")
+
+    // Default font for SRT / plain text subtitles
+    setOptionString("sub-font", "Noto Sans CJK SC")
+    setOptionString("sub-font-size", "40")
+    setOptionString("sub-codepage", "auto")
+
+    // ASS subtitles: don't force-override styles.
+    // When ASS references fonts like "Microsoft YaHei" that don't exist on iOS,
+    // CoreText + our bundled font provide fallback.
+    setOptionString("sub-ass-override", "no")
+    setOptionString("sub-ass-shaper", "simple")
+
+    // Auto-load external subtitles from same directory as video
+    setOptionString("sub-auto", "fuzzy")
+  }
+
   // MARK: - MPV Helpers
 
   private func commandAsync(_ command: String, args: [String] = []) {
@@ -501,6 +665,14 @@ class ExpoMpvView: ExpoView {
     return data
   }
 
+  private func getString(_ name: String) -> String? {
+    guard mpv != nil else { return nil }
+    let cstr = mpv_get_property_string(mpv, name)
+    defer { mpv_free(cstr) }
+    guard let cstr = cstr else { return nil }
+    return String(cString: cstr)
+  }
+
   private func getInt(_ name: String) -> Int64 {
     guard mpv != nil else { return 0 }
     var data: Int64 = 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-mpv",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "My new module",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/src/ExpoMpv.types.ts

@@ -47,6 +47,30 @@ export type PlaybackInfo = {
   muted: boolean;
 };
 
+export type TrackInfo = {
+  id: number;
+  type: 'video' | 'audio' | 'sub' | string;
+  title: string;
+  lang: string;
+  codec: string;
+  selected: boolean;
+  isDefault: boolean;
+  isExternal: boolean;
+  // audio-specific
+  channelCount?: number;
+  sampleRate?: number;
+  // video-specific
+  width?: number;
+  height?: number;
+  fps?: number;
+};
+
+export type CurrentTrackIds = {
+  vid: number;
+  aid: number;
+  sid: number;
+};
+
 // MARK: - Module Events (non-view)
 
 export type ExpoMpvModuleEvents = {};
@@ -141,5 +165,15 @@ export type ExpoMpvViewRef = {
   setMuted: (muted: boolean) => Promise<void>;
   setSubtitleTrack: (trackId: number) => Promise<void>;
   setAudioTrack: (trackId: number) => Promise<void>;
+  /** Load an external subtitle file (local path or URL). */
+  addSubtitle: (path: string, flag?: string, title?: string, lang?: string) => Promise<void>;
+  /** Remove a subtitle track by ID. */
+  removeSubtitle: (trackId: number) => Promise<void>;
+  /** Reload current subtitles. */
+  reloadSubtitles: () => Promise<void>;
+  /** Set subtitle delay in seconds (positive = later, negative = earlier). */
+  setSubtitleDelay: (seconds: number) => Promise<void>;
   getPlaybackInfo: () => Promise<PlaybackInfo>;
+  getTrackList: () => Promise<TrackInfo[]>;
+  getCurrentTrackIds: () => Promise<CurrentTrackIds>;
 };

package/src/ExpoMpvView.tsx

@@ -22,7 +22,14 @@ const ExpoMpvView = forwardRef<ExpoMpvViewRef, ExpoMpvViewProps>((props, ref) =>
     setMuted: (muted: boolean) => nativeRef.current?.setMuted(muted),
     setSubtitleTrack: (trackId: number) => nativeRef.current?.setSubtitleTrack(trackId),
     setAudioTrack: (trackId: number) => nativeRef.current?.setAudioTrack(trackId),
+    addSubtitle: (path: string, flag?: string, title?: string, lang?: string) =>
+      nativeRef.current?.addSubtitle(path, flag, title, lang),
+    removeSubtitle: (trackId: number) => nativeRef.current?.removeSubtitle(trackId),
+    reloadSubtitles: () => nativeRef.current?.reloadSubtitles(),
+    setSubtitleDelay: (seconds: number) => nativeRef.current?.setSubtitleDelay(seconds),
     getPlaybackInfo: () => nativeRef.current?.getPlaybackInfo(),
+    getTrackList: () => nativeRef.current?.getTrackList(),
+    getCurrentTrackIds: () => nativeRef.current?.getCurrentTrackIds(),
   }));
 
   return <NativeView ref={nativeRef} {...props} />;