Technical Diagnostics &
Troubleshooting

Khulani Mthanti By Khulani Mthanti | TV Systems Tester
Last updated: Jun 14, 2026

Is the app crashing? Videos buffering? Getting a parsing error? Browse our comprehensive, lab-tested diagnostic matrix to find the exact fix for your specific hardware.

Error Code / Symptom Primary Cause Immediate Fix Detailed Guide
App Not Installed Orphaned package signature mismatch. Force-purge package via ADB shell. View Fix →
Error: -201 Hardware codec failure (HEVC/MKV). Toggle to SW Decoder in app settings. View Fix →
Subtitle Desync Android 12 media extraction bug. Inject -1500ms delay via Subtitle Settings. View Fix →
Parse Error Corrupt APK / Insufficient NAND storage. Clear FireStick cache & re-download. View Fix →
Endless Buffering ISP throttling or DNS blockhole. Change router DNS to 1.1.1.1 / Use VPN. View Fix →

1. App Not Installed (ADB Orphan Fix)

A standard uninstall often leaves orphaned package data. When you attempt to sideload a newer version, the Android OS blocks it due to a cryptographic signature mismatch.

The ADB Shell Fix:

  1. Connect your Android device or TV to your PC via Android Debug Bridge (ADB).
  2. Open your terminal/command prompt.
  3. Run the following command to forcefully purge the old package:
adb shell pm uninstall -k --user 0 com.onstream.app

2. Error Code: -201 (Playback Failed)

This specific ExoPlayer error occurs when your device's hardware decoder fails to process x265 (HEVC) or MKV containers. It is extremely common on older FireSticks and budget Android TV boxes.

Force Software Decoding (SW):

  1. Open the OnStream app and navigate to the Settings gear icon.
  2. Select Player Settings.
  3. Locate the "Decoding Engine" toggle.
  4. Switch it from HW Decoder to SW Decoder.

Note: Software decoding forces the CPU to decode the stream. This will fix the error but may slightly increase battery drain on mobile devices.

3. Parse Error on FireStick & Android TV

"There was a problem parsing the package." This error almost exclusively means one of two things: the APK file you downloaded was corrupted due to a network drop, or your device does not have enough NAND storage to extract the package.

Solution A: Clear Storage

Navigate to Settings > Applications > Manage Installed Applications on your FireStick. Clear the cache for heavy apps (like YouTube or Netflix) to free up at least 300MB of space, then try installing again.

Solution B: Re-download

Open the Downloader App, delete the currently downloaded APK file from the "Files" section, and re-download the APK from a stable connection to ensure the file is not corrupted.

4. Network Triage: Endless Buffering

If your internet connection is fast (e.g., 100Mbps+) but the app refuses to load movie posters or constantly buffers during playback, you are likely experiencing ISP-level throttling or DNS blackholing.

  • Change DNS: Many ISPs block the tracker URLs that the app uses to scrape links. Go to your device's Network Settings and change your DNS to 1.1.1.1 (Cloudflare) or 8.8.8.8 (Google).
  • Use a VPN: If changing the DNS does not resolve the buffering, your ISP is employing Deep Packet Inspection (DPI) to throttle P2P video traffic. You must enable a VPN (like ExpressVPN or NordVPN) to encrypt your traffic before opening the app.

Report an Unlisted Bug

If you are experiencing a hardware-specific bug that is not listed in our Diagnostic Matrix, please report it directly to our Cape Town testing lab.

Contact The Lab