Pigasus FAQ

  • UPnP and DLNA are features that allow devices on your home network to discover and stream media to each other. Typically you will have a UPNP/DLNA capable media server running on your home network (either from your PC or NAS drive) which serves up your media to one or more UPNP/DLNA clients running on your home network such as Pigasus Streaming Theater.

  • Below is a small list of a few of the more popular home media servers:

    • Plex
    • Kodi
    • Emby
    • Universal Media Server
    • Serviio
    • Subsonic

    Please note that Hanging Hat Studios, LLC has no affiliation or stake in any of the above mentioned media servers. We are unable to provide support for any of the above mentioned media servers. Questions and queries regarding any of the above media servers should be addressed to the appropriate media server’s support contact.

    Also, please note that you should never have to pay to download, install or use any media server. Some media servers may have pro features that will require payment to activate but DLNA/UPNP streaming capabilities of a media server should always be available without the need for additional payment.

  • Pigasus is capable of playing back video, image and audio media given to it by a media server. Most audio/visual media formats are supported by Pigasus.

  • Yes! Pigasus supports navigation and playback control via the Gear VR headset touchpad, gamepad controllers and the Gear VR controller.

  • Headset Controls



    Gamepad Controller Controls



    Gear VR Controller Controls




  • Due to licensing issues, we unfortunately are unable to provide support for playback of Dolby audio (i.e. EAC3, DTS and MLP).

  • Pigasus Streaming Theater uses the libVLC media library for it’s media playback on the backend. This is an open source library under the LGPL2.1 license. As such, you are permitted to build your own custom version of the libVLC library with Dolby audio enabled and use that library instead. The latest source for libVLC used within Pigasus Streaming Theater can be downloaded here.

    Simply create a folder on your phone called “Pigasus” and drop your custom built libVLC lib into that folder. Pigasus on next launch will pick up the existence of your custom built lib and use that lib instead of it’s internal one.

    Please note, this feature is provided as a conveniance to the users of Pigasus Streaming Theater. You build and use your own custom libVLC libraries at your own risk. We disclaim ourselves from all responsibility. Further more, we cannot, and do not, provided any support for Pigasus Streaming Theater running under your own custom built libVLC libs. If you find Pigasus Streaming Theater to be unstable or stops working, your first point of trouble shooting should be to remove your custom built libVLC libs.

  • No.

    However, there are already people out there on the interwebs who have built their own versions of the libVLC library with Dolby audio support enabled and who are successfully using it with Pigasus Streaming Theater. You might consider checking or asking someone on the Gear VR forums on Reddit for example. You might find a kind soul willing to share their build with you.

  • Pigasus supports most major subtitle formats (e.g. srt, smi, sub, ssa, ass etc.).

    However! It is your media server’s job to reliably provide the subtitles to Pigasus. The app cannot display something which is not given to it.

    With some media servers, setting up external subtitle support is very easy (generally you just have to enable the “enable subtitle” option in the media server’s settings and make sure that the subtitle file is in the same folder as the video and named the same), while with others it can be quite difficult.

    Please note that subtitle support is also enabled in the “Lite” version of Pigasus. It is just the subtitle selection menu that is disabled. External subtitles served to Pigasus Lite by your media server will display by default. You just won’t have the option to disable or choose from multiple subtitles.

    Please don’t hesitate to drop us an email at “pigasus@hanginghatstudios.com” or through our contact web form if you need help troubleshooting your subtitle issues.

  • This generally happens for non-English subtitles only and is either caused by unsupported file encoding or the app not being able to find the appropriate font for display.

    If you are using Android 7 and currently using your own custom build of libVLC you will need to remove that file or rebuild your libVLC again using the updated source gotten from here. The internal libVLC library used by Pigasus contains code changes that fixes an Android 7 fonts issue which effects display of non-Latin character sets. As such, your build, unless built with the recent libVLC source provided here will not have that fix.

    One other thing to bare in mind is that your subtitle file should be UTF-8 encoded. Presently Pigasus assumes all subtitle files given to it is UTF-8 encoded. In the future, there will be an option to allow you to specify your subtitle file encoding within Pigasus.


  • Pigasus Streaming Theater automatically detects popular file naming conventions for 3D and surround 360/180 videos/images such as those outlined in the oculus support center for oculus video and will auto switch to that viewing mode when playing those videos/images.

    Currently Pigasus Streaming Theater recognizes the following file naming conventions and will auto switch your videos/images appropriately once it encounters them:

        – side by side 3D video: “_3DH”, “_3DPH” and “_LR”
        – over under 3D video: “_3DV”, “3DPV” and “_TB”
        – full side by side 3D video: “_3DHF”, “_3DPHF” and “_LRF”
        – full over under 3D video: “_3DVF”, “3DPVF” and “_TBF”
        – 360 surround video: “_360” and “_MONO360”
        – 180 surround video: “_180” and “_180x180”

        myVideo_180.mp4 (a 2D 180 surround video)
        myVideo_360_LR.mp4 (a side by side 3D 360 surround video)
        myVideo_3DV.mp4 (an over under 3D video)
        myVideo_3DHF.mp4 (a full side by side 3D video)
        myVideo.mp4 (a normal 2D video)

  • Media servers will at times truncate long file names. So if you have a very long named video, for example, something like:


    Pigasus may not get the entire file name from the server and as a result will be unable to determine the requested playback format.

    You should either make the video name smaller (e.g. “My.Video_3D_LR.mkv“) or ensure that your media server is serving up the full name of the video to Pigasus (e.g. if using Plex, putting your videos in the “Video” category instead of the “Movie” category is enough to stop Plex from truncating your video filenames).

  • Of course. You may find the viewing options menu by clicking on the “View Settings” button on the far right of the player controls.

  • You are most likely using the ‘Lite’ version of Pigasus Streaming Theater. This version has certain functionalities disabled.

  • The theater screen may be zoomed when in the the Void theater only. With the player controls visible, the zoom option can be found at the top of the screen.

  • There is a “sticky mode” available to you in the Void Theater which will stick the screen to your center of view always. You can find this “sticky mode” option at the top of the screen when the player controls are visible.

  • Yes you can. There is nothing worse than bad 3D but luckily there is an option inside the 3D options menu to enable you to disable stereo on 3D content.

  • Yes. There is a “Reorientate View” option at the top of the player controls that will allow you to do this. This option is only visible to you when you are viewing content in a 180/360 surround view.

  • Yes. There is a “Zoom View” option at the top of the player controls that will allow you to do this. This option is only visible to you when you are viewing content in a 180/360 surround view.

  • Yes. There is a “Aspect Ratio” option within the “View Options” menu on the player controls panel.

  • These are bookmark stars. Simply click on one to bookmark the item in question. All bookmarked items will appear in the “Favorites” folder at the top menu (i.e. the one showing your devices on the network).

  • Video playback results depend on many factors. These range from device hardware limitations, video encoding, video player decoding limitations etc. Generally speaking, at time of writing, an S7 phone is the most capable of playing back high resolution, high frame rate videos up to 4k at 30fps reliably (most of the time) with Pigasus. Of course, this also depends on other factors such as your local network connection speed, how well your media server can transcode these videos and your video’s encoded bitrate.

    If you find your higher resolution/framerate videos stuttering when playing back in Pigasus here are a couple things you can try to help relieve the issue:

    • Check your media player’s transcoding settings. If you are direct streaming your videos, perhaps consider transcoding them before streaming. If already transcoding them, see if you have an configuration option to favor playback over quality which may help in giving you a smoother playback experience for the higher resolution/framerate videos.
    • You may consider re-encoding your problem videos to a slightly lower resolution, framerate and/or bitrate. You can use a video transcoder software like Handbrake or if you are comfortable with command line, ffmpeg to do this.
  • Pigasus is a dedicated UPNP/DLNA streaming media player only. This means that it will only discover media that is given to it by a UPNP/DLNA capable media server. As such, media sitting on an SD card or on your phone will not be discoverable for playback by Pigasus as there is no media server to serve up that media for Pigasus.

    We may decide to make Pigasus an all round media player in the future so that it discovers local phone media too. But for now that feature is pretty far down on the Pigasus road map.

  • Of course. In fact we encourage it. We strive to make the best dedicated UPNP/DLNA media player for the Gear VR and we can only do that by listening to you, the users.

This software uses code from the following open source libraries: libVLC and Cling, licensed under the LGPLv2.1.
The libVLC source can be downloaded here.
The Cling source can be downloaded here.