Play EasyPlex
in your own player.

1. Open the folder

   Unzip the package and open the Source/EasyPlexPlayer folder in Android Studio (File → Open). Let Gradle sync finish; accept if it asks to install SDK Platform 37.

2. Run it

   Select a device and press Run. Without activation the player screen shows Player not activated: the home screens work, playback needs a license (see Activation).

   TerminalCopy

   gradlew.bat :app:assembleDebug        # Windows
   ./gradlew :app:assembleDebug          # macOS / Linux

3. Optional: develop without activation

   While you customize the player, debug builds can skip the license check. Add this line to local.properties (that file stays on your computer and is never part of a release):

   local.propertiesCopy

   player.devNoLicense=true

   Release builds always check the license, whatever this file says.

1. Enter the code in the panel

   In your EasyPlex panel, open Settings → Player Settings → Playback:

   Field	Value
   Enable standalone EasyPlex Player	On. The apps then offer “EasyPlex External Player”.
   Standalone player package name	Your player's applicationId, exactly as published.
   EasyPlex Player purchase code	Your Envato purchase code for this item. After saving, the field shows “Configured”.

   Select Save Settings.

2. Or set them in the EasyPlex Android project

   Instead of the panel fields, you can build them into the EasyPlex app. The panel fields take priority; you need only one of the two.

   EasyPlex app · gradle.propertiesCopy

   PLAYER_PURCHASE_KEY=your-easyplex-player-purchase-code

   The package name is STANDALONE_PLAYER_PACKAGE_NAME in util/Constants.java. The code is obfuscated into the app at build time and handed to the player with each video. The panel checks it and saves it the first time.

3. Open a video once

   The player learns your panel's address from the first video the EasyPlex app sends. To activate a player that is opened on its own first, set backend.api_base_url and backend.api_key in app_config.json.

app

player

backend

Your EasyPlex panel. Videos from the EasyPlex app bring these values; set them only so the player can activate and load ads before the first video from the app.

subtitles · cast · providers

• No Episodes panel, Next episode, auto-play, “More like this” or channel list: users pick the next video in the app.
• Premium-only servers are hidden, except the one the app chose.
• The video is not saved to the player's History or Favorites; the app's “Continue watching” keeps the position, in both directions.
• When the video ends, the player closes and the user is back in the app.
• Servers play like in the app: direct links, supported hosts (the same extractor), embeds (HTTPS, trusted providers only) and YouTube. In the panel's “full embed” mode, embed streams open in the player too.

Videos the user opens in the player itself (Videos, Stream, Playlists, other apps) keep every feature, including queues and auto-play.

The checks run when the home screen opens and before each video. The EasyPlex app also sends its copy of these settings with each video, so they apply even when the panel requires signed requests.

• Home-screen banner (res/drawable-xhdpi/tv_banner.png).
• The selected control always shows a ring or outline in your brand color.
• OK, Up, Down or Menu show the controls on play/pause; Left/Right seek while the controls are hidden; Back hides the controls, then closes. Media keys work everywhere.
• Episode, channel and related panels use the EasyPlex TV app's poster cards.
• The EasyPlex Android TV app hands videos to the player like the phone app.

M3U playlists

#EXTM3U
#EXTINF:-1 tvg-logo="https://example.com/logo.png" group-title="News",My Channel
#EXTVLCOPT:http-user-agent=MyAgent/1.0
#EXTVLCOPT:http-referrer=https://example.com/
https://example.com/live/stream.m3u8

#EXTINF:5400 group-title="Movies",My Movie
#KODIPROP:inputstream.adaptive.license_type=com.widevine.alpha
#KODIPROP:inputstream.adaptive.license_key=https://license.example.com/widevine
https://example.com/movie/manifest.mpd

#EXTINF:0,Channel with headers
https://example.com/live.m3u8|User-Agent=MyAgent&Referer=https://example.com/

A duration of -1 or 0 marks a live channel. To ship your own default playlist, replace assets/sample_playlist.m3u and its name in strings.xml (sample_playlist_name).

1. Create your keystore

   In Android Studio choose Build → Generate Signed App Bundle / APK → Android App Bundle and create a keystore. Keep it and its passwords safe: every update needs the same key.

2. Build the bundle

   TerminalCopy

   gradlew.bat :app:bundleRelease
   # Or an APK:
   gradlew.bat :app:assembleRelease

   Release builds are minified with R8 (rules in app/proguard-rules.pro) and always check the license.

3. Upload and update

   Upload the .aab to the Google Play Console. Before each update, increase versionCode (and usually versionName) in app/build.gradle.

• Content rights. The app ships without content. Don't preload playlists with channels or movies you don't own or license.
• Privacy policy. Required: set privacy_policy_url.
• Data safety. Declare what your ad network collects. The player stores history, favorites and playlists only on the device.
• Permissions. Video library access is asked only on the Videos tab. Background audio uses the mediaPlayback foreground service type; declare it when the Console asks.
• Families. If your app targets children, use only certified ad networks and settings.

The sample playlist uses Blender Foundation open movies (CC BY 3.0) and public test streams, for demonstration only.

• Standalone player for EasyPlex 2.4: movies, series, anime and live channels from the EasyPlex app and the EasyPlex Android TV app, with all server types and subtitles.
• Activation with the EasyPlex Player purchase code through the EasyPlex panel (or the app's PLAYER_PURCHASE_KEY), bound to the player's package name.
• Premium protection: videos from the app play alone, premium-only servers hidden, nothing saved locally, back to the app at the end.
• “Continue watching” in step with the EasyPlex app in both directions.
• Ads and security options from the EasyPlex panel.
• Android TV interface with remote navigation, TV poster cards and home-screen banner.
• Landscape-only player screen; full player app with device videos, streams, M3U playlists, history, favorites, Chromecast, picture-in-picture and background audio.