🎬 Flixsrota Player

A distraction free(without recommendations, share buttons, or channel overlays) implementation of youtube video player. Future versions will integrate with the upcoming Flixsrota Video Server, enabling adaptive streaming

🖼️ Preview

✨ Features

• 🎥 Play YouTube videos by ID
• 📱 Works on React Native CLI and Expo
• 🔄 Fullscreen toggle with orientation lock
• ▶️⏸️ Play / Pause controls
• 🔇🔊 Mute / Unmute support
• 🎚️ Gesture & slider-based seeking
• ⚡ Lightweight and easy-to-use
• 🛠️ Supports hooks for player state (ready, video states, current time, and total duration, etc.)

📦 Installation

1. Install the package

Using npm:

npm install @flixsrota/player

Using yarn:

yarn add @flixsrota/player

2. Install orientation support

This library uses device orientation for fullscreen video handling.
Install based on your ecosystem:

✅ Expo

expo install expo-screen-orientation

✅ React Native CLI

npm install react-native-orientation-locker
# or
yarn add react-native-orientation-locker

🚀 Usage

import { View, Text } from "react-native";
import { PlayerView } from "@flixsrota/player";

export default function App() {
  return (
    <View style={{ flex: 1 }}>
      <PlayerView videoId="_cMxraX_5RE" />
      <Text>Flixsrota Player Example</Text>
    </View>
  );
}

📂 Project Structure

├── assets/                # Images for preview & docs
├── example/               # Example Expo app
├── lib/                   # Build output (JS + types)
│   ├── module/            # Compiled JavaScript (for publishing)
│   └── typescript/        # TypeScript declaration files
├── src/                   # Source code (TypeScript)
│   └── __tests__/         # Tests (need to be implemented)
├── .github/               # Contribution configs (CI/CD, hooks)

🤝 Contributing

• Development workflow
• Sending a pull request
• Code of conduct

🗣️ Discussions & Feature Requests

📢 Important: We do not accept feature requests or questions via issues.
If you want to request a feature or need help, please use GitHub Discussions only:

• 💡 Request a Feature
• 💬 Ask a Question / General Discussion

This ensures issues are only used for bug reports and development tasks.

📜 License

MIT © Nikhil Verma