expo-libvlc-player 0.1.0

package/.eslintrc.js

@@ -0,0 +1,2 @@
+// @generated by expo-module-scripts
+module.exports = require('expo-module-scripts/eslintrc.base.js');

package/README.md

@@ -0,0 +1,107 @@
+<p align="center">
+     <img src="https://images.videolan.org/images/VLC-IconSmall.png" alt="VLC icon">
+</p>
+
+<h1 align="center">LibVLC Player for Expo</h1>
+
+### Installation
+
+Add the package to your npm dependencies
+
+```
+npm install expo-libvlc-player
+```
+
+### Bare React Native projects
+
+For bare React Native projects, you must ensure that you have [installed and configured](https://docs.expo.dev/bare/installing-expo-modules/) the `expo` package before continuing.
+
+### Configure for Android
+
+No additional configuration necessary.
+
+### Configure for iOS
+
+Run `npx pod-install` after installing the npm package.
+
+## Usage
+
+```tsx
+import { VLCPLayerView } from "expo-libvlc-player";
+
+return (
+  <View styles={{ height: 576 }}>
+    <VLCPlayerView
+      style={{ height: "100%" }}
+      uri="http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4"
+    />
+  </View>
+);
+```
+
+See the [example app](example/App.tsx) for additional usage.
+
+### Player methods
+
+| Prop                     | Description                           | Params                                 |
+| ------------------------ | ------------------------------------- | -------------------------------------- |
+| `play()`                 | Starts playback of the current player |                                        |
+| `pause()`                | Pauses playback of the current player |                                        |
+| `stop()`                 | Stops playback of the current player  |                                        |
+| `seek(position: number)` | Sets position of the current player   | Must be a float number between 0 and 1 |
+
+### Player props
+
+The `VLCPlayerView` extends React Native `ViewProps` and implements it's own props:
+
+| Prop               | Description                                                                               | Default  |
+| ------------------ | ----------------------------------------------------------------------------------------- | -------- |
+| `uri`              | Sets the URI of the media to be played                                                    |          |
+| `subtitle`         | Sets subtitle URI and enabled state                                                       |          |
+| `options`          | Sets the VLC options to initialize the player with                                        | `[]`     |
+| `volume`           | Controls the player volume, must be an integer number between `0` and `100`               | `100`    |
+| `mute`             | Sets the player volume to `0`                                                             | `false`  |
+| `rate`             | Controls the player rate, must be a float number between `0` and `1`                      | `1`      |
+| `tracks`           | Sets the player audio and subtitle tracks                                                 |          |
+| `repeat`           | Repeats the media once playback is ended                                                  | `false`  |
+| `aspectRatio`      | Sets the player aspect ratio, must be a valid `string`                                    |          |
+| `audioMixingMode`  | Determines how the player will interact with other audio playing in the system            | `"auto"` |
+| `playInBackground` | Determines whether the player should continue playing after the app enters the background | `false`  |
+| `autoplay`         | Autoplays media once player is created                                                    | `true`   |
+
+#### Callback props
+
+| Prop                | Description                                      | Payload                                                                                                       |
+| ------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
+| `onBuffering`       | Called after the `Buffering` player event        |                                                                                                               |
+| `onPlaying`         | Called after the `Playing` player event          |                                                                                                               |
+| `onPaused`          | Called after the `Paused` player event           |                                                                                                               |
+| `onStopped`         | Called after the `Stopped` player event          |                                                                                                               |
+| `onEnded`           | Called after the `EndReached` player event       |                                                                                                               |
+| `onRepeat`          | Called after the player repeats the media        |                                                                                                               |
+| `onWarn`            | Called after the player encounters a conflict    | `{ warn: string }`                                                                                            |
+| `onError`           | Called after the `EncounteredError` player event | `{ error: string }`                                                                                           |
+| `onPositionChanged` | Called after the `PositionChanged` player event  | `{ position: number }`                                                                                        |
+| `onLoad`            | Called after the `Buffering` player event        | `{ width: number, height: number, aspectRatio: string, duration: number, tracks: object, seekable: boolean }` |
+| `onBackground`      | Called after the player enters the background    |                                                                                                               |
+
+## Disclaimer
+
+**IMPORTANT:** This project is not affiliated with, endorsed by, or officially supported by VideoLAN or the VLC media player project.
+
+The VLC logo and cone icon are trademarks of VideoLAN and are used here solely to indicate compatibility with the following VLC libraries:
+
+- `LibVLC v3.6.2` for Android
+- `MobileVLCKit v3.6.0` for iOS
+
+This is an independent open-source implementation that provides React Native bindings for VLC's underlying media libraries.
+
+For official VLC products and support, please visit [videolan.org](https://www.videolan.org/).
+
+### Credits
+
+This project is heavily inspired by existing libraries such as [expo-video](https://github.com/expo/expo/tree/main/packages/expo-video) and [react-native-vlc-media-player](https://github.com/razorRun/react-native-vlc-media-player).
+
+## Contributing
+
+Contributions are always welcome. Please raise any issues and/or fix them by creating a pull request.

package/android/.gradle/buildOutputCleanup/cache.properties

@@ -0,0 +1,2 @@
+#Thu Jun 26 02:18:12 CST 2025
+gradle.version=9.0-milestone-1

package/android/.gradle/config.properties

@@ -0,0 +1,2 @@
+#Thu Jun 26 02:17:37 CST 2025
+java.home=\\\\wsl.localhost\\Ubuntu\\home\\rarbit\\.sdkman\\candidates\\java\\21.0.7-tem

package/android/.gradle/ideaInitScripts/ijtgtmapper.gradle

@@ -0,0 +1,3 @@
+ext.pathMapper = [:]
+ext.pathMapper.put("<<target java executable path>>", '/home/rarbit/.sdkman/candidates/java/21.0.7-tem/bin/java')
+ext.mapPath = { path -> pathMapper.get(path) ?: path }

package/android/.idea/AndroidProjectSystem.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AndroidProjectSystem">
+    <option name="providerId" value="com.android.tools.idea.GradleProjectSystem" />
+  </component>
+</project>

package/android/.idea/android.iml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="JAVA_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>