Mobile App Setup Guide

The IPTV mobile app is built with React Native/Expo and supports both Android and iOS. This guide covers building and customizing the app.

App Features

• Code Login: Simple 4-6 character code entry
• Live TV: Browse and watch live channels
• VOD (Movies): Video on Demand library
• Series: TV shows with seasons and episodes
• Favorites: Save favorite content
• Search: Find channels and content
• VLC Player: High-quality video playback
• Theme Support: Customizable appearance

Building the Android APK

Prerequisites

• Node.js 18+ installed
• Android Studio with SDK
• Java JDK 17+

Step-by-Step Build

1. Navigate to the frontend folder:

   cd /app/frontend

2. Install dependencies:

   npm install

3. Generate native Android project:

   npx expo prebuild --platform android

4. Open in Android Studio:

   # Open Android Studio and select:
   # File > Open > /app/frontend/android

5. Build APK:
   • In Android Studio: Build > Build Bundle(s) / APK(s) > Build APK(s)
   • Or from terminal: cd android && ./gradlew assembleRelease

Customizing the App

App Name & Package

Edit app.json:

{
  "expo": {
    "name": "Your App Name",
    "slug": "your-app-slug",
    "android": {
      "package": "com.yourcompany.appname"
    },
    "ios": {
      "bundleIdentifier": "com.yourcompany.appname"
    }
  }
}

App Icon

Replace the icon file at:

/app/frontend/assets/images/icon.png

Size: 1024x1024 pixels, PNG format

Splash Screen

Replace the splash screen at:

/app/frontend/assets/images/splash-icon.png

Connecting to Your Server

The app connects to your backend server for code validation. Update the backend URL in:

/app/frontend/.env

EXPO_PUBLIC_BACKEND_URL=https://your-server.com

How Customer Login Works

1. Customer opens the app
2. Enters their access code (e.g., AB12)
3. App validates code with your server
4. Server returns Xtream credentials
5. App connects to Xtream server for content

Distribution

Direct APK

Share the APK file directly with customers for sideloading.

Google Play Store

1. Create a Google Play Developer account
2. Build a signed AAB (Android App Bundle)
3. Submit through Play Console

Apple App Store

1. Create an Apple Developer account
2. Build using Xcode on macOS
3. Submit through App Store Connect