Pure IPTV is a modern Android IPTV player built with ExoPlayer, designed for fast performance, clean navigation, and a beautiful dark UI. Import playlists via M3U or Xtream Codes, browse channels by groups, and find what you want instantly with quick search and last-viewed resume. The app is ready for monetization with AdMob (Banner, Interstitial, App Open) and includes GDPR/UMP consent handling to respect user privacy.

Developers can easily rebrand the app by changing the app name, icons, and package name, with centralized AdMob IDs in strings.xml for simple ad configuration. The codebase follows a clean structure, background tasks are optimized, and the project is ready for release as AAB/APK. Ideal for sellers and teams who want a professional IPTV foundation with minimal setup.

• Powerful ExoPlayer-based video playback
• Multiple playlist support (M3U, Xtream Codes)
• Channel groups and tabs
• Fast channel search
• Last viewed (quick resume)
• Modern dark UI theme
• AdMob: Banner, Interstitial, App Open
• GDPR/UMP consent handling
• Centralized AdMob IDs in strings.xml
• Optimized background loading (ExecutorService)
• Clean architecture and maintainable code
• Easy rebranding (name, icon, package)
• Localization-ready (strings.xml)
• Ready for release (AAB/APK)

• Android Studio: latest stable version
• JDK: 17 (recommended for latest AGP)
• Android SDK: API 23+ (Android 6.0+) installed via SDK Manager
• Gradle: use the project’s Gradle wrapper (no manual install needed)
• Device/Emulator: Android 6.0+ for testing
• Internet access: required for IPTV streams and AdMob
• AdMob account: App ID + Ad Unit IDs (test IDs for development)
• Google Play Console (optional): for publishing AAB
• Keystore (release): to sign your release build
• Privacy Policy URL: required if serving ads (GDPR/UMP consent)

• Open the project
  • Launch Android Studio.
  • Open the folder: 

    pureIPTV/
    
    
    

    .
  • Wait for Gradle sync to finish (install any prompted SDKs).
• Run on device/emulator
  • Select an Android 6.0+ device/emulator.
  • Click Run to install and launch the app.
• Change app name (branding)
  • Edit  app/src/main/res/values/strings.xml.
  • Update 

    app_name
    
    
    

    .
• Change app icon
  • Android Studio → New → Image Asset → Launcher Icons.
  • Replace generated icons under 

    app/src/main/res/mipmap-*/
    
    
    

    .
  • Or manually replace 

    ic_launcher.png
    
    
    

     and 

    ic_launcher_round.png
    
    
    

    .
• Change package name
  • In 

    app/src/main/java/
    
    
    

    , right-click 

    com.black.pureiptv
    
    
    

     → Refactor → Rename → Rename Package.
  • Update 

    applicationId
    
    
    

     in 

    app/build.gradle
    
    
    

     to the new package.
  • Sync Gradle, then Rebuild.
  • Ensure  AndroidManifest.xml authorities use 

    ${applicationId}
    
    
    

    .
• Configure AdMob
  • Update IDs in  app/src/main/res/values/strings.xml:

    • admob_app_id
      
      
      

    • admob_banner_unit_id
      
      
      

    • admob_interstitial_unit_id
      
      
      

    • admob_app_open_unit_id
      
      
      

  • Manifest already references 

    @string/admob_app_id
    
    
    

    .
  • Banners in layouts use 

    @string/admob_banner_unit_id
    
    
    

    .
  • Interstitial/App Open are read via  getString(...) in code.
  • Use Google test IDs during development.
• Consent & Privacy
  • Ensure your Privacy Policy URL is correct wherever referenced.
  • Confirm UMP/consent flow behavior in your target regions.
• Localization
  • Add 

    values-xx/strings.xml
    
    
    

     for new languages.
  • Copy keys from  values/strings.xml and translate.
• Versioning
  • In 

    app/build.gradle
    
    
    

     → 

    defaultConfig
    
    
    

    :
    • Update 

      versionCode
      
      
      

       (integer, increment each release).
    • Update 

      versionName
      
      
      

       (e.g., "1.0.1").
• Build release (AAB/APK)
  • Android Studio → Build → Generate Signed Bundle/APK.
  • Create/Choose keystore, set passwords.
  • Choose Android App Bundle (AAB) for Play Store.
  • Select 

    release
    
    
    

     variant and finish.
  • Keep your keystore safe.
• Testing checklist
  • Verify streams load (M3U/Xtream).
  • Check channel search, tabs, last viewed.
  • Validate ads: Banner/Interstitial/App Open (use test IDs).
  • Confirm consent appears where required.
  • Smoke test on at least two Android versions.
• Troubleshooting
  • Build issues: re-sync Gradle, update Android Studio, install missing SDKs.
  • Ads not showing: check consent, internet, test IDs vs live IDs, AdMob dashboard.
  • Crashes on FileProvider: verify  file_paths.xml and 

    ${applicationId}.provider
    
    
    

     in Manifest.
  • Wrong package: confirm refactor + 

    applicationId
    
    
    

     match.