VR-reversal

Uses MPV and a plugin to play a 3D side-by-side video as a 2D video, allows you to look around and zoom within the video, optionally logs the head motions to a file for later rendering out to a 2D video with ffmpeg.

Installation and Usage:

• Download the lastest MPV https://mpv.io/
• Download the 360plugin.lua plugin from this repo.
• Play a video using the plugin with the command: mpv --script=360plugin.lua --script-opts=360plugin-enabled=yes videoFile.mp4

If you want to enable this script automatically on startup in your regular MPV, you can place the config file from the script-opts directory in the corresponding MPV config directory, along with the script itself in MPV's scripts directory. To activate auto-starting of the script every MPV session, change enabled=yes in the config file.

If you want to save the 2D versions videos rather than just watch them you'll need a recent version of ffmpeg from https://ffmpeg.org/ but it's not needed just for viewing.

Alternatively rather than using the command line, Microsoft Windows users may choose to:

• Place mpv.exe, vr-reversal.bat and 360plugin.lua (the latter two are available as a Zip file in releases) in the same directory.
• Run vr-reversal.bat
• Drag and drop videos onto the MPV window.

Controls

You can press ? to show all of the keyboard controls on screen at any time.

When the player is started, if the script is automatically enabled, you'll be looking straight forwards. If not type:

• v to toggle the main feature on or off.

The video will start at a low resolution, if you'd like more detail press y increase the initial preview quality h to reduce it again.

• y Increase resolution
• h decrease resolution

Control where you're looking with the mouse:

• MouseLook: click anywhere in the video and your mouse position will control the camera, click again to stop mouse control
• MouseScroll: zoom in and out

or alternately look around with these keys:

• i,j,k,l look around
• u,o roll head
• =,- zoom
• TAB center view

Additional controls:

• t switch the eye you're looking through between left and right
• e switch the video scaler between nearest neighbour and bicubic
• g toggle mouse smoothing
• n start / stop logging head motions to file (for later rendering)
• ? display reminder of keyboard and mouse controls

Advanced projection controls:

90% of modern vr releases work perfectly with the defauls of 180 degree 'hequirect' projection so you shound't need these unless playing older or unusually formatted content:

• r toggle stereo mode between top/bottom and side by-side
• b cycle input fov bounds between 180,360 and 90
• 1 cycle through input projections
• 2 cycle through output projections
• p cycle through 2D output modes including flat 2D, reprojected side by side and anaglyph modes.

Most of the standard default MPV controls are maintained:

• Arrow keys seek through video
• SPACE pause
• f fullscreen toggle
• 9,0 or /,* volume up and down
• m mute

And finally when you are done:

• q quit

You can configure the default keybindings in the script-opts/360plugin.conf file, or override them in your input.conf file as usual.

'Head' Motion Logging and saving your clips

If you have pressed n during your session your 'head' movements in the video will be logged to a file named {originalFilename}_3dViewHistory_{sectionNumber}.txt this is in the format of motion commands to be processed by ffmpeg https://ffmpeg.org/

The script will create a batch file convert_3dViewHistory.bat after you exit the player, if you have ffmpeg installed you may simply run this file to perform the conversion to 2D .mp4 clips automatically.