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.

  • A Samba share is a another way to enable sharing of files and services over the local network. It is an implementation of the SMB/CIFS networking protocol and can be easily set up by anyone running a Windows or Linux computer. A quick Google search will bring up many results on how to set up a simple Samba share either via Windows or Linux.

  • You will need to create a plain text “host” file with the same name as your Samba host (this host name is the name you see when you go into the Samba share folder in Pigasus). This text file may have the “.txt” extension or be left without the “.txt” extension.

    Inside your “host” file, on the first line, put your username. On the second line of the file, put your password for your Samba share. It is important that the first line be the username and the second line be the password.

    After that is done, place this plain text “host” file in the “SMB” folder found within the “Pigasus” folder on your phone. Whenever Pigasus needs authentication to access a password protected Samba share it will search for the associated “host” file and grab the authentication credentials from within that file.

    In this way, there should be no need to ever manually enter your authentication credentials in Pigasus when accessing your password protected Samba shares. This should be done automatically for you always.


    You have a password protected Samba share with a host called “MySMBShare” on your local network. Simply create a plain text “host” file and name it either “MySMBShare” or “MySMBShare.txt”. Place this file in the “SMB” folder within the “Pigasus” folder on your phone.

    Let’s say your user name is “your_username” and your password is “your_password“. Within this plain text “host” file you should have 2 lines of text which will somewhat like so:


  • No. Unfortunately at the moment, Pigasus only supports SMB1 shares.

    Please make sure that you have SMB1 support turned on if trying to use a Samba share with Pigasus.

  • 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 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.
  • Yes! As of version 2.0.0 of Pigasus you should now be able to access your local media both from your phone’s local storage as well as any attached SD cards.

    Simply click on the “SD Card” folder in the main menu to browse your SD card content and the “Phone” folder to browse the local content on your phone.

  • Bluetooth headsets can cause noticeable audio lag with video apps (such as Pigasus) on phones.

    To account for this, Pigasus is able to automatically detect whether or not you have a bluetooth headset enabled and if so it will try to auto offset the audio to account for the lag and keep the audio in sync with the video.

    Additionally, you will find in the “Settings” menu the ability to adjust this audio offset time that Pigasus auto applies to audio whenever it detects that a bluetooth headset is enabled.

  • Interpupillary distance (IPD) is the distance between the center of the pupils of the two eyes. Your IPD value can effect how comfortably you see stereo within a VR environment. An average IPD for adults is about 64mm.

    If you find that you are having eye comfort issues such as issues focusing on stereo video content and images or even within the general VR environment you may have an IPD that is either wider or shorter than the default set IPD (which is 64mm to conform to the average IPD for adults).

    If this is the case, you can adjust the IPD within the “Settings” menu which may help your overall eye comfort level.

  • Yes! Both brightness and contrast adjustment options can be found in the “Settings” menu.


  • 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, JCIFS and Cling, licensed under the LGPLv2.1.
The libVLC source can be downloaded here.
The JCIFS source can be downloaded here.
The Cling source can be downloaded here.