Skip to content
Ray edited this page Feb 28, 2026 · 24 revisions

Getting started

See install instructions

Downloader Code (latest release): 8668671

Downloader Code (develop release): 2505973

Tips & Tricks

  • On any grid page, such as library or TV guide, you can jump to the top by pressing Back
    • You can jump back to where you were by pressing & holding Back
  • You can long click on a card to see a context menu of options
  • You can click on the overview text to see metadata about the file

ExoPlayer vs MPV

MPV

Pros

  • Direct play pretty much everything
  • Significantly better subtitle support, particularly ASS
  • Easy subtitle offset adjustments
  • Huge amount of configuration options to control many aspects of playback

Cons

  • Cannot play HDR content on Android
  • Always decodes audio and outputs PCM
    • So older TVs without eARC will be limited to stereo
    • Loss of "spatial" audio
  • Can be temperamental, Wholphin's implementation is probably more prone to bugs than ExoPlayer

ExoPlayer

Pros

  • Supports HDR playback
  • Supports audio passthrough
  • Supports DRM content
  • Battle tested & backed by Google

Cons

  • Doesn't support some codecs or containers, especially older or proprietary ones, such as avi, divx, wmv
  • ASS subtitle support is limited (#569 will help greatly)

Roadmap

Core functionality

UI/UX Improvements

Other

Differences in distribution

There are no significant feature differences between GitHub releases and app store releases, such as on Google Play or Amazon AppStore, but there are a few technical differences:

  1. The GitHub release can update itself and app store releases cannot since the app stores handles updates
  2. App store releases may be delayed versus GitHub stable releases because the app stores have extra review steps
  3. Google Play releases are restricted to Android TV devices which are certified by Google and include the "Leanback" feature
  4. Amazon AppStore releases are restricted to Fire TV devices
  5. GitHub releases can be installed on any Android device with the minimum OS version
    • This is to allow some inexpensive TV boxes that are not certified by Google, but would still be compatible
    • However, Wholphin is only usable with a TV remote or game controller, touch input only devices will not work!

Clone this wiki locally