VR Helper for Samsung Gear VR
You don't have to buy a brewery to drink bear
...my father used to say, and although he didn't mean serving video streams, but something completely different (if you know what I mean...), I do believe that you shouldn't be required to install Apache, MySQL and PHP (whatever it is...) to just serve some files.
So in this repository you can find a simple self-contained, stand-alone HTTP server that has just one purpose: serving video streams for Samsung Gear VR.
What can it do?
-
quickly and easily browse your movie collection
-
launch movie by taping its name in Android browser (via
milkvr://sideload
url scheme) -
download *.mvrl file to your device (to be visible in Gear VR, you have to move it to proper directory yourself, though) by taping description under file title
-
guess video and audio type by hints present in video name
-
use images with name similar to video file as thumbnail
Configuration
VR Helper looks for config file (and all other optional files, by that matter) in current directory.
config.txt
There are just three parameters:
server = storage.lan # (IP or resolvable name)
port = some_port # (80 by default)
dirs = /path1/videos ; /path2/othervideos (server root directories, browsing outside of them is forbidden)
Note 1: hash comments are not actually supported
Note 2: this is not a secure server, it should be run only in your own, private network. It doesn't require authentication,
you can only limit its browsing capabilities to directories specified by dirs
keyword.
folder.png
folder.png
- an icon for folder
video.png
video.png
- default video icon
favicon.ico
favicon.ico
- probably an icon for bookmarks, some browsers keep requesting it
mainstyles.css
mainstyles.css
- if present will override internal css
Running the server
Just build it and start with
java -jar built_file.jar
Current limitations
It seems that due to some bug (or on purpose) milkvr://sideload
has no effect when browsed via Samsung Internet VR app.
This sucks. Hope they will fix it soon!