ssuukk / VRHelper

HTTP server for browsing and streaming video files through Samsung Gear VR

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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!

About

HTTP server for browsing and streaming video files through Samsung Gear VR


Languages

Language:Kotlin 100.0%